Volkswagen Carnet

Release PyPi Version

Downloads a day Downloads a week Downloads a month

Information

Retrieve statistics about your Volkswagen from the Volkswagen Carnet online service

No licence, public domain, no guarantees, feel free to use for anything. Please contribute improvements/bugfixes etc.

Thanks to

For supporting and helping in this project.

Other related repositories

HomeAssistant Component a custom component for Home Assistant
VolkswagenCarnetClient a cli version of this library

Installation

[venv-python3] user@localhost:~
$ pip install volkswagencarnet

Example

#!/usr/bin/env python3
import volkswagencarnet
import pprint
import asyncio
import logging

from aiohttp import ClientSession

logging.basicConfig(level=logging.DEBUG)

VW_USERNAME='test@example.com'
VW_PASSWORD='mysecretpassword'


COMPONENTS = {
    'sensor': 'sensor',
    'binary_sensor': 'binary_sensor',
    'lock': 'lock',
    'device_tracker': 'device_tracker',
    'switch': 'switch',
    'climate': 'climate'
}

RESOURCES = [
    'position',
    'distance',
    'electric_climatisation',
    'combustion_climatisation',
    'window_heater',
    'combustion_engine_heating',
    'charging',
    'adblue_level',
    'battery_level',
    'fuel_level',
    'service_inspection',
    'oil_inspection',
    'last_connected',
    'charging_time_left',
    'electric_range',
    'combustion_range',
    'combined_range',
    'charge_max_ampere',
    'climatisation_target_temperature',
    'external_power',
    'parking_light',
    'climatisation_without_external_power',
    'door_locked',
    'trunk_locked',
    'request_in_progress',
    'windows_closed',
    'sunroof_closed',
    'trip_last_average_speed',
    'trip_last_average_electric_consumption',
    'trip_last_average_fuel_consumption',
    'trip_last_duration',
    'trip_last_length'
]

def is_enabled(attr):
    """Return true if the user has enabled the resource."""
    return attr in RESOURCES

async def main():
    """Main method."""
    async with ClientSession(headers={'Connection': 'keep-alive'}) as session:
        connection = volkswagencarnet.Connection(session, VW_USERNAME, VW_PASSWORD)
        if await connection._login():
            if await connection.update():
                # Print overall state
                pprint.pprint(connection._state)

                # Print vehicles
                for vehicle in connection.vehicles:
                    pprint.pprint(vehicle)

                # get all instruments
                instruments = set()
                for vehicle in connection.vehicles:
                    dashboard = vehicle.dashboard(mutable=True)

                    for instrument in (
                            instrument
                            for instrument in dashboard.instruments
                            if instrument.component in COMPONENTS
                            and is_enabled(instrument.slug_attr)):

                        instruments.add(instrument)

                # Output all supported instruments
                for instrument in instruments:
                    print(f'name: {instrument.full_name}')
                    print(f'str_state: {instrument.str_state}')
                    print(f'state: {instrument.state}')
                    print(f'supported: {instrument.is_supported}')
                    print(f'attr: {instrument.attr}')
                    print(f'attributes: {instrument.attributes}')

if __name__ == "__main__":
    loop = asyncio.get_event_loop()
    # loop.run(main())
    loop.run_until_complete(main())

Metadata

Release files for volkswagencarnet 4.4.23

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for volkswagencarnet 4.4.23
File	Size	Uploaded
volkswagencarnet-4.4.23.tar.gz	21.5 kB	Dec 22, 2020	Details

Built distribution (wheel)

Table of built distributions (wheels) for volkswagencarnet 4.4.23
File	Interpreter	ABI	Platform	Reset
volkswagencarnet-4.4.23-py3-none-any.whl 15.8 kB Dec 22, 2020	Python 3	none	any	Details

Total release size: 37.3 kB

Release files / volkswagencarnet-4.4.23.tar.gz

Download URL	volkswagencarnet-4.4.23.tar.gz
Size	21.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`32b18746219d13eb953e4b2f25e56d5d4ad0e725cdc3d8244cc35d7ad54f9fd2`
BLAKE2b-256 checksum How to use checksums	`bebd256c9084cf0bc4d70987b9d968cd44e89d3bb5eae4c6f7cc6191cdb59558`
Upload date	Dec 22, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.6.1 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.54.1 CPython/3.9.1`

Release files / volkswagencarnet-4.4.23-py3-none-any.whl

Download URL	volkswagencarnet-4.4.23-py3-none-any.whl
Size	15.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`70d89eb6e5823984afe3c34128189e7f86e4a1eefe51e391946325b8506773ba`
BLAKE2b-256 checksum How to use checksums	`f66e63abbd56f7ab7743f63cd9e5ba8a62fef66a24073c76f6ec0801984d2f0d`
Upload date	Dec 22, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.6.1 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.54.1 CPython/3.9.1`