Skip to main content

Extracts useful information from Vehicle Identification Number (VIN)

Project description

https://github.com/idlesign/vininfo

release lic ci coverage

Description

Extracts useful information from Vehicle Identification Number (VIN)

  • Can be used as a standalone console application (CLI).

  • One can also use import it as any other package in your Python code.

  • Gives basic and detailed info (is available) about VIN.

  • Allows VIN checksum verification.

Additional info available for many vehicles from:

  • AvtoVAZ

  • Nissan

  • Opel

  • Renault

Requirements

  • Python 3.6+

  • click package for CLI

Usage

CLI

click package is required for CLI. You can install vininfo with click using:

$ pip install vininfo[cli]
$ vininfo --help

; Print out VIN info:
$ vininfo show XTAGFK330JY144213

; Basic:
; Country: USSR/CIS
; Manufacturer: AvtoVAZ
; Region: Europe
; Years: 2018, 1988
;
; Details:
; Body: Station Wagon, 5-Door
; Engine: 21179
; Model: Vesta
; Plant: Izhevsk
; Serial: 144213
; Transmission: Manual Renault

; Verify checksum
$ vininfo check 1M8GDM9AXKP042788
; Checksum is valid

Python

from vininfo import Vin

vin = Vin('VF1LM1B0H36666155')

vin.country  # France
vin.manufacturer  # Renault
vin.region  # Europe
vin.wmi  # VF1
vin.vds  # LM1B0H
vin.vis  # 36666155

annotated = vin.annotate()
details = vin.details

vin.verify_checksum()  # False
Vin('1M8GDM9AXKP042788').verify_checksum()  # True

Development

One can add missing WMI(s) using instructions from dicts/wmi.py: WMI dictionary, that maps WMI strings to manufacturers.

Those manufacturers may be represented by simple strings, or instances of Brand subclasses (see brands.py).

If you know how to decode additional information (model, body, engine, etc.) encoded in VIN, you may also want to create a so-called details extractor for a brand.

Details extractors are VinDetails subclasses in most cases making use of Detail descriptors to represent additional information (see details/nissan.py for example).

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

vininfo-1.5.0.tar.gz (19.7 kB view details)

Uploaded Source

Built Distribution

vininfo-1.5.0-py2.py3-none-any.whl (20.0 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file vininfo-1.5.0.tar.gz.

File metadata

  • Download URL: vininfo-1.5.0.tar.gz
  • Upload date:
  • Size: 19.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: Python-urllib/2.7

File hashes

Hashes for vininfo-1.5.0.tar.gz
Algorithm Hash digest
SHA256 8cb32b5467f699090f4db47750617023c37610d690385777b850c4bf1a615785
MD5 2d1fdd479c9e6b67ab669fdd24803ba5
BLAKE2b-256 1176cdaa47254cb45a2df696ed35ef33d6d35bbf3d553cbeb900c3fe166cce8e

See more details on using hashes here.

File details

Details for the file vininfo-1.5.0-py2.py3-none-any.whl.

File metadata

  • Download URL: vininfo-1.5.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 20.0 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: Python-urllib/2.7

File hashes

Hashes for vininfo-1.5.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 251c908bfecbeef1402f89fb0638606c015b398aa47a85ac9fb76e8149631aaf
MD5 e3bacf045664708434b1b400a7b3e482
BLAKE2b-256 3a383e934cec4ac6bdf038172c2664fa6c8bc975726b7b0a188a8338a20bf245

See more details on using hashes here.

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