Главная страница>Связанные с программированием>Другой исходный код
Скачать

✖️Неофициальная оболочка Python API 1337x.

1337x

Это неофициальный API 1337x. Он поддерживает все прокси 1337x и почти все функции 1337x. Вы можете искать, получать трендовые, лучшие и популярные торренты. Кроме того, вы можете просматривать торренты определенной категории. Он также поддерживает фильтрацию результатов по категориям, поддерживает сортировку и кэширование.

Оглавление

  • Установка
  • Начальное руководство
    • Быстрые примеры
      • Поиск торрентов
      • Получение трендовых торрентов
      • Получение информации о торренте
  • Подробная документация
    • Доступные атрибуты
    • Доступные методы
    • Доступная категория
    • Доступные методы сортировки
  • Содействие
  • Проекты, использующие этот API
  • Лицензия

Установка

  • Установить через PyPi 

    pip install 1337x

  • Установить из исходников 

    git clone https://github.com/hemantapkh/1337x && cd 1337x && python setup.py sdist && pip install dist/ *

Начать руководство

Быстрые примеры

1. Поиск торрентов 

 >> > from py1337x import py1337x

# Using 1337x.tw and saving the cache in sqlite database which expires after 500 seconds
>> > torrents = py1337x ( proxy = '1337x.to' , cache = 'py1337xCache' , cacheTime = 500 )

>> > torrents . search ( 'harry potter' )
{ 'items' : [...], 'currentPage' : 1 , 'itemCount' : 20 , 'pageCount' : 50 }

# Searching harry potter in category movies and sort by seeders in descending order
>> > torrents . search ( 'harry potter' , category = 'movies' , sortBy = 'seeders' , order = 'desc' ) 
{ 'items' : [...], 'currentPage' : 1 , 'itemCount' : 40 , 'pageCount' : 50 }

# Viewing the 5th page of the result
>> > torrents . search ( 'harry potter' , page = 5 ) 
{ 'items' : [...], 'currentPage' : , 'itemCount' : 20 , 'pageCount' : 50 }

2. Получение трендовых торрентов 

 >> > from py1337x import py1337x

# Using the default proxy (1337x.to) Without using cache
>> > torrents = py1337x () 

# Today's trending torrents of all category
>> > torrents . trending () 
{ 'items' : [...], 'currentPage' : 1 , 'itemCount' : 50 , 'pageCount' : 1 }

# Trending torrents this week of all category
>> > torrents . trending ( week = True ) 
{ 'items' : [...], 'currentPage' : 1 , 'itemCount' : 50 , 'pageCount' : 1 }

# Todays trending anime 
>> > torrents . trending ( category = 'anime' ) 
{ 'items' : [...], 'currentPage' : 1 , 'itemCount' : 50 , 'pageCount' : 1 }

# Trending anime this week
>> > torrents . trending ( category = 'anime' , week = True ) 
{ 'items' : [...], 'currentPage' : 1 , 'itemCount' : 50 , 'pageCount' : 1 }

3. Получение информации о торренте 

 >> > from py1337x import py1337x

# Using 11337x.st and passing the cookie since 11337x.st is cloudflare protected
>> > torrents = py1337x ( '11337x.st' , cookie = '<cookie>' )

# Getting the information of a torrent by its link
>> > torrents . info ( link = 'https://www.1337xx.to/torrent/258188/h9/' ) 
{ 'name' : 'Harry Potter and the Half-Blood Prince' , 'shortName' : 'Harry Potter' , 'description' : "...." , 'category' : 'Movies' , 'type' : 'HD' , 'genre' : [ 'Adventure' , 'Fantasy' , 'Family' ], 'language' : 'English' , 'size' : '3.0 GB' , 'thumbnail' : '...' , 'images' : [...], 'uploader' : ' ...' , 'uploaderLink' : '...' , 'downloads' : '5310' , 'lastChecked' : '44 seconds ago' , 'uploadDate' : '4 years ago' , 'seeders' : '36' , 'leechers' : '3' , 'magnetLink' : '...' , 'infoHash' : '...' }

# Getting the information of a torrent by its link
>> > torrents . info ( torrentId = '258188' ) 
{ 'name' : 'Harry Potter and the Half-Blood Prince' , 'shortName' : 'Harry Potter' , 'description' : "...." , 'category' : 'Movies' , 'type' : 'HD' , 'genre' : [ 'Adventure' , 'Fantasy' , 'Family' ], 'language' : 'English' , 'size' : '3.0 GB' , 'thumbnail' : '...' , 'images' : [...], 'uploader' : ' ...' , 'uploaderLink' : '...' , 'downloads' : '5310' , 'lastChecked' : '44 seconds ago' , 'uploadDate' : '4 years ago' , 'seeders' : '36' , 'leechers' : '3' , 'magnetLink' : '...' , 'infoHash' : '...' }

