glreview 0.1.0__tar.gz

glreview-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.pyc
+*.egg-info/
+_version.py
+*.egg
+dist/
+build/
+.eggs/

glreview-0.1.0/PKG-INFO

@@ -0,0 +1,211 @@
+Metadata-Version: 2.4
+Name: glreview
+Version: 0.1.0
+Summary: GitLab code review tracking for scientific software
+Author-email: Chad Hanna <chad.hanna@ligo.org>
+License: MIT
+Project-URL: Homepage, https://git.ligo.org/chad.hanna/glreview
+Project-URL: Documentation, https://git.ligo.org/chad.hanna/glreview
+Project-URL: Repository, https://git.ligo.org/chad.hanna/glreview
+Project-URL: Issues, https://git.ligo.org/chad.hanna/glreview/-/issues
+Keywords: gitlab,code-review,scientific-software,ci-cd
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0
+Requires-Dist: jinja2>=3.0
+Requires-Dist: python-gitlab>=4.0
+Requires-Dist: tomli>=2.0; python_version < "3.11"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: isort; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+
+# glreview
+
+GitLab code review tracking for scientific software.
+
+## Features
+
+- **Track review status** of source modules with git commit precision
+- **GitLab integration** - creates issues, verifies completion, closes on cancel
+- **AI-assisted review** - Claude Code integration for automated analysis
+- **Change detection** - warns if code changes during review
+- **Module analysis** - shows classes/functions in review issues
+- **Customizable templates** - Jinja2-based issue templates
+- **CI-friendly** - exit codes for automated checks
+- **Priority rules** - pattern-based priority assignment
+
+## Installation
+
+```bash
+pip install glreview
+```
+
+## GitLab Authentication
+
+For GitLab integration, set an environment variable:
+
+```bash
+export GITLAB_PRIVATE_TOKEN=glpat-xxxxxxxxxxxx
+
+# For self-hosted GitLab
+export GITLAB_URL=https://gitlab.example.com
+```
+
+In CI pipelines, `CI_JOB_TOKEN` is used automatically.
+
+## Quick Start
+
+```bash
+# Initialize in your project
+glreview init
+
+# Check status
+glreview status
+
+# Start a review (creates GitLab issue)
+glreview start src/mymodule/core.py --assignee @reviewer
+
+# After review is complete (issue closed)
+glreview signoff src/mymodule/core.py
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `glreview init` | Initialize (idempotent - safe to re-run) |
+| `glreview status` | Show review progress and module status |
+| `glreview start PATH` | Start a review (creates GitLab issue) |
+| `glreview signoff PATH` | Sign off on a completed review |
+| `glreview cancel PATH` | Cancel or restart a review |
+| `glreview claude-review PATH` | Run AI-assisted review with Claude |
+| `glreview report` | Generate coverage report (markdown/json/badge) |
+| `glreview list` | List all modules |
+| `glreview reviewers` | List available reviewers |
+| `glreview check` | CI check for changes |
+| `glreview sync` | Sync registry with filesystem |
+| `glreview ci-config` | Print recommended GitLab CI configuration |
+
+## Review Lifecycle
+
+```
+  ┌─────────────┐
+  │ needs_review│◄──────────────────┐
+  └──────┬──────┘                   │
+         │ start                    │ cancel
+         ▼                          │
+  ┌─────────────┐                   │
+  │ in_progress │───────────────────┤
+  └──────┬──────┘                   │
+         │ signoff                  │
+         ▼                          │
+  ┌─────────────┐   code changes    │
+  │  reviewed   │───────────────────┘
+  └─────────────┘   (re-review)
+```
+
+**Key behaviors:**
+- `signoff` warns if file changed during review (use `--acknowledge` to proceed)
+- `cancel` closes the GitLab issue by default (use `--leave-open` to skip)
+- `cancel --restart` keeps the issue open and updates the start commit
+
+## AI-Assisted Review
+
+Use Claude Code for automated code analysis:
+
+```bash
+# Run review (requires claude CLI)
+glreview claude-review src/module.py
+
+# Post findings to GitLab issue
+glreview claude-review src/module.py --post
+
+# Preview prompt without running
+glreview claude-review src/module.py --dry-run
+```
+
+Reviews check: correctness, scientific rigor, robustness, and maintainability.
+Large files are automatically chunked.
+
+## Configuration
+
+Add to `pyproject.toml`:
+
+```toml
+[tool.glreview]
+sources = ["src/**/*.py"]
+exclude = ["**/_version.py", "**/test_*.py"]
+
+# Custom issue template (optional)
+issue_template = ".glreview/issue_template.md"
+
+# Priority rules (first match wins)
+[[tool.glreview.priority]]
+pattern = "src/**/core.py"
+level = "critical"
+reviewers_required = 2
+
+[[tool.glreview.priority]]
+pattern = "src/**/*.py"
+level = "medium"
+reviewers_required = 1
+```
+
+## CI Integration
+
+glreview can automatically sync and report on every push:
+
+```bash
+# Print full CI configuration
+glreview ci-config
+```
+
+**Basic setup** - sync registry and generate coverage on MRs and main:
+
+```yaml
+review-sync:
+  script:
+    - pip install glreview
+    - glreview report --sync --commit -m "chore: update review registry [skip ci]"
+    - git push  # Push updated registry
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+```
+
+**Release gate** - require 100% coverage for releases:
+
+```yaml
+release-gate:
+  script:
+    - pip install glreview
+    - glreview report --format json | python -c "
+        import sys,json
+        c = json.load(sys.stdin)['coverage_pct']
+        sys.exit(0 if c == 100 else 1)
+      "
+  rules:
+    - if: $CI_COMMIT_TAG
+```
+
+Run `glreview ci-config` for complete configuration with proper git push setup.
+
+## License
+
+MIT

glreview-0.1.0/README.md

@@ -0,0 +1,174 @@
+# glreview
+
+GitLab code review tracking for scientific software.
+
+## Features
+
+- **Track review status** of source modules with git commit precision
+- **GitLab integration** - creates issues, verifies completion, closes on cancel
+- **AI-assisted review** - Claude Code integration for automated analysis
+- **Change detection** - warns if code changes during review
+- **Module analysis** - shows classes/functions in review issues
+- **Customizable templates** - Jinja2-based issue templates
+- **CI-friendly** - exit codes for automated checks
+- **Priority rules** - pattern-based priority assignment
+
+## Installation
+
+```bash
+pip install glreview
+```
+
+## GitLab Authentication
+
+For GitLab integration, set an environment variable:
+
+```bash
+export GITLAB_PRIVATE_TOKEN=glpat-xxxxxxxxxxxx
+
+# For self-hosted GitLab
+export GITLAB_URL=https://gitlab.example.com
+```
+
+In CI pipelines, `CI_JOB_TOKEN` is used automatically.
+
+## Quick Start
+
+```bash
+# Initialize in your project
+glreview init
+
+# Check status
+glreview status
+
+# Start a review (creates GitLab issue)
+glreview start src/mymodule/core.py --assignee @reviewer
+
+# After review is complete (issue closed)
+glreview signoff src/mymodule/core.py
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `glreview init` | Initialize (idempotent - safe to re-run) |
+| `glreview status` | Show review progress and module status |
+| `glreview start PATH` | Start a review (creates GitLab issue) |
+| `glreview signoff PATH` | Sign off on a completed review |
+| `glreview cancel PATH` | Cancel or restart a review |
+| `glreview claude-review PATH` | Run AI-assisted review with Claude |
+| `glreview report` | Generate coverage report (markdown/json/badge) |
+| `glreview list` | List all modules |
+| `glreview reviewers` | List available reviewers |
+| `glreview check` | CI check for changes |
+| `glreview sync` | Sync registry with filesystem |
+| `glreview ci-config` | Print recommended GitLab CI configuration |
+
+## Review Lifecycle
+
+```
+  ┌─────────────┐
+  │ needs_review│◄──────────────────┐
+  └──────┬──────┘                   │
+         │ start                    │ cancel
+         ▼                          │
+  ┌─────────────┐                   │
+  │ in_progress │───────────────────┤
+  └──────┬──────┘                   │
+         │ signoff                  │
+         ▼                          │
+  ┌─────────────┐   code changes    │
+  │  reviewed   │───────────────────┘
+  └─────────────┘   (re-review)
+```
+
+**Key behaviors:**
+- `signoff` warns if file changed during review (use `--acknowledge` to proceed)
+- `cancel` closes the GitLab issue by default (use `--leave-open` to skip)
+- `cancel --restart` keeps the issue open and updates the start commit
+
+## AI-Assisted Review
+
+Use Claude Code for automated code analysis:
+
+```bash
+# Run review (requires claude CLI)
+glreview claude-review src/module.py
+
+# Post findings to GitLab issue
+glreview claude-review src/module.py --post
+
+# Preview prompt without running
+glreview claude-review src/module.py --dry-run
+```
+
+Reviews check: correctness, scientific rigor, robustness, and maintainability.
+Large files are automatically chunked.
+
+## Configuration
+
+Add to `pyproject.toml`:
+
+```toml
+[tool.glreview]
+sources = ["src/**/*.py"]
+exclude = ["**/_version.py", "**/test_*.py"]
+
+# Custom issue template (optional)
+issue_template = ".glreview/issue_template.md"
+
+# Priority rules (first match wins)
+[[tool.glreview.priority]]
+pattern = "src/**/core.py"
+level = "critical"
+reviewers_required = 2
+
+[[tool.glreview.priority]]
+pattern = "src/**/*.py"
+level = "medium"
+reviewers_required = 1
+```
+
+## CI Integration
+
+glreview can automatically sync and report on every push:
+
+```bash
+# Print full CI configuration
+glreview ci-config
+```
+
+**Basic setup** - sync registry and generate coverage on MRs and main:
+
+```yaml
+review-sync:
+  script:
+    - pip install glreview
+    - glreview report --sync --commit -m "chore: update review registry [skip ci]"
+    - git push  # Push updated registry
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+```
+
+**Release gate** - require 100% coverage for releases:
+
+```yaml
+release-gate:
+  script:
+    - pip install glreview
+    - glreview report --format json | python -c "
+        import sys,json
+        c = json.load(sys.stdin)['coverage_pct']
+        sys.exit(0 if c == 100 else 1)
+      "
+  rules:
+    - if: $CI_COMMIT_TAG
+```
+
+Run `glreview ci-config` for complete configuration with proper git push setup.
+
+## License
+
+MIT

