python-eveonline 0.1.0__tar.gz → 0.2.1__tar.gz

{python_eveonline-0.1.0 → python_eveonline-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-eveonline
-Version: 0.1.0
+Version: 0.2.1
 Summary: Async Python client for the Eve Online ESI API
 Author: Ronald van der Meer
 License-Expression: MIT

{python_eveonline-0.1.0 → python_eveonline-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-eveonline"
-version = "0.1.0"
+version = "0.2.1"
 description = "Async Python client for the Eve Online ESI API"
 readme = "README.md"
 license = "MIT"

{python_eveonline-0.1.0 → python_eveonline-0.2.1}/src/eveonline/__init__.py

@@ -9,7 +9,7 @@ from .exceptions import (
     EveOnlineRateLimitError,
 )
 
-__version__ = "0.1.0"
+__version__ = "0.2.1"
 
 __all__ = [
     "AbstractAuth",

{python_eveonline-0.1.0 → python_eveonline-0.2.1}/src/eveonline/client.py

@@ -22,7 +22,12 @@ from .models import (
     CharacterPortrait,
     CharacterPublicInfo,
     CharacterShip,
+    CharacterSkillsSummary,
     CorporationPublicInfo,
+    IndustryJob,
+    JumpFatigue,
+    MailLabelsSummary,
+    MarketOrder,
     ServerStatus,
     SkillQueueEntry,
     UniverseName,
@@ -362,3 +367,119 @@ class EveOnlineClient:
             )
             for entry in data
         ]
+
+    async def async_get_skills(self, character_id: int) -> CharacterSkillsSummary:
+        """Get a character's total and unallocated skill points.
+
+        Requires scope: ``esi-skills.read_skills.v1``
+
+        Args:
+            character_id: The Eve Online character ID.
+
+        Returns:
+            CharacterSkillsSummary with total SP and unallocated SP.
+        """
+        data = await self._request("GET", f"characters/{character_id}/skills/", authenticated=True)
+        return CharacterSkillsSummary(
+            total_sp=data["total_sp"],
+            unallocated_sp=data.get("unallocated_sp", 0),
+        )
+
+    async def async_get_mail_labels(self, character_id: int) -> MailLabelsSummary:
+        """Get a character's mail labels with unread counts.
+
+        Requires scope: ``esi-mail.read_mail.v1``
+
+        Args:
+            character_id: The Eve Online character ID.
+
+        Returns:
+            MailLabelsSummary with total unread count.
+        """
+        data = await self._request("GET", f"characters/{character_id}/mail/labels/", authenticated=True)
+        return MailLabelsSummary(
+            total_unread_count=data.get("total_unread_count", 0),
+        )
+
+    async def async_get_industry_jobs(self, character_id: int, *, include_completed: bool = False) -> list[IndustryJob]:
+        """Get a character's industry jobs.
+
+        Requires scope: ``esi-industry.read_character_jobs.v1``
+
+        Args:
+            character_id: The Eve Online character ID.
+            include_completed: Whether to include completed jobs.
+
+        Returns:
+            List of IndustryJob entries.
+        """
+        params: dict[str, str] = {}
+        if include_completed:
+            params["include_completed"] = "true"
+        data = await self._request(
+            "GET", f"characters/{character_id}/industry/jobs/", authenticated=True, params=params
+        )
+        return [
+            IndustryJob(
+                job_id=entry["job_id"],
+                activity_id=entry["activity_id"],
+                status=entry["status"],
+                start_date=datetime.fromisoformat(entry["start_date"].replace("Z", "+00:00")),
+                end_date=datetime.fromisoformat(entry["end_date"].replace("Z", "+00:00")),
+                blueprint_type_id=entry["blueprint_type_id"],
+                output_location_id=entry["output_location_id"],
+                runs=entry["runs"],
+                product_type_id=entry.get("product_type_id"),
+                facility_id=entry.get("facility_id"),
+                cost=entry.get("cost"),
+            )
+            for entry in data
+        ]
+
+    async def async_get_market_orders(self, character_id: int) -> list[MarketOrder]:
+        """Get a character's open market orders.
+
+        Requires scope: ``esi-markets.read_character_orders.v1``
+
+        Args:
+            character_id: The Eve Online character ID.
+
+        Returns:
+            List of MarketOrder entries.
+        """
+        data = await self._request("GET", f"characters/{character_id}/orders/", authenticated=True)
+        return [
+            MarketOrder(
+                order_id=entry["order_id"],
+                type_id=entry["type_id"],
+                is_buy_order=entry.get("is_buy_order", False),
+                price=entry["price"],
+                volume_remain=entry["volume_remain"],
+                volume_total=entry["volume_total"],
+                location_id=entry["location_id"],
+                region_id=entry["region_id"],
+                issued=datetime.fromisoformat(entry["issued"].replace("Z", "+00:00")),
+                duration=entry["duration"],
+                range=entry["range"],
+                min_volume=entry.get("min_volume"),
+            )
+            for entry in data
+        ]
+
+    async def async_get_jump_fatigue(self, character_id: int) -> JumpFatigue:
+        """Get a character's jump fatigue information.
+
+        Requires scope: ``esi-characters.read_fatigue.v1``
+
+        Args:
+            character_id: The Eve Online character ID.
+
+        Returns:
+            JumpFatigue with expiry date and last jump info.
+        """
+        data = await self._request("GET", f"characters/{character_id}/fatigue/", authenticated=True)
+        return JumpFatigue(
+            jump_fatigue_expire_date=self._parse_datetime(data.get("jump_fatigue_expire_date")),
+            last_jump_date=self._parse_datetime(data.get("last_jump_date")),
+            last_update_date=self._parse_datetime(data.get("last_update_date")),
+        )

{python_eveonline-0.1.0 → python_eveonline-0.2.1}/src/eveonline/const.py

@@ -22,6 +22,10 @@ SCOPE_READ_KILLMAILS: Final = "esi-killmails.read_killmails.v1"
 SCOPE_READ_CLONES: Final = "esi-clones.read_clones.v1"
 SCOPE_READ_IMPLANTS: Final = "esi-clones.read_implants.v1"
 SCOPE_READ_NOTIFICATIONS: Final = "esi-characters.read_notifications.v1"
+SCOPE_READ_FATIGUE: Final = "esi-characters.read_fatigue.v1"
+SCOPE_READ_MAIL: Final = "esi-mail.read_mail.v1"
+SCOPE_READ_INDUSTRY_JOBS: Final = "esi-industry.read_character_jobs.v1"
+SCOPE_READ_MARKET_ORDERS: Final = "esi-markets.read_character_orders.v1"
 
 # Default scopes for a typical Home Assistant integration
 DEFAULT_SCOPES: Final = [
@@ -31,4 +35,8 @@ DEFAULT_SCOPES: Final = [
     SCOPE_READ_WALLET,
     SCOPE_READ_SKILLS,
     SCOPE_READ_SKILLQUEUE,
+    SCOPE_READ_FATIGUE,
+    SCOPE_READ_MAIL,
+    SCOPE_READ_INDUSTRY_JOBS,
+    SCOPE_READ_MARKET_ORDERS,
 ]

{python_eveonline-0.1.0 → python_eveonline-0.2.1}/src/eveonline/models.py

@@ -117,3 +117,62 @@ class UniverseName:
     id: int
     name: str
     category: str
+
+
+@dataclass(frozen=True)
+class CharacterSkillsSummary:
+    """Character skills summary (requires auth)."""
+
+    total_sp: int
+    unallocated_sp: int
+
+
+@dataclass(frozen=True)
+class MailLabelsSummary:
+    """Mail labels with unread count (requires auth)."""
+
+    total_unread_count: int
+
+
+@dataclass(frozen=True)
+class IndustryJob:
+    """An active industry job (requires auth)."""
+
+    job_id: int
+    activity_id: int
+    status: str
+    start_date: datetime
+    end_date: datetime
+    blueprint_type_id: int
+    output_location_id: int
+    runs: int
+    product_type_id: int | None = None
+    facility_id: int | None = None
+    cost: float | None = None
+
+
+@dataclass(frozen=True)
+class MarketOrder:
+    """A character's market order (requires auth)."""
+
+    order_id: int
+    type_id: int
+    is_buy_order: bool
+    price: float
+    volume_remain: int
+    volume_total: int
+    location_id: int
+    region_id: int
+    issued: datetime
+    duration: int
+    range: str
+    min_volume: int | None = None
+
+
+@dataclass(frozen=True)
+class JumpFatigue:
+    """Character jump fatigue information (requires auth)."""
+
+    jump_fatigue_expire_date: datetime | None = None
+    last_jump_date: datetime | None = None
+    last_update_date: datetime | None = None

{python_eveonline-0.1.0 → python_eveonline-0.2.1}/src/python_eveonline.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-eveonline
-Version: 0.1.0
+Version: 0.2.1
 Summary: Async Python client for the Eve Online ESI API
 Author: Ronald van der Meer
 License-Expression: MIT

{python_eveonline-0.1.0 → python_eveonline-0.2.1}/tests/test_client_authenticated.py

@@ -15,6 +15,11 @@ from eveonline.models import (
     CharacterLocation,
     CharacterOnlineStatus,
     CharacterShip,
+    CharacterSkillsSummary,
+    IndustryJob,
+    JumpFatigue,
+    MailLabelsSummary,
+    MarketOrder,
     SkillQueueEntry,
     WalletBalance,
 )
@@ -70,6 +75,46 @@ class TestAuthRequired:
             with pytest.raises(EveOnlineAuthenticationError):
                 await client.async_get_skill_queue(CHARACTER_ID)
 
+    @pytest.mark.asyncio
+    async def test_skills_without_auth_raises(self):
+        """Calling skills endpoint without auth raises error."""
+        async with aiohttp.ClientSession() as session:
+            client = EveOnlineClient(session=session)
+            with pytest.raises(EveOnlineAuthenticationError):
+                await client.async_get_skills(CHARACTER_ID)
+
+    @pytest.mark.asyncio
+    async def test_mail_labels_without_auth_raises(self):
+        """Calling mail labels endpoint without auth raises error."""
+        async with aiohttp.ClientSession() as session:
+            client = EveOnlineClient(session=session)
+            with pytest.raises(EveOnlineAuthenticationError):
+                await client.async_get_mail_labels(CHARACTER_ID)
+
+    @pytest.mark.asyncio
+    async def test_industry_jobs_without_auth_raises(self):
+        """Calling industry jobs endpoint without auth raises error."""
+        async with aiohttp.ClientSession() as session:
+            client = EveOnlineClient(session=session)
+            with pytest.raises(EveOnlineAuthenticationError):
+                await client.async_get_industry_jobs(CHARACTER_ID)
+
+    @pytest.mark.asyncio
+    async def test_market_orders_without_auth_raises(self):
+        """Calling market orders endpoint without auth raises error."""
+        async with aiohttp.ClientSession() as session:
+            client = EveOnlineClient(session=session)
+            with pytest.raises(EveOnlineAuthenticationError):
+                await client.async_get_market_orders(CHARACTER_ID)
+
+    @pytest.mark.asyncio
+    async def test_jump_fatigue_without_auth_raises(self):
+        """Calling jump fatigue endpoint without auth raises error."""
+        async with aiohttp.ClientSession() as session:
+            client = EveOnlineClient(session=session)
+            with pytest.raises(EveOnlineAuthenticationError):
+                await client.async_get_jump_fatigue(CHARACTER_ID)
+
 
 class TestCharacterOnline:
     """Test GET /characters/{character_id}/online/ endpoint."""
@@ -334,3 +379,231 @@ class TestSkillQueue:
         assert queue[0].start_date is None
         assert queue[0].finish_date is None
         assert queue[0].training_start_sp is None
+
+
+class TestSkills:
+    """Test GET /characters/{character_id}/skills/ endpoint."""
+
+    @pytest.mark.asyncio
+    async def test_get_skills_success(self, character_skills_data):
+        """Successful skills summary fetch."""
+        with aioresponses() as mocked:
+            mocked.get(
+                f"{ESI_BASE_URL}/characters/{CHARACTER_ID}/skills/?datasource=tranquility",
+                payload=character_skills_data,
+            )
+            async with aiohttp.ClientSession() as session:
+                auth = MockAuth(session)
+                client = EveOnlineClient(auth=auth)
+                skills = await client.async_get_skills(CHARACTER_ID)
+
+        assert isinstance(skills, CharacterSkillsSummary)
+        assert skills.total_sp == 48500000
+        assert skills.unallocated_sp == 150000
+
+    @pytest.mark.asyncio
+    async def test_get_skills_no_unallocated(self):
+        """Skills when unallocated_sp is missing defaults to 0."""
+        data = {"total_sp": 10000000, "skills": []}
+        with aioresponses() as mocked:
+            mocked.get(
+                f"{ESI_BASE_URL}/characters/{CHARACTER_ID}/skills/?datasource=tranquility",
+                payload=data,
+            )
+            async with aiohttp.ClientSession() as session:
+                auth = MockAuth(session)
+                client = EveOnlineClient(auth=auth)
+                skills = await client.async_get_skills(CHARACTER_ID)
+
+        assert skills.total_sp == 10000000
+        assert skills.unallocated_sp == 0
+
+
+class TestMailLabels:
+    """Test GET /characters/{character_id}/mail/labels/ endpoint."""
+
+    @pytest.mark.asyncio
+    async def test_get_mail_labels_success(self, mail_labels_data):
+        """Successful mail labels fetch."""
+        with aioresponses() as mocked:
+            mocked.get(
+                f"{ESI_BASE_URL}/characters/{CHARACTER_ID}/mail/labels/?datasource=tranquility",
+                payload=mail_labels_data,
+            )
+            async with aiohttp.ClientSession() as session:
+                auth = MockAuth(session)
+                client = EveOnlineClient(auth=auth)
+                labels = await client.async_get_mail_labels(CHARACTER_ID)
+
+        assert isinstance(labels, MailLabelsSummary)
+        assert labels.total_unread_count == 7
+
+    @pytest.mark.asyncio
+    async def test_get_mail_labels_no_unread(self):
+        """Mail labels when no unread mail."""
+        data = {"total_unread_count": 0, "labels": []}
+        with aioresponses() as mocked:
+            mocked.get(
+                f"{ESI_BASE_URL}/characters/{CHARACTER_ID}/mail/labels/?datasource=tranquility",
+                payload=data,
+            )
+            async with aiohttp.ClientSession() as session:
+                auth = MockAuth(session)
+                client = EveOnlineClient(auth=auth)
+                labels = await client.async_get_mail_labels(CHARACTER_ID)
+
+        assert labels.total_unread_count == 0
+
+
+class TestIndustryJobs:
+    """Test GET /characters/{character_id}/industry/jobs/ endpoint."""
+
+    @pytest.mark.asyncio
+    async def test_get_industry_jobs_success(self, industry_jobs_data):
+        """Successful industry jobs fetch."""
+        with aioresponses() as mocked:
+            mocked.get(
+                f"{ESI_BASE_URL}/characters/{CHARACTER_ID}/industry/jobs/?datasource=tranquility",
+                payload=industry_jobs_data,
+            )
+            async with aiohttp.ClientSession() as session:
+                auth = MockAuth(session)
+                client = EveOnlineClient(auth=auth)
+                jobs = await client.async_get_industry_jobs(CHARACTER_ID)
+
+        assert len(jobs) == 2
+        assert all(isinstance(j, IndustryJob) for j in jobs)
+
+        first = jobs[0]
+        assert first.job_id == 12345
+        assert first.activity_id == 1
+        assert first.status == "active"
+        assert first.blueprint_type_id == 1137
+        assert first.runs == 10
+        assert first.cost == 1500.50
+        assert first.start_date == datetime(2026, 3, 25, 10, 0, tzinfo=UTC)
+        assert first.end_date == datetime(2026, 3, 27, 10, 0, tzinfo=UTC)
+
+        second = jobs[1]
+        assert second.product_type_id is None
+        assert second.cost is None
+
+    @pytest.mark.asyncio
+    async def test_get_industry_jobs_include_completed(self):
+        """Industry jobs with include_completed parameter."""
+        with aioresponses() as mocked:
+            mocked.get(
+                f"{ESI_BASE_URL}/characters/{CHARACTER_ID}/industry/jobs/"
+                "?datasource=tranquility&include_completed=true",
+                payload=[],
+            )
+            async with aiohttp.ClientSession() as session:
+                auth = MockAuth(session)
+                client = EveOnlineClient(auth=auth)
+                jobs = await client.async_get_industry_jobs(CHARACTER_ID, include_completed=True)
+
+        assert jobs == []
+
+    @pytest.mark.asyncio
+    async def test_get_industry_jobs_empty(self):
+        """No active industry jobs returns empty list."""
+        with aioresponses() as mocked:
+            mocked.get(
+                f"{ESI_BASE_URL}/characters/{CHARACTER_ID}/industry/jobs/?datasource=tranquility",
+                payload=[],
+            )
+            async with aiohttp.ClientSession() as session:
+                auth = MockAuth(session)
+                client = EveOnlineClient(auth=auth)
+                jobs = await client.async_get_industry_jobs(CHARACTER_ID)
+
+        assert jobs == []
+
+
+class TestMarketOrders:
+    """Test GET /characters/{character_id}/orders/ endpoint."""
+
+    @pytest.mark.asyncio
+    async def test_get_market_orders_success(self, market_orders_data):
+        """Successful market orders fetch."""
+        with aioresponses() as mocked:
+            mocked.get(
+                f"{ESI_BASE_URL}/characters/{CHARACTER_ID}/orders/?datasource=tranquility",
+                payload=market_orders_data,
+            )
+            async with aiohttp.ClientSession() as session:
+                auth = MockAuth(session)
+                client = EveOnlineClient(auth=auth)
+                orders = await client.async_get_market_orders(CHARACTER_ID)
+
+        assert len(orders) == 2
+        assert all(isinstance(o, MarketOrder) for o in orders)
+
+        sell = orders[0]
+        assert sell.order_id == 9876543
+        assert sell.is_buy_order is False
+        assert sell.price == 5.50
+        assert sell.volume_remain == 100000
+        assert sell.volume_total == 500000
+        assert sell.duration == 90
+        assert sell.range == "region"
+        assert sell.issued == datetime(2026, 3, 20, 12, 0, tzinfo=UTC)
+
+        buy = orders[1]
+        assert buy.is_buy_order is True
+        assert buy.price == 10.00
+        assert buy.min_volume is None
+
+    @pytest.mark.asyncio
+    async def test_get_market_orders_empty(self):
+        """No active market orders returns empty list."""
+        with aioresponses() as mocked:
+            mocked.get(
+                f"{ESI_BASE_URL}/characters/{CHARACTER_ID}/orders/?datasource=tranquility",
+                payload=[],
+            )
+            async with aiohttp.ClientSession() as session:
+                auth = MockAuth(session)
+                client = EveOnlineClient(auth=auth)
+                orders = await client.async_get_market_orders(CHARACTER_ID)
+
+        assert orders == []
+
+
+class TestJumpFatigue:
+    """Test GET /characters/{character_id}/fatigue/ endpoint."""
+
+    @pytest.mark.asyncio
+    async def test_get_jump_fatigue_success(self, jump_fatigue_data):
+        """Successful jump fatigue fetch."""
+        with aioresponses() as mocked:
+            mocked.get(
+                f"{ESI_BASE_URL}/characters/{CHARACTER_ID}/fatigue/?datasource=tranquility",
+                payload=jump_fatigue_data,
+            )
+            async with aiohttp.ClientSession() as session:
+                auth = MockAuth(session)
+                client = EveOnlineClient(auth=auth)
+                fatigue = await client.async_get_jump_fatigue(CHARACTER_ID)
+
+        assert isinstance(fatigue, JumpFatigue)
+        assert fatigue.jump_fatigue_expire_date == datetime(2026, 3, 27, 15, 30, tzinfo=UTC)
+        assert fatigue.last_jump_date == datetime(2026, 3, 26, 12, 0, tzinfo=UTC)
+        assert fatigue.last_update_date == datetime(2026, 3, 26, 12, 0, tzinfo=UTC)
+
+    @pytest.mark.asyncio
+    async def test_get_jump_fatigue_no_fatigue(self):
+        """Character with no jump fatigue (all fields empty)."""
+        with aioresponses() as mocked:
+            mocked.get(
+                f"{ESI_BASE_URL}/characters/{CHARACTER_ID}/fatigue/?datasource=tranquility",
+                payload={},
+            )
+            async with aiohttp.ClientSession() as session:
+                auth = MockAuth(session)
+                client = EveOnlineClient(auth=auth)
+                fatigue = await client.async_get_jump_fatigue(CHARACTER_ID)
+
+        assert fatigue.jump_fatigue_expire_date is None
+        assert fatigue.last_jump_date is None
+        assert fatigue.last_update_date is None