splang

splang is an esoteric programming language written in the form of a playlist. A writeup of the language can be found in the splang documentation.

Programs, or splangs, are playlists whose track metadata encode operations. Take a look at the splang helloworld for a sample splang playlist. Use the splang interpreter to execute these playlists programmatically.

The most convenient way to run splang code is by creating a Spotify playlist and using a developer token. Refer to the Spotify API documentation and Spotipy API documentation for environment setup. However, you can also run splang code using a local JSON file that contains the playlist data.

🛠️ Installation and Use

📦 Development Setup

To get started with development, clone the splang repository and set up your environment:

Ensure Python >=3.11+ is installed. It's recommended to use a virtual environment:

python3 -m venv .venv
source .venv/bin/activate

Install dependencies:

pip install --upgrade pip setuptools wheel
pip install -e ".[dev]"

This installs the project in editable mode along with development tools like pytest.

🚀 General Setup

To install splang for general use, you can install it directly from PyPI:

pip install splang

▶️ Run with Spotify developer access:

splang

Ensure you have a valid Spotify developer token set up in your environment, i.e export SPOTIPY_CLIENT_ID, SPOTIPY_CLIENT_SECRET, and SPOTIPY_REDIRECT_URI as per the Spotipy documentation.

▶️ Run with a local playlist file:

splang helloworld.json

▶️ Run the example helloworld:

splang -hello

▶️ Run the example fibonacci:

splang -fib

📜 Splang v1.0 Language Reference