Billboard.py เป็น Python API สำหรับการเข้าถึงชาร์ตเพลงจาก Billboard.com
ติดตั้งด้วย PIP:
pip install billboard.py
หรือโคลน repo นี้และเรียกใช้ python setup.py install
ในการดาวน์โหลดแผนภูมิ บิลบอร์ด เราใช้ตัวสร้าง ChartData()
มาดึงแผนภูมิ Hot 100 ปัจจุบันกันเถอะ
>> > import billboard
>> > chart = billboard . ChartData ( 'hot-100' )
>> > chart . title
'The Hot 100' ตอนนี้เราสามารถดูรายการแผนภูมิซึ่งเป็นประเภท ChartEntry และมีคุณลักษณะเช่น artist และ 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 นอกจากนี้เรายังสามารถ print แผนภูมิทั้งหมด:
>>> 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
# ...
หน้านี้แสดงแผนภูมิทั้งหมดที่จัดกลุ่มตามหมวดหมู่
ชาร์ตสิ้นปีอยู่ที่นี่
ใช้ตัวสร้าง ChartData เพื่อดาวน์โหลดแผนภูมิ:
ChartData ( name , date = None , year = None , fetch = True , timeout = 25 )ข้อโต้แย้งคือ:
name -ชื่อแผนภูมิเช่น 'hot-100' หรือ 'pop-songs'date -วันที่แผนภูมิเป็นสตริงในรูปแบบ yyyy-mm-dd โดยค่าเริ่มต้นแผนภูมิล่าสุดจะถูกดึงyear -ปีแผนภูมิหากขอแผนภูมิสิ้นปี ต้องเป็นสตริงในรูปแบบ yyyy ไม่สามารถจัดหาทั้ง date และ yearfetch - บูลีนที่ระบุว่าจะดึงข้อมูลแผนภูมิจาก Billboard.com ทันที (ตามเวลาอินสแตนซ์) หากเป็น False ข้อมูลแผนภูมิสามารถเติมได้ในภายหลังโดยใช้วิธี fetchEntries()max_retries - จำนวนครั้งสูงสุดที่จะลองอีกครั้งเมื่อขอข้อมูล (ค่าเริ่มต้น: 5)timeout - จำนวนวินาทีที่จะรอการตอบกลับเซิร์ฟเวอร์ ถ้า None ไม่มีการใช้หมดเวลาตัวอย่างเช่นในการดาวน์โหลดชาร์ตเพลงทางเลือกสำหรับปี 2549:
>> > chart = billboard . ChartData ( 'alternative-songs' , year = 2006 ) หาก chart เป็นอินสแตนซ์ ChartData เราสามารถขอแอตทริบิวต์ entries เพื่อรับรายการแผนภูมิ (ดูด้านล่าง) เป็นรายการ
เพื่อความสะดวก chart[x] เทียบเท่ากับ chart.entries[x] และอินสแตนซ์ของ ChartData
รายการแผนภูมิ (โดยทั่วไปจะเป็นแทร็กเดียว) เป็นประเภท ChartEntry อินสแตนซ์ ChartEntry มีคุณลักษณะดังต่อไปนี้:
title - ชื่อเรื่องของแทร็กartist - ชื่อของศิลปินที่จัดรูปแบบบน Billboard.comimage - URL ของภาพสำหรับแทร็กpeakPos - ตำแหน่งสูงสุดของแทร็กบนแผนภูมิ ณ วันที่แผนภูมิเป็น INT (หรือ None หากแผนภูมิไม่รวมข้อมูลนี้)lastPos - ตำแหน่งของแทร็กในแผนภูมิของสัปดาห์ก่อนหน้าในฐานะ INT (หรือ None หากแผนภูมิไม่รวมข้อมูลนี้) ค่านี้คือ 0 ถ้าแทร็กไม่ได้อยู่ในแผนภูมิของสัปดาห์ก่อนweeks - จำนวนสัปดาห์ที่แทร็กได้รับหรืออยู่ในแผนภูมิรวมถึงวันที่ในอนาคต (จนถึงปัจจุบัน)rank - ตำแหน่งปัจจุบันของแทร็กในแผนภูมิisNew - แทร็กนั้นใหม่สำหรับแผนภูมิหรือไม่ สำหรับเอกสารเพิ่มเติมให้ดูที่ไฟล์ billboard.py หรือใช้คุณสมบัติ help แบบโต้ตอบของ Python
คิดว่าคุณพบข้อผิดพลาด? สร้างปัญหาที่นี่
ยินดีต้อนรับคำขอดึง! โปรดปฏิบัติตามแนวทางสไตล์ต่อไปนี้:
pre-commit install เพื่อติดตั้งตะขอล่วงหน้าที่ทำงานสีดำmixedCaseในการเรียกใช้ชุดทดสอบในเครื่องให้ติดตั้งจมูกและเรียกใช้
nosetests
ในการเรียกใช้ชุดทดสอบในเครื่องทั้ง Python 2.7 และ 3.4 ให้ติดตั้ง Tox และ Run
tox
โครงการและบทความที่ใช้ Billboard.py:
มีเพิ่มเติม? ทำคำขอดึง!
