initial Dimension protocol (#1)

* initial `Dimension` protocol

* Apply suggestions from code review

Co-authored-by: Joren Hammudoglu <[email protected]>

* remove `__eq__`

* add is_dimensionless

* remove is_dimensionless

---------

Co-authored-by: Joren Hammudoglu <[email protected]>

Author: lucascolley

.gitattributes

@@ -0,0 +1,2 @@
+# SCM syntax highlighting
+pixi.lock linguist-language=YAML linguist-generated=true

.gitignore

@@ -0,0 +1,4 @@
+
+# pixi environments
+.pixi
+*.egg-info

pyproject.toml

@@ -0,0 +1,17 @@
+[project]
+authors = [{ name = "quantity-dev contributors" }]
+dependencies = []
+name = "dimension-api"
+requires-python = ">= 3.12"
+version = "0.0.1.dev0"
+
+[build-system]
+build-backend = "hatchling.build"
+requires = ["hatchling"]
+
+[tool.pixi.project]
+channels = ["https://prefix.dev/conda-forge"]
+platforms = ["win-64", "linux-64", "osx-64", "osx-arm64"]
+
+[tool.pixi.pypi-dependencies]
+dimension_api = { path = ".", editable = true }

src/dimension_api/__init__.py

@@ -0,0 +1,12 @@
+"""Dimension API."""
+
+from typing import Final, Protocol, Self, runtime_checkable
+
+__version__: Final = "0.0.1.dev0"
+__all__ = ["__version__", "Dimension"]
+
+@runtime_checkable
+class Dimension(Protocol):
+    def __mul__(self, other: Self, /) -> Self: ...
+    def __truediv__(self, other: Self, /) -> Self: ...
+    def __pow__(self, other: int, /) -> Self: ...