Metadata-Version: 2.4
Name: taches-sdk
Version: 0.1.0
Summary: Official Python SDK for Tâches.ma — Freelance & Micro-Tasks Marketplace in Morocco
Author-email: "Tâches.ma Team" <contact@taches.ma>
License: MIT
Project-URL: Homepage, https://taches.ma
Project-URL: Documentation, https://taches.ma/docs
Project-URL: Source, https://github.com/elmehdibadaoui/taches
Project-URL: Marketplace, https://taches.ma/tasks
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.25.0

# Tâches.ma Python SDK (`taches-sdk`)

[![PyPI Version](https://img.shields.io/pypi/v/taches-sdk.svg)](https://pypi.org/project/taches-sdk/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![Marketplace](https://img.shields.io/badge/Marketplace-tâches.ma-orange)](https://taches.ma)

Official Python SDK for **[Tâches.ma](https://taches.ma)** — the premier micro-task and freelance services marketplace in Morocco.

## 🌟 Features
- **Escrow-Secured Transactions**: Native integration with the *Daman Escrow* workflow.
- **Task Management**: Programmatically post tasks, list opportunities, and filter by skill.
- **Bidding & Proposals**: Submit and manage bids with real-time updates.
- **Moroccan Localized**: Native support for MAD (Moroccan Dirham) and localized categories (E-commerce YouCan, Traduction Darija, Graphisme, Saisie Excel).

---

## 📦 Installation

```bash
pip install taches-sdk
```

---

## 🚀 Quick Start

```python
from taches_sdk import TachesClient

# Initialize client
client = TachesClient(api_key="your_api_token_here")

# List open tasks
tasks = client.list_tasks(category="E-Commerce & YouCan/Shopify")
for t in tasks:
    print(f"[{t['id']}] {t['title']} - {t['budget']} MAD")

# Post a new micro-task
new_task = client.create_task(
    title="Intégration Passerelle Paiement YouCan Maroc",
    description="Configuration passerelle CMI et test panier pour boutique e-commerce.",
    budget_mad=350.0,
    category="E-Commerce & YouCan/Shopify"
)
print("Created task ID:", new_task.get("id"))
```

---

## 🔗 Official Links & Authority Ecosystem
- 🌐 **Platform**: [https://taches.ma](https://taches.ma)
- 📋 **Browse Tasks**: [https://taches.ma/tasks](https://taches.ma/tasks)
- 🛡️ **Daman Escrow Protection**: [https://taches.ma/wallet](https://taches.ma/wallet)
- 📦 **NPM Package**: [https://www.npmjs.com/package/taches-client](https://www.npmjs.com/package/taches-client)
- 🔬 **Zenodo Research Dataset**: [https://doi.org/10.5281/zenodo.23041203](https://doi.org/10.5281/zenodo.23041203)
- 🤗 **Hugging Face Hub**: [https://huggingface.co/datasets/abdnaouri/morocco-freelance-microtasks-dataset](https://huggingface.co/datasets/abdnaouri/morocco-freelance-microtasks-dataset)
- 📊 **Kaggle Benchmark**: [https://www.kaggle.com/datasets/abdnaouri/morocco-freelance-microtasks-dataset](https://www.kaggle.com/datasets/abdnaouri/morocco-freelance-microtasks-dataset)
- 💻 **Source Code**: [https://github.com/elmehdibadaoui/taches](https://github.com/elmehdibadaoui/taches)

## 📄 License
MIT License.
