little song place

Hello! You've found the source code for littlesong.place. Feel free to have a look around.

Code Overview

This is a pretty simple Flask app. If you've used Flask before, hopefully it feels pretty familiar.

Here are some quick links if you just want to browse the code:

• /src/littlesongplace - the main python code
• /src/littlesongplace/templates - HTML templates
• /src/littlesongplace/static - static files, including images, CSS, and Javascript
• /test - tests, run with pytest

Dependencies

This project has some dependencies that need to be installed manually to your system PATH:

• Python 3.11
• ffmpeg

Environment Setup

First, clone this repo:

git clone https://littlesong.place/git/littlesongplace.git

Then, in the cloned project directory, setup a Python environment and install the necessary dependencies:

python -m venv .venv
. .venv/bin/activate     # (or .venv\Scripts\activate on Windows)
pip install -e .
pip install -r dev-requirements.txt

Running

Run the app locally (accessible in a browser at localhost:5000):

flask --app littlesongplace run --debug

Testing

Run the tests with Pytest:

pytest