Подробная документация

Доступные атрибуты 

 from py1337x import py1337x

torrents = py1337x ( proxy = '1337x.st' , cookie = '<cookie>' , cache = 'py1337xCache' , cacheTime = 86400 , backend = 'sqlite' )

Прокси

Если домен по умолчанию запрещен в вашей стране, вы можете использовать альтернативный домен 1337x.

  • 1337x.to ( по умолчанию )
  • 1337x.st
  • x1337x.ws
  • x1337x.eu
  • x1337x.se
  • 1337x.so
  • 1377x.to (неофициальный)
  • 1337xx.to (неофициальный)

печенье

Некоторые прокси защищены Cloudflare. Для таких прокси вам необходимо передать значение cookie. Чтобы получить файл cookie, зайдите на защищенный сайт в своем браузере, решите капчу и скопируйте значение cf_clearance .

Firefox: Inspect element > Storage > Cookies
Chrome: Inspect element > Application > Storage > Cookies

кэш

Py1337x использует кэш запросов для кэширования данных, чтобы будущие запросы к этим данным могли обслуживаться быстрее. cache может быть любым из следующих.

  • Логическое значение: True для использования кеша и False для неиспользования кеша. ( кеш не используется по умолчанию )
  • Каталог для хранения кэша.

кэшВремя

По умолчанию срок действия кеша истекает через один день. Вы можете изменить время истечения срока действия кэша, установив собственный параметр cacheTime .

  • -1 (не истекает никогда)

  • 0 (для «немедленного истечения срока действия», например, для обхода кеша)

  • Положительное число (в секундах [ по умолчанию 86400 ]).

  • timedelta

  • datetime

серверная часть

Серверная часть для хранения кеша может быть любой из следующих.

  • 'sqlite' : база данных SQLite ( по умолчанию ).

  • 'redis' : кеш Redis ( requires redis )

  • 'mongodb' : база данных MongoDB ( requires pymongo )

  • 'gridfs' : коллекции GridFS в базе данных MongoDB ( requires pymongo ).

  • 'dynamodb' : база данных Amazon DynamoDB ( requires boto3 ).

  • 'memory' : непостоянный кеш, который просто хранит ответы в памяти.

Доступные методы 

 from py1337x import py1337x

torrents = py1337x ()
Метод Описание Аргументы
torents.search(запрос) Поиск торрентов себя,
запрос: Keyword to search for ,
страница (по умолчанию 1): Page to view ,
категория (необязательно): категория,
sortBy (необязательно): Сортировать по,
Заказ (необязательно): заказать
торренты.тренд() Получайте популярные торренты себя,
категория (необязательно): категория,
неделя (по умолчанию — False): True for weekely, False for daily
торренты.топ() Получите топовые торренты себя,
категория (необязательно): категория
torrents.popular(категория) Получите популярные торренты себя,
категория: категория,
неделя (по умолчанию — False): True for weekely, False for daily
torrents.browse(категория) Просмотр просмотра определенной категории себя,
категория: категория,
страница (по умолчанию 1): Page to view
torrents.info (ссылка или torrentId) Получить информацию о торренте себя,
ссылка: Link of a torrent или
torrentId: ID of a torrent

Доступные категории

  • 'movies'
  • 'tv'
  • 'games'
  • 'music'
  • 'apps'
  • 'anime'
  • 'documentaries'
  • 'xxx'
  • 'others'

Доступные методы сортировки

  • 'time'
  • 'size'
  • 'seeders'
  • 'leechers'

Доступный порядок сортировки

  • 'desc' (в порядке убывания)
  • 'asc' (по возрастанию)

Содействие

Мы очень ценим любой ваш вклад.

  1. Форкнуть проект
  2. Создайте свою ветку функций ( git checkout -b feature/AmazingFeature )
  3. Зафиксируйте свои изменения ( git commit -m 'Add some AmazingFeature' )
  4. Нажмите на ветку ( git push origin feature/AmazingFeature )
  5. Открыть запрос на включение

Спасибо всем участникам, которые внесли свой вклад в этот проект.

Проекты, использующие этот API

  • Torrent Hunt — Telegram-бот для поиска торрентов.

Хотите разместить свой проект здесь? Просто сделайте запрос на вытягивание.

Лицензия

Распространяется по лицензии MIT. См. ЛИЦЕНЗИЮ для получения дополнительной информации.

Автор/сопровождающий: Хеманта Покхарел | Ютуб: @H9Youtube

Расширять
Дополнительная информация
Связанные приложения
Рекомендуем вам
Связанные новости Все