Metadata-Version: 2.1
Name: pyzcode
Version: 0.1.0
Summary: Python package to manage zip codes
License: Apache 2.0
Author: Youssef Ragab
Author-email: 77282699+youssefragab99@users.noreply.github.com
Requires-Python: >=3.9,<4.0
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: pandas (>=2.2.3,<3.0.0)
Description-Content-Type: text/markdown

# pyzcode

## Overview

`pyzcode` is a Python package designed to handle and manipulate zip codes in the United States. This package provides a comprehensive set of tools to validate, parse, and format zip codes, making it easier for developers to work with postal codes in their applications.

## Features

- **Validation**: Ensure that zip codes conform to the standard US formats.
- **Parsing**: Extract relevant information from zip codes, such as state and city.
- **Formatting**: Convert zip codes to various formats for display or storage.
- **Lookup**: Retrieve detailed information about a zip code, including geographic and demographic data.

## Installation

You can install `pyzcode` using pip:

```sh
pip install pyzcode
```

## Usage

Once installed, you can start using `pyzcode` to handle zip codes in your Python projects. The package is designed to be intuitive and easy to integrate into existing codebases.

## License

`pyzcode` is licensed under the MIT License. See the LICENSE file for more details.

## Contributing

We welcome contributions to `pyzcode`. If you have suggestions for improvements or have found a bug, please open an issue or submit a pull request on our GitHub repository.

## Contact

For any questions or inquiries, please contact the maintainers at [email@example.com].

