diff --git a/.gitignore b/.gitignore index f70c42b..ddc7b0c 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1,5 @@ test.py venv/ -__pycache__/ \ No newline at end of file +__pycache__/ +dist +itd_sdk.egg-info \ No newline at end of file diff --git a/README.md b/README.md index 5ccd3f2..919f42a 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,50 @@ # pyITDclient -ITD client for python +Клиент ITD для python + + +## Установка + +```bash +pip install pyITDclient +``` + +## Пример + +```python +from itd import ITDClient + +c = ITDClient('TOKEN', 'refresh_token=...; __ddg1_=...; __ddgid_=...; is_auth=1; __ddg2_=...; ddg_last_challenge=...; __ddg8_=...; __ddg10_=...; __ddg9_=...') +# можно указать только токен, тогда после просрочки перестанет работать, либо только куки чтобы токен сразу подтянулся, либо оба сразу + +print(c.get_me()) +``` + +### Встроенные запросы +Существуют встроенные эндпоинты для комментариев, хэштэгов, уведомлений, постов, репортов, поиска, пользователей, итд. +```python +c.get_user('ITD_API') # получение данных пользователя +c.get_me() # получение своих данных (me) +c.update_profile(display_name='22:26') # изменение данных профиля, например имя, био итд +c.create_post('тест1') # создание постов +# итд +``` + +### Кастомные запросы + +```python +from itd.request import fetch + +fetch(c.token, 'метод', 'эндпоинт', {'данные': 'данные'}) +``` +Из методов поддерживается `get`, `post`, `put` итд, которые есть в `requests` +К названию эндпоинта добавляется домен итд и `api`, то есть в этом примере отпарвится `https://xn--d1ah4a.com/api/эндпоинт`. + +> ![INFO] +> `xn--d1ah4a.com` - punycode от "итд.com" + +## прочее +Лицезия: [MIT](./LICENSE) +Идея (и часть эндпоинтов): https://github.com/FriceKa/ITD-SDK-js + - По сути этот проект является реворком, просто на другом языке + +Автор: [SizedBox](https://xn--d1ah4a.com/SizedBox) (в итд) [@desicars](https://t.me/desicars) (в тг) \ No newline at end of file diff --git a/pyproject.toml b/pyproject.toml new file mode 100644 index 0000000..379225e --- /dev/null +++ b/pyproject.toml @@ -0,0 +1,17 @@ +[build-system] +requires = ["setuptools", "wheel"] +build-backend = "setuptools.build_meta" + +[project] +name = "itd-sdk" +version = "0.1.0" +description = "ITD client for python" +readme = "README.md" +authors = [ + { name = "firedotguy", email = "nta16022013@gmail.com" } +] +license = "MIT" +dependencies = [ + "requests" +] +requires-python = ">=3.9" diff --git a/setup.py b/setup.py new file mode 100644 index 0000000..a3d3a36 --- /dev/null +++ b/setup.py @@ -0,0 +1,11 @@ +from setuptools import setup, find_packages + +setup( + name='itd-sdk', + version='0.1.0', + packages=find_packages(), + install_requires=[ + 'requests' + ], + python_requires=">=3.9" +)