Metadata-Version: 2.1
Name: connectedcars
Version: 0.1.3
Summary: Wrapper for access the Connected Cars API - an AVL/data collection service installed in most new danish vehicles from Audi, Volkswagen, Skoda and SEAT.
Home-page: https://github.com/niklascp/connectedcars-python
Author: Niklas Christoffer Petersen
Author-email: nikalscp@gmail.com
License: MIT
Download-URL: https://github.com/niklascp/connectedcars-python/archive/v0.1.0.tar.gz
Keywords: AVL,Audi,Volkswagen,Skoda,SEAT
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
Requires-Dist: aiohttp
Requires-Dist: attrs
Requires-Dist: python-dateutil

# Python wrapper for the ConnectedCars REST API 

Connected Cars is an AVL/data collection service installed in most new **danish** vehicles from Audi, Volkswagen, Skoda and SEAT. The service has an API that is using *GraphQL*. This is a thin python wrapper for that API which handles authentication and refresh of access tokens. It allows the direct execution of *GraphQL* queries, but also includes some predefined queries that returns pyton objects for convenience.

## Installation

```pip install connectedcars```

## Data available

Depends on the car, but examples includes:

- gps position
- fuel level
- odometer

## Usage
```python
from connectedcars import ConnectedCarsClient

client = ConnectedCarsClient(username = 'XXX', password = 'XXX', namespace = 'XXX')
vehicles = client.vehicles_overview()

for vehicle in vehicles:
  print(vehicle.make, vehicle.model, vehicle.fuelLevel.liter)
```

Could output something like:
```
Volkswagen Golf 38.0
```

## Namespaces
You will need to provide a namespace corresponding to your login. Known namespaces are:

- `semler:minvolkswagen`


