pararamio-aio 2.1.1__py3-none-any.whl

pararamio_aio-2.1.1.dist-info/METADATA

@@ -0,0 +1,269 @@
+Metadata-Version: 2.4
+Name: pararamio-aio
+Version: 2.1.1
+Summary: Async Python client library for pararam.io platform
+Author: Pararamio Team
+License: MIT
+Project-URL: Homepage, https://gitlab.com/pararam-public/py-pararamio
+Project-URL: Documentation, https://gitlab.com/pararam-public/py-pararamio/-/wikis/home
+Project-URL: Repository, https://gitlab.com/pararam-public/py-pararamio
+Project-URL: Issues, https://gitlab.com/pararam-public/py-pararamio/-/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: aiofiles>=0.8.0
+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"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: types-aiofiles; extra == "dev"
+
+# Pararamio AIO
+
+Async Python API client for [pararam.io](https://pararam.io) platform.
+
+## Features
+
+- ⚡ **Async/Await**: Modern asynchronous interface with aiohttp
+- 🚀 **Explicit Loading**: Predictable API calls with explicit `load()` methods
+- 🍪 **Cookie Persistence**: Automatic session management
+- 🔐 **Two-Factor Authentication**: Built-in 2FA support
+- 🐍 **Type Hints**: Full typing support for better IDE experience
+
+## Installation
+
+```bash
+pip install pararamio-aio
+```
+
+## Quick Start
+
+```python
+import asyncio
+from pararamio_aio import PararamioAIO, User, Chat, Post
+from pararamio_core import AsyncFileCookieManager
+
+async def main():
+    # Initialize cookie manager for persistent authentication
+    cookie_manager = AsyncFileCookieManager("session.cookie")
+
+    # Initialize client
+    async with PararamioAIO(
+        login="your_login",
+        password="your_password",
+        key="your_2fa_key",
+        cookie_manager=cookie_manager
+    ) as client:
+        # Authenticate
+        await client.authenticate()
+
+        # Search for users - returns User objects (clean names!)
+        users = await client.search_users("John")
+        for user in users:
+            print(f"{user.name}")
+
+        # Get chat messages - returns Chat and Post objects
+        chat = await client.get_chat_by_id(12345)
+        posts = await chat.get_posts(limit=10)
+        for post in posts:
+            await post.load()  # Explicit loading
+            print(f"{post.author.name}: {post.text}")
+
+asyncio.run(main())
+```
+
+## Explicit Loading
+
+Unlike the sync version, pararamio-aio uses explicit loading for predictable async behavior:
+
+```python
+# Get user object
+user = await client.get_user_by_id(123)
+print(user.name)  # Basic data is already loaded
+
+# Load full profile data explicitly
+await user.load()
+print(user.bio)  # Now additional data is available
+
+# Load specific relations
+posts = await user.get_posts()
+for post in posts:
+    await post.load()  # Load each post's content
+```
+
+## Cookie Management
+
+The async client supports multiple cookie storage options:
+
+### Default (In-Memory)
+```python
+# By default, uses AsyncInMemoryCookieManager (no persistence)
+async with PararamioAIO(
+    login="user",
+    password="pass",
+    key="key"
+) as client:
+    await client.authenticate()
+    # Cookies are stored in memory only during the session
+```
+
+### File-based Persistence
+```python
+from pararamio_core import AsyncFileCookieManager
+
+# Create a cookie manager for persistent storage
+cookie_manager = AsyncFileCookieManager("session.cookie")
+
+# First run - authenticates with credentials
+async with PararamioAIO(
+    login="user",
+    password="pass",
+    key="key",
+    cookie_manager=cookie_manager
+) as client:
+    await client.authenticate()
+
+# Later runs - uses saved cookie
+cookie_manager2 = AsyncFileCookieManager("session.cookie")
+async with PararamioAIO(cookie_manager=cookie_manager2) as client:
+    # Already authenticated!
+    profile = await client.get_profile()
+```
+
+## Concurrent Operations
+
+Take advantage of async for concurrent operations:
+
+```python
+async def get_multiple_users(client, user_ids):
+    # Fetch all users concurrently
+    tasks = [client.get_user_by_id(uid) for uid in user_ids]
+    users = await asyncio.gather(*tasks)
+
+    # Load all profiles concurrently
+    await asyncio.gather(*[user.load() for user in users])
+
+    return users
+```
+
+## API Reference
+
+### Client Methods
+
+All methods are async and must be awaited:
+
+- `authenticate()` - Authenticate with the API
+- `search_users(query)` - Search for users
+- `get_user_by_id(user_id)` - Get user by ID
+- `get_users_by_ids(ids)` - Get multiple users
+- `get_chat_by_id(chat_id)` - Get chat by ID
+- `search_groups(query)` - Search for groups
+- `create_chat(title, description)` - Create new chat
+
+### Model Objects
+
+All models have async methods:
+
+- `User` - User profile
+  - `load()` - Load full profile
+  - `get_posts()` - Get user's posts
+  - `get_groups()` - Get user's groups
+
+- `Chat` - Chat/conversation
+  - `load()` - Load chat details
+  - `get_posts(limit, offset)` - Get messages
+  - `send_message(text)` - Send message
+
+- `Post` - Message/post
+  - `load()` - Load post content
+  - `delete()` - Delete post
+
+- `Group` - Community group
+  - `load()` - Load group details
+  - `get_members()` - Get member list
+
+## Error Handling
+
+```python
+from pararamio_aio import (
+    PararamioAuthenticationException,
+    PararamioHTTPRequestException
+)
+
+async with PararamioAIO(**credentials) as client:
+    try:
+        await client.authenticate()
+    except PararamioAuthenticationException as e:
+        print(f"Authentication failed: {e}")
+    except PararamioHTTPRequestException as e:
+        print(f"HTTP error {e.code}: {e.message}")
+```
+
+## Advanced Usage
+
+### Custom Session
+
+```python
+import aiohttp
+
+# Create custom session with specific timeout
+timeout = aiohttp.ClientTimeout(total=60)
+connector = aiohttp.TCPConnector(limit=100)
+session = aiohttp.ClientSession(timeout=timeout, connector=connector)
+
+async with PararamioAIO(session=session, **credentials) as client:
+    # Client will use your custom session
+    await client.authenticate()
+```
+
+### Rate Limiting
+
+The client automatically handles rate limiting:
+
+```python
+client = PararamioAIO(
+    wait_auth_limit=True,  # Wait instead of failing on rate limit
+    **credentials
+)
+```
+
+## Migration from Sync Version
+
+If you're migrating from the synchronous `pararamio` package:
+
+1. Add `async`/`await` keywords
+2. Use async context manager (`async with`)
+3. Call `load()` explicitly when needed
+4. Use `asyncio.gather()` for concurrent operations
+
+Example migration:
+
+```python
+# Sync version
+client = Pararamio(**creds)
+user = client.get_user_by_id(123)
+print(user.bio)  # Lazy loaded
+
+# Async version
+async with PararamioAIO(**creds) as client:
+    user = await client.get_user_by_id(123)
+    await user.load()  # Explicit load
+    print(user.bio)
+```
+
+## License
+
+MIT License - see LICENSE file for details.

pararamio_aio-2.1.1.dist-info/RECORD

@@ -0,0 +1,57 @@
+pararamio_aio/__init__.py,sha256=I5EgOD69E7-Jlj6eiVH3oKjlYFfG6cxUdSXxKHGHdcA,1551
+pararamio_aio/_types.py,sha256=ubC7r0u1gK2hHfdfYzBs4AAbv5GkvI6k5GjaBkYFriY,513
+pararamio_aio/client.py,sha256=z9P-yBAUX6FPqVkpszq8Wp9eLP-JUfMRYsx8M4n7xXc,34481
+pararamio_aio/cookie_manager.py,sha256=S-Y0eWc-RifV9cBMjj-eK_81Fl2Pegr9AEH_xs9tzd8,358
+pararamio_aio/file_operations.py,sha256=mkqxP6rs1XRs4qRjVrVc2UGA134BVYjfv8IfbCU0F7k,6844
+pararamio_aio/py.typed,sha256=lO8QdKnW0rRNzOeMLUDJj_pGcUI45ehzD2Ci6FGjSyc,91
+pararamio_aio/_core/__init__.py,sha256=sKZaAIrAesvinqAP9RvHVrOQcJs1zlDjcC_hK4ar_Sw,3024
+pararamio_aio/_core/_types.py,sha256=J-Bx15_Wgxv2TEER3h3ZLmDUSk4aiWfcqRRZVMAJR6s,2420
+pararamio_aio/_core/base.py,sha256=wvxGX5Yk-CNlRDXfpSQVbyAMyOmf3zJw3T_P_npXFkw,4293
+pararamio_aio/_core/client_protocol.py,sha256=SWT5I3-sVkzkWCEg_fPjYHmZU-ip2O3pQ_kz0FN4DuQ,2577
+pararamio_aio/_core/cookie_decorator.py,sha256=1roJPKauUWOC4xzP39Q9mT3OhReKb309twKh2by84Jo,7270
+pararamio_aio/_core/cookie_manager.py,sha256=pl4IqAr8TWCFtLOk1YLLxGiZCsyp9tr_XgyH-yRu93c,43964
+pararamio_aio/_core/endpoints.py,sha256=XrRlbFvMqQrWKmy2zmoQ6pYNv-Wz1UqptkaQncW7GcI,1867
+pararamio_aio/_core/py.typed,sha256=lO8QdKnW0rRNzOeMLUDJj_pGcUI45ehzD2Ci6FGjSyc,91
+pararamio_aio/_core/validators.py,sha256=6AB_miJiX8jbvSzOX5IbLwYwJn0mTRpF3wS0BCc3BG0,2397
+pararamio_aio/_core/constants/__init__.py,sha256=HnuJjEqv1mU6NPHYQqnM4WPw-zYC3oc9YGN0G77VGBc,124
+pararamio_aio/_core/constants/base.py,sha256=gG0xIozPSG04GZSIJtEIgyje7hnJVF0uS7AMhrR7ZUs,279
+pararamio_aio/_core/constants/endpoints.py,sha256=4cbisrT6FDK9-Zc5zmg1R1k2K1L36ynR8aF__Fq5rSo,1990
+pararamio_aio/_core/exceptions/__init__.py,sha256=Res9nMxrOYV5U1Lmgh8HOXKm2J_-vig0YzC5yAh05yc,125
+pararamio_aio/_core/exceptions/auth.py,sha256=sUWEZrF9FeItFmBZFAQ4v8ujwh3OXNiDRLd4E45e_V8,2641
+pararamio_aio/_core/exceptions/base.py,sha256=vpWEfy4NikKeH35QoRZ8_aWds66QpP7RK2kdMVn0nls,3141
+pararamio_aio/_core/models/__init__.py,sha256=yYgrn-t2SRXVo0rs_v0DPDe1G2H5zJRDAzr6q_IE5Es,289
+pararamio_aio/_core/models/base.py,sha256=FlGWVBiku6k5Xdiz4UiJQApUx4CIKedlmkKqVbjtUl8,1834
+pararamio_aio/_core/models/chat.py,sha256=O_F0JACBA_iDLSnY_XVcf-H3y2Fqdm63QdW-8OwTTWE,2457
+pararamio_aio/_core/models/post.py,sha256=-PwV3lrcax64hiV945J--rkjB0ejCnfUZK4xIb0TCAw,1691
+pararamio_aio/_core/models/user.py,sha256=jD9DEA8witff7Uz5HbKwhJ6FeLh_zGbgk28EIRgaKFA,1357
+pararamio_aio/_core/utils/__init__.py,sha256=cdthEMSxrnKxbAQmpvL4nIbuIFvj3vNEJkhRoPNFUwY,1614
+pararamio_aio/_core/utils/async_requests.py,sha256=hEPfkY4bel3nlhbzzxunJ5_IG61fzQfjEmInw2aGx4c,13203
+pararamio_aio/_core/utils/auth_flow.py,sha256=CdqgtkqcQQzjRG9z4HO7KIme8Ao7lPmUSvEdF9KKBlE,5574
+pararamio_aio/_core/utils/authentication.py,sha256=1Dp6AKd9QOLJ5CFnzJKGtf2GDVG2pYaYiAYxCeiFHpE,7557
+pararamio_aio/_core/utils/captcha.py,sha256=NThx0RVZitUQXj-0FFDsoFC_RzjCszJXVK2_iTD-SoE,2870
+pararamio_aio/_core/utils/helpers.py,sha256=nx2auOc5nm5XVg8YWs4gZemb7WCoWl-opojTttaCxbc,10975
+pararamio_aio/_core/utils/http_client.py,sha256=mnMblvCVAOuXioWFEqIiGs9Y9BL5byAYNcs5RM5NsmU,5482
+pararamio_aio/_core/utils/requests.py,sha256=8YvsxWFdWUXdtMwvikvQglrbcZ1I9Fe-WXSEzULF33Q,14393
+pararamio_aio/constants/__init__.py,sha256=IeBstHaf_NOtCt3DKSpBXGYlkG78WMSynIMXlv922R0,302
+pararamio_aio/exceptions/__init__.py,sha256=sJcl0eZOESZndIjJj_aTUcbXM-QpcyHmHhujt3rPPXs,945
+pararamio_aio/exceptions/base.py,sha256=AilA_mJwd0tgrf3Z5jPWZBnxGgu33pzEuxNEKkKfv9E,49
+pararamio_aio/models/__init__.py,sha256=SUXamoB9MK8CKYB9Eg27FMjikOnyRMEjxdDcvk84SJg,704
+pararamio_aio/models/activity.py,sha256=1SgKWuzC_kr2oH8udjkUT2nrAZQ0w5XlvBzoOP4k-Ig,3372
+pararamio_aio/models/attachment.py,sha256=ryjitTErC2CPfndzCb9Y2vCe56Y3b20Ll1Yd9uqyYGE,3887
+pararamio_aio/models/base.py,sha256=06AML0IVwGptswsZnHxWc6-jbfkRAqTM9LKLNnM1DWQ,2386
+pararamio_aio/models/bot.py,sha256=jyTdXMHJbxVW2_gJ5giazvO_BJAijRtPqtTSQVzsLrk,7700
+pararamio_aio/models/chat.py,sha256=rQYVxMxcDoCVFiax10vvO1xW_7lTG2Ip9bbuXdwXznY,21946
+pararamio_aio/models/deferred_post.py,sha256=dbNOJI8Qpusy4oASugJfnej2M1rxh-gAuajJrz8jjOY,4806
+pararamio_aio/models/file.py,sha256=5krs0bcUiyxdsGMr6zUjyujm2iuzQr7RjPAdWeyoRJY,2854
+pararamio_aio/models/group.py,sha256=j5XoA8cfucTelLnCIZl43WysN-_nRHT41ugnrJuVQv8,10918
+pararamio_aio/models/poll.py,sha256=2dqbjeKpNE5MxjWOdX_HpleH5B2Ths8kZw5e11OpGtE,7988
+pararamio_aio/models/post.py,sha256=3tSO5afqyCmZXhKOqQEdnBbh_JorxUyGl16QWjeZJHs,19728
+pararamio_aio/models/team.py,sha256=8C5e1gx0MbR8z0kUud1c2WoZlLmv-BCMFH8Gud3Vs_g,10959
+pararamio_aio/models/user.py,sha256=stiDRQ0WdsjYLKsP_gwkn6pfcauPp41T7-pWFKWKy3A,6647
+pararamio_aio/utils/__init__.py,sha256=b51cwaL3aMb1VzqCrlg_gDkgj5lKtO9ptkwXFzdAgqs,438
+pararamio_aio/utils/authentication.py,sha256=SMMrqAY1MOZx6TAhmhgpc9619f0r7XgNky8_30T3sUM,11706
+pararamio_aio/utils/requests.py,sha256=JIb0rBI6MPMicjyz6E2xKPtxfO0B9G5S_l6OZCmu9Hw,1873
+pararamio_aio-2.1.1.dist-info/METADATA,sha256=djBcnnwukPanLnl0wyXOCM3lvkoxp3WqwbS09K8qOBQ,7432
+pararamio_aio-2.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pararamio_aio-2.1.1.dist-info/top_level.txt,sha256=jJ1yLKIEkYu3uri2xi6Jc49rmtGy8U-YfLSoESnkQ-w,14
+pararamio_aio-2.1.1.dist-info/RECORD,,

pararamio_aio-2.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pararamio_aio-2.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+pararamio_aio