python-eveonline 0.2.2__tar.gz → 0.4.0__tar.gz

python_eveonline-0.4.0/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: python-eveonline
+Version: 0.4.0
+Summary: Async Python client for the Eve Online ESI API
+Author: Ronald van der Meer
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ronaldvdmeer/python-eveonline
+Project-URL: Repository, https://github.com/ronaldvdmeer/python-eveonline
+Project-URL: Issues, https://github.com/ronaldvdmeer/python-eveonline/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Games/Entertainment
+Classifier: Typing :: Typed
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.9.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: aioresponses>=0.7; extra == "dev"
+Requires-Dist: mypy>=1.8; extra == "dev"
+Requires-Dist: pylint>=3.0; extra == "dev"
+Requires-Dist: ruff>=0.3; extra == "dev"
+Dynamic: license-file
+
+# python-eveonline
+
+[![PyPI](https://img.shields.io/pypi/v/python-eveonline.svg)](https://pypi.org/project/python-eveonline/)
+[![Python](https://img.shields.io/pypi/pyversions/python-eveonline.svg)](https://pypi.org/project/python-eveonline/)
+[![License](https://img.shields.io/github/license/ronaldvdmeer/python-eveonline.svg)](https://github.com/ronaldvdmeer/python-eveonline/blob/main/LICENSE)
+[![GitHub Release](https://img.shields.io/github/v/release/ronaldvdmeer/python-eveonline.svg)](https://github.com/ronaldvdmeer/python-eveonline/releases)
+
+Async Python client library for the [Eve Online ESI API](https://esi.evetech.net/ui/).
+
+Built for use with [Home Assistant](https://www.home-assistant.io/) but can be used standalone in any async Python project.
+
+## Features
+
+- **Fully async** — built on [aiohttp](https://docs.aiohttp.org/)
+- **Typed models** — all API responses are frozen dataclasses with full type annotations
+- **23 endpoints** — public (server, character, corporation, universe) and authenticated (wallet, skills, location, industry, market, mail, notifications, clones, fatigue, contacts, calendar, loyalty, killmails)
+- **Abstract auth** — implement `AbstractAuth` to plug in any OAuth2 token source
+- **Type-safe** — PEP 561 compatible (`py.typed`), strict mypy configuration
+- **Tested** — ≥98% test coverage
+
+## Installation
+
+```bash
+pip install python-eveonline
+```
+
+## Quick start
+
+```python
+import asyncio
+import aiohttp
+from eveonline import EveOnlineClient
+
+async def main():
+    async with aiohttp.ClientSession() as session:
+        client = EveOnlineClient(session=session)
+        status = await client.async_get_server_status()
+        print(f"{status.players} players online (v{status.server_version})")
+
+asyncio.run(main())
+```
+
+## Documentation
+
+- [**Quickstart**](docs/quickstart.md) — public and authenticated endpoint examples
+- [**Authentication**](docs/authentication.md) — implementing `AbstractAuth`, required OAuth scopes
+- [**Endpoints**](docs/endpoints.md) — full reference with field tables for all 23 methods
+- [**Error Handling**](docs/error-handling.md) — exception hierarchy, rate limiting, ESI cache times
+
+## License
+
+[MIT](LICENSE)

python_eveonline-0.4.0/README.md

@@ -0,0 +1,52 @@
+# python-eveonline
+
+[![PyPI](https://img.shields.io/pypi/v/python-eveonline.svg)](https://pypi.org/project/python-eveonline/)
+[![Python](https://img.shields.io/pypi/pyversions/python-eveonline.svg)](https://pypi.org/project/python-eveonline/)
+[![License](https://img.shields.io/github/license/ronaldvdmeer/python-eveonline.svg)](https://github.com/ronaldvdmeer/python-eveonline/blob/main/LICENSE)
+[![GitHub Release](https://img.shields.io/github/v/release/ronaldvdmeer/python-eveonline.svg)](https://github.com/ronaldvdmeer/python-eveonline/releases)
+
+Async Python client library for the [Eve Online ESI API](https://esi.evetech.net/ui/).
+
+Built for use with [Home Assistant](https://www.home-assistant.io/) but can be used standalone in any async Python project.
+
+## Features
+
+- **Fully async** — built on [aiohttp](https://docs.aiohttp.org/)
+- **Typed models** — all API responses are frozen dataclasses with full type annotations
+- **23 endpoints** — public (server, character, corporation, universe) and authenticated (wallet, skills, location, industry, market, mail, notifications, clones, fatigue, contacts, calendar, loyalty, killmails)
+- **Abstract auth** — implement `AbstractAuth` to plug in any OAuth2 token source
+- **Type-safe** — PEP 561 compatible (`py.typed`), strict mypy configuration
+- **Tested** — ≥98% test coverage
+
+## Installation
+
+```bash
+pip install python-eveonline
+```
+
+## Quick start
+
+```python
+import asyncio
+import aiohttp
+from eveonline import EveOnlineClient
+
+async def main():
+    async with aiohttp.ClientSession() as session:
+        client = EveOnlineClient(session=session)
+        status = await client.async_get_server_status()
+        print(f"{status.players} players online (v{status.server_version})")
+
+asyncio.run(main())
+```
+
+## Documentation
+
+- [**Quickstart**](docs/quickstart.md) — public and authenticated endpoint examples
+- [**Authentication**](docs/authentication.md) — implementing `AbstractAuth`, required OAuth scopes
+- [**Endpoints**](docs/endpoints.md) — full reference with field tables for all 23 methods
+- [**Error Handling**](docs/error-handling.md) — exception hierarchy, rate limiting, ESI cache times
+
+## License
+
+[MIT](LICENSE)

{python_eveonline-0.2.2 → python_eveonline-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-eveonline"
-version = "0.2.2"
+version = "0.4.0"
 description = "Async Python client for the Eve Online ESI API"
 readme = "README.md"
 license = "MIT"
@@ -58,6 +58,10 @@ addopts = [
     "--cov-report=term-missing",
     "--cov-fail-under=90",
     "-v",
+    "-m", "not integration",
+]
+markers = [
+    "integration: live ESI API tests — require network access; authenticated tests also require ESI_TOKEN env var",
 ]
 
 # -- coverage ----------------------------------------------------------------
@@ -160,6 +164,13 @@ ignore = [
 "src/eveonline/const.py" = [
     "S105",   # SSO_TOKEN_URL is a URL, not a password
 ]
+"scripts/**/*.py" = [
+    "D",      # No docstring requirements in scripts
+    "T20",    # Allow print in scripts (CLI output)
+    "ANN",    # No annotation requirements in scripts
+    "S105",   # URL constants that look like passwords
+    "S310",   # URL open is expected in these scripts
+]
 
 [tool.ruff.lint.pydocstyle]
 convention = "google"
@@ -181,3 +192,4 @@ disable = [
 
 [tool.pylint.design]
 max-args = 10
+max-public-methods = 30

{python_eveonline-0.2.2 → python_eveonline-0.4.0}/src/eveonline/__init__.py

@@ -13,6 +13,7 @@ from .exceptions import (
     EveOnlineNotFoundError,
     EveOnlineRateLimitError,
 )
+from .models import CharacterKillmail
 
 try:
     __version__ = version("python-eveonline")
@@ -21,6 +22,7 @@ except PackageNotFoundError:
 
 __all__ = [
     "AbstractAuth",
+    "CharacterKillmail",
     "EveOnlineAuthenticationError",
     "EveOnlineClient",
     "EveOnlineConnectionError",