{ "info": { "author": "Ivan Rincon", "author_email": "ivan.rincon76@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "License :: OSI Approved :: GNU General Public License v3 (GPLv3)", "Programming Language :: Python :: 3", "Topic :: Security" ], "description": "MRZ Generator & MRZ Checker\n===========================\n\nDescription:\n------------\n\nMachine Readable Zone generator and checker for official travel\ndocuments sizes 1, 2, 3, MRVA and MRVB (Passports, Visas, national id\ncards and other travel documents)\n\nMRZ Generator and MRZ Checker are built according to International Civil\nAviation Organization specifications (ICAO 9303):\n\n- `Specifications Common to all Machine Readable Travel Documents\n (MRTDs) `__\n- `Specifications for Machine Readable Passports\n (MRPs) `__\n- `Specifications for TD1 Size Machine Readable Official Travel\n Documents\n (MROTDs) `__\n- `Specifications for TD2 Size Machine Readable Official Travel\n Documents\n (MROTDs) `__\n- `Specifications for Machine Readable Visas\n (MRV) `__\n\nFields Distribution of Official Travel Documents:\n-------------------------------------------------\n\n.. figure:: https://raw.githubusercontent.com/Arg0s1080/mrz/master/docs/Fields_Distribution.png\n :alt: image\n\n image\n\nUsage Generator:\n----------------\n\nTD1's (id cards):\n^^^^^^^^^^^^^^^^^\n\n::\n\n Params: Case insensitive\n\n document_type (str): The first letter shall be 'I', 'A' or 'C'\n country_code (str): 3 letters code (ISO 3166-1) or country name (in English)\n document_number (str): Document number\n birth_date (str): YYMMDD\n sex (str): Genre. Male: 'M', Female: 'F' or Undefined 'X'\n expiry_date (str): YYMMDD\n nationality (str): 3 letters code (ISO 3166-1) or country name (in English)\n surname (str): Holder primary identifier(s). This field will be transliterated\n given_names (str): Holder secondary identifier(s). This field will be transliterated\n optional_data1 (str): Optional personal data at the discretion of the issuing State.\n Non-mandatory field. Empty string by default\n optional_data2 (str): Optional personal data at the discretion of the issuing State.\n Non-mandatory field. Empty string by default\n transliteration (dict): Transliteration dictionary for non-ascii chars. Latin based by default\n force (bool): Disables checks for country, nationality and document_type fields.\n Allows to use 3-letter-codes not included in the countries dictionary\n and to use document_type codes without restrictions.\n\n\nTD2\n^^^\n\n::\n\n Params: Case insensitive\n\n document_type (str): The first letter shall be 'I', 'A' or 'C'\n country_code (str): 3 letters code (ISO 3166-1) or country name (in English)\n surname (str): Holder primary identifier(s). This field will be transliterated.\n given_names (str): Holder secondary identifier(s). This field will be transliterated.\n document_number (str): Document number.\n nationality (str): 3 letters code (ISO 3166-1) or country name\n birth_date (str): YYMMDD\n sex (str): Genre. Male: 'M', Female: 'F' or Undefined 'X'\n expiry_date (str): YYMMDD\n optional_data (str): Optional personal data at the discretion of the issuing State.\n Non-mandatory field. Empty string by default\n transliteration (dict): Transliteration dictionary for non-ascii chars. Latin based by default\n force (bool): Disables checks for country, nationality and document_type fields.\n Allows to use 3-letter-codes not included in the countries dictionary\n and to use document_type codes without restrictions.\n\n\nTD3 (Passports)\n^^^^^^^^^^^^^^^\n\n::\n\n Params: Case insensitive\n\n document_type (str): Normally 'P' for passport\n country_code (str): 3 letters code (ISO 3166-1) or country name (in English)\n surname (str): Primary identifier(s)\n given_names (str): Secondary identifier(s)\n passport_number (str): Passport number\n nationality (str): 3 letters code (ISO 3166-1) or country name\n birth_date (str): YYMMDD\n sex (str): Genre. Male: 'M', Female: 'F' or Undefined 'X'\n expiry_date (str): YYMMDD\n optional data (str): Personal number. In some countries non-mandatory field. Empty string by default\n transliteration (dict): Transliteration dictionary for non-ascii chars. Latin based by default\n force (bool): Disables checks for country, nationality and document_type fields.\n Allows to use 3-letter-codes not included in the countries dictionary\n and to use document_type codes without restrictions.\n\n\nMRVA (Visas type A)\n^^^^^^^^^^^^^^^^^^^\n\n::\n\n Params: Case insensitive\n\n document_type (str): The First letter must be 'V'\n country_code (str): 3 letters code (ISO 3166-1) or country name (in English)\n surname (str): Primary identifier(s)\n given_names (str): Secondary identifier(s)\n passport_number (str): Passport number\n nationality (str): 3 letters code (ISO 3166-1) or country name\n birth_date (str): YYMMDD\n sex (str): Genre. Male: 'M', Female: 'F' or Undefined 'X'\n expiry_date (str): YYMMDD\n optional_data (str): Optional personal data at the discretion of the issuing State.\n Non-mandatory field. Empty string by default.\n transliteration (dict): Transliteration dictionary for non-ascii chars. Latin based by default\n force (bool): Disables checks for country, nationality and document_type fields.\n Allows to use 3-letter-codes not included in the countries dictionary\n and to use document_type codes without restrictions.\n\n\nMRVB (Visas type B)\n^^^^^^^^^^^^^^^^^^^\n\n::\n\n Params: Case insensitive\n\n document_type (str): The First letter must be 'V'\n country_code (str): 3 letters code (ISO 3166-1) or country name (in English)\n surname (str): Primary identifier(s)\n given_names (str): Secondary identifier(s)\n passport_number (str): Passport number\n nationality (str): 3 letters code (ISO 3166-1) or country name\n birth_date (str): YYMMDD\n sex (str): Genre. Male: 'M', Female: 'F' or Undefined 'X'\n expiry_date (str): YYMMDD\n optional_data (str): Optional personal data at the discretion of the issuing State.\n Non-mandatory field. Empty string by default.\n transliteration (dict): Transliteration dictionary for non-ascii chars. Latin based by default\n force (bool): Disables checks for country, nationality and document_type fields.\n Allows to use 3-letter-codes not included in the countries dictionary\n and to use document_type codes without restrictions.\n\n\nPassport generator example (ICAO9303 Specimen):\n'''''''''''''''''''''''''''''''''''''''''''''''\n\n.. figure:: https://raw.githubusercontent.com/Arg0s1080/mrz/master/docs/images/passports/ICAO_Example.png\n :alt: image\n\n image\n\nTD3CodeGenerator -> str:\n''''''''''''''''''''''''\n\n.. code:: python\n\n from mrz.generator.td3 import TD3CodeGenerator\n\n code = TD3CodeGenerator(\"P\", \"UTO\", \"Eriksson\", \"Anna Mar\u00eda\", \"L898902C3\", \"UTO\", \"740812\", \"F\", \"120415\",\"ZE184226B\")\n\n print(code)\n\nOutput:\n'''''''\n\n::\n\n P`__\n\n\nUsage Checker:\n--------------\n\nTD1's (id cards):\n^^^^^^^^^^^^^^^^^\n\n::\n\n Params:\n\n mrz_string (str): MRZ string of TD1. Must be 90 uppercase characters long (3 lines)\n check_expiry (bool): If it's set to True, it is verified and reported as warning that the\n document is not expired and that expiry_date is not greater than 10 years\n compute_warnings (bool): If it's set True, warnings compute as False\n\nTD2:\n^^^^\n\n::\n\n Params:\n\n mrz_string (str): MRZ string of TD2. Must be 72 characters long (uppercase) (2 lines)\n check_expiry (bool): If it's set to True, it is verified and reported as warning that the\n document is not expired and that expiry_date is not greater than 10 years\n compute_warnings (bool): If it's set True, warnings compute as False\n\n\nTD3 (Passports):\n^^^^^^^^^^^^^^^^\n\n::\n\n Params:\n\n mrz_string (str): MRZ string of TD3. Must be 88 characters long (uppercase) (2 lines)\n check_expiry (bool): If it's set to True, it is verified and reported as warning that the\n document is not expired and that expiry_date is not greater than 10 years\n compute_warnings (bool): If it's set True, warnings compute as False\n\n\nMRVA:\n^^^^^\n\n::\n\n Params:\n\n mrz_string (str): MRZ string of Visas type A. Must be 88 characters long (uppercase) (2 lines)\n check_expiry (bool): If it's set to True, it is verified and reported as warning that the\n document is not expired and that expiry_date is not greater than 10 years\n compute_warnings (bool): If it's set True, warnings compute as False\n\n\nMRVB:\n^^^^^\n\n::\n\n Params:\n\n mrz_string (str): MRZ string of Visas type B. Must be 72 characters long (uppercase) (2 lines)\n check_expiry (bool): If it's set to True, it is verified and reported as warning that the\n document is not expired and that expiry_date is not greater than 10 years\n compute_warnings (bool): If it's set True, warnings compute as False\n\n\nId Card Checker example\n'''''''''''''''''''''''\n\n.. figure:: https://raw.githubusercontent.com/Arg0s1080/mrz/master/docs/images/id_cards/Sweden.png\n :alt: image\n\n image\n\nTD1CodeChecker -> bool\n''''''''''''''''''''''\n\n.. code:: python\n\n from mrz.checker.td1 import TD1CodeChecker\n\n result = bool(TD1CodeChecker(\"I`__\n\n\nFields extraction example (valid for td1, td2, td3 and visas)\n'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''\n\n.. code:: python\n\n from mrz.checker.td1 import TD1CodeChecker, get_country\n\n td1_check = TD1CodeChecker(\"IDLIEID98754015<<<<<<<<<<<<<<<\\n\"\n \"8205122M1906224LIE<<<<<<<<<<<6\\n\"\n \"OSPELT`__ and `this issue `__\n\n\nInstallation:\n-------------\n\nBy pip (It may not be the latest version):\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n::\n\n sudo -H pip install mrz\n\nCloning this repo (It may not work fine):\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n::\n\n git clone https://github.com/Arg0s1080/mrz.git\n cd mrz\n sudo python3 setup.py install\n\nFeatures:\n---------\n\n- [x] Transliteration of special Latin characters (acutes, tildes,\n diaeresis, graves, circumflex, etc)\n- [x] Arabic chars transliteration\n- [x] Several variations of Cyrillic added: Serbian, Macedonian,\n Belarusian, Ukrainian and Bulgarian\n- [x] Transliteration of modern Greek (experimental)\n- [x] Transliteration of modern Hebrew (without vowels) (experimental)\n- [x] Generation of the country code from its name in English (Ex.:\n \"Netherlands\" -> \"NLD\")\n- [x] Name truncation detection\n- [x] Error report, warnings report and full report in Checker.\n- [x] Possibility that warnings compute as errors using\n compute\\_warnings keyword in Checker.\n- [x] Possibility of disabling checks for country code, nationality and\n type of document, allowing to use 3-letter-codes not included in the\n countries dictionary and to use document\\_type codes without\n restrictions in Generator.\n- [x] Added new checks for periods of time in Checker.\n- [x] Visas support\n- [x] Fields extraction in checker (name, surname, country, sex, etc)\n (version 0.5.0)\n\nTODO:\n\n\n- [ ] Automatic name truncation in Generator\n- [ ] Possibility of disabling checks for country code, nationality,\n type of document and the others fields in Checker.\n- [ ] Add logging\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/Arg0s1080/mrz", "keywords": "mrz passports visas id cards td1 td2 td3 mrva mrvb icao", "license": "GPLv3", "maintainer": "", "maintainer_email": "", "name": "mrz", "package_url": "https://pypi.org/project/mrz/", "platform": "", "project_url": "https://pypi.org/project/mrz/", "project_urls": { "Homepage": "https://github.com/Arg0s1080/mrz" }, "release_url": "https://pypi.org/project/mrz/0.5.5/", "requires_dist": null, "requires_python": "", "summary": "Machine readable zone generator and checker for passports, visas, id cards and other travel documents", "version": "0.5.5" }, "last_serial": 5151349, "releases": { "0.2.2": [ { "comment_text": "", "digests": { "md5": "50ab0142d105a0b8e26b045e8cd66c33", "sha256": "d688c7939b3432c068f1d98ae6c8b8e4425ad87378eb2ca44175e1373a688eaa" }, "downloads": -1, "filename": "mrz-0.2.2-py3-none-any.whl", "has_sig": false, "md5_digest": "50ab0142d105a0b8e26b045e8cd66c33", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 48585, "upload_time": "2018-03-28T17:54:35", "url": "https://files.pythonhosted.org/packages/b8/3d/57e516a307fedb9f822cf95e5b6f7596448954bfee89bd4602e3892f5c02/mrz-0.2.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "44004f4c9c54c0fee703760cf4ff5b81", "sha256": "1a9613f33a4b33e830d6a6aa70124d1603f654f654f7565146a110730ef38e64" }, "downloads": -1, "filename": "mrz-0.2.2.tar.gz", "has_sig": false, "md5_digest": "44004f4c9c54c0fee703760cf4ff5b81", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23059, "upload_time": "2018-03-28T17:54:38", "url": "https://files.pythonhosted.org/packages/a1/3e/f5cc03c40ffdaa7d73fc632b3b4087307c13eea73c7fd1e0207cd8f26c95/mrz-0.2.2.tar.gz" } ], "0.3.5": [ { "comment_text": "", "digests": { "md5": "42b72f2a35d0d727f201b96f70ffd051", "sha256": "6a63a656a733accb8b15c8d12aaa15071ad462262875d9e4ceccc11cc3eb0fa3" }, "downloads": -1, "filename": "mrz-0.3.5-py3-none-any.whl", "has_sig": false, "md5_digest": "42b72f2a35d0d727f201b96f70ffd051", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 51885, "upload_time": "2018-08-22T16:10:38", "url": "https://files.pythonhosted.org/packages/eb/85/fa4de30180152aa1ffb02a4f22f4e3c30f8f377538fed6f283cb7e4a2268/mrz-0.3.5-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e518ab569d0b51c3f7342fe3568bd575", "sha256": "d5bedaedeb16c0077661d2c9633f51eed49788e3c63d79e23edd03259a1ddc51" }, "downloads": -1, "filename": "mrz-0.3.5.tar.gz", "has_sig": false, "md5_digest": "e518ab569d0b51c3f7342fe3568bd575", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23955, "upload_time": "2018-08-22T16:10:40", "url": "https://files.pythonhosted.org/packages/99/d8/65123efa80b752536b4228ea8940a383f113f4fc3d9a43adea7e36754de6/mrz-0.3.5.tar.gz" } ], "0.4.0": [ { "comment_text": "", "digests": { "md5": "e4b558ac0c53a679d9f2a1e188ab3f45", "sha256": "7b84045e9370dc4c411f4829fb2fc374e1660209114901c4d2cdb76443977cb6" }, "downloads": -1, "filename": "mrz-0.4.0-py3-none-any.whl", "has_sig": false, "md5_digest": "e4b558ac0c53a679d9f2a1e188ab3f45", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 64368, "upload_time": "2019-03-09T17:02:03", "url": "https://files.pythonhosted.org/packages/fc/04/20e7c7047c91f9b526e422dc75f46588651edfc11ae4d2740b71bf1123b2/mrz-0.4.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "95e8622c8fec104a9e529321fb04e692", "sha256": "396dbb53bd94a6346e422ae1e14e9dd11a3e8d69f4fde17e4cb07bdcb2953dae" }, "downloads": -1, "filename": "mrz-0.4.0.tar.gz", "has_sig": false, "md5_digest": "95e8622c8fec104a9e529321fb04e692", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 24339, "upload_time": "2019-03-09T17:02:06", "url": "https://files.pythonhosted.org/packages/03/81/31c17b3e7a346f4ce81a752b60669e7f890e97cbdfe56d75190a0721452e/mrz-0.4.0.tar.gz" } ], "0.5.5": [ { "comment_text": "", "digests": { "md5": "aed09472eb9445c4d40a0134ce14907b", "sha256": "d055b3f36a31ce28ded2c8c641b8dc66d03a54f06bd05515117265f9b477d813" }, "downloads": -1, "filename": "mrz-0.5.5-py3-none-any.whl", "has_sig": false, "md5_digest": "aed09472eb9445c4d40a0134ce14907b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 66972, "upload_time": "2019-04-16T18:12:45", "url": "https://files.pythonhosted.org/packages/bb/cc/182ef4116d00ab7b671e37a5ccc411940989830f6754ca88cb84b08bbee4/mrz-0.5.5-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2dc9f461e7cae531a7caa806d89ae641", "sha256": "d3226922c7dab260da379a24b1657299c352e66469edcf5d03a935c994b61efd" }, "downloads": -1, "filename": "mrz-0.5.5.tar.gz", "has_sig": false, "md5_digest": "2dc9f461e7cae531a7caa806d89ae641", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 25445, "upload_time": "2019-04-16T18:12:49", "url": "https://files.pythonhosted.org/packages/50/93/32dbe69e3b479519b7766fef51bd63818de0605b156de91e5ebc48d97df5/mrz-0.5.5.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "aed09472eb9445c4d40a0134ce14907b", "sha256": "d055b3f36a31ce28ded2c8c641b8dc66d03a54f06bd05515117265f9b477d813" }, "downloads": -1, "filename": "mrz-0.5.5-py3-none-any.whl", "has_sig": false, "md5_digest": "aed09472eb9445c4d40a0134ce14907b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 66972, "upload_time": "2019-04-16T18:12:45", "url": "https://files.pythonhosted.org/packages/bb/cc/182ef4116d00ab7b671e37a5ccc411940989830f6754ca88cb84b08bbee4/mrz-0.5.5-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2dc9f461e7cae531a7caa806d89ae641", "sha256": "d3226922c7dab260da379a24b1657299c352e66469edcf5d03a935c994b61efd" }, "downloads": -1, "filename": "mrz-0.5.5.tar.gz", "has_sig": false, "md5_digest": "2dc9f461e7cae531a7caa806d89ae641", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 25445, "upload_time": "2019-04-16T18:12:49", "url": "https://files.pythonhosted.org/packages/50/93/32dbe69e3b479519b7766fef51bd63818de0605b156de91e5ebc48d97df5/mrz-0.5.5.tar.gz" } ] }