ISO Filters
Adds filters for interpreting standard codes and identifiers, including:
ISO 3166-1 alpha-2 and alpha-3 country codes.
ISO 4217 currency codes.
IETF Language Tags (aka BCP 47).
Requirements
ISO Filters is known to be compatible with the following Python versions:
3.14
3.13
3.12
Installation
This package is an extension for the Filters library, so you can install it as an extra to phx-filters:
pip install phx-filters[iso]
If desired, you can install this package separately. This allows you to control the package version separately from phx-filters:
pip install phx-filters-iso
Maintainers
To set up a local development environment:
Install uv (once per machine).
Install dependencies:
uv sync
Activate pre-commit hooks:
uv run autohooks activate --mode=pythonpath
Run tests for all supported Python versions using tox:
uv run tox -p
To run tests in the current virtualenv:
uv run python -m unittest
Documentation
Documentation is available on ReadTheDocs.
Source files for this project’s documentation can be found in the phx-filters repo.
Releases
1. One-time setup
Create a PyPI API token if you don’t have one, then install keyring as a global tool and store the token:
uv tool install keyring
uv tool update-shell
keyring set https://upload.pypi.org/legacy/ __token__Paste your pypi-... token when prompted.
2. Publish to PyPI
Bump the version (updates pyproject.toml and uv.lock):
uv version <version>
Commit the changes:
git add pyproject.toml uv.lock git commit
Publish to PyPI:
uv publish --username __token__
3. Create GitHub Release
Create an annotated tag and push to GitHub:
git tag -a <version> -m "Release <version>" git push origin <version>
<version> must match the updated version number in pyproject.toml.
Go to the Releases page for the repo.
Click Draft a new release.
Select the tag that you created in step 1.
Specify the title of the release (e.g., ISO Filters v1.2.3).
Write a description for the release. Make sure to include: - Credit for code contributed by community members. - Significant functionality that was added/changed/removed. - Any backwards-incompatible changes and/or migration instructions. - SHA256 hashes of the build artefacts.
GPG-sign the description for the release (ASCII-armoured).
Attach the build artefacts to the release.
Click Publish release.
1 maintainer
Metadata
1 maintainer
Release files for phx-filters-iso 3.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| phx_filters_iso-3.2.0.tar.gz | 6.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| phx_filters_iso-3.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 13.0 kB
Release files / phx_filters_iso-3.2.0.tar.gz
| Download URL | phx_filters_iso-3.2.0.tar.gz |
|---|---|
| Size | 6.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
716ceb3f88f07e81191377c567cf00bf208be3c55191e2e5cf7d71ba9dd81947
|
|
BLAKE2b-256 checksum How to use checksums |
fddc02e6689928437565c849711ad22a3f9283d1ed05d25bdfe50778fac53c05
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / phx_filters_iso-3.2.0-py3-none-any.whl
| Download URL | phx_filters_iso-3.2.0-py3-none-any.whl |
|---|---|
| Size | 6.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
96d07670d545639a63c3695d80a3ce77181f9d69a89432bb29424f486c3f1e84
|
|
BLAKE2b-256 checksum How to use checksums |
628277f4d909c7e4f48c027506b60826ae60151ee311b3a2c936a244e3d9c82c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
