Note: Due to commas existing in the source data, all CSV files in `sources` are not actually csv files, except `music-cleaned-2.csv`, which is tab-delimmited to handle this. It also was abandoned because of handling issues with the `csv` library on LuaRocks. As it has been a while since my initial work on this, I don't remember what order of operations led to my initial database, except that it contained all tracks played on Friday Night Tracks from episode 150-205. I have since added tracks from episodes 12-149 and 226-230. ## music.json An object of objects, each track indexed by a normalized form of its name, which is all lowercase alphanumeric characters only. Note that only `names` is enforced by the library. - `names`: A list of names equivalent to this track (some tracks have duplicate names due to formatting differences) - `downloaded`: (TRUE or NULL) whether or not I have downloaded it - `url`: (String or NULL) representing where I downloaded it - `note`: (String or NULL) misc. note - `buy`: (String or NULL) a URL where it can be bought (or where I bought it) - `favorite`: (TRUE or NULL) a favorite track - `genre`: (String or NULL) primary genre (Note: I'm sure I've downloaded many tracks that aren't marked as downloaded.) ## music.lua A simple interface library to use in a Lua REPL. - `load(force, file_name)` loads from specified file or `music.json` (called immediately by default, but exposed so you can force a reload or a different file) - `save(file_name)` saves to `file_name` or `music.json` - `add(str)` adds a new track (checks for duplicates) - `add_file(file_name)` adds new tracks from the specified file (file must have one track per line, ignores empty lines) - `find(str)` finds possible track matches by normalizing the input string, returns them as a list of normalized names - `set(match, info)` match can be a list (as is returned by find) or a track name (either will be normalized), info must be a table of key-value pairs, these will be set on the matched tracks, overwriting existing values if a key is already in use - `normalize(str)` returns a normalized form of the input string `music.random(count, match, include, exclude)` is a little more complicated. - `count` is the maximum number of returned names, and defaults to 1 - `match` can be nil, a name, or a list of names (names and lists will have their values normalized) - `include` and `exclude` are tables of key-value pairs that must exist or not exist, `true` values mean non-false keys, but other values must match exactly Example: `music.random(5, nil, {url = true}, {downloaded = true})` will return 5 random tracks from the whole database that have a url, but do not have `downloaded` set.