Music Faker Community Provider
Project description
faker_music: music provider for Faker
An add-on provider for the Python Faker module to generate random and/or fake data for music-related categories.
Description
faker_music
provides music-related fake data for testing purposes. The definition of "fake" in this context really means "random," as the musical data are real. Invocation of this module simply provides a random choice from the underlying real-world data.
No claims are made as to the accuracy or completeness of this data. However, suggestions/corrections/additional data are happily accepted.
Currently implemented:
- Music genres
- Musical instruments
Coming soon:
- Composers
- Performers
For future implementation:
- Band names (existing)
- Fake band name generator
- Theory (notes/scales/chord-types/progressions)
- ...?
Installation
From PyPi:
pip install faker_music
From source code:
git clone https://github.com/jeffwright13/faker_music/
cd faker_music && python setup.py install
Execution
Add as a provider to your Faker instance:
>>> from faker import Faker
>>> from faker_music import MusicProvider
>>> fake = Faker()
>>> fake.add_provider(MusicProvider)
Now you can start to generate data:
>>> fake.music_genre()
>>> fake.music_subgenre()
>>> fake.music_instrument()
>>> fake.music_instrument_category()
About faker_music Objects
The music_genre_object
is a dictionary consisting of a 'genre' string, and an associated 'subgenre' list. The purpose is to provide data that ties together a given genre with all of it known subgenres.
For example:
>>> fake.music_genre_object()
{'genre': 'Singer/Songwriter',
'subgenres': [
'Alternative Folk',
'Contemporary Folk',
'Contemporary Singer/Songwriter',
'Indie Folk',
'Folk-Rock',
'Love Song',
'New Acoustic',
'Traditional Folk']}
Similarly, The music_instrument_object
is a dictionary consisting of an instrument 'category' string, and an associated 'instrument' list. The purpose is to provide data that ties together a given caegory with all of it known instruments.
For example:
>>> fake.music_instrument_object()
{'category': 'electronics',
'instruments': [
'Drum machine',
'Electric guitar',
'Keyboard',
'Synthesizer',
'Theremin',
'Turntable']}
Data Sources
Original data for this project (stored in genres.py
, instruments.py
) was lifted from https://www.musicgenreslist.com and Wikipedia, and massaged into a format suitable for coding using the genre_parser.py
and instrument_parser.py
code found here.
Acknowlegements
- I would like to thank the maintainer of the faker_airtravel repository, since I used its structure to create this one.
- Big thanks also to Bob Belderbos for his expert guidance in getting this litte project off the ground.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for faker_music-0.4-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7ad13d9a085cccc87d2b1f0510ff8a95c2176b41122ae289d38c321dbc29d8f2 |
|
MD5 | 04aa2c60e05a166fec1b1fcd4b8b66db |
|
BLAKE2b-256 | 1c356a6a2717a0a6e5ef04b27b11f09a70b3cfbd12cc656495f1261bee429dcc |