Merge remote-tracking branch 'origin/master'

# Conflicts:
#	.gitignore
#	pyproject.toml
#	setup.py

Author: daveronan

.gitignore

@@ -1,84 +1,29 @@
-# API Keys and Secrets
 token
-*.env
-.env
-.env.local
-.env.*.local
 
-# Python
-*.pyc
+# Python Artifacts
 __pycache__/
 *.py[cod]
 *$py.class
-*.so
-.Python
 
-# Virtual Environments
-venv/
-.venv/
-env/
-ENV/
-env.bak/
-venv.bak/
-
-# Testing
-htmlcov/
-.coverage
-.coverage.*
-.pytest_cache/
-.tox/
-.nox/
-coverage.xml
-*.cover
-.hypothesis/
-
-# Test Audio Files (large files)
-tests/fixtures/audio/*.wav
-tests/fixtures/audio/*.mp3
-tests/fixtures/audio/*.flac
-tests/fixtures/audio/*.m4a
-
-# Build and Distribution
-dist/
+# Build Artifacts
 build/
+dist/
 *.egg-info/
-.eggs/
-wheels/
-*.whl
 
-# Documentation Build
-_build/
-docs/_build/
-docs/_static/
-docs/_templates/
+# Virtual Environment
+.venv/
+venv/
+env/
 
-# IDE and Editors
-.vscode/
-.idea/
-*.swp
-*.swo
-*~
-.DS_Store
+# Sphinx documentation build output
+_build/
 
-# Project Specific Output
-single_masters/
-mixed_tracks/
-enhanced_tracks/
-cleaned_audio/
+# Example output directories
 analysis_results/
-album_masters/
-final_masters/
-
-# Logs
-*.log
-
-# mypy
-.mypy_cache/
-.dmypy.json
-dmypy.json
-
-# Jupyter Notebook
-.ipynb_checkpoints
+cleaned_audio/
+enhanced_tracks/
+mixed_tracks/
+single_masters/
 
-# Test scripts with API keys
+# Other untracked files
 test.sh

CONTRIBUTING.md

@@ -0,0 +1,38 @@
+# Contributing to roex-python
+
+First off, thank you for considering contributing to the `roex-python` package! Your help is appreciated. Following these guidelines helps maintainers and the community understand your suggestions and contributions.
+
+## How Can I Contribute?
+
+### Reporting Bugs
+
+If you find a bug, please ensure the bug was not already reported by searching on GitHub under [Issues](https://github.com/roex-audio/roex-python/issues).
+
+If you're unable to find an open issue addressing the problem, [open a new one](https://github.com/roex-audio/roex-python/issues/new). Be sure to include a **title and clear description**, as much relevant information as possible, and a **code sample** or an **executable test case** demonstrating the expected behavior that is not occurring.
+
+### Suggesting Enhancements
+
+Suggestions for enhancements are tracked as GitHub issues.
+
+Before creating enhancement suggestions, please check the [issues list](https://github.com/roex-audio/roex-python/issues) as you might find out that you don't need to create one. When you are creating an enhancement suggestion, please include as many details as possible, including the steps that you imagine you would take if the feature you're requesting existed.
+
+### Pull Requests
+
+If you have code changes you'd like to contribute:
+
+1.  Fork the repository.
+2.  Create a new branch (`git checkout -b feature/your-feature-name`).
+3.  Make your changes.
+4.  Ensure your code adheres to the project's style guidelines (e.g., using a linter like Flake8 or Black if applicable).
+5.  Add tests for your changes if applicable.
+6.  Commit your changes (`git commit -m 'Add some feature'`).
+7.  Push to the branch (`git push origin feature/your-feature-name`).
+8.  Open a [Pull Request](https://github.com/roex-audio/roex-python/pulls) with a clear title and description of your changes.
+
+## Styleguides
+
+Try to follow standard Python conventions (PEP 8) and maintain consistency with the existing codebase style.
+
+## Questions?
+
+If you have questions about contributing, feel free to open an issue and tag it as a 'question'.

Makefile

@@ -0,0 +1,32 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = .
+BUILDDIR      = docs
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@echo "Building $@..."
+	@$(SPHINXBUILD) -b $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+# Special handling for 'html' target to avoid subdirectory
+.PHONY: html
+html: Makefile
+	@echo "Building html directly into $(BUILDDIR)..."
+	@$(SPHINXBUILD) -b html "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: clean
+clean:
+	@echo "Cleaning $(BUILDDIR)..."
+	@rm -rf "$(BUILDDIR)"/*