PRAW, um acrônimo para "Python Reddit API Wrapper", é um pacote Python que permite acesso simples à API do Reddit. O PRAW pretende ser fácil de usar e seguir internamente todas as regras da API do Reddit. Com o PRAW não há necessidade de introduzir chamadas sleep
no seu código. Dê ao seu cliente um agente de usuário apropriado e pronto.
PRAW é compatível com Python 3.8+. A forma recomendada de instalar o PRAW é via pip.
pip install praw
Para instalar a versão de desenvolvimento mais recente do PRAW, execute o seguinte:
pip install --upgrade https://github.com/praw-dev/praw/archive/master.zip
Para obter instruções sobre como instalar o Python e o pip, consulte os guias de instalação do "Guia do Mochileiro do Python".
Supondo que você já tenha credenciais para um aplicativo OAuth do tipo script, você pode instanciar uma instância do PRAW da seguinte forma:
import praw
reddit = praw . Reddit (
client_id = "CLIENT_ID" ,
client_secret = "CLIENT_SECRET" ,
password = "PASSWORD" ,
user_agent = "USERAGENT" ,
username = "USERNAME" ,
)
Com a instância reddit
você pode interagir com o Reddit:
# Create a submission to r/test
reddit . subreddit ( "test" ). submit ( "Test Submission" , url = "https://reddit.com" )
# Comment on a known submission
submission = reddit . submission ( url = "https://www.reddit.com/comments/5e1az9" )
submission . reply ( "Super rad!" )
# Reply to the first comment of a weekly top thread of a moderated community
submission = next ( reddit . subreddit ( "mod" ). top ( time_filter = "week" ))
submission . comments [ 0 ]. reply ( "An automated reply" )
# Output score for the first 256 items on the frontpage
for submission in reddit . front . hot ( limit = 256 ):
print ( submission . score )
# Obtain the moderator listing for r/test
for moderator in reddit . subreddit ( "test" ). moderator ():
print ( moderator )
Consulte a documentação do PRAW para obter mais exemplos do que você pode fazer com o PRAW.
Se você planeja usar o PRAW em um ambiente assíncrono (por exemplo, discord.py, asyncio), é altamente recomendável usar o Async PRAW. É a versão assíncrona oficial do PRAW e seu uso é semelhante e possui os mesmos recursos do PRAW.
Para aqueles que são novos em Python, ou que de outra forma se consideram iniciantes em Python, considere fazer perguntas no subreddit r/learnpython. Há pessoas maravilhosas lá que podem ajudar com questões gerais sobre Python e questões simples relacionadas ao PRAW.
Caso contrário, existem alguns locais oficiais para fazer perguntas sobre o PRAW:
r/redditdev é o melhor lugar no Reddit para fazer perguntas relacionadas ao PRAW. Este subreddit é para todas as discussões relacionadas à API do Reddit, portanto, marque os envios com [PRAW] . Por favor, faça uma pesquisa no subreddit primeiro para ver se alguém tem perguntas semelhantes.
O bate-papo em tempo real pode ser conduzido por meio da organização PRAW Slack (crie um problema se o link de convite tiver expirado).
Por favor, não envie mensagens diretamente a nenhum dos colaboradores via Reddit, e-mail ou Slack, a menos que eles indiquem o contrário. Encorajamos fortemente todos a ajudar os outros com suas perguntas.
Registre bugs e solicitações de recursos como problemas no GitHub após a primeira pesquisa para garantir que um problema semelhante ainda não tenha sido registrado. Se esse problema já existir, dê uma reação positiva. Comentários sobre questões que contenham informações adicionais são certamente bem-vindos.
Observação
Este projeto é lançado com um Código de Conduta do Colaborador. Ao participar deste projeto você concorda em cumprir seus termos.
A documentação do PRAW está localizada em https://praw.readthedocs.io/.
Agosto de 2010: Timothy Mellor criou um projeto no github chamado reddit_api
.
Março de 2011: O pacote Python reddit
foi registrado e carregado no pypi.
Dezembro de 2011: Bryce Boe assumiu como mantenedor do pacote reddit
.
Junho de 2012: Bryce renomeou o projeto PRAW
e o repositório foi realocado para a recém-criada organização praw-dev no GitHub.
Fevereiro de 2016: Bryce começou a trabalhar no PRAW4, uma reescrita completa do PRAW.
A fonte do PRAW (v4.0.0+) é fornecida sob a licença BSD simplificada.
Versões anteriores do PRAW foram lançadas sob GPLv3.