Metadata-Version: 2.4
Name: weconnect-cupra-daern
Version: 0.50.16
Summary: Python API for the Cupra Born online services
Home-page: https://github.com/daernsinstantfortress/WeConnect-Cupra-python
Author: Till Steinbach / Alan Gibson / Stuart Hall
License: MIT
Project-URL: Funding, https://github.com/sponsors/tillsteinbach
Project-URL: Source, https://github.com/daernsinstantfortress/WeConnect-Cupra-python
Project-URL: Bug Tracker, https://github.com/daernsinstantfortress/WeConnect-Cupra-python/issues
Keywords: weconnect_cupra,weconnect,we connect,carnet,car net,volkswagen,vw,telemetry,cupra
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28.0
Requires-Dist: oauthlib~=3.2.0
Provides-Extra: images
Requires-Dist: pillow~=10.0.0; extra == "images"
Requires-Dist: ascii_magic~=2.1.1; extra == "images"
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary



# WeConnect-Cupra-python
[![GitHub sourcecode](https://img.shields.io/badge/Source-GitHub-green)](https://github.com/daernsinstantfortress/WeConnect-Cupra-python)
[![GitHub release (latest by date)](https://img.shields.io/github/v/release/daernsinstantfortress/WeConnect-Cupra-python)](https://github.com/daernsinstantfortress/WeConnect-Cupra-python/releases/latest)
[![GitHub](https://img.shields.io/github/license/daernsinstantfortress/WeConnect-Cupra-python)](https://github.com/daernsinstantfortress/WeConnect-Cupra-python/blob/master/LICENSE)
[![GitHub issues](https://img.shields.io/github/issues/daernsinstantfortress/WeConnect-Cupra-python)](https://github.com/daernsinstantfortress/WeConnect-Cupra-python/issues)
[![PyPI - Downloads](https://img.shields.io/pypi/dm/weconnect-cupra-daern?label=PyPI%20Downloads)](https://pypi.org/project/weconnect-cupra-daern/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/weconnect-cupra-daern)](https://pypi.org/project/weconnect-cupra-daern/)

Python API for the MyCupra Services. If you are not a developer and ended up here you probably want to check out a project using this library (see below).

## Projects in which the library is used
- [VWsFriend](https://github.com/tillsteinbach/VWsFriend): VWsFriend records statistics about your car (charging sessions, battery, trips, fueling, etc.) and displays them nicely. It also allows you to forward data from the car to other applications such as [A better routeplanner](https://abetterrouteplanner.com/) and allows you to integrate your car into [Apple HomeKit](https://www.apple.com/ios/home/)
- [WeConnect-cli](https://github.com/tillsteinbach/WeConnect-cli): A commandline interface to interact with WeConnect
- [WeConnect-MQTT](https://github.com/tillsteinbach/WeConnect-mqtt): A MQTT Client that provides WeConnect data to the MQTT Broker of your choice (e.g. your home automation solution such as [ioBroker](https://www.iobroker.net), [FHEM](https://fhem.de) or [Home Assistant](https://www.home-assistant.io))

## Install
```
pip3 install weconnect-cupra-daern[Images]
```

## Package
```
python3 -m pip install --upgrade build
python3 -m build --sdist
python3 -m build --wheel
```

## Distribute
```
python3 -m pip install --upgrade twine
python3 -m twine upload --repository pypi dist/*
```

## Getting started
- To get started have a look in the [examples folder](https://github.com/daernsinstantfortress/WeConnect-Cupra-python/tree/main/examples)

## Tested with
- Cupra Born Model year 2022/23

## Login & Consent
WeConnect-python is based on the new WeConnect ID API that was introduced with the new series of ID cars. If you use another car or hybrid you probably need to agree to the terms and conditions of the WeConnect ID interface. Easiest to do so is by installing the WeConnect ID app on your smartphone and login there. If necessary you will be asked to agree to the terms and conditions.

## Reporting Issues
Please feel free to open an issue at [GitHub Issue page](https://github.com/daernsinstantfortress/WeConnect-Cupra-python/issues) to report problems you found.

### Known Issues
- The API is in alpha state and may change unexpectedly at any time! Please conscider this and pin to a specific version if you depend on it.
- Examples and API documentation is missing

## Credits
Largely based on WeConnect-python for VW from https://github.com/tillsteinbach/WeConnect-python, with the initial Cupra port developed by Alan Gibson
Inspired by [TA2k/ioBroker.vw-connect](https://github.com/TA2k/ioBroker.vw-connect/) that gave me a point to start working with the API
