autoskope-client 1.3.1__tar.gz

autoskope_client-1.3.1/LICENSE

@@ -0,0 +1,17 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright 2024 The Autoskope Client Contributors
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

autoskope_client-1.3.1/PKG-INFO

@@ -0,0 +1,24 @@
+Metadata-Version: 2.4
+Name: autoskope_client
+Version: 1.3.1
+Summary: Python client library for the Autoskope API.
+Home-page: https://github.com/mcisk/autoskope_client
+Author: Nico Liebeskind
+Author-email: nico@autoskope.de
+License: Apache-2.0
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

autoskope_client-1.3.1/README.md

@@ -0,0 +1,137 @@
+# Autoskope Client
+
+A Python client library for interacting with the Autoskope vehicle tracking API.
+
+## Features
+
+- Async/await support using aiohttp
+- Session management with cookie isolation
+- Context manager support for automatic cleanup
+- Type hints for better IDE support
+- Comprehensive error handling
+
+## Installation
+
+```bash
+pip install autoskope-client
+```
+
+## Usage
+
+### Basic Usage with Context Manager
+
+```python
+import asyncio
+from autoskope_client import AutoskopeApi
+
+async def main():
+    async with AutoskopeApi(
+        host="https://portal.autoskope.de",
+        username="your_username",
+        password="your_password"
+    ) as api:
+        # Get all vehicles
+        vehicles = await api.get_vehicles()
+
+        for vehicle in vehicles:
+            print(f"Vehicle: {vehicle.name}")
+            if vehicle.position:
+                print(f"  Location: {vehicle.position.latitude}, {vehicle.position.longitude}")
+                print(f"  Speed: {vehicle.position.speed} km/h")
+
+asyncio.run(main())
+```
+
+### Manual Session Management
+
+```python
+import asyncio
+from autoskope_client import AutoskopeApi
+
+async def main():
+    api = AutoskopeApi(
+        host="https://portal.autoskope.de",
+        username="your_username",
+        password="your_password"
+    )
+
+    try:
+        await api.connect()
+        vehicles = await api.get_vehicles()
+
+        for vehicle in vehicles:
+            print(f"Vehicle: {vehicle.name}")
+    finally:
+        await api.close()
+
+asyncio.run(main())
+```
+
+### Using with External Session
+
+```python
+import asyncio
+import aiohttp
+from autoskope_client import AutoskopeApi
+
+async def main():
+    async with aiohttp.ClientSession() as session:
+        api = AutoskopeApi(
+            host="https://portal.autoskope.de",
+            username="your_username",
+            password="your_password",
+            session=session  # Use external session
+        )
+
+        await api.connect()
+        vehicles = await api.get_vehicles()
+
+asyncio.run(main())
+```
+
+## Data Models
+
+### Vehicle
+- `id`: Unique identifier
+- `name`: Vehicle name
+- `model`: Vehicle model
+- `battery_voltage`: Battery voltage in volts
+- `external_voltage`: External power voltage in volts
+- `gps_quality`: GPS quality (HDOP - lower is better)
+- `imei`: Device IMEI
+- `position`: Current position (if available)
+
+### VehiclePosition
+- `latitude`: Latitude coordinate
+- `longitude`: Longitude coordinate
+- `speed`: Speed in km/h
+- `timestamp`: Position timestamp
+- `is_parked`: Whether vehicle is parked
+
+## Error Handling
+
+The library defines two main exception types:
+
+- `InvalidAuth`: Raised when authentication fails
+- `CannotConnect`: Raised when connection to the API fails
+
+```python
+from autoskope_client import AutoskopeApi, InvalidAuth, CannotConnect
+
+try:
+    async with AutoskopeApi(...) as api:
+        vehicles = await api.get_vehicles()
+except InvalidAuth:
+    print("Authentication failed. Check credentials.")
+except CannotConnect:
+    print("Could not connect to Autoskope API.")
+```
+
+## Requirements
+
+- Python 3.8+
+- aiohttp >= 3.8.0
+
+## Author
+
+Nico Liebeskind (nico@autoskope.de)

autoskope_client-1.3.1/autoskope_client.egg-info/PKG-INFO

@@ -0,0 +1,24 @@
+Metadata-Version: 2.4
+Name: autoskope_client
+Version: 1.3.1
+Summary: Python client library for the Autoskope API.
+Home-page: https://github.com/mcisk/autoskope_client
+Author: Nico Liebeskind
+Author-email: nico@autoskope.de
+License: Apache-2.0
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

autoskope_client-1.3.1/autoskope_client.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+autoskope_client.egg-info/PKG-INFO
+autoskope_client.egg-info/SOURCES.txt
+autoskope_client.egg-info/dependency_links.txt
+autoskope_client.egg-info/requires.txt
+autoskope_client.egg-info/top_level.txt

autoskope_client-1.3.1/autoskope_client.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

autoskope_client-1.3.1/autoskope_client.egg-info/requires.txt

@@ -0,0 +1 @@
+aiohttp>=3.8.0

autoskope_client-1.3.1/autoskope_client.egg-info/top_level.txt

@@ -0,0 +1 @@
+

autoskope_client-1.3.1/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"

autoskope_client-1.3.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

autoskope_client-1.3.1/setup.py

@@ -0,0 +1,27 @@
+"""Setup script for the Autoskope client library."""
+
+from setuptools import find_packages, setup
+
+setup(
+    name="autoskope_client",
+    version="1.3.1",
+    description="Python client library for the Autoskope API.",
+    author="Nico Liebeskind",
+    author_email="nico@autoskope.de",
+    url="https://github.com/mcisk/autoskope_client",
+    packages=find_packages(),
+    package_data={
+        "autoskope_client": ["py.typed"],
+    },
+    install_requires=[
+        "aiohttp>=3.8.0",
+    ],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: Apache Software License",
+        "Operating System :: OS Independent",
+        "Typing :: Typed",
+    ],
+    python_requires=">=3.8",
+    license="Apache-2.0",
+)