Metadata-Version: 2.4
Name: ddexusc
Version: 2.1.0
Summary: Official Python client for ddexus platform
Home-page: https://github.com/ddexus/ddexusc
Author: ddexus Team
Author-email: ddexus Team <dev@ddexus.com>
License: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: click>=8.1.0
Provides-Extra: async
Requires-Dist: httpx>=0.24.0; extra == "async"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# ddexusc

<p align="center">
  <strong>Official Python Client for ddexus Platform</strong>
</p>

ddexusc is the official Python client library for **ddexus**, a modern data aggregation platform that serves as a curated directory of the best websites, tools, and resources across the web.

## Installation

```bash
pip install ddexusc
```

With optional async support:
```bash
pip install ddexusc[async]
```

## Quick Start

```python
from ddexusc import DdexusClient

# Initialize the client
client = DdexusClient(api_key="your-api-key-here")

# Submit a website
result = client.submit(
    title="My Awesome Tool",
    description="A powerful tool for developers",
    url="https://myawesometool.com",
    category="Development Tools",
    tags=["python", "cli", "developer-tools"],
    author="John Doe"
)

print(f"Website submitted! ID: {result['id']}")
```

## CLI Usage

```bash
# Submit a website (interactive prompts)
ddexus submit

# Search websites
ddexus search "machine learning"

# List websites
ddexus list --category "Development Tools" --limit 10
```

## Features

- Submit websites to ddexus programmatically
- Search and browse the directory
- Async support for high-throughput operations
- CLI tool for terminal usage
- Type hints for IDE autocomplete
- Comprehensive error handling

## Configuration

```bash
# Environment variables
export DDEXUS_API_KEY="your-api-key"
export DDEXUS_BASE_URL="https://your-ddexus-instance.com"
```

## License

MIT License - see [LICENSE](LICENSE) file.
