PRAW, acrónimo de "Python Reddit API Wrapper", es un paquete de Python que permite un acceso sencillo a la API de Reddit. PRAW pretende ser fácil de usar e internamente sigue todas las reglas API de Reddit. Con PRAW no es necesario introducir llamadas sleep
en su código. Proporcione a su cliente un agente de usuario apropiado y listo.
PRAW es compatible con Python 3.8+. La forma recomendada de instalar PRAW es mediante pip.
pip install praw
Para instalar la última versión de desarrollo de PRAW, ejecute lo siguiente:
pip install --upgrade https://github.com/praw-dev/praw/archive/master.zip
Para obtener instrucciones sobre cómo instalar Python y pip, consulte las guías de instalación "La guía del autoestopista Python".
Suponiendo que ya tiene credenciales para una aplicación OAuth de tipo script, puede crear una instancia de PRAW de esta manera:
import praw
reddit = praw . Reddit (
client_id = "CLIENT_ID" ,
client_secret = "CLIENT_SECRET" ,
password = "PASSWORD" ,
user_agent = "USERAGENT" ,
username = "USERNAME" ,
)
Con la instancia reddit
puedes interactuar con 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 la documentación de PRAW para obtener más ejemplos de lo que puede hacer con PRAW.
Si planea utilizar PRAW en un entorno asincrónico (por ejemplo, discord.py, asyncio), se recomienda encarecidamente utilizar Async PRAW. Es la versión asincrónica oficial de PRAW y su uso es similar y tiene las mismas características que PRAW.
Para aquellos nuevos en Python, o que de otro modo se considerarían principiantes en Python, consideren hacer preguntas en el subreddit r/learnpython. Hay personas maravillosas que pueden ayudar con Python general y preguntas simples relacionadas con PRAW.
De lo contrario, existen algunos lugares oficiales para hacer preguntas sobre PRAW:
r/redditdev es el mejor lugar en Reddit para hacer preguntas relacionadas con PRAW. Este subreddit es para todas las discusiones relacionadas con la API de Reddit, así que etiquete los envíos con [PRAW] . Primero realice una búsqueda en el subreddit para ver si alguien tiene preguntas similares.
El chat en tiempo real se puede realizar a través de PRAW Slack Organization (crea un problema si el enlace de invitación ha caducado).
No envíe mensajes directamente a ninguno de los contribuyentes a través de Reddit, correo electrónico o Slack a menos que hayan indicado lo contrario. Recomendamos encarecidamente a todos que ayuden a otros con sus preguntas.
Presente los errores y las solicitudes de funciones como problemas en GitHub después de la primera búsqueda para asegurarse de que no se haya presentado un problema similar. Si ya existe un problema de este tipo, dale el visto bueno. Los comentarios sobre ediciones que contengan información adicional son ciertamente bienvenidos.
Nota
Este proyecto se publica con un Código de conducta para colaboradores. Al participar en este proyecto, usted acepta cumplir con sus términos.
La documentación de PRAW se encuentra en https://praw.readthedocs.io/.
Agosto de 2010: Timothy Mellor creó un proyecto github llamado reddit_api
.
Marzo de 2011: el paquete Python reddit
se registró y se cargó en pypi.
Diciembre de 2011: Bryce Boe asumió el cargo de responsable del paquete reddit
.
Junio de 2012: Bryce cambió el nombre del proyecto PRAW
y el repositorio se trasladó a la organización praw-dev recién creada en GitHub.
Febrero de 2016: Bryce comenzó a trabajar en PRAW4, una reescritura completa de PRAW.
La fuente de PRAW (v4.0.0+) se proporciona bajo la licencia BSD simplificada.
Las versiones anteriores de PRAW se publicaron bajo GPLv3.