Release v0.1.0

Prepare v0.1.0

Author: patcon

CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+## [Unreleased][] (YYYY-MM-DD)
+
+_No changes yet._
+
+## [0.1.0][] (2026-01-19)
+
+Initial release includes:
+
+- `val.viz.schematic_diagram()` helper to showing data structure and visual diffs.
+- Helper methods for PaCMAP and LocalMAP dimensional reduction.
+- Langevitour visualisation for exploring high dimensional space.
+- Basic Jupyter Scatter support for up to 1M participants, including animations.
+- Import of Polis conversation data.
+- Basic Polis v1 pipeline support.
+- Added `val.tools.kmeans()`.
+- Large reference datasets for Aufstehen political party consultation (33k participants) and the #ChileDesperto protest (3k).
+- `val.viz.voter_vignette_widget()` for exploring data stories of random individuals.
+- Comprehensive documentation website.
+- Wrappers for various scanpy methods.
+
+<!-- Links -->
+
+[Unreleased]: https://github.com/patcon/valency-anndata/compare/v0.1.0...main
+[0.1.0]: https://github.com/patcon/valency-anndata/releases/tag/v0.1.0

Makefile

@@ -11,8 +11,30 @@ notebook-docs-debug:
 		--log-level=DEBUG \
 		--to markdown
 
-serve:
+serve: ## Serve documentation website for local development
 	uv run mkdocs serve
 
-build:
+docs: ## Build documentation website directory
 	uv run mkdocs build
+
+build: ## Build wheel package for publishing to PyPI
+	rm -rf dist/
+	uv build
+
+publish: ## Publish built package to PyPI
+	uv publish
+
+# These make tasks allow the default help text to work properly.
+%:
+	@true
+
+.PHONY: help notebook-docs notebook-docs-debug serve docs build publish
+
+help:
+	@echo 'Usage: make <command>'
+	@echo
+	@echo 'where <command> is one of the following:'
+	@echo
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'
+
+.DEFAULT_GOAL := help

README.md

@@ -9,7 +9,7 @@ Experimental tooling to support notebook analysis of polislike data.
 ## Installation
 
 ```
-pip install git+https://github.com/patcon/valency-anndata
+pip install valency-anndata
 ```
 
 ## Usage

docs/installation.md

@@ -1,11 +1,15 @@
 # Installation
 
-For now, installation is a bit inelegant:
+To install the latest release:
 
 ```python
-pip install git+https://github.com/patcon/valency-anndata
+pip install valency-anndata
 ```
 
-Once we make a full release and settle the versions of our dependant libraries, installation will be simply `pip install valency-anndata`!
+At the moment, there are a lot of core dependencies (even without installing development packages). In the future, we will have a more slim core if there is interest.
+
+To install unreleased code from the source repository:
 
-At the moment, there are a lot of core dependencies (even without installing development packages). In the future, we will have a more slim core if there is interest.
+```py
+pip install git+https://github.com/patcon/valency-anndata
+```

pyproject.toml

@@ -1,12 +1,33 @@
 [project]
 name = "valency-anndata"
 version = "0.1.0"
-description = "Add your description here"
+description = "Experimental tooling to support notebook analysis of polislike data"
 readme = "README.md"
 authors = [
     { name = "Patrick Connolly", email = "patrick.c.connolly@gmail.com" }
 ]
 requires-python = ">=3.10"
+keywords = [
+    "polis",
+    "anndata",
+    "single-cell",
+    "data-analysis",
+    "clustering",
+    "dimensionality-reduction",
+    "opinion-data",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+    "Topic :: Scientific/Engineering :: Visualization",
+    "Operating System :: OS Independent",
+]
 dependencies = [
     "anndata>=0.11.4",
     "googletrans>=4.0.2",
@@ -29,16 +50,14 @@ dependencies = [
     "jupyter-scatter>=0.22.2",
 ]
 
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[tool.uv.sources]
-# Temporary fork (for website build only), until this gets merged:
-# See: https://github.com/pfh/langevitour/pull/9
-langevitour = { git = "https://github.com/patcon/langevitour", rev = "fix-js-indent" }
+[project.urls]
+Homepage = "https://github.com/patcon/valency-anndata"
+Documentation = "https://github.com/patcon/valency-anndata#readme"
+Repository = "https://github.com/patcon/valency-anndata"
+"Bug Tracker" = "https://github.com/patcon/valency-anndata/issues"
+Changelog = "https://github.com/patcon/valency-anndata/releases"
 
-[dependency-groups]
+[project.optional-dependencies]
 dev = [
     "ipykernel>=7.1.0",
     "itables>=2.6.2",
@@ -48,3 +67,12 @@ dev = [
     "nbconvert>=7.16.6",
     "ruff>=0.14.10",
 ]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.uv.sources]
+# Temporary fork (for website build only), until this gets merged:
+# See: https://github.com/pfh/langevitour/pull/9
+langevitour = { git = "https://github.com/patcon/langevitour", rev = "fix-js-indent" }