Extracts useful information from Vehicle Identification Number (VIN)
Project description
https://github.com/idlesign/vininfo
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8cb32b5467f699090f4db47750617023c37610d690385777b850c4bf1a615785 |
|
MD5 | 2d1fdd479c9e6b67ab669fdd24803ba5 |
|
BLAKE2b-256 | 1176cdaa47254cb45a2df696ed35ef33d6d35bbf3d553cbeb900c3fe166cce8e |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 251c908bfecbeef1402f89fb0638606c015b398aa47a85ac9fb76e8149631aaf |
|
MD5 | e3bacf045664708434b1b400a7b3e482 |
|
BLAKE2b-256 | 3a383e934cec4ac6bdf038172c2664fa6c8bc975726b7b0a188a8338a20bf245 |