A Python-based utility developed to interface with the cryptographic algorithms governing Turkish Identification Numbers (TC Kimlik No). This tool facilitates validation, deterministic generation, and relational extraction of ID data for testing and verification purposes.

Architecture

Source repository: Turkish_IDs.

Core Capabilities

• Validation Protocol: Cryptographically verifies the structural validity of a given Turkish ID number against national algorithmic standards.
• Deterministic Generation: Generates arbitrary volumes of structurally valid ID numbers, optimizing data mocks for integration testing.
• Relational Mapping: Computes sibling and relative ID numbers based on chronological algorithms (older/younger determinism).
• Data Recovery: Reconstructs the checksum identifiers (the final two digits) given the primary 9-digit sequence.

Execution Protocol

The suite is executed locally via the Python runtime environment, utilizing standardized CLI arguments.

Validation Example:

python main.py --validate 12345678901

Generation Example:

python main.py -g 10 -s 12345678901

Operational Context

This utility provides critical infrastructural support for software engineering processes that require robust validation of Turkish demographic data. By enabling automated generation of valid dummy IDs, developers can strictly validate backend logic without relying on sensitive, real-world personally identifiable information (PII).