python-eveonline 0.1.0__tar.gz

python_eveonline-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ronald van der Meer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

python_eveonline-0.1.0/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: python-eveonline
+Version: 0.1.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
+
+Async Python client library for the [Eve Online ESI API](https://esi.evetech.net/ui/).
+
+## Features
+
+- Fully async (aiohttp)
+- Typed models (frozen dataclasses)
+- Public endpoints: server status, character info, corporation info, portraits, name resolution
+- Authenticated endpoints: online status, location, ship, wallet, skill queue
+- AbstractAuth pattern for Home Assistant OAuth2 integration
+- PEP 561 typed package (py.typed)
+- 100% 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")
+
+asyncio.run(main())
+```
+
+## License
+
+MIT

python_eveonline-0.1.0/README.md

@@ -0,0 +1,39 @@
+# python-eveonline
+
+Async Python client library for the [Eve Online ESI API](https://esi.evetech.net/ui/).
+
+## Features
+
+- Fully async (aiohttp)
+- Typed models (frozen dataclasses)
+- Public endpoints: server status, character info, corporation info, portraits, name resolution
+- Authenticated endpoints: online status, location, ship, wallet, skill queue
+- AbstractAuth pattern for Home Assistant OAuth2 integration
+- PEP 561 typed package (py.typed)
+- 100% 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")
+
+asyncio.run(main())
+```
+
+## License
+
+MIT

python_eveonline-0.1.0/pyproject.toml

@@ -0,0 +1,183 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "python-eveonline"
+version = "0.1.0"
+description = "Async Python client for the Eve Online ESI API"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+authors = [
+    { name = "Ronald van der Meer" },
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Games/Entertainment",
+    "Typing :: Typed",
+    "Framework :: AsyncIO",
+]
+dependencies = [
+    "aiohttp>=3.9.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.23",
+    "pytest-cov>=4.0",
+    "aioresponses>=0.7",
+    "mypy>=1.8",
+    "pylint>=3.0",
+    "ruff>=0.3",
+]
+
+[project.urls]
+Homepage = "https://github.com/ronaldvdmeer/python-eveonline"
+Repository = "https://github.com/ronaldvdmeer/python-eveonline"
+Issues = "https://github.com/ronaldvdmeer/python-eveonline/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+eveonline = ["py.typed"]
+
+# -- pytest ------------------------------------------------------------------
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+addopts = [
+    "--cov=eveonline",
+    "--cov-report=term-missing",
+    "--cov-fail-under=90",
+    "-v",
+]
+
+# -- coverage ----------------------------------------------------------------
+[tool.coverage.run]
+source = ["src/eveonline"]
+branch = true
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "if TYPE_CHECKING:",
+    "@abstractmethod",
+    "raise NotImplementedError",
+]
+show_missing = true
+
+# -- mypy --------------------------------------------------------------------
+[tool.mypy]
+python_version = "3.11"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+strict_equality = true
+show_error_codes = true
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+strict = false
+
+[[tool.mypy.overrides]]
+module = "examples.*"
+ignore_errors = true
+
+[[tool.mypy.overrides]]
+module = "aioresponses.*"
+ignore_missing_imports = true
+
+# -- ruff --------------------------------------------------------------------
+[tool.ruff]
+target-version = "py311"
+line-length = 120
+
+[tool.ruff.lint]
+select = [
+    "E",      # pycodestyle errors
+    "W",      # pycodestyle warnings
+    "F",      # pyflakes
+    "I",      # isort
+    "N",      # pep8-naming
+    "UP",     # pyupgrade
+    "B",      # flake8-bugbear
+    "A",      # flake8-builtins
+    "C4",     # flake8-comprehensions
+    "DTZ",    # flake8-datetimez
+    "T20",    # flake8-print
+    "SIM",    # flake8-simplify
+    "TC",     # flake8-type-checking
+    "RUF",    # ruff-specific rules
+    "D",      # pydocstyle
+    "ANN",    # flake8-annotations
+    "S",      # flake8-bandit (security)
+    "PT",     # flake8-pytest-style
+]
+ignore = [
+    "D100",   # Missing docstring in public module (handled per-file)
+    "D104",   # Missing docstring in public package
+    "D203",   # 1 blank line before class docstring (conflicts with D211)
+    "D213",   # Multi-line docstring summary on second line (conflicts with D212)
+    "ANN401", # Allow Any for JSON responses and kwargs passthrough
+    "S101",   # Use of assert (needed in tests)
+    "TC001",  # Move application import into TYPE_CHECKING block
+    "TC002",  # Move third-party import into TYPE_CHECKING block
+    "TC003",  # Move stdlib import into TYPE_CHECKING block
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = [
+    "D",      # No docstring requirements in tests
+    "ANN",    # No annotation requirements in tests
+    "S101",   # Allow assert in tests
+    "S105",   # Allow hardcoded strings in tests
+    "S106",   # Allow hardcoded passwords in tests
+    "S107",   # Allow hardcoded passwords in test defaults
+    "T20",    # Allow print in tests
+]
+"examples/**/*.py" = [
+    "D",      # No docstring requirements in examples
+    "T20",    # Allow print in examples
+    "ANN",    # No annotation requirements in examples
+]
+"src/eveonline/const.py" = [
+    "S105",   # SSO_TOKEN_URL is a URL, not a password
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+# -- pylint ------------------------------------------------------------------
+[tool.pylint.main]
+py-version = "3.11"
+load-plugins = ["pylint.extensions.code_style"]
+
+[tool.pylint.format]
+max-line-length = 120
+
+[tool.pylint."messages control"]
+disable = [
+    "too-few-public-methods",
+    "too-many-instance-attributes",
+    "duplicate-code",
+]
+
+[tool.pylint.design]
+max-args = 10

python_eveonline-0.1.0/setup.cfg

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

python_eveonline-0.1.0/src/eveonline/__init__.py

@@ -0,0 +1,22 @@
+"""Async Python client for the Eve Online ESI API."""
+
+from .auth import AbstractAuth
+from .client import EveOnlineClient
+from .exceptions import (
+    EveOnlineAuthenticationError,
+    EveOnlineConnectionError,
+    EveOnlineError,
+    EveOnlineRateLimitError,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "AbstractAuth",
+    "EveOnlineAuthenticationError",
+    "EveOnlineClient",
+    "EveOnlineConnectionError",
+    "EveOnlineError",
+    "EveOnlineRateLimitError",
+    "__version__",
+]

python_eveonline-0.1.0/src/eveonline/auth.py

@@ -0,0 +1,68 @@
+"""Abstract authentication for the Eve Online ESI API."""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import Any
+
+from aiohttp import ClientResponse, ClientSession
+
+from .const import ESI_BASE_URL
+
+
+class AbstractAuth(ABC):
+    """Abstract class to make authenticated requests to the ESI API.
+
+    This follows the Home Assistant API library pattern where the library
+    provides an abstract auth class, and the integration (or standalone user)
+    provides a concrete implementation that handles token management.
+
+    Example usage::
+
+        class MyAuth(AbstractAuth):
+            async def async_get_access_token(self) -> str:
+                return self._my_token_manager.get_token()
+
+        auth = MyAuth(session)
+        client = EveOnlineClient(auth=auth)
+    """
+
+    def __init__(
+        self,
+        websession: ClientSession,
+        host: str = ESI_BASE_URL,
+    ) -> None:
+        """Initialize the auth.
+
+        Args:
+            websession: An aiohttp ClientSession for making requests.
+            host: The ESI API base URL. Defaults to the official ESI endpoint.
+        """
+        self.websession = websession
+        self.host = host
+
+    @abstractmethod
+    async def async_get_access_token(self) -> str:
+        """Return a valid access token for the ESI API."""
+
+    async def request(self, method: str, path: str, **kwargs: Any) -> ClientResponse:
+        """Make an authenticated request to the ESI API.
+
+        Args:
+            method: HTTP method (GET, POST, etc.).
+            path: API path (e.g., "characters/12345/wallet/").
+            **kwargs: Additional arguments passed to aiohttp request.
+
+        Returns:
+            The aiohttp ClientResponse.
+        """
+        headers: dict[str, str] = dict(kwargs.pop("headers", {}) or {})
+        access_token = await self.async_get_access_token()
+        headers["authorization"] = f"Bearer {access_token}"
+
+        return await self.websession.request(
+            method,
+            f"{self.host}/{path}",
+            **kwargs,
+            headers=headers,
+        )