probitas-api 0.1.0__tar.gz

probitas_api-0.1.0/LICENSE

@@ -0,0 +1,72 @@
+# PROBITAS SDK — PROPRIETARY SOFTWARE LICENSE
+
+**Copyright © 2026 PROBITAS. All rights reserved.**
+
+## 1. Ownership
+
+The PROBITAS API, including its source code, documentation, structure, and associated materials, is the intellectual property of its legitimate copyright holder ("Licensor").
+
+Nothing in this License transfers ownership or intellectual property rights to the Licensee.
+
+## 2. Grant of License
+
+Subject to compliance with this License, the Licensor grants the Licensee a limited, non-exclusive, non-transferable, revocable license to install and use the PROBITAS API for authorized educational, research, testing, and institutional purposes.
+
+This license does not grant unrestricted access to the PROBITAS platform or its services.
+
+## 3. Permitted Activities
+
+Unless otherwise restricted by a separate agreement, the Licensee may:
+
+- Install and execute the SDK for authorized purposes.
+- Integrate the SDK into internal applications for authorized institutional use.
+- Modify local copies for internal testing and compatibility.
+- Access publicly available documentation.
+
+## 4. Restrictions
+
+Without prior written authorization from the Licensor, the Licensee shall not:
+
+- Sell, rent, lease, sublicense, or commercially redistribute the API.
+- Distribute or publish copies of the API, whether modified or unmodified.
+- Incorporate the API into commercial products or paid services.
+- Repackage, rebrand, or distribute the API as an independently developed product.
+- Remove, alter, or conceal copyright notices and proprietary attribution.
+- Reverse engineer or attempt to circumvent technical access restrictions, except where applicable law expressly permits such activity.
+- Use the API to develop or distribute unauthorized competing products using PROBITAS proprietary materials.
+
+## 5. Commercial Authorization
+
+Commercial use, commercial integration, redistribution, sublicensing, or other activities outside the permitted scope require prior written authorization from the Licensor.
+
+The Licensor reserves the right to establish separate commercial licensing conditions.
+
+## 6. Platform Access
+
+Possession, installation, or use of the SDK does not automatically authorize access to the PROBITAS platform, API services, or Analytics Module (AM).
+
+Platform access is governed separately by the PROBITAS Terms of Service and applicable authorization policies.
+
+## 7. Termination
+
+This License may be terminated upon material breach of its terms, subject to applicable law and any required notice or cure period.
+
+Upon termination, the Licensee must cease activities no longer authorized under this License and comply with applicable instructions concerning copies of the SDK.
+
+## 8. Disclaimer of Warranty
+
+THE SDK IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW.
+
+The Licensor does not guarantee uninterrupted availability, error-free operation, or suitability for a particular purpose.
+
+## 9. Limitation of Liability
+
+To the maximum extent permitted by applicable law, the Licensor shall not be liable for indirect, incidental, special, consequential, or punitive damages arising from the use or inability to use the SDK and API.
+
+Nothing in this section excludes liability that cannot lawfully be excluded.
+
+## 10. Permissions and Contact
+
+Requests for commercial authorization, redistribution rights, or other permissions outside this License must be submitted to the legitimate copyright holder through its designated contact channel.
+
+**All rights not expressly granted under this License are reserved.**

probitas_api-0.1.0/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: probitas-api
+Version: 0.1.0
+Summary: Official Python SDK for the PROBITAS API
+Author: PROBITAS Development Team
+License-Expression: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27.0
+Dynamic: license-file
+
+# PROBITAS Python SDK
+
+A Python SDK for interacting with the PROBITAS API.
+
+PROBITAS provides an API interface for behavioral analytics and risk assessment workflows.
+
+## Installation
+
+```bash
+pip install probitas
+```
+
+## Quick Start
+
+```python
+from probitas import Probitas
+
+client = Probitas(
+    api_key="YOUR_API_KEY",
+)
+
+# Calculate project risk
+result = client.calculate_risk()
+
+print(result)
+```
+
+## Available Services
+
+The SDK provides access to the following PROBITAS API services:
+
+- Risk calculation
+- Conflict-of-interest screening
+- Construct analysis
+- Reports comparison
+- Reports vector embeddings
+- Vector comparison
+
+
+
+## Authentication
+
+The SDK authenticates requests using your PROBITAS API key.
+
+Keep your API key private. Do not commit credentials to source control or expose them in public repositories.
+
+## Requirements
+
+- Python 3.10 or later
+
+## License
+
+See the LICENSE file for licensing information.

