Files

T

sysadmin dd6f1308c1 feat: add mirror_refs.sh for bidirectional ref syncing

- mirror_refs.sh: additive branch+tag mirroring between dadeschools (HTTPS)
  and prgs (SSH:2222). Dry-run default, --apply to execute, --force for
  diverged branches. Uses bare repo cache for isolation.
- test_mirror_refs.py: flag parsing, safety defaults, brace-delimited refspec
  validation, and local bare-repo integration tests (FF detection, branch/tag
  comparison).
- README.md: document mirror_refs.sh, test suite, and multi-instance auth.

2026-06-21 18:08:53 -04:00

3.5 KiB

Raw Blame History

Gitea Tools

A collection of Python and Bash scripts to automate interactions with Gitea instances.

Supported Instances

Remote	Host	Org / Repo
`dadeschools`	`gitea.dadeschools.net`	`Contractor / Timesheet`
`prgs`	`gitea.prgs.cc`	`Scaled-Tech-Consulting / Timesheet`

Authentication

Scripts extract credentials from the macOS keychain automatically — no tokens on the command line.

dadeschools — HTTPS via git credential fill (SSH:2222 is flaky)
prgs — SSH via ssh://git@gitea-ssh.prgs.cc:2222 (SSH is reliable here)

Ensure you've logged in via Git over HTTPS at least once so the keychain caches your credentials.

Available Scripts

Script	Description
`create_issue.py`	Create an issue (`--remote`, `--title`, `--body`, `--body-file`)
`create_pr.py`	Open a Pull Request (`--remote`, `--title`, `--head`, `--base`)
`close_issue.sh`	Close a specific issue (dadeschools only)
`mark_issue.sh`	Claim/release an issue via `status:in-progress` label
`manage_labels.py`	Create label set and apply label mappings (`--dry` to preview)
`mirror_refs.sh`	Mirror branches + tags between dadeschools ⇄ prgs

Quick Examples

# Create an issue
./create_issue.py --title "Fix PDF output" --body "Blank on Safari"

# Create an issue on the prgs instance
./create_issue.py --remote prgs --title "Add tests" --body-file description.md

# Create a PR
./create_pr.py --title "feat: add validation" --head feat/validation --body "Closes #12"

# Close issue #5
./close_issue.sh 5

# Claim an issue before working on it
./mark_issue.sh 10 start

# Release when done
./mark_issue.sh 10 done

# Mirror refs (dry-run by default)
./mirror_refs.sh

# Actually push the refs
./mirror_refs.sh --apply

Use --help on any Python script or shell script for full usage details.

Mirror Refs

mirror_refs.sh keeps branches and tags in sync between dadeschools and prgs:

Additive only — never deletes branches or tags
Dry-run by default — pass --apply to actually push
Divergence protection — shared branches that have diverged are skipped with a warning; pass --force to override
Uses a bare repo cache in /tmp/gitea-mirror-Timesheet for isolation
Won't auto-close or merge anything — just ref mirroring

Tests

Run the full test suite:

python3 -m pytest tests/ -v

Test file	Covers
`test_create_issue.py`	Arg parsing, remote resolution, payload, auth, errors
`test_create_pr.py`	Arg parsing, remote resolution, payload, auth, errors
`test_credentials.py`	`get_credentials()` parsing edge cases
`test_manage_labels.py`	Label create/skip, dry run, mapping, constant validation
`test_shell_scripts.py`	`close_issue.sh` + `mark_issue.sh` arg validation
`test_mirror_refs.py`	Flags, safety defaults, local integration tests

All tests mock network and keychain access — no real API calls are made.

3.5 KiB Raw Blame History