preventive breaking changes with pandas v3

Author: fdobad

BUILDING.md

@@ -18,27 +18,33 @@ pip install -e .
 
 #### Manual Steps
 ```bash
-# clean (-n is dry-run, remove to delete)
+# Ensure working tree is clean
+git status
+
+# Clean (-n is dry-run, remove to delete)
 git clean -dfX -n
-git clean -dfX
+git clean -dfX      # X removes only .gitignored files
 git clean -dfx -n
-git clean -dfx
-
-# tags check
-git tag
+git clean -dfx      # x removes all untracked (danger!)
 
-# Create tags on the main branch!
-# tag create locally & upload
-git tag -a v0.3.12 -m 'minor future deprecation fix' && git push origin v0.3.12
+# Calculate the next tag
+git tag --sort=-version:refname -n | head
+python -m setuptools_scm
 
-# delete tag locally & upstream
-git tag --delete v0.3.12 && git push --delete origin v0.3.12
+# Create tag LOCALLY first (don't push yet)
+git tag -a v0.3.13 -m 'preventive breaking changes with pandas v3'
 
-# view calculated version to check is not dirty
+# NOW check version is clean
 python -m setuptools_scm
 
-# build : creates `dist` with .whl & tar.gz files
+# Test build locally: creates `dist` with .whl & tar.gz files
 python -m build
+
+# Push tag (triggers GitHub Actions workflow for PyPI publishing)
+git push origin v0.3.13
+
+# [if failure] Undo delete tag locally & upstream
+git tag --delete v0.3.13 && git push --delete origin v0.3.13
 ```
 
 ### Documentation

pyproject.toml

@@ -27,7 +27,7 @@ dependencies = [
     "networkx>=2.7",
     "numpy<2; python_version < '3.11'",
     "numpy; python_version >= '3.11'",
-    "pandas",
+    "pandas<3.0.0",
     "pyomo",
     "scikit-learn",
     "scipy",