You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Scaruffi/README.md

60 lines
1.1 KiB

4 years ago
Scaruffi
========
Get some data from scaruffi.com from Python.
4 years ago
Piero Scaruffi has written a lot about rock music, jazz, classical, whether it
is reviews or history. It is a valuable ressource for a variety of reasons and
this script aims to make data fetching easier for personal usage.
Features:
- Get a big list of musicians.
- Get best albums per decade, grouped by rating.
This is a work in progress, I would like to add more content to be usable!
Install
-------
This library is available on PyPI:
```bash
pip install scaruffi
```
Usage
-----
Check out the `ScaruffiApi` for all available methods.
```python
from scaruffi.api import ScaruffiApi
api = ScaruffiApi()
api.get_ratings(1960)
# { 9.5: [ Release(title='Trout Mask Replica', ...
```
This module can also be used as a command-line tool:
```bash
scaruffi --help
scaruffi --musicians --offset 5555 --limit 5
# Mooseheart Faith
# Morbid Angel
# Morcheeba
# Morgan Fisher
# Morning 40 Federation
scaruffi --ratings 1960
# 9.5
# - Captain Beefheart - Trout Mask Replica (1969)
# 9.0
# - Bob Dylan - Blonde On Blonde (1966)
# - Captain Beefheart - Safe As Milk (1967)
# ...
```