probitas_api-0.1.0/README.md

@@ -0,0 +1,53 @@
+# PROBITAS Python SDK
+
+A Python SDK for interacting with the PROBITAS API.
+
+PROBITAS provides an API interface for behavioral analytics and risk assessment workflows.
+
+## Installation
+
+```bash
+pip install probitas
+```
+
+## Quick Start
+
+```python
+from probitas import Probitas
+
+client = Probitas(
+    api_key="YOUR_API_KEY",
+)
+
+# Calculate project risk
+result = client.calculate_risk()
+
+print(result)
+```
+
+## Available Services
+
+The SDK provides access to the following PROBITAS API services:
+
+- Risk calculation
+- Conflict-of-interest screening
+- Construct analysis
+- Reports comparison
+- Reports vector embeddings
+- Vector comparison
+
+
+
+## Authentication
+
+The SDK authenticates requests using your PROBITAS API key.
+
+Keep your API key private. Do not commit credentials to source control or expose them in public repositories.
+
+## Requirements
+
+- Python 3.10 or later
+
+## License
+
+See the LICENSE file for licensing information.

probitas_api-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "probitas-api"
+version = "0.1.0"
+description = "Official Python SDK for the PROBITAS API"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+
+authors = [
+    { name = "PROBITAS Development Team" }
+]
+
+dependencies = [
+    "httpx>=0.27.0"
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]

probitas_api-0.1.0/setup.cfg

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

probitas_api-0.1.0/src/probitas/__init__.py

@@ -0,0 +1,4 @@
+from probitas.client import Probitas
+from probitas.exceptions import ProbitasAPIError
+
+__all__ = ["Probitas", "ProbitasAPIError"]

probitas_api-0.1.0/src/probitas/client.py

@@ -0,0 +1,68 @@
+import httpx
+from probitas.exceptions import ProbitasAPIError
+from probitas.resources.v1 import (
+    api_keys,
+    reports_vector_embeddings,
+    calculate_risk,
+    construct_analysis,
+    conflict_of_interest,
+    reports_comparison,
+    vector_comparison,
+)
+
+class Probitas:
+    def __init__(
+        self, 
+        api_key: str, 
+        base_url: str = "https://api.probitas.com/v1/api/",
+        timeout: float = 30.0,
+        transport=None,
+    ):
+
+        self.client = httpx.Client(
+            base_url=base_url,
+            headers={
+                "Authorization": f"ApiKey {api_key}",
+                "Accept": "application/json",
+            },
+            timeout=timeout,
+            transport=transport,
+        )
+
+        self.calculate_risk = calculate_risk.CalculateRisk(self)
+        self.conflict_of_interest = conflict_of_interest.ConflictofInterest(self)
+        self.construct_analysis = construct_analysis.ConstructAnalysis(self)
+        self.reports_comparison = reports_comparison.ReportsComparison(self)
+        self.reports_vector_embeddings = reports_vector_embeddings.ReportsVectorEmbeddings(self)
+        self.vector_comparison = vector_comparison.VectorComparison(self)
+    
+
+    def request(self, method: str, endpoint: str, **kwargs):
+        response = self.client.request(method, endpoint, **kwargs)
+
+        if not response.is_success:
+            try:
+                error_data = response.json()
+            except ValueError:
+                error_data = {"message": response.text}
+
+            message = error_data.get("message", error_data.get("detail", "An API error occurred."))
+            raise ProbitasAPIError(
+                message=message,
+                status_code=response.status_code,
+                response=error_data,
+            )
+
+        if response.status_code == 204:
+            return None
+        return response.json()
+
+    def close(self):
+        self.client.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_value, traceback):
+        self.close()
+

