Skip to content
jsporna

jsporna/pypesel

PESEL is the national identification number used in Poland since 1979. It always has 11 digits, identifies just one person and cannot be changed to another one

Polish PESEL Python module

5 2PythonPush 3y agoListed 13d agoApache-2.0
peselpesel-generatorpesel-numberpesel-pythonpesel-validationpypipypi-packagepython
  • Python99.4%
  • Makefile0.6%
View on GitHub

Report a problem

1 Review

pypesel is a clean, focused Python package that does one thing and presents it well: validate, parse, compare, and generate Polish PESEL numbers. The API is simple (Pesel(...), Pesel.validate, Pesel.generate), the package includes a small CLI, and the README gives enough examples for quick adoption. I also like the test coverage around valid/invalid numbers, generated values, gender/date extraction, comparisons, and CLI behavior; for a compact utility library, that is exactly the right emphasis.

The implementation is readable and dependency-light, with Poetry packaging and a straightforward Makefile. My main critique is maintenance polish: CI still targets develop while the repo URL defaults to main, several GitHub Actions versions are old, and lint currently uses --exit-zero, which reports problems without failing the build. The package metadata could also use a real description and updated tool table names. Overall, though, this is a practical, well-scoped utility with a pleasantly small surface area and enough tests to feel trustworthy.