glreview-0.1.0/pyproject.toml

@@ -0,0 +1,92 @@
+[build-system]
+requires = ["setuptools>=61.0", "setuptools_scm[toml]>=6.2"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "glreview"
+dynamic = ["version"]
+description = "GitLab code review tracking for scientific software"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+authors = [
+    {name = "Chad Hanna", email = "chad.hanna@ligo.org"},
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Quality Assurance",
+    "Topic :: Software Development :: Version Control :: Git",
+]
+keywords = ["gitlab", "code-review", "scientific-software", "ci-cd"]
+dependencies = [
+    "click>=8.0",
+    "jinja2>=3.0",
+    "python-gitlab>=4.0",
+    "tomli>=2.0;python_version<'3.11'",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov",
+    "black",
+    "isort",
+    "flake8",
+    "mypy",
+]
+
+[project.scripts]
+glreview = "glreview.cli:main"
+
+[project.urls]
+Homepage = "https://git.ligo.org/chad.hanna/glreview"
+Documentation = "https://git.ligo.org/chad.hanna/glreview"
+Repository = "https://git.ligo.org/chad.hanna/glreview"
+Issues = "https://git.ligo.org/chad.hanna/glreview/-/issues"
+
+[tool.setuptools_scm]
+write_to = "src/glreview/_version.py"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+glreview = ["templates/*"]
+
+[tool.black]
+line-length = 88
+
+[tool.isort]
+profile = "black"
+
+[tool.mypy]
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-v"
+
+# Example glreview configuration (for self-hosting)
+[tool.glreview]
+sources = ["src/**/*.py"]
+exclude = ["**/_version.py"]
+registry = "review_registry.json"
+
+[[tool.glreview.priority]]
+pattern = "src/glreview/cli.py"
+level = "critical"
+reviewers_required = 2
+
+[[tool.glreview.priority]]
+pattern = "src/glreview/*.py"
+level = "high"
+reviewers_required = 1

glreview-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

glreview-0.1.0/src/glreview/__init__.py

@@ -0,0 +1,8 @@
+"""glreview - GitLab code review tracking for scientific software."""
+
+try:
+    from ._version import version as __version__
+except ImportError:
+    __version__ = "0.0.0.dev0"
+
+__all__ = ["__version__"]

glreview-0.1.0/src/glreview/_version.py

@@ -0,0 +1,34 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
+else:
+    VERSION_TUPLE = object
+    COMMIT_ID = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
+
+__version__ = version = '0.1.0'
+__version_tuple__ = version_tuple = (0, 1, 0)
+
+__commit_id__ = commit_id = 'gbb35870ad'