crowdsec-tracker-api 1.92.0__py3-none-any.whl

crowdsec_tracker_api/services/cves.py

@@ -0,0 +1,179 @@
+import json
+from types import NoneType
+from typing import Optional, Union, Annotated
+
+from ..models import *
+from ..base_model import Page, Service
+from pydantic import BaseModel, Field
+from pydantic.fields import FieldInfo
+from httpx import Auth
+from ..http_client import HttpClient
+
+class Cves(Service):
+    def __init__(self, auth: Auth, base_url: str = "https://admin.api.crowdsec.net/v1") -> None:
+        super().__init__(base_url=base_url, auth=auth)
+    
+    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:
+        endpoint_url = "/cves/"
+        loc = locals()
+        headers = {}
+        params = json.loads(
+            CvesGetCvesQueryParameters(**loc).model_dump_json(
+                exclude_none=True
+            )
+        )
+        path_params = {}
+        
+        response = self.http_client.get(
+            url=endpoint_url, path_params=path_params, params=params, headers=headers
+        )
+        
+        return GetCVEsResponsePage(_client=self, **response.json())
+    
+    def get_cve(
+        self,
+        cve_id: str,
+    )-> GetCVEResponse:
+        endpoint_url = "/cves/{cve_id}"
+        loc = locals()
+        headers = {}
+        params = {}
+        path_params = json.loads(
+            CvesGetCvePathParameters(**loc).model_dump_json(
+                exclude_none=True
+            )
+        )
+        
+        response = self.http_client.get(
+            url=endpoint_url, path_params=path_params, params=params, headers=headers
+        )
+        
+        return GetCVEResponse(**response.json())
+    
+    def download_cve_ips(
+        self,
+        cve_id: str,
+    )-> 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-details"
+        loc = locals()
+        headers = {}
+        params = json.loads(
+            CvesGetCveIpsDetailsQueryParameters(**loc).model_dump_json(
+                exclude_none=True
+            )
+        )
+        path_params = json.loads(
+            CvesGetCveIpsDetailsPathParameters(**loc).model_dump_json(
+                exclude_none=True
+            )
+        )
+        
+        response = self.http_client.get(
+            url=endpoint_url, path_params=path_params, params=params, headers=headers
+        )
+        
+        return GetCVEIPsResponsePage(_client=self, **response.json())
+    
+    def get_cve_subscribed_integrations(
+        self,
+        cve_id: str,
+        page: int = 1,
+        size: int = 50,
+    )-> GetCVESubscribedIntegrationsResponsePage:
+        endpoint_url = "/cves/{cve_id}/integrations"
+        loc = locals()
+        headers = {}
+        params = json.loads(
+            CvesGetCveSubscribedIntegrationsQueryParameters(**loc).model_dump_json(
+                exclude_none=True
+            )
+        )
+        path_params = json.loads(
+            CvesGetCveSubscribedIntegrationsPathParameters(**loc).model_dump_json(
+                exclude_none=True
+            )
+        )
+        
+        response = self.http_client.get(
+            url=endpoint_url, path_params=path_params, params=params, headers=headers
+        )
+        
+        return GetCVESubscribedIntegrationsResponsePage(_client=self, **response.json())
+    
+    def subscribe_integration_to_cve(
+        self,
+        request: SubscribeCVEIntegrationRequest,
+        cve_id: str,
+    ):
+        endpoint_url = "/cves/{cve_id}/integrations"
+        loc = locals()
+        headers = {}
+        params = {}
+        path_params = json.loads(
+            CvesSubscribeIntegrationToCvePathParameters(**loc).model_dump_json(
+                exclude_none=True
+            )
+        )
+        
+        payload = json.loads(
+            request.model_dump_json(
+                exclude_none=True
+            )
+        ) if "request" in loc else None
+        response = self.http_client.post(
+            url=endpoint_url, path_params=path_params, params=params, headers=headers, json=payload
+        )
+        
+        return None
+    
+    def unsubscribe_integration_from_cve(
+        self,
+        cve_id: str,
+        integration_name: str,
+    ):
+        endpoint_url = "/cves/{cve_id}/integrations/{integration_name}"
+        loc = locals()
+        headers = {}
+        params = {}
+        path_params = json.loads(
+            CvesUnsubscribeIntegrationFromCvePathParameters(**loc).model_dump_json(
+                exclude_none=True
+            )
+        )
+        
+        response = self.http_client.delete(
+            url=endpoint_url, path_params=path_params, params=params, headers=headers
+        )
+        
+        return None
+    

