Skip to main content

Validator, generator and parser for Bulgarian unique citizenship numbers (EGN/ЕГН).

Project description

egn

Python package for validating, parsing and generating unique citizenship numbers in Bulgaria EGN (ЕГН).

Български: Скрипт за проверка и генериране на ЕГН / Програма за проверка и генериране на единни граждански номера.

PyPI package https://img.shields.io/travis/miglen/egn.svg Documentation Status https://img.shields.io/codecov/c/github/miglen/egn.svg https://img.shields.io/codeclimate/github/miglen/egn.svg

Installation

Install the package with pypi.

$ pip install egn

Usage

Use it as command line or python package. Here are the options:

Python package

import egn

# Validate
egn.validate(123123123)
>>> 123123123 is invalid!

# Parsing
egn.parse(1234567890)
>>> ....

# Generating
egn.generate()
>>> ....

# Generating with options
egn_options = {'year': 1999, 'month': 3, 'day': 3, 'region': 'Sofia', 'gender': 'm'}
egn.generate(egn_options)
>>> ....

Command line

Invoke the package with simply typing egn:

$ egn

Which will print the help message. Here are the most common commands:

# Validate
$ egn 1234567890

# Parse
$ egn -p 1234567890

# Generate
$ egn -g # random without options
$ egn -g -y 1999 -m 3 -d 3 -r Sofia -s male # with options

to-do

  • First step: validation

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

egn-0.1.4.tar.gz (7.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page