billboard charts

Billboard.py

Billboard.py adalah API Python untuk mengakses grafik musik dari Billboard.com.

Instalasi

Instal dengan Pip:

 pip install billboard.py

Atau klon repo ini dan jalankan python setup.py install .

QuickStart

Untuk mengunduh grafik Billboard , kami menggunakan konstruktor ChartData() .

Ayo ambil grafik Hot 100 saat ini.

 >> > import billboard
>> > chart = billboard . ChartData ( 'hot-100' )
>> > chart . title
'The Hot 100'

Sekarang kita dapat melihat entri bagan, yang merupakan tipe ChartEntry dan memiliki atribut seperti artist dan title :

 >> > song = chart [ 0 ]  # Get no. 1 song on chart
>> > song . title
'Nice For What'
>> > song . artist
'Drake'
>> > song . weeks  # Number of weeks on chart
2

Kami juga dapat print seluruh bagan:

 >>> print(chart)
hot-100 chart from 2018-04-28
-----------------------------
1. 'Nice For What' by Drake
2. 'God's Plan' by Drake
3. 'Meant To Be' by Bebe Rexha & Florida Georgia Line
4. 'Psycho' by Post Malone Featuring Ty Dolla $ign
5. 'The Middle' by Zedd, Maren Morris & Grey
# ...

Memandu

Bagan apa yang ada?

Halaman ini menunjukkan semua bagan yang dikelompokkan berdasarkan kategori.

Grafik akhir tahun ada di sini.

Mengunduh bagan

Gunakan ChartData Constructor untuk mengunduh grafik:

 ChartData ( name , date = None , year = None , fetch = True , timeout = 25 )

Argumennya adalah:

• name -Nama Bagan, misalnya 'hot-100' atau 'pop-songs' .
• date -Tanggal bagan sebagai string, dalam format yyyy-mm-dd. Secara default, grafik terbaru diambil.
• year -Tahun bagan, jika meminta bagan akhir tahun. Harus menjadi string dalam format yyyy. Tidak dapat memasok date dan year .
• fetch - Boolean yang menunjukkan apakah akan mengambil data grafik dari Billboard.com segera (pada waktu instantiasi). Jika False , data grafik dapat diisi di kemudian hari menggunakan metode fetchEntries() .
• max_retries - jumlah maksimal kali untuk mencoba kembali saat meminta data (default: 5).
• timeout - Jumlah detik untuk menunggu respons server. Jika None , tidak ada batas waktu yang diterapkan.

Misalnya, untuk mengunduh lagu alternatif lagu akhir tahun untuk tahun 2006:

 >> > chart = billboard . ChartData ( 'alternative-songs' , year = 2006 )

Mengakses entri bagan

Jika chart adalah instance ChartData , kami dapat meminta atribut entries untuk mendapatkan entri bagan (lihat di bawah) sebagai daftar.

Untuk kenyamanan, chart[x] ChartData dengan chart.entries[x] .

Atribut Entri Bagan

Entri bagan (biasanya satu trek) adalah tipe ChartEntry . Instance ChartEntry memiliki atribut berikut:

• title - Judul trek.
• artist - Nama Artis, yang diformat di Billboard.com.
• image - URL gambar untuk trek.
• peakPos - Posisi puncak trek pada bagan pada tanggal grafik, sebagai int (atau None jika bagan tidak termasuk informasi ini).
• lastPos - Posisi trek pada grafik minggu sebelumnya, sebagai int (atau None jika bagan tidak termasuk informasi ini). Nilai ini adalah 0 jika trek tidak ada di bagan minggu sebelumnya.
• weeks - Jumlah minggu trek telah atau berada di grafik, termasuk tanggal mendatang (hingga saat ini).
• rank - Posisi trek saat ini di bagan.
• isNew - Apakah trek baru di bagan.

Lebih banyak sumber daya

Untuk dokumentasi tambahan, lihat file billboard.py , atau gunakan fitur help interaktif Python.

Pikir Anda menemukan bug? Buat masalah di sini.

Berkontribusi

Permintaan tarik dipersilakan! Harap patuhi pedoman gaya berikut:

• Kami menggunakan hitam untuk memformat.
  • Jika Anda memiliki pra-komit yang diinstal, jalankan pre-commit install untuk menginstal kait pra-komit yang berjalan hitam.
• Nama variabel harus di mixedCase .

Menjalankan tes

Untuk menjalankan suite test secara lokal, pasang hidung dan jalankan

 nosetests

Untuk menjalankan suite tes secara lokal di Python 2.7 dan 3.4, pasang racun dan jalankan

 tox

Dibuat dengan Billboard.py

Proyek dan Artikel yang Menggunakan Billboard.py:

• "Apa yang membuat musik pop?" oleh Zach Loery
• "Bagaimana hip hop berubah selama bertahun -tahun?" oleh Rohan Kshirsagar
• "Spotify dan Billboard.py" oleh Allen Guo
• chart_success.py oleh 3ngthrust
• "Top Billboard Streaks" dan "Drake's Hot-100 Streak" oleh James Wenzel @ Polygraph
• "Menentukan 'siklus hidup' dari setiap genre musik" oleh Jack Beckwith @ The Data Face
• "Splunking the Billboard Hot 100 dengan bantuan dari Spotify API" oleh Karthik Subramanian
• "Prediksi Gerakan pada 70 -an & 80 -an Billboard R&B Charts" oleh Andy Friedman
• "Billboard Trends" oleh Tom Johnson
• "Billboard Charts Alexa Skill" oleh Cameron Ezell
• "Dalam campuran: Apa formula rahasia di balik trek terpanas?" Oleh Jason Kibozi-Yocka
• "Muhsic: Dataset Terbuka dengan Informasi Keberhasilan Musikal Temporal" oleh Gabriel P. Oliveira et al.

Punya tambahan? Buat permintaan tarik!

Dependensi

• Sup indah 4
• Permintaan

Lisensi

• Proyek ini dilisensikan di bawah lisensi MIT.
• Bagan Billboard dimiliki oleh Prometheus Global Media LLC. Lihat Ketentuan Penggunaan Billboard.com untuk informasi lebih lanjut.