crowdsec_tracker_api/services/integrations.py

@@ -0,0 +1,172 @@
+import json
+from types import NoneType
+from typing import Optional, Union, Annotated
+
+from ..models import *
+from ..base_model import Page, Service
+from pydantic import BaseModel, Field
+from pydantic.fields import FieldInfo
+from httpx import Auth
+from ..http_client import HttpClient
+
+class Integrations(Service):
+    def __init__(self, auth: Auth, base_url: str = "https://admin.api.crowdsec.net/v1") -> None:
+        super().__init__(base_url=base_url, auth=auth)
+    
+    def get_integrations(
+        self,
+        tag: Optional[list[str]] = None,
+    )-> IntegrationGetResponsePage:
+        endpoint_url = "/integrations"
+        loc = locals()
+        headers = {}
+        params = json.loads(
+            IntegrationsGetIntegrationsQueryParameters(**loc).model_dump_json(
+                exclude_none=True
+            )
+        )
+        path_params = {}
+        
+        response = self.http_client.get(
+            url=endpoint_url, path_params=path_params, params=params, headers=headers
+        )
+        
+        return IntegrationGetResponsePage(_client=self, **response.json())
+    
+    def create_integration(
+        self,
+        request: IntegrationCreateRequest,
+    )-> IntegrationCreateResponse:
+        endpoint_url = "/integrations"
+        loc = locals()
+        headers = {}
+        params = {}
+        path_params = {}
+        
+        payload = json.loads(
+            request.model_dump_json(
+                exclude_none=True
+            )
+        ) if "request" in loc else None
+        response = self.http_client.post(
+            url=endpoint_url, path_params=path_params, params=params, headers=headers, json=payload
+        )
+        
+        return IntegrationCreateResponse(**response.json())
+    
+    def get_integration(
+        self,
+        integration_id: str,
+    )-> IntegrationGetResponse:
+        endpoint_url = "/integrations/{integration_id}"
+        loc = locals()
+        headers = {}
+        params = {}
+        path_params = json.loads(
+            IntegrationsGetIntegrationPathParameters(**loc).model_dump_json(
+                exclude_none=True
+            )
+        )
+        
+        response = self.http_client.get(
+            url=endpoint_url, path_params=path_params, params=params, headers=headers
+        )
+        
+        return IntegrationGetResponse(**response.json())
+    
+    def delete_integration(
+        self,
+        integration_id: str,
+    ):
+        endpoint_url = "/integrations/{integration_id}"
+        loc = locals()
+        headers = {}
+        params = {}
+        path_params = json.loads(
+            IntegrationsDeleteIntegrationPathParameters(**loc).model_dump_json(
+                exclude_none=True
+            )
+        )
+        
+        response = self.http_client.delete(
+            url=endpoint_url, path_params=path_params, params=params, headers=headers
+        )
+        
+        return None
+    
+    def update_integration(
+        self,
+        request: IntegrationUpdateRequest,
+        integration_id: str,
+    )-> IntegrationUpdateResponse:
+        endpoint_url = "/integrations/{integration_id}"
+        loc = locals()
+        headers = {}
+        params = {}
+        path_params = json.loads(
+            IntegrationsUpdateIntegrationPathParameters(**loc).model_dump_json(
+                exclude_none=True
+            )
+        )
+        
+        response = self.http_client.patch(
+            url=endpoint_url, path_params=path_params, params=params, headers=headers, json=json.loads(
+                request.model_dump_json(
+                    exclude_unset=True
+                )
+            )
+        )
+        
+        return IntegrationUpdateResponse(**response.json())
+    
+    def get_integration_content(
+        self,
+        integration_id: str,
+        page: int = 1,
+        page_size: Optional[int] = None,
+    ):
+        endpoint_url = "/integrations/{integration_id}/content"
+        loc = locals()
+        headers = {}
+        params = json.loads(
+            IntegrationsGetIntegrationContentQueryParameters(**loc).model_dump_json(
+                exclude_none=True
+            )
+        )
+        path_params = json.loads(
+            IntegrationsGetIntegrationContentPathParameters(**loc).model_dump_json(
+                exclude_none=True
+            )
+        )
+        
+        response = self.http_client.get(
+            url=endpoint_url, path_params=path_params, params=params, headers=headers
+        )
+        
+        return None
+    
+    def get_integration_content_stream(
+        self,
+        integration_id: str,
+        startup: bool = False,
+    ):
+        endpoint_url = "/integrations/{integration_id}/v1/decisions/stream"
+        loc = locals()
+        headers = {}
+        params = json.loads(
+            IntegrationsGetIntegrationContentStreamQueryParameters(**loc).model_dump_json(
+                exclude_none=True
+            )
+        )
+        path_params = json.loads(
+            IntegrationsGetIntegrationContentStreamPathParameters(**loc).model_dump_json(
+                exclude_none=True
+            )
+        )
+        
+        response = self.http_client.get(
+            url=endpoint_url, path_params=path_params, params=params, headers=headers
+        )
+        
+        return None
+    

