Billboard.py هي واجهة برمجة تطبيقات Python للوصول إلى المخططات الموسيقية من Billboard.com.
تثبيت مع PIP:
pip install billboard.py
أو استنساخ هذا الريبو وتشغيل python setup.py install .
لتنزيل مخطط Billboard ، نستخدم مُنشئ ChartData() .
دعنا نجلب مخطط 100 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 year .fetch - A BOOLEAN التي تشير إلى ما إذا كان يجب جلب بيانات الرسم البياني من billboard.com على الفور (في وقت مثيل). إذا كان False ، يمكن ملء بيانات المخطط في وقت لاحق باستخدام طريقة fetchEntries() .max_retries - الحد الأقصى لعدد المرات لإعادة إعادة المحاولة عند طلب البيانات (افتراضي: 5).timeout - عدد الثواني لانتظار استجابة الخادم. إذا لم يتم تطبيق None مهلة.على سبيل المثال ، لتنزيل الرسم البياني للأغاني البديلة في نهاية العام لعام 2006:
>> > chart = billboard . ChartData ( 'alternative-songs' , year = 2006 ) إذا كان chart هو مثيل ChartData ، فيمكننا طلب سمة entries للحصول على إدخالات الرسم البياني (انظر أدناه) كقائمة.
للراحة ، فإن chart[x] يعادل chart.entries[x] ChartData
إدخال الرسم البياني (عادة مسار واحد) هو من نوع ChartEntry . يحتوي مثيل ChartEntry على السمات التالية:
title - عنوان المسار.artist - اسم الفنان ، كما تم تنسيقه على billboard.com.image - عنوان 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:
لديك إضافة؟ اصنع طلب سحب!
