feat(packages): add example monorepo package

- migrates original root package to pnt-functional
- replaces root package with simplified package

Signed-off-by: Cameron Smith <[email protected]>

Author: cameronraysmith

src/.keep renamed to packages/pnt-functional/README.md

@@ -0,0 +1,137 @@
+[project]
+authors = [
+  { name = "Your Name", email = "[email protected]" },
+]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+  "beartype>=0.19.0,<0.20.0",
+  "expression>=5.5.0",
+]
+description = "A Python package template using Nix and uv"
+license = { text = "Apache-2.0" }
+name = "pnt-functional"
+readme = "README.md"
+requires-python = ">=3.11"
+version = "0.1.0"
+
+[project.scripts]
+pnt-functional = "pnt_functional.main:greet"
+
+[build-system]
+build-backend = "hatchling.build"
+requires      = ["hatchling"]
+
+[project.optional-dependencies]
+
+[dependency-groups]
+dev = [
+  { include-group = "interactive" },
+  { include-group = "lint" },
+  { include-group = "test" },
+  { include-group = "types" },
+]
+interactive = [
+  "ipython>=8.32.0",
+]
+lint = [
+  "ruff>=0.9.4",
+]
+test = [
+  "hypothesis>=6.125.1",
+  "pytest-cov>=6.0.0",
+  "pytest>=8.3.4",
+  "xdoctest>=1.2.0",
+]
+types = [
+  "pyright>=1.1.395",
+]
+
+[tool.uv]
+default-groups = ["lint", "test", "types"]
+
+[tool.pixi.workspace]
+channels  = ["conda-forge"]
+platforms = ["linux-64", "osx-arm64"]
+preview   = ["pixi-build"]
+
+[tool.pixi.dependencies]
+beartype   = ">=0.19.0"
+expression = ">=5.5.0"
+python     = ">=3.11"
+
+[tool.pixi.pypi-dependencies]
+pnt-functional = { path = ".", editable = true }
+
+[tool.pixi.environments]
+default     = { solve-group = "default" }
+dev         = { features = ["dev"], solve-group = "default" }
+interactive = { features = ["interactive"], solve-group = "default" }
+lint        = { features = ["lint"], solve-group = "default" }
+test        = { features = ["test"], solve-group = "default" }
+types       = { features = ["types"], solve-group = "default" }
+
+[tool.pixi.feature.test.tasks]
+test = "pytest"
+
+[tool.pixi.feature.lint.tasks]
+lint       = "ruff check --fix src/"
+lint-check = "ruff check src/"
+
+[tool.pixi.feature.types.tasks]
+types = "pyright src/"
+
+[tool.pixi.package]
+name    = "pnt-functional"
+version = "0.1.0"
+
+[tool.pixi.package.run-dependencies]
+beartype   = ">=0.19.0"
+expression = ">=5.5.0"
+
+[tool.pixi.package.host-dependencies]
+hatchling = "*"
+
+[tool.pixi.package.build]
+backend = { name = "pixi-build-python", version = "0.1.*" }
+channels = [
+  "https://prefix.dev/conda-forge",
+  "https://prefix.dev/pixi-build-backends",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pnt_functional"]
+
+[tool.pytest.ini_options]
+addopts = """
+-rA
+--xdoctest
+--disable-warnings
+--cov=src/pnt_functional/
+--cov-report=term-missing
+--durations=0
+"""
+log_level = "INFO"
+testpaths = [
+  "src/pnt_functional/tests",
+]
+
+[tool.ruff]
+line-length    = 88
+src            = ["src"]
+target-version = "py311"
+
+[tool.ruff.lint]
+select = [
+  "B", # flake8-bugbear
+  "E", # pycodestyle errors
+  "F", # pyflakes
+  "I", # isort
+  "W", # pycodestyle warnings
+]

packages/pnt-functional/pyproject.toml

@@ -0,0 +1,9 @@
+"""A Python package template using Nix and uv."""
+
+__version__ = "0.1.0"
+
+from pnt_functional.main import greet
+
+__all__ = [
+    "greet",
+]

packages/pnt-functional/src/.keep

@@ -1,4 +1,4 @@
-"""Main module for python_nix_template demonstrating functional programming patterns."""
+"""Main module for pnt_functional demonstrating functional programming patterns."""
 
 from beartype import beartype
 from expression import Error, Ok, Result

packages/pnt-functional/src/pnt_functional/__init__.py

@@ -0,0 +1,52 @@
+"""Tests for main module."""
+
+from expression import Error, Ok
+
+from pnt_functional.main import create_greeting, greet, validate_name
+
+
+def test_validate_name_valid():
+    """Test name validation with valid input."""
+    assert validate_name("alice") == Ok("Alice")
+    assert validate_name(" bob ") == Ok("Bob")
+
+
+def test_validate_name_invalid():
+    """Test name validation with invalid input."""
+    assert validate_name("") == Error("Name cannot be empty")
+    assert validate_name(" ") == Error("Name cannot be empty")
+    assert validate_name("a") == Error("Name must be at least 2 characters")
+    assert validate_name("x" * 51) == Error("Name must be at most 50 characters")
+
+
+def test_create_greeting_valid():
+    """Test greeting creation with valid input."""
+    assert create_greeting("alice") == Ok("Hello, Alice!")
+    assert create_greeting(" bob ") == Ok("Hello, Bob!")
+
+
+def test_create_greeting_invalid():
+    """Test greeting creation with invalid input."""
+    result = create_greeting("")
+    assert result.is_error()
+
+    result = create_greeting("a")
+    assert result.is_error()
+
+
+def test_greet_default():
+    """Test greet function with default argument."""
+    result = greet()
+    assert result == "Hello, World!"
+
+
+def test_greet_custom():
+    """Test greet function with custom name."""
+    result = greet("Alice")
+    assert result == "Hello, Alice!"
+
+
+def test_greet_invalid():
+    """Test greet function with invalid input."""
+    result = greet("a")
+    assert result == "This is supposed to be a hello world program, but it failed."

src/python_nix_template/main.py renamed to packages/pnt-functional/src/pnt_functional/main.py

@@ -2,33 +2,28 @@
 authors = [
   { name = "Your Name", email = "[email protected]" },
 ]
-classifiers = [
-  "Development Status :: 3 - Alpha",
-  "License :: OSI Approved :: MIT License",
-  "Operating System :: OS Independent",
-  "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.11",
-  "Programming Language :: Python :: 3.12",
-]
-dependencies = [
-  "beartype>=0.19.0",
-  "expression>=5.5.0",
-]
-description = "A Python package template using Nix and uv"
-license = { text = "Apache-2.0" }
+dependencies = []
+description = "Add your description here"
 name = "python-nix-template"
 readme = "README.md"
 requires-python = ">=3.11"
 version = "0.1.0"
 
 [project.scripts]
-python-nix-template = "python_nix_template.main:greet"
+python-nix-template = "python_nix_template:main"
 
 [build-system]
 build-backend = "hatchling.build"
 requires      = ["hatchling"]
 
-[project.optional-dependencies]
+# [tool.uv.sources]
+# pnt-functional = { workspace = true }
+
+# [tool.uv.workspace]
+# members = ["packages/*"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/python_nix_template"]
 
 [dependency-groups]
 dev = [
@@ -62,9 +57,7 @@ platforms = ["linux-64", "osx-arm64"]
 preview   = ["pixi-build"]
 
 [tool.pixi.dependencies]
-beartype   = ">=0.19.0"
-expression = ">=5.5.0"
-python     = ">=3.11"
+python = ">=3.11"
 
 [tool.pixi.pypi-dependencies]
 python-nix-template = { path = ".", editable = true }
@@ -77,23 +70,11 @@ lint        = { features = ["lint"], solve-group = "default" }
 test        = { features = ["test"], solve-group = "default" }
 types       = { features = ["types"], solve-group = "default" }
 
-[tool.pixi.feature.test.tasks]
-test = "pytest"
-
-[tool.pixi.feature.lint.tasks]
-lint       = "ruff check --fix src/"
-lint-check = "ruff check src/"
-
-[tool.pixi.feature.types.tasks]
-types = "pyright src/"
-
 [tool.pixi.package]
 name    = "python-nix-template"
 version = "0.1.0"
 
 [tool.pixi.package.run-dependencies]
-beartype   = ">=0.19.0"
-expression = ">=5.5.0"
 
 [tool.pixi.package.build]
 backend = { name = "pixi-build-python", version = "0.1.*" }
@@ -102,10 +83,12 @@ channels = [
   "https://prefix.dev/pixi-build-backends",
 ]
 
-[tool.hatch.build.targets.wheel]
-packages = ["src/python_nix_template"]
+[tool.pixi.package.host-dependencies]
+hatchling = "*"
 
 [tool.pytest.ini_options]
+# Add source locations to pytest-cov e.g.:
+# --cov=packages/pnt-functional/src/pnt_functional/
 addopts = """
 -rA
 --xdoctest
@@ -116,6 +99,8 @@ addopts = """
 """
 log_level = "INFO"
 testpaths = [
+  # Add test locations e.g.:
+  # "packages/pnt-functional/src/pnt_functional/tests",
   "src/python_nix_template/tests",
 ]
 

packages/pnt-functional/src/pnt_functional/tests/test_main.py

@@ -1,9 +1,2 @@
-"""A Python package template using Nix and uv."""
-
-__version__ = "0.1.0"
-
-from python_nix_template.main import greet
-
-__all__ = [
-    "greet",
-]
+def main() -> None:
+    print("Hello from python-nix-template!")

pyproject.toml

@@ -0,0 +1 @@
+# This file is intentionally left empty to mark the directory as a Python package

src/python_nix_template/__init__.py

@@ -1,52 +1,14 @@
-"""Tests for main module."""
+from python_nix_template import main
 
-from expression import Error, Ok
 
-from python_nix_template.main import create_greeting, greet, validate_name
+def test_main(capsys):
+    """Test that the main function prints the expected greeting."""
+    main()
+    captured = capsys.readouterr()
+    assert "Hello from python-nix-template!" in captured.out
 
 
-def test_validate_name_valid():
-    """Test name validation with valid input."""
-    assert validate_name("alice") == Ok("Alice")
-    assert validate_name(" bob ") == Ok("Bob")
-
-
-def test_validate_name_invalid():
-    """Test name validation with invalid input."""
-    assert validate_name("") == Error("Name cannot be empty")
-    assert validate_name(" ") == Error("Name cannot be empty")
-    assert validate_name("a") == Error("Name must be at least 2 characters")
-    assert validate_name("x" * 51) == Error("Name must be at most 50 characters")
-
-
-def test_create_greeting_valid():
-    """Test greeting creation with valid input."""
-    assert create_greeting("alice") == Ok("Hello, Alice!")
-    assert create_greeting(" bob ") == Ok("Hello, Bob!")
-
-
-def test_create_greeting_invalid():
-    """Test greeting creation with invalid input."""
-    result = create_greeting("")
-    assert result.is_error()
-
-    result = create_greeting("a")
-    assert result.is_error()
-
-
-def test_greet_default():
-    """Test greet function with default argument."""
-    result = greet()
-    assert result == "Hello, World!"
-
-
-def test_greet_custom():
-    """Test greet function with custom name."""
-    result = greet("Alice")
-    assert result == "Hello, Alice!"
-
-
-def test_greet_invalid():
-    """Test greet function with invalid input."""
-    result = greet("a")
-    assert result == "This is supposed to be a hello world program, but it failed."
+def test_main_returns_none():
+    """Test that the main function returns None."""
+    result = main()
+    assert result is None