docs and pixi for pyprojects

Author: WardDeb

pyproject/README.md

@@ -0,0 +1,4 @@
+# {{ cookiecutter.project_name }}
+
+Source code for the {{ cookiecutter.project_name }} project.
+Use `pip` or `pixi` to install the package in editable mode.

pyproject/docs/conf.py

@@ -0,0 +1,15 @@
+from importlib.metadata import version as importlibversion
+
+project = "{{ cookiecutter.project_name }}"
+author = "WardDeb"
+version = importlibversion("{{ cookiecutter.project_slug }}")
+release = version
+
+extensions = [
+    'sphinx_click.ext'
+]
+language = "en"
+master_doc = 'index'
+pygments_style = 'sphinx'
+source_suffix = '.rst'
+html_theme = 'sphinx_rtd_theme'

pyproject/docs/index.rst

@@ -0,0 +1,8 @@
+{{ cookiecutter.project_name }}
+===============================
+
+Documentation for the {{ cookiecutter.project_name }} project.
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:

…kiecutter.project_slug }}/pyproject.toml pyproject/pyproject.tomlpyproject/{{ cookiecutter.project_slug }}/pyproject.toml renamed to pyproject/pyproject.toml pyproject/{{ cookiecutter.project_slug }}/pyproject.toml renamed to pyproject/pyproject.toml

@@ -19,8 +19,21 @@ dependencies = [
 dev = [
     "ruff",
     "pytest",
+    "sphinx",
+    "sphinx-rtd-theme",
+    "sphinx-click"
 ]
 
 [project.scripts]
 
 [tool.setuptools_scm]
+[tool.ruff]
+exclude = [
+  "docs",
+  "tests"
+]
+[tool.pixi.workspace]
+channels = ['conda-forge', 'bioconda']
+platforms = ['linux-64', 'osx-arm64', 'osx-64']
+[tool.pixi.pypi-dependencies]
+{{ cookiecutter.project_slug }} = {path = ".", editable = true, extras = ['dev']}