{"id":13815273,"url":"https://github.com/idlesign/vininfo","last_synced_at":"2025-10-08T20:18:08.296Z","repository":{"id":46094161,"uuid":"142445162","full_name":"idlesign/vininfo","owner":"idlesign","description":"Extracts useful information from Vehicle Identification Number (VIN)","archived":false,"fork":false,"pushed_at":"2024-01-31T01:01:17.000Z","size":140,"stargazers_count":119,"open_issues_count":2,"forks_count":40,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-04-04T04:12:33.843Z","etag":null,"topics":["car","cli","python","python3","vin"],"latest_commit_sha":null,"homepage":"https://github.com/idlesign/vininfo","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/idlesign.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG","contributing":"CONTRIBUTING","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-07-26T13:31:28.000Z","updated_at":"2025-02-16T21:35:57.000Z","dependencies_parsed_at":"2024-01-13T22:23:08.952Z","dependency_job_id":"a9de1d05-53a3-4717-8fa8-2496dd70c98c","html_url":"https://github.com/idlesign/vininfo","commit_stats":{"total_commits":87,"total_committers":7,"mean_commits":"12.428571428571429","dds":"0.14942528735632188","last_synced_commit":"d54afe659d3ee301a9b4e470a1d8d40884437d93"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/idlesign%2Fvininfo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/idlesign%2Fvininfo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/idlesign%2Fvininfo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/idlesign%2Fvininfo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/idlesign","download_url":"https://codeload.github.com/idlesign/vininfo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248655366,"owners_count":21140476,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["car","cli","python","python3","vin"],"created_at":"2024-08-04T04:03:14.424Z","updated_at":"2025-10-08T20:18:03.103Z","avatar_url":"https://github.com/idlesign.png","language":"Python","funding_links":[],"categories":["Utilities","Python"],"sub_categories":["Packages"],"readme":"vininfo\n=======\nhttps://github.com/idlesign/vininfo\n\n\n|release| |lic| |coverage|\n\n.. |release| image:: https://img.shields.io/pypi/v/vininfo.svg\n    :target: https://pypi.python.org/pypi/vininfo\n\n.. |lic| image:: https://img.shields.io/pypi/l/vininfo.svg\n    :target: https://pypi.python.org/pypi/vininfo\n\n.. |coverage| image:: https://img.shields.io/coveralls/idlesign/vininfo/master.svg\n    :target: https://coveralls.io/r/idlesign/vininfo\n\n\nDescription\n-----------\n\n*Extracts useful information from Vehicle Identification Number (VIN)*\n\n* Can be used as a standalone console application (CLI).\n* One can also use import it as any other package in your Python code.\n* Gives basic and detailed info (is available) about VIN.\n* Allows VIN checksum verification.\n\nAdditional info available for many vehicles from:\n\n* AvtoVAZ\n* Nissan\n* Opel\n* Renault\n\n\nRequirements\n------------\n\n* Python 3.6+\n* ``click`` package for CLI\n\n\nUsage\n-----\n\nCLI\n~~~\n\n``click`` package is required for CLI. You can install ``vininfo`` with ``click`` using::\n\n    $ pip install vininfo[cli]\n\n\n.. code-block:: bash\n\n    $ vininfo --help\n\n    ; Print out VIN info:\n    $ vininfo show XTAGFK330JY144213\n\n    ; Basic:\n    ; Country: USSR/CIS\n    ; Manufacturer: AvtoVAZ\n    ; Region: Europe\n    ; Years: 2018, 1988\n    ;\n    ; Details:\n    ; Body: Station Wagon, 5-Door\n    ; Engine: 21179\n    ; Model: Vesta\n    ; Plant: Izhevsk\n    ; Serial: 144213\n    ; Transmission: Manual Renault\n\n    ; Verify checksum\n    $ vininfo check 1M8GDM9AXKP042788\n    ; Checksum is valid\n\n\nPython\n~~~~~~\n\n.. code-block:: python\n\n    from vininfo import Vin\n\n    vin = Vin('VF1LM1B0H36666155')\n\n    vin.country  # France\n    vin.manufacturer  # Renault\n    vin.region  # Europe\n    vin.wmi  # VF1\n    vin.vds  # LM1B0H\n    vin.vis  # 36666155\n\n    annotated = vin.annotate()\n    details = vin.details\n\n    vin.verify_checksum()  # False\n    Vin('1M8GDM9AXKP042788').verify_checksum()  # True\n\n\nDevelopment\n-----------\n\nOne can add missing WMI(s) using instructions from ``dicts/wmi.py``:\n``WMI`` dictionary, that maps WMI strings to manufacturers.\n\nThose manufacturers may be represented by simple strings, or instances of ``Brand``\nsubclasses (see ``brands.py``).\n\nIf you know how to decode additional information (model, body, engine, etc.)\nencoded in VIN, you may also want to create a so-called `details extractor`\nfor a brand.\n\nDetails extractors are ``VinDetails`` subclasses in most cases making use of\n``Detail`` descriptors to represent additional information\n(see ``details/nissan.py`` for example).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fidlesign%2Fvininfo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fidlesign%2Fvininfo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fidlesign%2Fvininfo/lists"}