2021-03-02 09:14:24 +00:00
|
|
|
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.
|
|
|
|
|
|
2021-09-28 21:22:34 +00:00
|
|
|
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.
|
|
|
|
|
|
2021-03-02 09:14:24 +00:00
|
|
|
## music.json
|
|
|
|
|
|
|
|
|
|
An object of objects, each track indexed by a normalized form of its name, which
|
2021-09-28 21:22:34 +00:00
|
|
|
is all lowercase alphanumeric characters only. Note that these are not enforced
|
|
|
|
|
or formalized by the library, but convention I have adopted.
|
2021-03-02 09:14:24 +00:00
|
|
|
|
|
|
|
|
- `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.
|
|
|
|
|
|
2021-09-28 21:22:34 +00:00
|
|
|
- `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`
|
2021-03-02 09:14:24 +00:00
|
|
|
- `add(str)` adds a new track (checks for duplicates)
|
2021-09-28 21:22:34 +00:00
|
|
|
- `add_file(file_name)` adds new tracks from the specified file (file must have
|
|
|
|
|
one track per line, ignores empty lines)
|
2021-03-02 09:14:24 +00:00
|
|
|
- `find(str)` finds possible track matches by normalizing the input string,
|
|
|
|
|
returns them in a list
|
2021-09-28 21:22:34 +00:00
|
|
|
- `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
|
2021-03-02 09:14:24 +00:00
|
|
|
- `normalize(str)` returns a normalized form of the input string
|
