Skip to main content

Enforce a triangular Git workflow. If this is not possible, explain why.

Project description

Samosa (समोसा)

Enforce a triangular Git workflow. If this is not possible, explain why.

Usage

Usage: samosa [OPTIONS] COMMAND [ARGS]...

  Enforce a triangular Git workflow. If this is not possible, explain why.

Options:
  --help  Show this message and exit.

Commands:
  add       Add URL as remote repository named REMOTE.
  checkout  Check out a new or existing BRANCH.
  clone     Clone remote URL as a local repository.
  commit    Commit changes with a signed MESSAGE.
  diff      Compare with upstream.
  fetch     Fetch all remote updates without changing local files.
  force     Force-push changes to remote branch.
  graph     Show detailed commit graph.
  init      Initialise an empty local repository.
  log       Show streamlined commit log.
  pull      Pull changes from remote.
  push      Push changes to remote branch.
  status    Inspect and repair local repository.

Samosa will always prepare a repository before attempting a command. If all checks pass, the command is executed. Otherwise, Samosa will make a suggestion and terminate with exit code 1 (error).

Samosa standard

The following checks should be true:

  • In a Git repository
  • There is a remote named "origin"
  • There is a remote named "upstream"
  • Author name and email are set, and are not invalid
  • The default push target is "origin:current"
  • The pre-commit hook exists and is executable
  • There is a local branch named "main"
  • The main branch tracks "upstream/main"

See WORKFLOW.md for a detailed workflow that results in a samosa standard repository.

Suggestions

If you aren't forking, make origin and upstream equal

Forking a project may not be feasible or possible. In this case, set upstream and origin to the same URL.

(Forks may be disallowed for confidential projects. Forking may not be useful for solo maintainers.)

Out of scope

  • Detecting/supporting other workflows.
  • Oh sh*, git!
  • Non-Python packaging. Requires git and libgit2.

Acknowledgements

WORKFLOW.md and the associated pre-commit bash script are derived from Aaron Bull Schaefer's excellent Git Triangular Workflow. License details are included in the relevant files.

Additional references

Alternatives

Development environment

Install prerequisites

  • Python 3.10
  • pdm
  • make
  • pipx (optional, required for make install-source)

Instructions

  • Fork the upstream repository.
  • git clone [fork-url]
  • cd [project-folder]
  • Run make develop to initialise your development environment.

You can use any text editor or IDE that supports virtualenv / pdm. See the Makefile for toolchain details.

Please make test and make lint before submitting changes.

Make targets

USAGE: make [target]

help    : Show this message.
develop : Set up Python development environment.
run     : Run from source.
clean   : Remove all build artefacts.
test    : Run tests and generate coverage report.
lint    : Fix or warn about linting errors.
build   : Clean, test, lint, then generate new build artefacts.
publish : Upload build artefacts to PyPI.
install-source : Install source as a local Python application.

Sharing and contributions

Samosa (समोसा)
https://lofidevops.neocities.org
Copyright 2022 David Seaward and contributors
SPDX-License-Identifier: AGPL-3.0-or-later

Shared under AGPL-3.0-or-later. We adhere to the Contributor Covenant 2.1, and certify origin per DCO 1.1 with a signed-off-by line. Contributions under the same terms are welcome.

Submit security and conduct issues as private tickets. Sign commits with git commit --signoff. For a software bill of materials run reuse spdx. For more details see CONDUCT, COPYING and CONTRIBUTING.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

samosa-0.4.0.tar.gz (37.5 kB view details)

Uploaded Source

Built Distribution

samosa-0.4.0-py3-none-any.whl (41.3 kB view details)

Uploaded Python 3

File details

Details for the file samosa-0.4.0.tar.gz.

File metadata

  • Download URL: samosa-0.4.0.tar.gz
  • Upload date:
  • Size: 37.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: pdm/2.10.0 CPython/3.10.12

File hashes

Hashes for samosa-0.4.0.tar.gz
Algorithm Hash digest
SHA256 5f92b6668b16cf77bc1bfbf513e579ec4f4404dd259593c068c75f4544004d76
MD5 b3f0d382a2ca942736b3eab78a087428
BLAKE2b-256 25b21263334ebb8a00d1a031b9bac68650150e25b44333016dc5aba618a304e7

See more details on using hashes here.

Provenance

File details

Details for the file samosa-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: samosa-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 41.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: pdm/2.10.0 CPython/3.10.12

File hashes

Hashes for samosa-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6ac71617f7b36421df9521648c6ea36022f77638907781291b85b50076695762
MD5 ad11dd48aaf8365f7519775c3dd94e1e
BLAKE2b-256 9135c4d1bf788e7e73e42567ee15560b3edebeaa5412d3c985d604741f8d798a

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page