https://github.com/jsporna/pypesel

Polish PESEL Python module
https://github.com/jsporna/pypesel

pesel pesel-generator pesel-number pesel-python pesel-validation pypi pypi-package python python-module python-package

Last synced: 17 days ago
JSON representation

Polish PESEL Python module

• Host: GitHub
• URL: https://github.com/jsporna/pypesel
• Owner: jsporna
• License: apache-2.0
• Created: 2021-02-11T20:03:23.000Z (about 5 years ago)
• Default Branch: develop
• Last Pushed: 2023-02-20T12:13:26.000Z (about 3 years ago)
• Last Synced: 2025-05-07T03:11:20.643Z (11 months ago)
• Topics: pesel, pesel-generator, pesel-number, pesel-python, pesel-validation, pypi, pypi-package, python, python-module, python-package
• Language: Python
• Homepage:
• Size: 53.7 KB
• Stars: 5
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# pypesel

PESEL Python module

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 (except some specific situations such as gender reassignment).

[![Test](https://github.com/jsporna/pypesel/workflows/Test/badge.svg)](https://github.com/jsporna/pypesel/actions?query=workflow%3ATest)

[![codecov](https://codecov.io/gh/jsporna/pypesel/branch/develop/graph/badge.svg?token=0ZQP387S65)](https://codecov.io/gh/jsporna/pypesel)

[![PyPI version](https://badge.fury.io/py/pesel.svg)](https://badge.fury.io/py/pesel)

![GitHub](https://img.shields.io/github/license/jsporna/pypesel)

![PyPI - Downloads](https://img.shields.io/pypi/dm/pesel)

## Installation

```shell

pip install pesel

```

## Python usage

```python

from pesel import Pesel

random_pesel = Pesel.generate()

random_pesel_male = Pesel.generate(male=True)

random_pesel_2021 = Pesel.generate(year=2021)

pesel = Pesel("65432101239")

```

## Shell usage

There are 2 commands: `generate` & `validate`

```shell

❯ pesel generate --help

usage: pesel generate [-h] [--year YEAR] [--month MONTH] [--day DAY] [--male | --female]

optional arguments:

  -h, --help            show this help message and exit

  --year YEAR, -y YEAR  Year of birth

  --month MONTH, -m MONTH

                        Month of birth

  --day DAY, -d DAY     Day of birth

  --male                It is male person

  --female              It is female person

```

```shell

❯ pesel generate

62512426682

```

```shell

❯ pesel validate --help

usage: pesel validate [-h] pesel

positional arguments:

  pesel       PESEL number

optional arguments:

  -h, --help  show this help message and exit

```

```shell

> pesel validate 62512426682

True

```