Metadata-Version: 2.4
Name: aiodot
Version: 1.0.0
Summary: Async Python client for MyDot.one social platform
Home-page: https://github.com/karbaladev/aiodot
Author: karbaladev.ir
Author-email: "karbaladev.ir" <saleh.mohammadi.az@gmail.com>
License: MIT
Project-URL: Homepage, https://karbaladev.ir
Project-URL: Repository, https://github.com/karbaladevir/aiodot
Project-URL: Issues, https://github.com/karbaladevir/aiodot/issues
Keywords: mydot,aiodot,mydot-bot,social-media,async,bot
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp>=3.8.0
Requires-Dist: requests>=2.28.0
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

<p align="center">
  <img src="https://abrehamrahi.ir/o/public/rNf0ej8l/" alt="aiodot logo" width="200">
</p>

<h1 align="center">aiodot 🚀</h1>
<p align="center">
  <b>Async Python client for MyDot.one social platform</b><br>
  Build bots, automation, and tools with ease.
</p>

<p align="center">
  <a href="https://pypi.org/project/aiodot/">
    <img src="https://badge.fury.io/py/aiodot.svg" alt="PyPI version">
  </a>
  <a href="https://pypi.org/project/aiodot/">
    <img src="https://img.shields.io/pypi/pyversions/aiodot.svg" alt="Python">
  </a>
  <a href="https://github.com/karbaladev/aiodot/blob/main/LICENSE">
    <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT">
  </a>
</p>

---

**`aiodot`** is an asynchronous Python library for [MyDot.one](https://mydot.one). Built with `aiohttp` — fast, async-first, session-based like aiogram.

---

## ✨ Features

- ⚡ **Async-first** — Built on aiohttp
- 💾 **Session persistence** — Login once, auto-loads next time
- 🔄 **Auto token refresh** — Handles 401 gracefully
- 📦 **50+ endpoints** — Full API coverage
- 🎯 **Type hints** — Full type annotations

---

## 📦 Installation

```bash
pip install aiodot
```

---

## 💡 Quick Start

```python
import asyncio
from aiodot import MyDotClient

TOKEN = "your-token"  # F12 → Cookies → __Secure-access_token

async def main():
    async with MyDotClient(token=TOKEN, session_file="user.session.json") as client:
        me = await client.get_me()
        print(f"@{me.username}")

        dot = await client.create_dot("Hello aiodot! 🚀")
        print(dot.url)

asyncio.run(main())
```

---

## 🤖 Echo Bot

```python
import asyncio
from aiodot import MyDotClient

TOKEN = "your-token"

async def main():
    processed = set()
    async with MyDotClient(token=TOKEN, session_file="bot.session.json") as c:
        print(f"🤖 @{(await c.get_me()).username} started!")
        while True:
            for n in (await c.get_notifications(10)).get("results", []):
                if n.get("id") in processed: continue
                processed.add(n.get("id"))
                if n.get("type") == "mention":
                    d = n.get("dot", {})
                    if d.get("id"):
                        await c.reply(d["id"], "Hello! 🤖")
            await asyncio.sleep(15)

asyncio.run(main())
```

---

## 📖 API Reference

| Category | Methods |
|----------|---------|
| **Profile** | `get_me()`, `update_profile()`, `set_visibility()` |
| **Dots** | `create_dot()`, `get_dot()`, `reply()`, `repost()`, `quote()`, `like()`, `bookmark()`, `edit_dot()`, `delete_dot()` |
| **Social** | `follow()`, `unfollow()`, `block()`, `unblock()`, `mute()`, `unmute()` |
| **Users** | `search_users()`, `get_user_followers()`, `get_user_following()`, `get_user_dots()` |
| **Feed** | `home_feed()`, `following_feed()`, `follow_suggestions()` |
| **Notifications** | `get_notifications()`, `mark_all_read()`, `get_notification_preferences()` |
| **Trending** | `get_trending_hashtags()`, `get_trending_media()` |

---

## ⚠️ Disclaimer

Unofficial library. Use responsibly per MyDot.one Terms of Service.

---

## 📡 Community

- 📢 **Telegram:** [@aiodotlib](https://t.me/aiodotlib)
- 💬 **Bale:** [ble.ir/aiodot](https://ble.ir/aiodot)
- 🌐 **Website:** [karbaladev.ir](https://karbaladev.ir)

---

## 📄 License

MIT © [karbaladev.ir](https://karbaladev.ir)
