Compare commits
2 changed files with 7 additions and 78 deletions
|
|
@ -1,11 +1,6 @@
|
||||||
# Git Repo Registration
|
# Git Repo Registration
|
||||||
|
|
||||||
- all commands support `-debug`
|
- all commands support `-debug`
|
||||||
- at its simplest level these commands allow you to register a git repo against a simple name, and provide the ability to quickly pushd to a location
|
|
||||||
|
|
||||||
Most `*-GitRepoRegistration` commands are expected to be run within a folder that is contained within a git repo. The only exceptions to this are any verbs that list information or change locations such as `Get-`, `Show-`, `Push-`, `Pop-`.
|
|
||||||
|
|
||||||
Any exceptions to behaviours are outlined within the relevant command section
|
|
||||||
|
|
||||||
## New-GitRepoRegistration
|
## New-GitRepoRegistration
|
||||||
|
|
||||||
|
|
@ -15,10 +10,8 @@ Creates a new registration for the current directory, optionally registering aga
|
||||||
|
|
||||||
Name registrations are _not_ case-sensitive, so registrations can be made using different cases for the same location, and multiple registrations can exist for the git repository.
|
Name registrations are _not_ case-sensitive, so registrations can be made using different cases for the same location, and multiple registrations can exist for the git repository.
|
||||||
|
|
||||||
If `New-GitRepoRegistration` is used in 2 repositories with the same name but different locations, the 2nd call will fail as a registration will already exist by name.
|
|
||||||
|
|
||||||
```pwsh
|
```pwsh
|
||||||
# Default registration without a name within a folder in a git repo
|
# Default registration
|
||||||
PS D:/Repos/Project-a> New-GitRepoRegistration -debug
|
PS D:/Repos/Project-a> New-GitRepoRegistration -debug
|
||||||
DEBUG: Checking if current directory is a git repository...
|
DEBUG: Checking if current directory is a git repository...
|
||||||
DEBUG: ...location is a git repo!
|
DEBUG: ...location is a git repo!
|
||||||
|
|
@ -62,67 +55,10 @@ The current branch is cached for 15 minutes for performance reasons so it may no
|
||||||
|
|
||||||
`Show-GitRepoRegistration -Name string [-NoStack|-NoPushLocation]`
|
`Show-GitRepoRegistration -Name string [-NoStack|-NoPushLocation]`
|
||||||
|
|
||||||
Changes your location to the location of the git repo registered by the given `-Name` and your original location will be preserved and can be returned to at any time via `Pop-Location`/`Popd`. By default, this command is identical to calling
|
Changes your location to the location of the git repo registered by the given `-Name`. If used without `-NoStack` or its alias `-NoPushLocation`, your original location will be preserved and can be returned to at any time via `Pop-Location`/`Popd`.
|
||||||
`pushd [repository directory]`.
|
|
||||||
|
|
||||||
Using `-NoStack`/`-NoPushLocation` will not push your current location onto the stack, and will behave the same as `cd [repository directory]`/`Set-Location [repository directory]`.
|
Using `-NoStack`/`-NoPushLocation` will not push your current location onto the stack, and will behave the same as `cd`/`Set-Location`.
|
||||||
|
|
||||||
```pwsh
|
|
||||||
PS C:/> Show-GitRepoRegistration Project-a
|
|
||||||
PS D:/Repos/Project-a> Get-Location -stack
|
|
||||||
|
|
||||||
Path
|
|
||||||
----
|
|
||||||
C:\
|
|
||||||
|
|
||||||
PS D:/Repos/Project-a> cd ./build
|
|
||||||
PS D:/Repos/Project-a/Build> Get-Location -stack
|
|
||||||
|
|
||||||
Path
|
|
||||||
----
|
|
||||||
C:\
|
|
||||||
|
|
||||||
PS D:/Repos/Project-a/Build> popd
|
|
||||||
PS C:/>
|
|
||||||
```
|
|
||||||
|
|
||||||
## Remove-GitRepoRegistration
|
## Remove-GitRepoRegistration
|
||||||
|
|
||||||
`Remove-GitRepoRegistration [-Name string]`
|
`Remove-GitRepoRegistration [-Name string]`
|
||||||
|
|
||||||
Removes a repo registration by the given name, or if no name is specified, attempts to remove the git repo registered by resolving the git repo.
|
|
||||||
|
|
||||||
If `Name` is not provided then the command must be run in a location that is a git repo and the registration to remove will use the parent git repo folder name. If `Name` _is_ provided this command can be executed from any location.
|
|
||||||
|
|
||||||
```pwsh
|
|
||||||
# Default registration without a name within a folder in a git repo
|
|
||||||
PS D:/Repos/Project-a> New-GitRepoRegistration
|
|
||||||
|
|
||||||
# List registrations
|
|
||||||
PS D:/Repos/Project-a> Get-GitRepoRegistration
|
|
||||||
|
|
||||||
Name Location CurrentBranch
|
|
||||||
---- -------- -------------
|
|
||||||
Project-a D:/Repos/Project-a main
|
|
||||||
Test-Repo D:/Repos/Project-a main
|
|
||||||
|
|
||||||
# Remove a registration from within a git repo
|
|
||||||
PS D:/Repos/Project-a> Remove-GitRepoRegistration
|
|
||||||
# No output indicates successful removal
|
|
||||||
|
|
||||||
PS D:/Repos/Project-a> Get-GitRepoRegistration
|
|
||||||
|
|
||||||
Name Location CurrentBranch
|
|
||||||
---- -------- -------------
|
|
||||||
Test-Repo D:/Repos/Project-a main
|
|
||||||
|
|
||||||
# Duplicate calls error if there is no registration
|
|
||||||
PS D:/Repos/Project-a> Remove-GitRepoRegistration
|
|
||||||
Remove-GitRepoRegistration: No registration exists for 'Project-a'.
|
|
||||||
|
|
||||||
# Debug output via named argument
|
|
||||||
PS D:/Repos/Project-a> Remove-GitRepoRegistration -name Test-Repo -debug
|
|
||||||
DEBUG: Checking if current directory is a git repository...
|
|
||||||
DEBUG: ...location is a git repo!
|
|
||||||
DEBUG: Removed Test-Repo.
|
|
||||||
```
|
|
||||||
|
|
@ -19,18 +19,11 @@ public class RemoveGitRepoRegistrationCommand : PSCmdlet
|
||||||
{
|
{
|
||||||
GitManager.SetDebugWriter(WriteDebug);
|
GitManager.SetDebugWriter(WriteDebug);
|
||||||
|
|
||||||
// If we aren't given a value for the Name argument, default behaviour is to attempt to remove a registration
|
var repoFolder = GitManager.IsGitRepo(SessionState.Path.CurrentLocation.Path);
|
||||||
// by the current git repo folder name for the current location.
|
|
||||||
// If we have a name, don't bother testing for a git repo, just attempt to remove the registration by name
|
|
||||||
// regardless of where we're being called from
|
|
||||||
var registrationNameToRemove = string.IsNullOrEmpty(Name)
|
|
||||||
? GitManager.IsGitRepo(SessionState.Path.CurrentLocation.Path).Folder
|
|
||||||
: Name;
|
|
||||||
|
|
||||||
GitManager.Instance.UnregisterRepo(registrationNameToRemove);
|
|
||||||
|
|
||||||
// Removing a registration works similar to registering a new one - we either remove by exact name, or by
|
// Removing a registration works similar to registering a new one - we either remove by exact name, or by
|
||||||
// the folder if no name is given (so a user can remove a registration from a git repo they're currently in)
|
// the folder if no name is given (so a user can remove a registration from a git repo they're currently in)
|
||||||
|
GitManager.Instance.UnregisterRepo(Name ?? repoFolder.Folder);
|
||||||
GitManager.ClearDebugWriter();
|
GitManager.ClearDebugWriter();
|
||||||
|
|
||||||
base.BeginProcessing();
|
base.BeginProcessing();
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue