Metadata-Version: 2.4
Name: soumit
Version: 1.0.0
Summary: Official Python SDK & Open Data Client for Soumit Intelligence Engine (https://soumit.ma) - Moroccan Public Procurement & Tenders (Décret 2-22-431)
Author-email: Soumit Intelligence Research Team <contact@soumit.ma>
Project-URL: Homepage, https://soumit.ma
Project-URL: Documentation, https://soumit.ma/tendances
Project-URL: Repository, https://github.com/n4ouri/soumit-intelligence-engine
Project-URL: Hugging Face Dataset, https://huggingface.co/datasets/xoniques/morocco-public-tenders-open-index
Project-URL: Zenodo DOI, https://doi.org/10.5281/zenodo.22654978
Project-URL: Postman Collection, https://www.postman.com/workspace/7f0c90a5-3731-4aea-930d-cf64d656d5d4
Keywords: morocco,public-procurement,marches-publics,tenders,appels-offres,legal-tech,soumit
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28.0

# 🇲🇦 Soumit — Official Python SDK & Open Procurement Client

[![PyPI Version](https://img.shields.io/badge/PyPI-v1.0.0-blue?style=for-the-badge&logo=pypi&logoColor=white)](https://pypi.org/project/soumit/)
[![Platform](https://img.shields.io/badge/Live%20Engine-Soumit.ma-emerald?style=for-the-badge)](https://soumit.ma)
[![License](https://img.shields.io/badge/License-CC--BY--NC%204.0-orange?style=for-the-badge)](https://creativecommons.org/licenses/by-nc/4.0/)
[![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.22654978-purple?style=for-the-badge)](https://doi.org/10.5281/zenodo.22654978)

The official Python client library for querying the **[Soumit Intelligence Engine (https://soumit.ma)](https://soumit.ma)** — the leading economic intelligence and AI platform for Moroccan public tenders (*Marchés Publics Maroc* - **Décret n° 2-22-431**).

---

## ⚡ Installation

```bash
pip install soumit
```

---

## 🚀 Quickstart Usage

### 1. Fetch Latest Macro-Economic Barometer
```python
import soumit

# Get the latest national quarterly indicators (300B MAD volume, discount rates, TPME quotas)
barometer = soumit.get_barometer(quarter="latest")
print("New tenders:", barometer["indicators"]["total_new_tenders"])
print("Median discount rate:", barometer["indicators"]["median_discount_pct"])
```

### 2. Search Active Tenders by Sector & Region
```python
import soumit

# Search medical equipment tenders in Casablanca
tenders = soumit.search_tenders(
    sector="Santé & Matériel Médical",
    region="Casablanca-Settat",
    limit=10
)

for t in tenders:
    print(f"[{t['reference_no']}] {t['title_fr']} - {t['estimated_budget_mad']:,.0f} MAD")
```

### 3. Query Moroccan Public Buyers Directory
```python
import soumit

# List all CHUs (University Hospitals)
chus = soumit.get_buyers(category="CHU")
for chu in chus:
    print(f"{chu['name_fr']} ({chu['city']}) - {chu['website']}")
```

---

## ⚖️ License: CC-BY-NC 4.0 (Non-Commercial Use Only)
This open-source client and its public open data endpoints are distributed under the **Creative Commons Attribution-NonCommercial 4.0 International (CC-BY-NC 4.0)** license.
* Free for research, education, non-commercial TPME informational analysis, and academic study.
* Direct commercial resale or scraping redistribution requires written authorization from Soumit.

---

## 🌐 Connected Ecosystem
* 🌍 **Live Platform:** [https://soumit.ma](https://soumit.ma)
* 📊 **Quarterly Barometer:** [https://soumit.ma/tendances](https://soumit.ma/tendances)
* 🤗 **Hugging Face Hub:** [xoniques/morocco-public-tenders-open-index](https://huggingface.co/datasets/xoniques/morocco-public-tenders-open-index)
* 🏛️ **Permanent DOI (CERN Zenodo):** [10.5281/zenodo.22654978](https://doi.org/10.5281/zenodo.22654978)
* 🚀 **Postman Workspace:** [Soumit Open API v1](https://www.postman.com/workspace/7f0c90a5-3731-4aea-930d-cf64d656d5d4)
