Update python SDK 1.92.0

Author: nitescuc

crowdsec_tracker_api/__init__.py

@@ -42,6 +42,8 @@ class Server(Enum):
     'GetCVEResponse',
     'GetCVESubscribedIntegrationsResponsePage',
     'GetCVEsResponsePage',
+    'GetCVEsSortBy',
+    'GetCVEsSortOrder',
     'History',
     'IPItem',
     'IntegrationResponse',

crowdsec_tracker_api/__pycache__/base_model.cpython-311.pyc

@@ -49,7 +49,7 @@ def __init__(self, base_url: str, auth: httpx.Auth, aws_region="eu-west-1") -> N
         self.aws_region = aws_region
         self.base_url = base_url
         self.auth = auth
-        self.client = httpx.Client()
+        self.client = httpx.Client(headers={"Accept-Encoding": "gzip"})
         self.timeout = 30
 
     def _replace_path_params(self, url: str, path_params: dict):

crowdsec_tracker_api/__pycache__/http_client.cpython-311.pyc

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  <stdin>
-#   timestamp: 2025-12-15T11:06:13+00:00
+#   timestamp: 2025-12-17T10:47:38+00:00
 
 from __future__ import annotations
 
@@ -311,6 +311,18 @@ class GetCVEsResponsePage(BaseModelSdk):
     links: Links
 
 
+class GetCVEsSortBy(StrEnum):
+    RULE_RELEASE_DATE = 'rule_release_date'
+    TRENDING = 'trending'
+    NB_IPS = 'nb_ips'
+    NAME = 'name'
+
+
+class GetCVEsSortOrder(StrEnum):
+    ASC = 'asc'
+    DESC = 'desc'
+
+
 class History(BaseModelSdk):
     first_seen: Annotated[
         datetime, Field(description='First seen timestamp', title='First Seen')
@@ -493,6 +505,13 @@ class CvesGetCvesQueryParameters(BaseModelSdk):
     query: Annotated[
         Optional[str], Field(description='Search query for CVEs', title='Query')
     ] = None
+    sort_by: Annotated[
+        Optional[GetCVEsSortBy], Field(description='Field to sort by', title='Sort By')
+    ] = 'rule_release_date'
+    sort_order: Annotated[
+        Optional[GetCVEsSortOrder],
+        Field(description='Sort order: ascending or descending', title='Sort Order'),
+    ] = 'desc'
     page: Annotated[
         Optional[int], Field(description='Page number', ge=1, title='Page')
     ] = 1
@@ -505,25 +524,29 @@ class CvesGetCvePathParameters(BaseModelSdk):
     cve_id: Annotated[str, Field(title='Cve Id')]
 
 
+class CvesDownloadCveIpsPathParameters(BaseModelSdk):
+    cve_id: Annotated[str, Field(title='Cve Id')]
+
+
 class Since(RootModelSdk[str]):
     root: Annotated[
         str,
         Field(
-            description='Filter IPs seen since this date, format duration (e.g., 7d, 24h)',
+            description='Filter IPs seen since this date, format duration (e.g., 7d, 24h), default to 14d',
             pattern='^\\d+[hd]$',
             title='Since',
         ),
     ]
 
 
-class CvesGetCveIpsQueryParameters(BaseModelSdk):
+class CvesGetCveIpsDetailsQueryParameters(BaseModelSdk):
     since: Annotated[
         Optional[Since],
         Field(
-            description='Filter IPs seen since this date, format duration (e.g., 7d, 24h)',
+            description='Filter IPs seen since this date, format duration (e.g., 7d, 24h), default to 14d',
             title='Since',
         ),
-    ] = None
+    ] = Since('14d')
     page: Annotated[
         Optional[int], Field(description='Page number', ge=1, title='Page')
     ] = 1
@@ -532,7 +555,7 @@ class CvesGetCveIpsQueryParameters(BaseModelSdk):
     ] = 50
 
 
-class CvesGetCveIpsPathParameters(BaseModelSdk):
+class CvesGetCveIpsDetailsPathParameters(BaseModelSdk):
     cve_id: Annotated[str, Field(title='Cve Id')]
 
 

crowdsec_tracker_api/http_client.py

@@ -16,6 +16,8 @@ def __init__(self, auth: Auth, base_url: str = "https://admin.api.crowdsec.net/v
     def get_cves(
         self,
         query: Optional[str] = None,
+        sort_by: Optional[GetCVEsSortBy] = GetCVEsSortBy("rule_release_date"),
+        sort_order: Optional[GetCVEsSortOrder] = GetCVEsSortOrder("desc"),
         page: int = 1,
         size: int = 50,
     )-> GetCVEsResponsePage:
@@ -55,23 +57,43 @@ def get_cve(
 
         return GetCVEResponse(**response.json())
 
-    def get_cve_ips(
+    def download_cve_ips(
         self,
         cve_id: str,
-        since: Optional[str] = None,
+    )-> str:
+        endpoint_url = "/cves/{cve_id}/ips-download"
+        loc = locals()
+        headers = {}
+        params = {}
+        path_params = json.loads(
+            CvesDownloadCveIpsPathParameters(**loc).model_dump_json(
+                exclude_none=True
+            )
+        )
+        
+        response = self.http_client.get(
+            url=endpoint_url, path_params=path_params, params=params, headers=headers
+        )
+        
+        return response.text
+    
+    def get_cve_ips_details(
+        self,
+        cve_id: str,
+        since: Optional[str] = "14d",
         page: int = 1,
         size: int = 50,
     )-> GetCVEIPsResponsePage:
-        endpoint_url = "/cves/{cve_id}/ips"
+        endpoint_url = "/cves/{cve_id}/ips-details"
         loc = locals()
         headers = {}
         params = json.loads(
-            CvesGetCveIpsQueryParameters(**loc).model_dump_json(
+            CvesGetCveIpsDetailsQueryParameters(**loc).model_dump_json(
                 exclude_none=True
             )
         )
         path_params = json.loads(
-            CvesGetCveIpsPathParameters(**loc).model_dump_json(
+            CvesGetCveIpsDetailsPathParameters(**loc).model_dump_json(
                 exclude_none=True
             )
         )

crowdsec_tracker_api/models.py

@@ -5,7 +5,8 @@
 | ------ | ----------- |
 | [get_cves](#get_cves) | Get a paginated list of CVEs that CrowdSec is tracking |
 | [get_cve](#get_cve) | Get information about a specific CVE ID |
-| [get_cve_ips](#get_cve_ips) | Get information about IPs exploiting a specific CVE ID |
+| [download_cve_ips](#download_cve_ips) | Download the list of IPs exploiting a specific CVE ID in raw format |
+| [get_cve_ips_details](#get_cve_ips_details) | Get detailed information about IPs exploiting a specific CVE ID |
 | [get_cve_subscribed_integrations](#get_cve_subscribed_integrations) | Get the list of integrations subscribed to a specific CVE ID |
 | [subscribe_integration_to_cve](#subscribe_integration_to_cve) | Subscribe an integration to receive threats related to a specific CVE ID |
 | [unsubscribe_integration_from_cve](#unsubscribe_integration_from_cve) | Unsubscribe an integration from receiving threats related to a specific CVE ID |
@@ -19,6 +20,8 @@
 | Parameter | Type | Description | Required | Default |
 | --------- | ---- | ----------- | -------- | ------- |
 | query | Optional[str] | Search query for CVEs | False | None |
+| sort_by | Optional[GetCVEsSortBy] | Field to sort by | False | GetCVEsSortBy("rule_release_date") |
+| sort_order | Optional[GetCVEsSortOrder] | Sort order: ascending or descending | False | GetCVEsSortOrder("desc") |
 | page | int | Page number | False | 1 |
 | size | int | Page size | False | 50 |
 ### Returns:
@@ -40,6 +43,8 @@ client = Cves(auth=auth)
 try:
     response = client.get_cves(
         query=None,
+        sort_by=rule_release_date,
+        sort_order=desc,
         page=1,
         size=50,
     )
@@ -85,16 +90,52 @@ except HTTPStatusError as e:
 ```
 
 
-## **get_cve_ips**
-### Get information about IPs exploiting a specific CVE ID 
-- Endpoint: `/cves/{cve_id}/ips`
+## **download_cve_ips**
+### Download the list of IPs exploiting a specific CVE ID in raw format 
+- Endpoint: `/cves/{cve_id}/ips-download`
 - Method: `GET`
 
 ### Parameters:
 | Parameter | Type | Description | Required | Default |
 | --------- | ---- | ----------- | -------- | ------- |
 | cve_id | str |  | True |  |
-| since | Optional[str] | Filter IPs seen since this date, format duration (e.g., 7d, 24h) | False | None |
+### Returns:
+[str](./Models.md#str)
+### Errors:
+| Code | Description |
+| ---- | ----------- |
+| 404 | CVE Not Found |
+| 422 | Validation Error |
+### Usage
+
+```python
+from crowdsec_tracker_api import (
+    Cves,
+    ApiKeyAuth,
+)
+from httpx import HTTPStatusError
+auth = ApiKeyAuth(api_key='your_api_key')
+client = Cves(auth=auth)
+try:
+    response = client.download_cve_ips(
+        cve_id='cve_id',
+    )
+    print(response)
+except HTTPStatusError as e:
+    print(f"An error occurred: {e.response.status_code} - {e.response.text}")
+```
+
+
+## **get_cve_ips_details**
+### Get detailed information about IPs exploiting a specific CVE ID 
+- Endpoint: `/cves/{cve_id}/ips-details`
+- Method: `GET`
+
+### Parameters:
+| Parameter | Type | Description | Required | Default |
+| --------- | ---- | ----------- | -------- | ------- |
+| cve_id | str |  | True |  |
+| since | Optional[str] | Filter IPs seen since this date, format duration (e.g., 7d, 24h), default to 14d | False | "14d" |
 | page | int | Page number | False | 1 |
 | size | int | Page size | False | 50 |
 ### Returns:
@@ -115,9 +156,9 @@ from httpx import HTTPStatusError
 auth = ApiKeyAuth(api_key='your_api_key')
 client = Cves(auth=auth)
 try:
-    response = client.get_cve_ips(
+    response = client.get_cve_ips_details(
         cve_id='cve_id',
-        since=None,
+        since=14d,
         page=1,
         size=50,
     )

crowdsec_tracker_api/services/__pycache__/__init__.cpython-311.pyc

@@ -48,8 +48,8 @@ name, entity_type, output_format
 |----------|------|-------------|---------|
 | name | str | Name of the integration ||
 | description | str | Description of the integration ||
-| entity_type | str | None ||
-| output_format | str | None ||
+| entity_type | IntegrationType | None ||
+| output_format | OutputFormat | None ||
 
 # **IntegrationCreateResponse**
 ## Required: 
@@ -63,8 +63,8 @@ id, name, organization_id, created_at, updated_at, entity_type, output_format, b
 | description | str | Description of the integration ||
 | created_at | str | Time the integration was created ||
 | updated_at | str | Last time the integration was updated ||
-| entity_type | str | None ||
-| output_format | str | None ||
+| entity_type | IntegrationType | None ||
+| output_format | OutputFormat | None ||
 | last_pull | Optional[str] | Last time the integration pulled blocklists ||
 | blocklists | list[BlocklistSubscription] | Blocklists that are subscribed by the integration ||
 | cves | list[CVESubscription] | CVEs that are subscribed by the integration ||
@@ -85,8 +85,8 @@ id, name, organization_id, created_at, updated_at, entity_type, output_format, b
 | description | str | Description of the integration ||
 | created_at | str | Time the integration was created ||
 | updated_at | str | Last time the integration was updated ||
-| entity_type | str | None ||
-| output_format | str | None ||
+| entity_type | IntegrationType | None ||
+| output_format | OutputFormat | None ||
 | last_pull | Optional[str] | Last time the integration pulled blocklists ||
 | blocklists | list[BlocklistSubscription] | Blocklists that are subscribed by the integration ||
 | cves | list[CVESubscription] | CVEs that are subscribed by the integration ||
@@ -117,7 +117,7 @@ FIREWALL_INTEGRATION, REMEDIATION_COMPONENT_INTEGRATION
 |----------|------|-------------|---------|
 | name | str | New name ||
 | description | str | New description ||
-| output_format | str | None ||
+| output_format | OutputFormat | None ||
 | regenerate_credentials | bool | Regenerate credentials for the integration ||
 
 # **IntegrationUpdateResponse**
@@ -132,8 +132,8 @@ id, name, organization_id, created_at, updated_at, entity_type, output_format, b
 | description | str | Description of the integration ||
 | created_at | str | Time the integration was created ||
 | updated_at | str | Last time the integration was updated ||
-| entity_type | str | None ||
-| output_format | str | None ||
+| entity_type | IntegrationType | None ||
+| output_format | OutputFormat | None ||
 | last_pull | Optional[str] | Last time the integration pulled blocklists ||
 | blocklists | list[BlocklistSubscription] | Blocklists that are subscribed by the integration ||
 | cves | list[CVESubscription] | CVEs that are subscribed by the integration ||
@@ -342,6 +342,14 @@ items, total, page, size, pages, links
 | pages | int | None ||
 | links | Links | None ||
 
+# **GetCVEsSortBy**
+## Enum: 
+RULE_RELEASE_DATE, TRENDING, NB_IPS, NAME
+
+# **GetCVEsSortOrder**
+## Enum: 
+ASC, DESC
+
 # **History**
 ## Required: 
 first_seen, last_seen, full_age, days_age
@@ -392,15 +400,15 @@ organization_id, entity_type, name, output_format
 | tags | list[str] | None ||
 | organization_id | str | None ||
 | created_at | str | Time the integration was created ||
-| entity_type | str | None ||
+| entity_type | EntityType | None ||
 | id | str | ID of the integration ||
 | blocklists | list[BlocklistSubscription] | None ||
 | allowlists | list[AllowlistSubscription] | None ||
 | cves | list[CVEsubscription] | None ||
 | name | str | Name of the integration ||
 | updated_at | str | Last time the integration was updated ||
 | description | Optional[str] | Description of the integration ||
-| output_format | str | None ||
+| output_format | OutputFormat | None ||
 | last_pull | Optional[str] | Last time the integration pulled blocklists ||
 
 # **Location**

crowdsec_tracker_api/services/cves.py

@@ -79,6 +79,10 @@ You can find a Quickstart about this SDK, following this [documentation](https:/
 
 [GetCVEsResponsePage](./Models.md#getcvesresponsepage)
 
+[GetCVEsSortBy](./Models.md#getcvessortby)
+
+[GetCVEsSortOrder](./Models.md#getcvessortorder)
+
 [History](./Models.md#history)
 
 [IPItem](./Models.md#ipitem)