hak Unduh - hak Unduh kode sumber

hak

ular piton

v7.8.1

Unduh

PRAW: Pembungkus API Python Reddit

PRAW, singkatan dari "Python Reddit API Wrapper", adalah paket Python yang memungkinkan akses mudah ke API Reddit. PRAW bertujuan agar mudah digunakan dan secara internal mengikuti semua aturan API Reddit. Dengan PRAW tidak perlu memasukkan panggilan sleep ke dalam kode Anda. Berikan klien Anda agen pengguna yang sesuai dan Anda sudah siap.

Instalasi

PRAW didukung pada Python 3.8+. Cara yang disarankan untuk menginstal PRAW adalah melalui pip.

pip install praw

Untuk menginstal PRAW versi pengembangan terbaru, jalankan perintah berikut:

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

Untuk petunjuk tentang cara menginstal Python dan pip, lihat Panduan Instalasi "The Hitchhiker's Guide to Python".

Mulai cepat

Dengan asumsi Anda sudah memiliki kredensial untuk aplikasi OAuth tipe skrip, Anda dapat membuat instance PRAW seperti ini:

 import praw

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

Dengan contoh reddit Anda kemudian dapat berinteraksi dengan 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 )

Silakan lihat dokumentasi PRAW untuk mengetahui lebih banyak contoh tentang apa yang dapat Anda lakukan dengan PRAW.

Bot Perselisihan dan Lingkungan Asinkron

Jika Anda berencana menggunakan PRAW di lingkungan asinkron, (misalnya, discord.py, asyncio) sangat disarankan untuk menggunakan Async PRAW. Ini adalah versi PRAW asinkron resmi dan penggunaannya serupa serta memiliki fitur yang sama dengan PRAW.

Diskusi dan Dukungan PRAW

Bagi mereka yang baru mengenal Python, atau menganggap diri mereka seorang pemula Python, harap pertimbangkan untuk mengajukan pertanyaan di subreddit r/learnpython. Ada orang-orang hebat di sana yang dapat membantu dengan pertanyaan umum tentang Python dan pertanyaan sederhana terkait PRAW.

Jika tidak, ada beberapa tempat resmi untuk bertanya tentang PRAW:

r/redditdev adalah tempat terbaik di Reddit untuk menanyakan pertanyaan terkait PRAW. Subreddit ini ditujukan untuk semua diskusi terkait API Reddit, jadi harap beri tag pada kiriman dengan [PRAW] . Silakan lakukan pencarian di subreddit terlebih dahulu untuk melihat apakah ada yang memiliki pertanyaan serupa.

Obrolan waktu nyata dapat dilakukan melalui Organisasi PRAW Slack (harap buat masalah jika tautan undangan tersebut telah kedaluwarsa).

Harap jangan langsung mengirim pesan kepada kontributor mana pun melalui Reddit, email, atau Slack kecuali mereka menyatakan sebaliknya. Kami sangat menganjurkan semua orang untuk membantu orang lain dengan pertanyaan mereka.

Harap laporkan bug dan permintaan fitur sebagai masalah di GitHub setelah pencarian pertama untuk memastikan masalah serupa belum pernah dilaporkan. Jika masalah seperti itu sudah ada, harap beri acungan jempol. Komentar terhadap terbitan yang mengandung informasi tambahan tentu saja diterima.

Catatan

Proyek ini dirilis dengan Kode Etik Kontributor. Dengan berpartisipasi dalam proyek ini, Anda setuju untuk mematuhi ketentuannya.