跳转到主要内容

Async PRAW,即“异步Python Reddit API包装器”的缩写,是一个允许简单访问Reddit API的Python包。

项目描述

Latest Async PRAW Version Supported Python Versions PyPI - Downloads - Monthly Coveralls Coverage GitHub Actions Status Contributor Covenant pre-commit

Async PRAW,即“异步Python Reddit API包装器”的缩写,是一个允许简单访问Reddit API的Python包。Async PRAW旨在易于使用,并内部遵循Reddit的所有API规则。使用Async PRAW,您无需在代码中引入sleep调用。为您的客户端提供一个合适的用户代理即可。

安装

异步 PRAW 支持在 Python 3.7+ 上运行。安装异步 PRAW 推荐使用 pip

pip install asyncpraw

要安装异步 PRAW 的最新开发版本,请运行以下命令

pip install --upgrade https://github.com/praw-dev/asyncpraw/archive/master.zip

有关安装 Python 和 pip 的说明,请参阅“Python 搭车指南”中的“安装指南” 安装指南

快速入门

假设您已经有一个脚本类型 OAuth 应用的凭证,您可以按照以下方式实例化异步 PRAW

import asyncpraw

reddit = asyncpraw.Reddit(
    client_id="CLIENT_ID",
    client_secret="CLIENT_SECRET",
    password="PASSWORD",
    user_agent="USERAGENT",
    username="USERNAME",
)

使用 reddit 实例,您可以与 Reddit 进行交互

# Create a submission to r/test
subreddit = await reddit.subreddit("test")
await subreddit.submit("Test Submission", url="https://reddit.com")

# Comment on a known submission
submission = await reddit.submission(
    url="https://www.reddit.com/comments/5e1az9", fetch=False
)
await submission.reply("Super rad!")

# Reply to the first comment of a weekly top thread of a moderated community
subreddit = await reddit.subreddit("mod")
async for submission in subreddit.top(time_filter="week"):
    comments = await submission.comments()
    await comments[0].reply("An automated reply")

# Output score for the first 256 items on the frontpage
async for submission in reddit.front.hot(limit=256):
    print(submission.score)

# Obtain the moderator listing for r/test
subreddit = await reddit.subreddit("test")
async for moderator in subreddit.moderator:
    print(moderator)

有关异步 PRAW 的更多示例,请参阅异步 PRAW 的 文档

异步 PRAW 讨论和支持

对于 Python 初学者或自认为是 Python 初学者的人来说,请在 r/learnpython 子版块上提问。那里有很多人乐于帮助解决一般的 Python 和简单的异步 PRAW 相关问题。

否则,还有一些官方的地方可以提问关于异步 PRAW 的问题

r/redditdev 是 Reddit 上询问异步 PRAW 相关问题的最佳位置。这个子版块是关于所有 Reddit API 相关讨论的地方,所以请用 [Async PRAW] 标签提交。请在提交前先搜索,看看是否有人提出过类似的问题。

实时聊天可以通过 PRAW Slack 组织 (如果邀请链接已过期,请创建一个 issue) 进行。

除非他们明确表示同意,否则请不要通过 Reddit、电子邮件或 Slack 直接向任何贡献者发送消息。我们强烈鼓励大家互相帮助解答问题。

请在 GitHub 上提交 bug 和功能请求作为 issue,在提交之前请先搜索,确保类似的问题尚未提交。如果已存在此类问题,请给它点赞。当然,欢迎对包含额外信息的 issue 进行评论。

文档

异步 PRAW 的文档位于 https://asyncpraw.readthedocs.io/

历史

2019 年 2 月:Joel 分支出了 PRAW,开始着手开发异步 PRAW,它是 PRAW 的异步兼容版本。

2020 年 7 月:异步 PRAW 被移动到 praw-dev 命名空间。

许可证

异步 PRAW 的源代码(v7.1.1+)在 简化版 BSD 许可证下提供。

  • 版权所有 ©,2020,Joel Payne

项目详情


下载文件

下载适用于您的平台文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源分布

asyncpraw-7.7.1.tar.gz (164.5 kB 查看哈希值)

上传时间

构建分布

asyncpraw-7.7.1-py3-none-any.whl (196.7 kB 查看哈希值)

上传时间 Python 3

由以下支持