Pull data directly from the danish vehicle register with dmr.py
Project description
dmr.py
You will no longer need an exspensive API for danish license plate lookups with dmr.py, this tool scrapes the danish vehicle registry directly and returns the data for you to use in your application. Be aware, that because of skat.dk's very slow database lookups, it could take about 3-4 seconds before getting a response.
Table of Contents
Installation
From Pip
python -m pip install dmr.py
From Source
Install current code from this repo, you will need to have git installed in order to do this. The code in the repo might not match the current release, if you experience errors you should switch back the the latest release.
python -m pip install git+https://github.com/j4asper/dmr.py
Examples
The library is very easy to use, these two examples might be the only methods you need to know.
Synchronous Get
Get a Vehicle object synchronously.
from dmr import DMR
# Import models directly if needed:
from dmr.models import *
license_plate = "cw87553"
# Get Vehicle object with data
vehicle: Vehicle = DMR.get_by_plate(license_plate)
print("The vehicle make is:", vehicle.make)
# The vehicle make is: Suzuki
Asynchronous Get
Get a Vehicle object asynchronously.
from dmr import DMR
license_plate = "cw87553"
# Get Vehicle object with data
vehicle = await DMR.get_by_plate_async(license_plate)
print("The vehicle make is:", vehicle.make)
# The vehicle make is: Suzuki
Validating License Plates
This is the easiest way to check if a license plate is in a valid format. This will only check if the format is valid, not if the license plate actually exists. This check is also used when using the get_by_plate() method.
from dmr import DMR
is_valid = DMR.validate_license_plate("cw87553")
# True
is_valid = DMR.validate_license_plate("Very Cool")
# False
is_valid = DMR.validate_license_plate("GGGGGGG")
# True
Models to dict/json
The model classes are Pydantic BaseModels or Enums. These are easily converted into a dict or a json string. I have listed 3 main methods of doing it.
from dmr import DMR
# Get Vehicle object
vehicle = DMR.get_by_plate("cw87553")
# If you want your model as a JSON string, this is the method to use. This is the equivalent of using json.dumps() on a dictionary.
vehicle.model_dump_json()
# Preferred method to use if you want sub models to be made into dicts as well
vehicle.model_dump()
# This is not recommeded, because the underlying Insurance object isn't parsed as a dictionary.
dict(vehicle)
Unit Conversion
The default units used in this library is metric. A Converter class has been implemented, to make it easier to convert units to imperial and the other way around.
from dmr import Converter
range_in_km = 100
range_in_miles = Converter.km_to_miles(range_in_km)
print("Range in miles:", range_in_miles)
# Range in miles: 62.14
Contributing
I would be more than happy if those who know how to make pull requests, contribute with code! Sometimes XPaths may not match with the ones on the danish vehicle registry, if that's the case, then you can either make a pull request with XPath fixes or make an issue saying that the XPaths are wrong, then I will fix it. XPaths are kept in this file.
ToDo
- Add documentation with all possible values.
- Scrape more parts of the DMR site to get even more data.
- Add more broad tests with different types of cars or bikes.
Issue we can't do anything about
If you have used this tool, you might notice that it's very slow. That is probably due to our government using multiple 80-100 GB XML files as the databse for all vehicles in Denmark. It roughly takes about 3 seconds to do a lookup on the DMR site. Caching is highly recommended!
License Plates for testing
This is a collectoin of license plates that you can use for testing.
You can find the list here. Most of the license plates in this file should be valid.
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.