wrolpi/modules/repos/errors.py
lrnselfreliance 93d878952c
Add a Repos module that mirrors git repositories (#783)
Repos keeps local mirrors of git repositories, cloned over https and kept up to date on a schedule.

- A Repo is a Collection (kind='repo') plus a `repository` row.  The new `git` downloader clones it, then updates it
  (weekly by default, or Never: the clone is kept as it is and only updated on request).
- Repos are saved in `repos/<tag>/<name>` (the Repos Directory, ignored by default) or a directory the user chooses.
  An existing clone can be imported where it is.  repos.yaml is the source of truth.
- A GitHub-like page shows each repo's README, files, and history, with a ZIP download.  READMEs are searchable
  under the global search's Other tab.
- git is hardened against hostile repos and configs: https only, pinned addresses with no private addresses (for the
  repo and its submodules), sanitized configs, no hooks or links, and only clones WROLPi made or imported are
  updated.
- Tagging a Repo moves its clone as one directory.  Repo changes wait for repos.yaml to be imported at startup.
- The file mover groups unindexed files with no primary file as one FileGroup, and never replaces a file at the
  destination.  A failed tag move restores the Collection's tag.  A Collection's directory cannot leave the media
  directory.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 15:16:58 -06:00

21 lines
488 B
Python

from http import HTTPStatus
from wrolpi.errors import APIError
class UnknownRepo(APIError):
code = 'UNKNOWN_REPO'
summary = 'Unable to find the repo'
status_code = HTTPStatus.NOT_FOUND
class InvalidRepo(APIError):
code = 'INVALID_REPO'
summary = 'The repo is invalid'
status_code = HTTPStatus.BAD_REQUEST
class RepoConflict(APIError):
code = 'REPO_CONFLICT'
summary = 'The repo conflicts with an existing repo'
status_code = HTTPStatus.CONFLICT