Skip to content

Latest commit

 

History

History
37 lines (25 loc) · 1.35 KB

README.md

File metadata and controls

37 lines (25 loc) · 1.35 KB

SOAG: Son Of A Git

SOAG is a repository management toolkit designed for Git. It provides a set of tools to facilitate the management of Git repositories.

Usage

GitHub or GitLab access tokens are necessary for separating repos. To configure access tokens use the config option:

soag config --set-github-token <YOUR-ACCESS-TOKEN>
soag config --set-gitlab-token <YOUR-ACCESS-TOKEN>

Or use the interactive setup:

soag config -i

To separate a target into its own repository, use the following command:

soag separate <target> --github <NAME-YOUR-REPO>
soag separate <target> --gitlab <NAME-YOUR-REPO>
  • The .soagconfig file is needed
  • <target>: The target directory or repository to be separated.
  • --github/--gitlab: (FLAG): This flags are to specify which remote SCM to use
  • repo-name: The name to use for the creation of the new repo

This will create a new GitHub repository with the provided name and will use it as a subtree of the current project.

Benefits

  • Integrity in History: Every step of the repository changes is preserved, ensuring integrity in the history.
  • Preservation of References: Users can work on the separated repository from the local (parent) repository or in isolation. References to each other are maintained, allowing for efficient collaboration and tracking of isolated histories.