ksef2.testdata

Public helpers for generating TEST-environment identifiers.

Funkcje

generate_nip

Import: from ksef2.testdata import generate_nip

def generate_nip(rng: random.Random | None = None) -> str

Return a random but valid 10-digit NIP.

Parametry

• rng (random.Random | None) — Random generator to draw from; a new one is created when None. Pass a seeded generator for reproducible values.

Zwraca

• str — A NIP with a valid checksum, as a string.

generate_pesel

Import: from ksef2.testdata import generate_pesel

def generate_pesel(
    year: int | None = None,
    month: int | None = None,
    day: int | None = None,
    rng: random.Random | None = None,
) -> str

Return a random but valid 11-digit PESEL.

Optionally pin the birth date components; unspecified parts are randomised.

Parametry

• year (int | None) — Birth year (1800–2299); random when None.
• month (int | None) — Birth month (1–12); random when None.
• day (int | None) — Birth day of month; random in 1–28 when None.
• rng (random.Random | None) — Random generator to draw from; a new one is created when None. Pass a seeded generator for reproducible values.

Zwraca

• str — A PESEL with a valid checksum, as a string.