Skip to main content

Reddit and python, made simple.

Project description

py-reddit

A package that can be used to get reddit submissions, and their various attributes. The package supports both synchronous and asynchronous development. I am more familiar with synchronous programming, but have tried my best at making a good asynchronous implementation. The package is written in Python 3.10, and uses requests and aiohttp as its main dependencies.

Updates will be coming soon, thank you for viewing this package, please consider using it.

Version - 1.1.12

Docs - docs

Socials - KING7077 - GitHub

Installation methods:

pip3 install py-reddit

py -3 -m pip install py-reddit

python3 -m pip install py-reddit

Example usage:

import reddit

client = reddit.Client('agent', 'key')

subreddit = client.Subreddit('top', 'subreddit-here') # supports 'top', 'new' or 'hot' mode of submissions

print(subreddit.selftext(0)) #gets the selftext of the first post here

Asynchronus client:

import reddit
import asyncio

client = reddit.AsyncClient('agent', 'key')


async def main():
    subreddit = await client.Subreddit('top', 'subreddit-here') # supports 'top', 'new' or 'hot' mode of submissions
    print(await subreddit.selftext(0))

asyncio.run(main())

The package is still under active development

CHANGELOG

May 9, 2022

Added documentation, and added raw_json method for Client.Subreddit and AsyncClient.Subreddit - 1.1.12

March 28, 2022

Small changes to the project functionality. - 1.1.11

March 28, 2022

Small changes to the README. - 1.1.10

March 28, 2022

You no longer need to use __call__ (Found a way to use async __init__) - 1.1.9

March 16, 2022

Changes to the async client usage (Need to use __call__()) - 1.1.8

March 16, 2022

License changes - 1.1.7

February 21, 2022

Just changing package DIRs - 1.1.6

February 21, 2022

Just changing package DIRs - 1.1.5

February 21, 2022

You can now specify the number of posts you want to fetch in Client.Subreddit() and AsyncClient.Subreddit(). For example:

import reddit

subreddit = reddit.Client('agent', 'key').Subreddit('top', 'memes', 100) # To fetch 100 posts. If a limit is not specified, it defaults to 25

Similar for the Async Client

limit does not follow a zero index, but all the methods under Subreddit() follow zero index. This may be changed sooner or later

​- 1.1.4

February 20, 2022

Bettered the asynchronous implementation of the project. Much faster now. Renamed Client.Subreddit.url to Client.Subreddit.post_url, the same change for the asynchronous client - 1.1.3

February 19, 2022

Minor changes to the description of the project - 1.1.2

February 19, 2022

Minor changes to the description of the project - 1.1.1

February 19, 2022

The project actually works now - 1.1.0

February 18, 2022

Minor changes to make the project more usuable - 1.0.6

February 18, 2022

Minor changes to make the project more usuable - 1.0.5

February 18, 2022

Minor changes to make the project more usuable - 1.0.4

February 18, 2022

Minor changes to make the project more usuable - 1.0.3

February 18, 2022

Minor changes to the description of the project - 1.0.2

February 18, 2022

Initial release - 1.0.1

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

py-reddit-1.1.12.tar.gz (6.1 kB view details)

Uploaded Source

Built Distribution

py_reddit-1.1.12-py3-none-any.whl (5.3 kB view details)

Uploaded Python 3

File details

Details for the file py-reddit-1.1.12.tar.gz.

File metadata

  • Download URL: py-reddit-1.1.12.tar.gz
  • Upload date:
  • Size: 6.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.26.0 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.63.0 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.10.0

File hashes

Hashes for py-reddit-1.1.12.tar.gz
Algorithm Hash digest
SHA256 d4db39fd0698562649321e1336a9bfb85998b94c80f1a6ca0853932216cf122a
MD5 003303dbd5d12742d33ee445e15add33
BLAKE2b-256 22c54830448def2424e9c43841f029087525051292caf81711f203d3fb965972

See more details on using hashes here.

File details

Details for the file py_reddit-1.1.12-py3-none-any.whl.

File metadata

  • Download URL: py_reddit-1.1.12-py3-none-any.whl
  • Upload date:
  • Size: 5.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.26.0 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.63.0 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.10.0

File hashes

Hashes for py_reddit-1.1.12-py3-none-any.whl
Algorithm Hash digest
SHA256 8c4d66c86de7b9d09cc4fafe92e95a0ac6e4f9e4acf9433f49bee759fb304284
MD5 790efbca3131894f599543e2d95c53e1
BLAKE2b-256 d066122ee82ebfcb8b9617e2c13a0873ef08533b314ba73b5d3365899ebc5f7f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page