Skip to content

Added new functionality including song search functionality, added additional search parameters #17

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jogoe222 wants to merge 9 commits into
base: master
Choose a base branch
from
Open

Added new functionality including song search functionality, added additional search parameters #17

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
f176d21
* fix import requests_cache
jogoe222 Mar 27, 2023
5e4a4cf
update README
jogoe222 Mar 27, 2023
35d3b15
merge "similar artists" feature from @msanlop's pull request on the main
jogoe222 Mar 27, 2023
57b717f
add return value type for similar_artists
jogoe222 Mar 27, 2023
9c2bcdc
add additional parameters for album_search and band_search such as re…
jogoe222 Mar 27, 2023
60c461f
update the Track duration (I had unintentionally overwritten this)
jogoe222 Mar 27, 2023
9bef6c4
Remove unnecessary parameter mappings in song_search
jogoe222 Mar 27, 2023
108b394
remove a debug print
jogoe222 Mar 27, 2023
1931ba2
* fix the "bands" property so that it works for collaboration release…
jogoe222 Apr 24, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,10 @@ bands[0].name
# Fetch band page
band = bands[0].get()

# Fetch band's similiar artists
band.similar_artists
# -> <SimilarArtists: Megadeth (490) | Testament (415) | Exodus (212) | Evile (206) | Anthrax (184) | Death Angel (149) | Diamond Head (119) | Xentrix (114) | Annihilator (110) | Newsted (108) | Heathen (106) | Metal Church (105) | Flotsam and Jetsam (103) | Slayer (71) | Trivium (70) | Overkill (66) | Artillery (58) | Mortal Sin (58) | Volbeat (55) | Sacred Reich (50)>

# Get all albums
band.albums
# -> [<Album: No Life 'til Leather (Demo)>, <Album: Kill 'Em All (Full-length)>, ...]
Expand Down Expand Up @@ -63,5 +67,28 @@ metallum.album_search('seventh', band='iron maiden', strict=False)

```

Song search

```python
import metallum

# Search songs matching term
metallum.song_search('fear of the')
# -> []

# Search songs containing term
metallum.album_search('fear of the', strict=False)
# -> [<SearchResult: Antipope | 3 Eyes of Time | Full-length | The Fear of Fear | Progressive Black Metal (early); Progressive/Gothic/Industrial Metal (later) | 2588300>, ...]

# Search songs by band
metallum.song_search('fear of the', band='iron maiden', strict=False)
# -> [<SearchResult: Iron Maiden | A Real Live One | Live album | Fear of the Dark | Heavy Metal, NWOBHM | 501324>, ...]

# Search songs by release
metallum.song_search('fear of the', release='fear of the dark', strict=False)
# -> [<SearchResult: Iron Maiden | Fear of the Dark | Full-length | Fear of the Dark | Heavy Metal, NWOBHM | 3449>, ...]

```

Refer to source and doctests for detailed usage

Loading