https://github.com/marcxjo/git-workspace-extension
Track repository collections for advanced processing
https://github.com/marcxjo/git-workspace-extension
bash bash-script git git-extension git-plugin shell-script
Last synced: about 2 months ago
JSON representation
Track repository collections for advanced processing
- Host: GitHub
- URL: https://github.com/marcxjo/git-workspace-extension
- Owner: marcxjo
- Created: 2024-07-19T12:15:27.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-12T15:46:43.000Z (over 1 year ago)
- Last Synced: 2025-12-13T05:29:27.926Z (6 months ago)
- Topics: bash, bash-script, git, git-extension, git-plugin, shell-script
- Language: Shell
- Homepage:
- Size: 5.86 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Git Workspace Extension
=
Track repositories as collections for advanced handling
-
`git-workspace` adds configuration settings to your global Git configuration
* How do I use this extension?
The command's syntax is kept as simple as possible, exposing a few properties
through OOP-style getters and setters along with appropriate verbs to act on
those properties (much like OOP-style methods).
Note that the workspace name parameter (denoted below as `WORKSPACE`) is
optional for all commands exposed by `git-workspace`. When `WORKSPACE` is
omitted from the command line, it resolves to `default`.
Use
```
git workspace add [WORKSPACE]
```
to create a new default workspace `WORKSPACE` (you'll need to add your own
settings after creation!).
Use
```
git workspace [WORKSPACE] [git-commands]
```
to perform any standard Git operation with access to the environment variable
`GIT_WORKSPACE`.
Use
```
git workspace [WORKSPACE] root [get|set]
```
to get or set the root directory associated with `WORKSPACE`. For the purposes
of `git-workspace`, all Git repositories under the workspace's root directory,
are considered to belong to the workspace.
Use
```
git workspace [WORKSPACE] cache [get|set]
```
to get or set the location of the cache file associated with `WORKSPACE`. This
file is used to list all repositories which belong to the workspace.
Use
```
git workspace [WORKSPACE] cache update
```
to regenerate the cache file associated with `WORKSPACE`.
* How does this plugin interact with other Git commands/extensions?
This intent is to enable chaining `git-workspace` with all supported Git
commands. Note that this may provide difficult for more complex or rigid
extensions and may not be useful for all Git commands. At this early stage,
support for `git clone` and `git config` are prioritized.
* What's on the roadmap?
The following:
* Makefile support (e.g., to enable build-time configuration of script-internal
variables)
* I _may_ go with Meson support for easier maintainability, but that seems
hard to justify for such a small project
* documented example use cases