{"id":28560721,"url":"https://github.com/selva221724/pypostalwin","last_synced_at":"2025-06-10T09:38:13.680Z","repository":{"id":44961696,"uuid":"426369433","full_name":"selva221724/pypostalwin","owner":"selva221724","description":"libpostal wrapper python package for windows","archived":false,"fork":false,"pushed_at":"2023-08-12T20:58:50.000Z","size":74,"stargazers_count":15,"open_issues_count":8,"forks_count":5,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-05-10T18:48:23.170Z","etag":null,"topics":["address","addressparser","libpostal","parser","pypi","python","python-library","windows","wrapper"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/selva221724.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-11-09T20:03:55.000Z","updated_at":"2024-12-09T02:56:18.000Z","dependencies_parsed_at":"2022-07-13T11:10:31.051Z","dependency_job_id":null,"html_url":"https://github.com/selva221724/pypostalwin","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":"readthedocs/tutorial-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/selva221724%2Fpypostalwin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/selva221724%2Fpypostalwin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/selva221724%2Fpypostalwin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/selva221724%2Fpypostalwin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/selva221724","download_url":"https://codeload.github.com/selva221724/pypostalwin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/selva221724%2Fpypostalwin/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259049799,"owners_count":22798031,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["address","addressparser","libpostal","parser","pypi","python","python-library","windows","wrapper"],"created_at":"2025-06-10T09:37:54.871Z","updated_at":"2025-06-10T09:38:13.646Z","avatar_url":"https://github.com/selva221724.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pypostalwin \n\n[\u003cimg src=\"https://img.shields.io/pypi/v/pypostalwin\"\u003e](https://pypi.org/project/pypostalwin/)\n[\u003cimg src=\"https://img.shields.io/static/v1?label=license\u0026message=MIT\u0026color=green\"\u003e](https://opensource.org/licenses/MIT)\n\u003cimg src = \"https://img.shields.io/badge/Operating%20system-Windows-blue\"\u003e\n\u003cimg src=\"https://img.shields.io/pypi/wheel/pypostalwin\"\u003e\n\u003cimg src = \"https://img.shields.io/pypi/pyversions/pypostalwin\"\u003e\n\u003cimg src = \"https://img.shields.io/github/commit-activity/w/selva221724/pypostalwin\"\u003e\n\u003cimg src = \"https://img.shields.io/github/languages/code-size/selva221724/pypostalwin\"\u003e\n\npypostalwin is the Un-Official Python wrapper to [libpostal](https://github.com/openvenues/libpostal) only for Windows, a fast statistical parser/normalizer for street addresses anywhere in the world.\n\n\n## About libpostal\nlibpostal is a C library for parsing/normalizing street addresses around the world using statistical NLP and open data. The goal of this project is to understand location-based strings in every language, everywhere.\n\n## Installation\n\n### 1. Build the libpostal in Windows\n- Before using the Python wrapper, you need to build the libpostal C library as a bundle which can be accessed by the python package. (still under development) \n\n(OR)\n\n- Download and Install [MSYS2](https://www.msys2.org/)\n- You can use the libpostal prebuilt zipped file [Download here](https://drive.google.com/file/d/1fZUlyLFCGYD7l_PDM0NzD8pAo-ICrVVd/view?usp=sharing)  \n- Unpack the zip to C:\\Workbench\\libpostal\\\n- If you don't have **Workbench** folder in C Drive, then create one. \n- Copy the zip inside the **Workbench** and unzip using [7zip](https://www.7-zip.org/download.html) \n\n### 2. Install the python wrapper \n**Install using pip**. [Offical Python Package Here!!](https://pypi.org/project/pypostalwin/)\n```shell\npip install pypostalwin\n```\n\n(OR)\n\nClone this Repository. Run this from the root directory to install\n\n```shell\npython setup.py install\n```\n\n## Usage\n\n### Import Package\n```python\nimport pypostalwin\n```\n\n### 1. Initialize Address Parser Object\n```python\nparser = pypostalwin.AddressParser()\nparsed_address = parser.parse_address(\"The White House 1600 Pennsylvania Avenue NW, Washington, DC 20500, USA\")\nprint(parsed_address)\n```\noutput\n```sh\n[\n  {'house': 'the white house'}, \n  {'house_number': '1600'},\n  {'road': 'pennsylvania avenue nw'}, \n  {'city': 'washington'}, \n  {'state': 'dc'}, \n  {'postcode': '20500'}, \n  {'country': 'usa'}\n]\n\n```\n**Note:** In a single runtime, the first-time parser.runParser() will take a few seconds to run since it is loading the models from libpostal in the backend process. Once it is loaded, the recurrent runs will be faster as usual. You need to use the same object instance to get the results faster.\n\nfor eg:\n\n```python\nparser = pypostalwin.AddressParser()\nparsed_address1 = parser.parse_address(\"The White House 1600\") #only first time will take few seconds to load\nparsed_address2 = parser.parse_address(\"Washington, DC 20500, USA\") #will be faster as usual\nparsed_address3 = parser.parse_address(\" 20500, USA\") #will be faster as usual\nparsed_address4 = parser.parse_address(\"Pennsylvania Avenue NW, Washington,\") #will be faster as usual\n```\n### 2. Expand the Address\n```python\nexpanded_address = parser.expand_address(\"District Science Cntr, Kokkirakulam Rd, Tirunelveli, TamilNadu 627009\")\nprint(expanded_address)\n```\noutput\n```sh\n['district science center kokkirakulam road tirunelveli tamilnadu 627009',\n 'district science connector kokkirakulam road tirunelveli tamilnadu 627009']\n```\n\n\n### 3. Terminate Address Parser Object\n```python\nparser.terminate_parser()\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fselva221724%2Fpypostalwin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fselva221724%2Fpypostalwin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fselva221724%2Fpypostalwin/lists"}