mvr-api-client 2.6.0__py3-none-any.whl

mvr_api/__init__.py

@@ -0,0 +1,58 @@
+"""African Market OS MVR API Client"""
+
+from .client import MVRApiClient, SessionMVRApiClient
+from .models import (
+    MVRApiConfig,
+    MVRScoreResponse,
+    SurveyAggregateRequest,
+    SurveyAggregateResponse,
+    TrendsResponse,
+    ForecastRequest,
+    ForecastResponse,
+    CompareRequest,
+    CompareResponse,
+    BenchmarkResponse,
+    InsightsResponse,
+    TemperatureResponse,
+    PolicyAuditResponse,
+    StoryResponse,
+    MetaResponse,
+    UsageResponse,
+    WhoAmIResponse,
+    DocsResponse,
+    SessionResponse,
+    HealthResponse,
+    MVRError,
+    AttributionObject,
+    VersionInfo,
+)
+
+__version__ = "2.6.0"
+
+__all__ = [
+    "MVRApiClient",
+    "SessionMVRApiClient",
+    "MVRApiConfig",
+    "MVRScoreResponse",
+    "SurveyAggregateRequest",
+    "SurveyAggregateResponse",
+    "TrendsResponse",
+    "ForecastRequest",
+    "ForecastResponse",
+    "CompareRequest",
+    "CompareResponse",
+    "BenchmarkResponse",
+    "InsightsResponse",
+    "TemperatureResponse",
+    "PolicyAuditResponse",
+    "StoryResponse",
+    "MetaResponse",
+    "UsageResponse",
+    "WhoAmIResponse",
+    "DocsResponse",
+    "SessionResponse",
+    "HealthResponse",
+    "MVRError",
+    "AttributionObject",
+    "VersionInfo",
+]

mvr_api/client.py

@@ -0,0 +1,344 @@
+import time
+import requests
+from typing import Optional, Dict, Any
+from .models import (
+    MVRApiConfig, MVRScoreResponse, SurveyAggregateRequest,
+    SurveyAggregateResponse, TrendsResponse, ForecastRequest,
+    ForecastResponse, CompareRequest, CompareResponse,
+    BenchmarkResponse, InsightsResponse, TemperatureResponse,
+    PolicyAuditResponse, StoryResponse, MetaResponse,
+    UsageResponse, WhoAmIResponse, DocsResponse, SessionResponse,
+    HealthResponse, MVRError, AttributionObject
+)
+
+
+class MVRApiError(Exception):
+    """Base exception for MVR API errors."""
+    def __init__(self, error_data: MVRError):
+        self.error_data = error_data
+        super().__init__(f"{error_data.error_code}: {error_data.message}")
+
+
+class MVRApiClient:
+    """Main MVR API client using License + Email authentication."""
+
+    def __init__(self, config: MVRApiConfig):
+        self.config = config
+
+        # Persistent session
+        self.session = requests.Session()
+        self.session.headers.update({
+            "x-mvr-license": config.license,
+            "x-buyer-email": config.email,
+            "Content-Type": "application/json",
+            "User-Agent": "mvr-api-py-client/2.6.0"
+        })
+
+        self.base_url = config.base_url
+        self.max_retries = config.max_retries
+        self.timeout = config.timeout
+
+    # ------------------------------------------------------------
+    # INTERNAL REQUEST WRAPPER
+    # ------------------------------------------------------------
+    def _request(self, method: str, endpoint: str, **kwargs) -> Dict[str, Any]:
+        """Low-level HTTP request with retry + rate limit handling."""
+
+        url = f"{self.base_url}{endpoint}"
+
+        for attempt in range(self.max_retries + 1):
+            try:
+                response = self.session.request(
+                    method,
+                    url,
+                    timeout=self.timeout,
+                    **kwargs
+                )
+
+                data = response.json()
+
+                # -------------------------
+                # Successful Response
+                # -------------------------
+                if response.status_code == 200:
+                    return data
+
+                # -------------------------
+                # Rate Limited (429)
+                # -------------------------
+                if response.status_code == 429:
+                    retry_after = int(response.headers.get("Retry-After", 60))
+                    if attempt < self.max_retries:
+                        time.sleep(retry_after)
+                        continue
+                    raise MVRApiError(MVRError(**data))
+
+                # -------------------------
+                # Other API Errors
+                # -------------------------
+                raise MVRApiError(MVRError(**data))
+
+            except requests.exceptions.RequestException as e:
+                # Network errors (timeouts, connection drops)
+                if attempt == self.max_retries:
+                    raise MVRApiError(MVRError(
+                        ok=False,
+                        error="NETWORK_ERROR",
+                        error_code="NETWORK_ERROR",
+                        message=str(e),
+                        attribution=AttributionObject(
+                            framework="Minimum Viable Relationships (MVR)",
+                            creator="Farouk Mark Mukiibi",
+                            source="African Market OS",
+                            license="CC BY 4.0 | Commercial Use Licensed",
+                            doi="10.5281/zenodo.17310446"
+                        )
+                    ))
+                time.sleep(2 ** attempt)  # exponential retry
+
+    # ------------------------------------------------------------
+    # SCORES + SURVEY
+    # ------------------------------------------------------------
+    def get_scores(self, sector: Optional[str] = None) -> MVRScoreResponse:
+        """GET /v1/scores"""
+        params: Dict[str, Any] = {}
+        if sector:
+            params["sector"] = sector
+
+        data = self._request("GET", "/v1/scores", params=params)
+        return MVRScoreResponse(**data)
+
+    def survey_aggregate(self, request: SurveyAggregateRequest) -> SurveyAggregateResponse:
+        """POST /v1/survey-aggregate"""
+        data = self._request("POST", "/v1/survey-aggregate", json=request.dict())
+        return SurveyAggregateResponse(**data)
+
+    # ------------------------------------------------------------
+    # INTELLIGENCE: TRENDS, FORECAST, COMPARE
+    # ------------------------------------------------------------
+    def get_trends(
+        self,
+        sector: Optional[str] = None,
+        days: Optional[int] = None
+    ) -> TrendsResponse:
+        """GET /v1/trends"""
+        params: Dict[str, Any] = {}
+        if sector:
+            params["sector"] = sector
+        if days is not None:
+            params["days"] = days
+
+        data = self._request("GET", "/v1/trends", params=params)
+        return TrendsResponse(**data)
+
+    def forecast(self, request: ForecastRequest) -> ForecastResponse:
+        """POST /v1/forecast"""
+        data = self._request("POST", "/v1/forecast", json=request.dict())
+        return ForecastResponse(**data)
+
+    def compare(self, request: CompareRequest) -> CompareResponse:
+        """POST /v1/compare"""
+        data = self._request("POST", "/v1/compare", json=request.dict())
+        return CompareResponse(**data)
+
+    # ------------------------------------------------------------
+    # INTELLIGENCE: BENCHMARK, INSIGHTS, TEMPERATURE
+    # ------------------------------------------------------------
+    def get_benchmark(self, sector: Optional[str] = None) -> BenchmarkResponse:
+        """GET /v1/benchmark"""
+        params: Dict[str, Any] = {}
+        if sector:
+            params["sector"] = sector
+
+        data = self._request("GET", "/v1/benchmark", params=params)
+        return BenchmarkResponse(**data)
+
+    def get_insights(self, sector: Optional[str] = None) -> InsightsResponse:
+        """GET /v1/insights"""
+        params: Dict[str, Any] = {}
+        if sector:
+            params["sector"] = sector
+
+        data = self._request("GET", "/v1/insights", params=params)
+        return InsightsResponse(**data)
+
+    def get_temperature(self) -> TemperatureResponse:
+        """GET /v1/temperature"""
+        data = self._request("GET", "/v1/temperature")
+        return TemperatureResponse(**data)
+
+    # ------------------------------------------------------------
+    # INTELLIGENCE: POLICY + STORY
+    # ------------------------------------------------------------
+    def get_policy_multi(self) -> PolicyAuditResponse:
+        """GET /v1/policy_multi"""
+        data = self._request("GET", "/v1/policy_multi")
+        return PolicyAuditResponse(**data)
+
+    def post_policy_multi(self) -> PolicyAuditResponse:
+        """POST /v1/policy_multi"""
+        data = self._request("POST", "/v1/policy_multi")
+        return PolicyAuditResponse(**data)
+
+    def get_story(self) -> StoryResponse:
+        """GET /v1/story"""
+        data = self._request("GET", "/v1/story")
+        return StoryResponse(**data)
+
+    def post_story(self) -> StoryResponse:
+        """POST /v1/story"""
+        data = self._request("POST", "/v1/story")
+        return StoryResponse(**data)
+
+    # ------------------------------------------------------------
+    # UTILITIES
+    # ------------------------------------------------------------
+    def get_meta(self) -> MetaResponse:
+        """GET /v1/meta"""
+        data = self._request("GET", "/v1/meta")
+        return MetaResponse(**data)
+
+    def get_usage(self) -> UsageResponse:
+        """GET /v1/usage"""
+        data = self._request("GET", "/v1/usage")
+        return UsageResponse(**data)
+
+    def whoami(self) -> WhoAmIResponse:
+        """GET /v1/whoami"""
+        data = self._request("GET", "/v1/whoami")
+        return WhoAmIResponse(**data)
+
+    def get_docs(self) -> DocsResponse:
+        """GET /v1/docs"""
+        data = self._request("GET", "/v1/docs")
+        return DocsResponse(**data)
+
+    def create_session(self, license: str, email: str) -> SessionResponse:
+        """POST /v1/session/new"""
+        payload = {"license": license, "email": email}
+        data = self._request("POST", "/v1/session/new", json=payload)
+        return SessionResponse(**data)
+
+    def health(self) -> HealthResponse:
+        """GET /v1/health"""
+        data = self._request("GET", "/v1/health")
+        return HealthResponse(**data)
+
+    # ------------------------------------------------------------
+    # SESSION-BASED CLIENT FACTORY
+    # ------------------------------------------------------------
+    def with_session(self, session_token: str) -> "SessionMVRApiClient":
+        """Return a SessionMVRApiClient using x-mvr-session auth."""
+        return SessionMVRApiClient(
+            base_url=self.base_url,
+            session_token=session_token,
+            timeout=self.timeout
+        )
+
+
+# ============================================================
+# SESSION-BASED CLIENT (x-mvr-session)
+# ============================================================
+class SessionMVRApiClient:
+    """MVR API client using session-token authentication."""
+
+    def __init__(self, base_url: str, session_token: str, timeout: int = 30):
+        self.base_url = base_url
+        self.timeout = timeout
+        self.session_token = session_token
+
+        self.session = requests.Session()
+        self.session.headers.update({
+            "x-mvr-session": session_token,
+            "Content-Type": "application/json",
+            "User-Agent": "mvr-api-py-client/2.6.0"
+        })
+
+    def _request(self, method: str, endpoint: str, **kwargs) -> Dict[str, Any]:
+        """Internal request handler"""
+        url = f"{self.base_url}{endpoint}"
+
+        response = self.session.request(method, url, timeout=self.timeout, **kwargs)
+        data = response.json()
+
+        if response.status_code != 200:
+            raise MVRApiError(MVRError(**data))
+
+        return data
+
+    # --------------------------------------------------------
+    # Session-auth GET/POST endpoints
+    # --------------------------------------------------------
+    def get_scores(self, sector: Optional[str] = None) -> MVRScoreResponse:
+        params = {"sector": sector} if sector else {}
+        data = self._request("GET", "/v1/scores", params=params)
+        return MVRScoreResponse(**data)
+
+    def get_trends(self, sector: Optional[str] = None, days: Optional[int] = None) -> TrendsResponse:
+        params = {}
+        if sector:
+            params["sector"] = sector
+        if days:
+            params["days"] = days
+
+        data = self._request("GET", "/v1/trends", params=params)
+        return TrendsResponse(**data)
+
+    def forecast(self, request: ForecastRequest) -> ForecastResponse:
+        data = self._request("POST", "/v1/forecast", json=request.dict())
+        return ForecastResponse(**data)
+
+    def compare(self, request: CompareRequest) -> CompareResponse:
+        data = self._request("POST", "/v1/compare", json=request.dict())
+        return CompareResponse(**data)
+
+    def get_benchmark(self, sector: Optional[str] = None) -> BenchmarkResponse:
+        params = {"sector": sector} if sector else {}
+        data = self._request("GET", "/v1/benchmark", params=params)
+        return BenchmarkResponse(**data)
+
+    def get_insights(self, sector: Optional[str] = None) -> InsightsResponse:
+        params = {"sector": sector} if sector else {}
+        data = self._request("GET", "/v1/insights", params=params)
+        return InsightsResponse(**data)
+
+    def get_temperature(self) -> TemperatureResponse:
+        data = self._request("GET", "/v1/temperature")
+        return TemperatureResponse(**data)
+
+    def get_policy_multi(self) -> PolicyAuditResponse:
+        data = self._request("GET", "/v1/policy_multi")
+        return PolicyAuditResponse(**data)
+
+    def post_policy_multi(self) -> PolicyAuditResponse:
+        data = self._request("POST", "/v1/policy_multi")
+        return PolicyAuditResponse(**data)
+
+    def get_story(self) -> StoryResponse:
+        data = self._request("GET", "/v1/story")
+        return StoryResponse(**data)
+
+    def post_story(self) -> StoryResponse:
+        data = self._request("POST", "/v1/story")
+        return StoryResponse(**data)
+
+    def get_meta(self) -> MetaResponse:
+        data = self._request("GET", "/v1/meta")
+        return MetaResponse(**data)
+
+    def get_usage(self) -> UsageResponse:
+        data = self._request("GET", "/v1/usage")
+        return UsageResponse(**data)
+
+    def whoami(self) -> WhoAmIResponse:
+        data = self._request("GET", "/v1/whoami")
+        return WhoAmIResponse(**data)
+
+    def get_docs(self) -> DocsResponse:
+        data = self._request("GET", "/v1/docs")
+        return DocsResponse(**data)
+
+    def health(self) -> HealthResponse:
+        data = self._request("GET", "/v1/health")
+        return HealthResponse(**data)
+

mvr_api/models.py

@@ -0,0 +1,251 @@
+from typing import List, Optional, Dict, Any, Union
+from pydantic import BaseModel, Field, validator
+from datetime import datetime
+
+
+class AttributionObject(BaseModel):
+    framework: str = Field(..., example="Minimum Viable Relationships (MVR)")
+    creator: str = Field(..., example="Farouk Mark Mukiibi")
+    source: str = Field(..., example="African Market OS")
+    license: str = Field(..., example="CC BY 4.0 | Commercial Use Licensed")
+    doi: str = Field(..., example="10.5281/zenodo.17310446")
+
+
+class VersionInfo(BaseModel):
+    api: str = Field(..., example="2.6.0")
+    feature: Optional[str] = None
+    method: Optional[str] = None
+    model: Optional[str] = None
+    mvr_proprietary: bool = Field(..., example=True)
+
+
+class MVRError(BaseModel):
+    ok: bool = Field(..., example=False)
+    error: str
+    error_code: str
+    message: str
+    request_id: Optional[str] = None
+    limit: Optional[int] = None
+    window: Optional[str] = None
+    retry_after: Optional[int] = None
+    attribution: AttributionObject
+
+
+class MVRDimension(BaseModel):
+    name: str
+    score: float = Field(..., ge=0, le=1)
+    confidence: float = Field(..., ge=0, le=1)
+    threshold_ok: bool
+    binding: bool
+    evidence_ptrs: List[str] = Field(default_factory=list)
+
+
+class MVRScoreResponse(BaseModel):
+    ok: bool
+    mvr_index: float = Field(..., ge=0, le=1)
+    confidence: float = Field(..., ge=0, le=1)
+    sector: str
+    mvr_dimensions: List[MVRDimension]
+    mvr_threshold: bool
+    recommendations: List[str]
+    version_info: VersionInfo
+    attribution: AttributionObject
+
+
+class StakeholderResponse(BaseModel):
+    dimension: str
+    scale: int = Field(..., ge=1, le=5)
+    reasons: List[str] = Field(default_factory=list)
+
+
+class SurveyAggregateRequest(BaseModel):
+    stakeholder_responses: List[StakeholderResponse]
+    sector: Optional[str] = None
+
+    @validator("sector")
+    def validate_sector(cls, v):
+        valid_sectors = [
+            "fmcg", "fintech", "policy",
+            "health", "agritech", "retail", "default"
+        ]
+        if v and v not in valid_sectors:
+            raise ValueError(
+                f"Sector must be one of: {', '.join(valid_sectors)}"
+            )
+        return v
+
+
+class SurveyAggregateResponse(BaseModel):
+    ok: bool
+    sector: str
+    mvr_index: float = Field(..., ge=0, le=1)
+    matrix_axes: Dict[str, float]
+    insights: List[str]
+    recommendations: List[str]
+    summary: str
+    version_info: VersionInfo
+    attribution: AttributionObject
+
+
+class TrendsResponse(BaseModel):
+    ok: bool
+    sector: str
+    days: int
+    average_index: float
+    slope: float
+    interpretation: str
+    version_info: VersionInfo
+    attribution: AttributionObject
+
+
+class ForecastRequest(BaseModel):
+    current_index: float = Field(..., ge=0, le=1)
+    velocity: float
+    horizon: int = Field(default=30, ge=1)
+
+
+class ForecastResponse(BaseModel):
+    ok: bool
+    current_index: float = Field(..., ge=0, le=1)
+    projected_index: float = Field(..., ge=0, le=1)
+    horizon_days: int
+    confidence: float = Field(..., ge=0, le=1)
+    pmf_projection: str
+    version_info: VersionInfo
+    attribution: AttributionObject
+
+
+class CompareRequest(BaseModel):
+    a_index: float = Field(..., ge=0, le=1)
+    b_index: float = Field(..., ge=0, le=1)
+
+
+class CompareResponse(BaseModel):
+    ok: bool
+    delta: float
+    verdict: str
+    policy_trace: Dict[str, Any]
+    version_info: VersionInfo
+    attribution: AttributionObject
+
+
+class BenchmarkResponse(BaseModel):
+    ok: bool
+    sector: str
+    benchmark: Dict[str, Union[int, float]]
+    version_info: VersionInfo
+    attribution: AttributionObject
+
+
+class InsightEntity(BaseModel):
+    rank: int
+    sector: str
+    mvr_index: float = Field(..., ge=0, le=1)
+    caption: str
+
+
+class InsightsResponse(BaseModel):
+    ok: bool
+    sector: str
+    top_entities: List[InsightEntity]
+    version_info: VersionInfo
+    attribution: AttributionObject
+
+
+class TemperatureResponse(BaseModel):
+    ok: bool
+    date: str
+    continent_score: float = Field(..., ge=0, le=1)
+    hottest_sector: str
+    coolest_sector: str
+    region: str
+    sample_size: int
+    version_info: VersionInfo
+    attribution: AttributionObject
+
+
+class PolicyAuditResponse(BaseModel):
+    ok: bool
+    policies_analyzed: int
+    compliance_score: float = Field(..., ge=0, le=1)
+    recommendations: List[str]
+    version_info: VersionInfo
+    attribution: AttributionObject
+
+
+class StoryResponse(BaseModel):
+    ok: bool
+    story: str
+    impact_metrics: Dict[str, float]
+    version_info: VersionInfo
+    attribution: AttributionObject
+
+
+class MetaResponse(BaseModel):
+    ok: bool
+    api_name: str
+    version: str
+    model: str
+    endpoints: List[str]
+    limits: Dict[str, int]
+    last_model_refresh: Optional[str] = None
+    model_fingerprint: Optional[str] = None
+    attribution: AttributionObject
+
+
+class UsageResponse(BaseModel):
+    ok: bool
+    plan: str
+    date: str
+    used_today: int
+    daily_limit: int
+    attribution: AttributionObject
+
+
+class WhoAmIResponse(BaseModel):
+    ok: bool
+    api: str
+    version: str
+    capabilities: List[str]
+    author: str
+    region: str
+    attribution: AttributionObject
+
+
+class DocsResponse(BaseModel):
+    ok: bool
+    documentation: str
+    endpoints: List[str]
+    version_info: VersionInfo
+    attribution: AttributionObject
+
+
+class SessionResponse(BaseModel):
+    ok: bool
+    session_token: str
+    expires_in: int
+    expires_at: str
+    plan: str
+    version_info: VersionInfo
+    attribution: AttributionObject
+
+
+class HealthResponse(BaseModel):
+    ok: bool
+    service: str
+    time: str
+    region: str
+    performance: str
+    security: str
+    version: str
+    uptime_seconds: int
+    features: List[str]
+    attribution: AttributionObject
+
+
+class MVRApiConfig(BaseModel):
+    license: str
+    email: str
+    base_url: str = "https://mvr-api.africanmarketos.workers.dev"
+    timeout: int = 30
+    max_retries: int = 3

mvr_api_client-2.6.0.dist-info/METADATA

@@ -0,0 +1,187 @@
+Metadata-Version: 2.4
+Name: mvr-api-client
+Version: 2.6.0
+Summary: Python client for African Market OS — Minimum Viable Relationships (MVR) API
+Home-page: https://github.com/africanmarketos/mvr-api-py-client
+Author: African Market OS
+Author-email: African Market OS <info@africanmarketos.com>
+License: MIT
+Project-URL: Homepage, https://github.com/africanmarketos/mvr-api-py-client
+Project-URL: Repository, https://github.com/africanmarketos/mvr-api-py-client
+Project-URL: Issues, https://github.com/africanmarketos/mvr-api-py-client/issues
+Keywords: mvr,api,relationships,african-market,trust
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Requires-Dist: pydantic>=1.8.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# African Market OS — MVR API Python Client
+
+Official **Python SDK** for the  
+**Minimum Viable Relationships (MVR) API — v2.6.0-enterprise**
+
+This client provides full access to all MVR API endpoints:
+
+### ✔ Scores  
+### ✔ Survey aggregation  
+### ✔ Trends  
+### ✔ Forecasts  
+### ✔ Benchmarking  
+### ✔ Insights  
+### ✔ Policy multi-audit  
+### ✔ Stories  
+### ✔ Metadata + Usage  
+### ✔ Health checks  
+### ✔ Session token authentication  
+
+---
+
+## 📦 Installation
+
+You can install directly from PyPI (recommended):
+
+```bash
+pip install mvr-api-client
+
+Or install from source:
+
+pip install .
+
+🚀 Quickstart Example
+
+from mvr_api import MVRApiClient, MVRApiConfig
+
+# Create configuration
+config = MVRApiConfig(
+    license="your-license-key",
+    email="you@example.com"
+)
+
+# Initialize client
+client = MVRApiClient(config)
+
+# Call API
+scores = client.get_scores("fintech")
+print("MVR Index:", scores.mvr_index)
+
+🧪 Submitting Survey Data
+
+from mvr_api import SurveyAggregateRequest, StakeholderResponse
+
+survey_request = SurveyAggregateRequest(
+    stakeholder_responses=[
+        StakeholderResponse(
+            dimension="Embeddedness",
+            scale=4,
+            reasons=["Strong community integration"]
+        )
+    ],
+    sector="fintech"
+)
+
+result = client.survey_aggregate(survey_request)
+print(result.mvr_index)
+
+📈 Trends Example
+trends = client.get_trends(sector="fmcg", days=30)
+print("Average Index:", trends.average_index)
+print("Slope:", trends.slope)
+
+🔮 Forecast Example
+from mvr_api import ForecastRequest
+
+forecast = client.forecast(ForecastRequest(
+    current_index=0.65,
+    velocity=0.02,
+    horizon=30
+))
+
+print("Projected MVR:", forecast.projected_index)
+
+👥 Entity Comparison
+from mvr_api import CompareRequest
+
+comparison = client.compare(CompareRequest(
+    a_index=0.72,
+    b_index=0.58
+))
+
+print("Delta:", comparison.delta)
+print("Verdict:", comparison.verdict)
+
+📊 Benchmarks
+bench = client.get_benchmark("fintech")
+print(bench.benchmark)
+
+♨ Temperature
+temp = client.get_temperature()
+print(temp.continent_score)
+
+📘 Metadata
+meta = client.get_meta()
+print(meta.model)
+
+🔐 Session-Based Authentication
+# Create session token
+session = client.create_session("license-key", "you@example.com")
+
+# Build session-authenticated client
+session_client = client.with_session(session.session_token)
+
+scores = session_client.get_scores()
+print(scores.mvr_index)
+
+🛡 Error Handling
+
+All API errors raise a structured MVRApiError:
+
+from mvr_api import MVRApiError
+
+try:
+    client.get_scores()
+except MVRApiError as e:
+    print("Error:", e.error_data.error_code)
+    print("Message:", e.error_data.message)
+
+📂 Project Structure
+mvr-api-py-client/
+│
+├── setup.py
+├── README.md
+└── mvr_api/
+    ├── __init__.py
+    ├── client.py
+    └── models.py
+
+📄 License
+
+This SDK is released under the MIT License.
+
+🧬 Attribution
+MVR Framework • African Market OS
+Creator: Farouk Mark Mukiibi
+Framework DOI: 10.5281/zenodo.17310446
+
+🌍 About
+
+The Minimum Viable Relationships (MVR) Framework measures:
+
+Trust
+
+Belonging
+
+Permission
+
+Embeddedness
+
+…to evaluate relational readiness for ventures entering
+high-context markets across Africa.
+
+Learn more:https://africanmarketos.com/the-mvr-framework-minimum-viable-relationships/
+
+

mvr_api_client-2.6.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+mvr_api/__init__.py,sha256=7ZWR7KSHMIRC7jRnKBOuljNd9sfVM2ZxRmBt47Ax2uw,1219
+mvr_api/client.py,sha256=cqN8EUW0PigatK7GgyKDXzFsiJ5rue26KqlzpG6Dg_M,13010
+mvr_api/models.py,sha256=LZH36C61Q0o3BXzrtN9MRYCK3WeVt7dlkCSmeqwb13k,5978
+mvr_api_client-2.6.0.dist-info/licenses/LICENSE,sha256=gEdYkTY_4fN-0q2d1j72N1pxtN_OYstZHIzTP79HNGg,1074
+mvr_api_client-2.6.0.dist-info/METADATA,sha256=vZm7BmisQwKEf_S89PLCuX37t4849AON3KmYEnfPtHk,4175
+mvr_api_client-2.6.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+mvr_api_client-2.6.0.dist-info/top_level.txt,sha256=XtH_FTPIizqk666Wo2PX7ueinRNcwoZApH16IxXtcDA,8
+mvr_api_client-2.6.0.dist-info/RECORD,,

mvr_api_client-2.6.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
+

mvr_api_client-2.6.0.dist-info/licenses/LICENSE

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

mvr_api_client-2.6.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+mvr_api