crowdsec_tracker_api-1.92.0.dist-info/METADATA

@@ -0,0 +1,35 @@
+Metadata-Version: 2.4
+Name: crowdsec_tracker_api
+Version: 1.92.0
+Summary: This is the API to manage Crowdsec Live Exploit Tracker service
+Author-email: crowdsec <info@crowdsec.net>
+License: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx==0.27.0
+Requires-Dist: botocore
+Requires-Dist: pydantic[email,timezone]<3.0.0,>=2.5.0
+Dynamic: license-file
+
+# crowdsec_tracker_api
+
+**crowdsec_tracker_api** is a Python SDK for the [CrowdSec Tracker API](https://docs.crowdsec.net/u/tracker_api/intro/).
+This library enables you to manage CrowdSec Live Exploit Tracker resources such as CVEs data, IPs from a specific CVE and manage integrations.
+
+## Installation
+
+```bash
+pip install crowdsec_tracker_api
+```
+
+## Usage
+
+You can follow this [documentation](https://docs.crowdsec.net/u/tracker_api/intro/) to see the basic usage of the SDK.
+
+## Documentation
+You can access the full usage documentation [here](https://github.com/crowdsecurity/crowdsec-tracker-api-sdk-python/tree/main/doc).
+
+## Contributing
+
+This SDK is auto-generated from the API specification. You can open an issue on this repository if you find a bug or if you want to add a feature.

crowdsec_tracker_api-1.92.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+crowdsec_tracker_api/__init__.py,sha256=qVgdTR0nEMf7N9E1vr2W8fushTJNNahUiKRrkKPK5eE,1359
+crowdsec_tracker_api/base_model.py,sha256=UMpRf5Y9N85ldRqsfjfjZJW8LwLugrgJTWpMOulu4cY,1909
+crowdsec_tracker_api/http_client.py,sha256=7Ub19T1aRnbMz5TcLgzFWq3sy08-6PwuyGFVFrivUf0,4627
+crowdsec_tracker_api/models.py,sha256=oQVYZ9V_DsIigbToqOhkmLBCIGyABjoKdR5aLvDquNw,31563
+crowdsec_tracker_api/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+crowdsec_tracker_api/services/cves.py,sha256=LAeOeChFpUQoH6UgGrFchuvMSpREPv28_fubsvTuFQM,5394
+crowdsec_tracker_api/services/integrations.py,sha256=Gu-hMno46E6huEh6maqyvho-epam3mecUuKt4fblhhk,5250
+crowdsec_tracker_api-1.92.0.dist-info/licenses/LICENSE,sha256=fDPfY1qTG2iqaRIHXQOfPol7DIaWatUayHa8SUPk4cE,1064
+crowdsec_tracker_api-1.92.0.dist-info/METADATA,sha256=Pcf69OFxq2SYVssVKQba7uktpXMEyUbnoWiZd_CiucQ,1206
+crowdsec_tracker_api-1.92.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+crowdsec_tracker_api-1.92.0.dist-info/top_level.txt,sha256=PjzuJQNS-E2cYLihw-evV3MrsY9OWAb8QNKEFEg1hhE,21
+crowdsec_tracker_api-1.92.0.dist-info/RECORD,,

crowdsec_tracker_api-1.92.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

crowdsec_tracker_api-1.92.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Crowdsec
+
+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.

crowdsec_tracker_api-1.92.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+crowdsec_tracker_api