Metadata-Version: 2.1
Name: music_manager_micro
Version: 0.2.2
Summary: A media file discovery tool, intended to work alone or fit into a larger toolchain
Author: Samuel Shiels
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11.5
Requires-Dist: jsonpickle
Description-Content-Type: text/markdown

# MusicManager
Build a list of media files from a root directory
# Usage
First time usage should use the execute function. This will return the python list of entries containing tuples in the form 
```
[
(mtime:int,path:str),
...
]
```
```python
from music_manager_micro.music_manager import MusicManager as mm
library = 'my_library'
manager = mm(library)
root_dir = '/media/music'
music_list = manager.execute(library, root_dir)
```
Since the program stores the result in a sqlite DB in 
```
$HOME/.config/MusicManagerMicro/<library_name>
```
we can retrieve the data quickly without re-scanning the directory. We only need to execute when we want to check for new files.

Get an existing list
```python
from music_manager_micro.music_manager import MusicManager as mm
library = 'my_library'
manager = mm(library)
music_list = mm.get_list()
```
# Features
* Default searches for .mp3 and .flac files
* Supports absolute and relative root directory
# Maintenance
* Remove .config/MusicManager directory to safely clear all library data
* Backup .config/MusicManager directory and restore
# Notes
* Library name is intended for internal use so should only contain characters acceptable for a folder name A-Z, a-z, _, -.

# Build

```bash
python -m build
python -m twine upload dist/*
```