probitas_api-0.1.0/src/probitas/exceptions.py

@@ -0,0 +1,6 @@
+class ProbitasAPIError(Exception):
+    def __init__(self, message: str, status_code: int, response):
+
+        super().__init__(message)
+        self.status_code = status_code
+        self.response = response

probitas_api-0.1.0/src/probitas/resources/v1/_uploads.py

@@ -0,0 +1,48 @@
+from contextlib import ExitStack
+from os import PathLike
+from pathlib import Path
+
+
+def prepare_uploads(stack: ExitStack, field: str, uploads):
+    """Build httpx multipart entries from paths, streams, bytes, or file tuples."""
+    entries = []
+    for index, upload in enumerate(uploads):
+
+        if isinstance(upload, (str, PathLike)):
+            path = Path(upload)
+            stream = stack.enter_context(path.open("rb"))
+            value = (path.name, stream)
+
+        elif isinstance(upload, bytes):
+            value = (f"upload-{index + 1}", upload)
+            
+        else:
+            value = upload
+        entries.append((f"{field}[{index}]", value))
+    return entries
+
+
+def prepare_mapping_uploads(stack: ExitStack, field: str, uploads: dict):
+    entries = []
+    for key, upload in uploads.items():
+        if isinstance(upload, (str, PathLike)):
+            path = Path(upload)
+            stream = stack.enter_context(path.open("rb"))
+            value = (path.name, stream)
+        elif isinstance(upload, bytes):
+            value = (str(key), upload)
+        else:
+            value = upload
+        # DRF DictField's HTML form parser expects dot-separated keys
+        # (for example ``reports_files.case-1``), not bracket notation.
+        entries.append((f"{field}.{key}", value))
+    return entries
+
+
+def indexed_form_values(field: str, values):
+    return [(f"{field}[{index}]", value) for index, value in enumerate(values)]
+
+
+def mapped_form_values(field: str, values: dict):
+    # Keep this encoding aligned with DRF's DictField multipart parser.
+    return [(f"{field}.{key}", value) for key, value in values.items()]

probitas_api-0.1.0/src/probitas/resources/v1/calculate_risk.py

@@ -0,0 +1,17 @@
+from datetime import date
+
+
+class CalculateRisk:
+    def __init__(self, client):
+        self.client = client
+
+    def __call__(self, project_name: str, project_start_date: date, project_participants: dict):
+        return self.client.request(
+            "POST",
+            "calculate-risk/",
+            json = {
+                "project_name" : project_name,
+                "project_start_date" : project_start_date.isoformat(),
+                "project_participants": project_participants
+            }
+        )

probitas_api-0.1.0/src/probitas/resources/v1/conflict_of_interest.py

@@ -0,0 +1,29 @@
+
+class ConflictofInterest:
+	def __init__(self, client):
+		self.client = client
+
+	def screen_hr_conflict(self, reporter_ids: list, subject_ids: list, screener_ids: list):
+		return self.client.request(
+			"POST",
+			"conflict-interest-screening/",
+			json={
+				"reporter_ids" : reporter_ids,
+				"subject_ids" : subject_ids,
+				"screener_ids" : screener_ids,
+				"screening_type": "hr",
+			}
+
+		)
+
+	def screen_approving_bodies_conflict(self, subject_ids: list, screener_ids: list):
+		return self.client.request(
+			"POST",
+			"conflict-interest-screening/",
+			json={
+				"subject_ids" : subject_ids,
+				"screener_ids" : screener_ids,
+				"screening_type": "approving_bodies",
+			}
+
+		)

probitas_api-0.1.0/src/probitas/resources/v1/construct_analysis.py

@@ -0,0 +1,33 @@
+from contextlib import ExitStack
+from typing import Optional
+
+from probitas.resources.v1._uploads import (
+    indexed_form_values,
+    mapped_form_values,
+    prepare_uploads,
+)
+
+
+class ConstructAnalysis:
+	def __init__(self, client):
+		self.client = client
+	
+	def __call__(
+		self,
+		report_files: list,
+		hr_staff_ids: list,
+		submitted_validator_ids: list,
+		hr_assessments: dict,
+		report_images: Optional[list] = None,
+		report_image_urls: Optional[list] = None,
+	):
+		with ExitStack() as stack:
+			files = prepare_uploads(stack, "report_files", report_files)
+			files += prepare_uploads(stack, "report_images", report_images or [])
+			data = indexed_form_values("hr_staff_ids", hr_staff_ids)
+			data += indexed_form_values("submitted_validator_ids", submitted_validator_ids)
+			data += mapped_form_values("hr_assessments", hr_assessments)
+			data += indexed_form_values("report_image_urls", report_image_urls or [])
+			return self.client.request(
+				"POST", "construct-analysis/", files=files, data=data
+			)

probitas_api-0.1.0/src/probitas/resources/v1/reports_comparison.py

@@ -0,0 +1,13 @@
+from contextlib import ExitStack
+
+from probitas.resources.v1._uploads import prepare_mapping_uploads
+
+
+class ReportsComparison:
+    def __init__(self, client):
+        self.client = client
+
+    def __call__(self, reports_files: dict):
+        with ExitStack() as stack:
+            files = prepare_mapping_uploads(stack, "reports_files", reports_files)
+            return self.client.request("POST", "report-comparison/", files=files)

probitas_api-0.1.0/src/probitas/resources/v1/reports_vector_embeddings.py

@@ -0,0 +1,12 @@
+class ReportsVectorEmbeddings:
+	def __init__(self, client):
+		self.client = client
+
+	def __call__(self, report_summary: str):
+		return self.client.request(
+			"POST",
+			"reports-vector-embeddings/",
+			json={
+				"report_summary": report_summary
+			}
+		)

probitas_api-0.1.0/src/probitas/resources/v1/vector_comparison.py

@@ -0,0 +1,10 @@
+class VectorComparison:
+    def __init__(self, client):
+        self.client = client
+
+    def __call__(self, reports_vectors: list):
+        return self.client.request(
+            "POST",
+            "vector-comparison/",
+            json={"reports_vector": reports_vectors},
+        )

probitas_api-0.1.0/src/probitas_api.egg-info/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: probitas-api
+Version: 0.1.0
+Summary: Official Python SDK for the PROBITAS API
+Author: PROBITAS Development Team
+License-Expression: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27.0
+Dynamic: license-file
+
+# PROBITAS Python SDK
+
+A Python SDK for interacting with the PROBITAS API.
+
+PROBITAS provides an API interface for behavioral analytics and risk assessment workflows.
+
+## Installation
+
+```bash
+pip install probitas
+```
+
+## Quick Start
+
+```python
+from probitas import Probitas
+
+client = Probitas(
+    api_key="YOUR_API_KEY",
+)
+
+# Calculate project risk
+result = client.calculate_risk()
+
+print(result)
+```
+
+## Available Services
+
+The SDK provides access to the following PROBITAS API services:
+
+- Risk calculation
+- Conflict-of-interest screening
+- Construct analysis
+- Reports comparison
+- Reports vector embeddings
+- Vector comparison
+
+
+
+## Authentication
+
+The SDK authenticates requests using your PROBITAS API key.
+
+Keep your API key private. Do not commit credentials to source control or expose them in public repositories.
+
+## Requirements
+
+- Python 3.10 or later
+
+## License
+
+See the LICENSE file for licensing information.

probitas_api-0.1.0/src/probitas_api.egg-info/SOURCES.txt

@@ -0,0 +1,22 @@
+LICENSE
+README.md
+pyproject.toml
+src/probitas/__init__.py
+src/probitas/client.py
+src/probitas/exceptions.py
+src/probitas/resources/__init__.py
+src/probitas/resources/v1/__init__.py
+src/probitas/resources/v1/_uploads.py
+src/probitas/resources/v1/calculate_risk.py
+src/probitas/resources/v1/conflict_of_interest.py
+src/probitas/resources/v1/construct_analysis.py
+src/probitas/resources/v1/reports_comparison.py
+src/probitas/resources/v1/reports_vector_embeddings.py
+src/probitas/resources/v1/vector_comparison.py
+src/probitas_api.egg-info/PKG-INFO
+src/probitas_api.egg-info/SOURCES.txt
+src/probitas_api.egg-info/dependency_links.txt
+src/probitas_api.egg-info/requires.txt
+src/probitas_api.egg-info/top_level.txt
+src/tests/test_client.py
+src/tests/test_multipart_fields.py

probitas_api-0.1.0/src/probitas_api.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

probitas_api-0.1.0/src/probitas_api.egg-info/requires.txt

@@ -0,0 +1 @@
+httpx>=0.27.0

probitas_api-0.1.0/src/probitas_api.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+probitas
+tests

probitas_api-0.1.0/src/tests/test_client.py

@@ -0,0 +1,63 @@
+import unittest
+
+import httpx
+
+from probitas import Probitas, ProbitasAPIError
+
+
+class ProbitasClientTests(unittest.TestCase):
+    def test_resource_uses_api_route_and_auth_header(self):
+        seen = {}
+
+        def handler(request):
+            seen["path"] = request.url.path
+            seen["authorization"] = request.headers.get("authorization")
+            seen["body"] = request.read().decode()
+            return httpx.Response(200, json={"embedding": [0.1, 0.2]})
+
+        client = Probitas(
+            api_key="sample-key",
+            base_url="https://example.test/v1/api/",
+            transport=httpx.MockTransport(handler),
+        )
+        result = client.reports_vector_embeddings("summary")
+
+        self.assertEqual(result, {"embedding": [0.1, 0.2]})
+        self.assertEqual(seen["path"], "/v1/api/reports-vector-embeddings/")
+        self.assertEqual(seen["authorization"], "ApiKey sample-key")
+        self.assertIn('"report_summary":"summary"', seen["body"])
+        client.close()
+
+    def test_api_error_preserves_status_and_body(self):
+        client = Probitas(
+            api_key="sample-key",
+            base_url="https://example.test/v1/api/",
+            transport=httpx.MockTransport(
+                lambda request: httpx.Response(400, json={"detail": "invalid input"})
+            ),
+        )
+
+        with self.assertRaises(ProbitasAPIError) as raised:
+            client.vector_comparison([[1.0, 0.0]])
+
+        self.assertEqual(raised.exception.status_code, 400)
+        self.assertEqual(raised.exception.response, {"detail": "invalid input"})
+        self.assertEqual(str(raised.exception), "invalid input")
+        client.close()
+
+    def test_context_manager_closes_transport(self):
+        client = Probitas(
+            api_key="sample-key",
+            base_url="https://example.test/v1/api/",
+            transport=httpx.MockTransport(
+                lambda request: httpx.Response(204)
+            ),
+        )
+
+        with client as entered:
+            self.assertIs(entered, client)
+        self.assertTrue(client.client.is_closed)
+
+
+if __name__ == "__main__":
+    unittest.main()

probitas_api-0.1.0/src/tests/test_multipart_fields.py

@@ -0,0 +1,22 @@
+import unittest
+from contextlib import ExitStack
+
+from probitas.resources.v1._uploads import mapped_form_values, prepare_mapping_uploads
+
+
+class MultipartFieldTests(unittest.TestCase):
+    def test_dictionary_values_use_drf_dictfield_notation(self):
+        fields = mapped_form_values("hr_assessments", {"validator-1": "review"})
+        self.assertEqual(fields, [("hr_assessments.validator-1", "review")])
+
+    def test_dictionary_uploads_use_drf_dictfield_notation(self):
+        fields = prepare_mapping_uploads(
+            ExitStack(),
+            "reports_files",
+            {"report-1": b"pdf"},
+        )
+        self.assertEqual(fields, [("reports_files.report-1", ("report-1", b"pdf"))])
+
+
+if __name__ == "__main__":
+    unittest.main()