gogh

package module
v2.5.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jun 25, 2023 License: MIT Imports: 21 Imported by: 0

README

Gogh

GO GitHub project manager

PkgGoDev Go Report Card Coverage Status Release

Description

gogh is forked from ghq.

$ gogh list
github.com/kyoh86/git-branches
github.com/kyoh86/gogh
github.com/kyoh86/vim-wipeout
github.com/kyoh86-tryouts/bare
github.com/nvim-telescope/telescope.nvim
...

gogh provides a way to organize remote repository clones, like go get does. When you clone a remote repository by gogh get, gogh makes a directory under a specific root directory (by default ~/go/src) using the remote repository URL's host and path. And creating new one by gogh new, gogh make both of a local project and a remote repository.

$ gogh get https://github.com/kyoh86/gogh
# Runs `git clone https://github.com/kyoh86/gogh ~/go/src/github.com/kyoh86/gogh`

You can also list projects (local repositories) (gogh list).

Install

For Golang developers
$ go install github.com/kyoh86/gogh/cmd/gogh@latest

If you want zsh-completions, you can create completions file like this:

$ echo "autoload -Uz compinit && compinit" >> ~/.zshrc
$ gogh completion zsh > $fpath[1]/_gogh
Homebrew/Linuxbrew
$ brew tap kyoh86/tap
$ brew update
$ brew install kyoh86/tap/gogh
Makepkg
$ mkdir -p gogh_build && \
  cd gogh_build && \
  curl -L --silent https://github.com/kyoh86/gogh/releases/latest/download/gogh_PKGBUILD.tar.gz | tar -xvz
$ makepkg -i

Available commands

Show projects
Command Description
gogh list List local projects
gogh repos List remote repositories
Manipulate projects
Command Description
gogh create Create a new project with a remote repository
gogh delete Delete a repository with a remote repository
gogh fork Fork a repository
gogh clone Clone a repository to local
Others
Command Description
gogh roots Manage roots
gogh servers Manage servers
gogh bundle Manage bundle
gogh help Help about any command

Use gogh [command] --help for more information about a command. Or see the manual in usage/gogh.md.

Roots

gogh manages projects under the roots directories.

See also: Directory structures

You can change the roots with roots add <path> or roots remove <path> and see all of them by roots list. gogh uses the first one as the default one, create, fork or clone will put a local project under it. If you want to change the default, use roots set-default <path>.

Default: ~/Projects.

Servers

gogh manages repositories in some servers that pairs of a user and a host name. To login in new server or logout, you should use servers login. gogh uses the first server as the default one. When you specify a repository with ambiguous user or host, it will be interpolated with a default server.

I.E. when servers are:

- github.com:
  - user: kyoh86
- example.com:
  - user: foobar

Ambiguous repository names will be interpolated:

Ambiguous name Interpolated name
gogh github.com/kyoh86/gogh
foobar/gogh github.com/foobar/gogh

Commands

Manual: usage/gogh.md.

Directory structures

Local projects are placed under gogh.roots with named `host/user/repo.

~/Projects
+-- github.com/
|-- google/
|   +-- go-github/
|-- kyoh86/
|   +-- gogh/
+-- alecthomas/
  +-- kingpin/

LICENSE

MIT License

This software is released under the MIT License, see LICENSE. And this software is based on ghq.

Documentation

Overview

Package gogh manages GitHub repositories for the local directory structures.

Index

Constants

View Source 
const (
	RepositoryRelationOwner              = RepositoryRelation("owner")
	RepositoryRelationOrganizationMember = RepositoryRelation("organizationMember")
	RepositoryRelationCollaborator       = RepositoryRelation("collaborator")
)
View Source 
const (
	DefaultHost = github.DefaultHost
)
View Source 
const DefaultRootDirName = "Projects"
View Source 
const (
	RepositoryListMaxLimitPerPage = 100
)

Variables

View Source 
var (
	ErrEmptyHost  = ErrInvalidHost("empty host")
	ErrEmptyOwner = ErrInvalidOwner("empty owner")
	ErrEmptyName  = ErrInvalidName("empty name")
)
View Source 
var (
	ErrNoServer          = errors.New("no server registered")
	ErrServerNotFound    = errors.New("server not found")
	ErrUnremovableServer = errors.New("default server is not able to be removed")
)
View Source 
var AllOrderDirection = githubv4.AllOrderDirection
View Source 
var AllRepositoryOrderField = githubv4.AllRepositoryOrderField
View Source 
var AllRepositoryRelation = []RepositoryRelation{
	RepositoryRelationOwner,
	RepositoryRelationOrganizationMember,
	RepositoryRelationCollaborator,
}
View Source 
var (
	ErrTooManySlashes = errors.New("too many slashes")
)

Functions

func CreateLocalProject added in v2.3.1 

func CreateLocalProject(
	_ context.Context,
	project Project,
	remoteURL string,
	_ *LocalCreateOption,
) error

func DeleteLocalProject added in v2.3.1 

func DeleteLocalProject(_ context.Context, project Project, _ *LocalDeleteOption) error

func GetDefaultRemoteURLFromLocalProject added in v2.3.1 

func GetDefaultRemoteURLFromLocalProject(_ context.Context, project Project) (string, error)

func GetRemoteURLsFromLocalProject added in v2.3.1 

func GetRemoteURLsFromLocalProject(
	_ context.Context,
	project Project,
	name string,
) ([]string, error)

func SetRemoteURLsOnLocalProject added in v2.3.1 

func SetRemoteURLsOnLocalProject(
	_ context.Context,
	project Project,
	remotes map[string][]string,
) error

func ValidateHost 

func ValidateHost(h string) error

func ValidateName 

func ValidateName(name string) error

func ValidateOwner 

func ValidateOwner(owner string) error

Types

type ErrInvalidHost 

type ErrInvalidHost string

func (ErrInvalidHost) Error 

func (e ErrInvalidHost) Error() string

type ErrInvalidName 

type ErrInvalidName string

func (ErrInvalidName) Error 

func (e ErrInvalidName) Error() string

type ErrInvalidOwner 

type ErrInvalidOwner string

func (ErrInvalidOwner) Error 

func (e ErrInvalidOwner) Error() string

type LocalCloneOption 

type LocalCloneOption struct {
	Alias *Spec
}

type LocalController 

type LocalController struct {
	// contains filtered or unexported fields
}

func NewLocalController 

func NewLocalController(root string) *LocalController

func (*LocalController) Clone 

func (l *LocalController) Clone(
	ctx context.Context,
	spec Spec,
	server Server,
	opt *LocalCloneOption,
) (Project, error)

func (*LocalController) Create 

func (l *LocalController) Create(
	ctx context.Context,
	spec Spec,
	opt *LocalCreateOption,
) (Project, error)

func (*LocalController) Delete 

func (l *LocalController) Delete(ctx context.Context, spec Spec, opt *LocalDeleteOption) error

func (*LocalController) Exist added in v2.3.5 

func (l *LocalController) Exist(
	ctx context.Context,
	spec Spec,
	opt *LocalExistOption,
) (bool, error)

func (*LocalController) GetRemoteURLs 

func (l *LocalController) GetRemoteURLs(
	ctx context.Context,
	spec Spec,
	name string,
) ([]string, error)

func (*LocalController) List 

func (l *LocalController) List(ctx context.Context, opt *LocalListOption) ([]Project, error)

func (*LocalController) SetRemoteSpecs added in v2.1.0 

func (l *LocalController) SetRemoteSpecs(
	ctx context.Context,
	spec Spec,
	remotes map[string][]Spec,
) error

func (*LocalController) SetRemoteURLs 

func (l *LocalController) SetRemoteURLs(
	ctx context.Context,
	spec Spec,
	remotes map[string][]string,
) error

func (*LocalController) Walk 

func (l *LocalController) Walk(
	ctx context.Context,
	opt *LocalWalkOption,
	walkFn LocalWalkFunc,
) error

type LocalCreateOption 

type LocalCreateOption struct {
}

type LocalDeleteOption 

type LocalDeleteOption struct{}

type LocalExistOption added in v2.3.5 

type LocalExistOption struct {
}

type LocalListOption 

type LocalListOption struct {
	Query string
}

type LocalWalkFunc 

type LocalWalkFunc func(Project) error

type LocalWalkOption 

type LocalWalkOption struct {
	Query string
}

type OrderDirection added in v2.2.0 

type OrderDirection = githubv4.OrderDirection

type Project 

type Project struct {
	// contains filtered or unexported fields
}

Project is the location of a repository in the local. It is a valid location, that never means "exist".

func NewProject 

func NewProject(root string, spec Spec) Project

func (Project) CheckEntity 

func (p Project) CheckEntity() error

CheckEntity checks the project is exist in the local file-system.

func (Project) FullFilePath 

func (p Project) FullFilePath() string

func (Project) FullLevels 

func (p Project) FullLevels() []string

func (Project) Host 

func (p Project) Host() string

func (Project) Name 

func (p Project) Name() string

func (Project) Owner 

func (p Project) Owner() string

func (Project) RelFilePath 

func (p Project) RelFilePath() string

func (Project) RelLevels 

func (p Project) RelLevels() []string

func (Project) RelPath 

func (p Project) RelPath() string

func (Project) Root 

func (p Project) Root() string

type RemoteController 

type RemoteController struct {
	// contains filtered or unexported fields
}

func NewRemoteController 

func NewRemoteController(adaptor github.Adaptor) *RemoteController

func (*RemoteController) Create 

func (c *RemoteController) Create(
	ctx context.Context,
	name string,
	option *RemoteCreateOption,
) (Repository, error)

func (*RemoteController) CreateFromTemplate added in v2.1.4 

func (c *RemoteController) CreateFromTemplate(
	ctx context.Context,
	templateOwner, templateName, name string,
	option *RemoteCreateFromTemplateOption,
) (Repository, error)

func (*RemoteController) Delete 

func (c *RemoteController) Delete(
	ctx context.Context,
	owner string,
	name string,
	_ *RemoteDeleteOption,
) error

func (*RemoteController) Fork 

func (c *RemoteController) Fork(
	ctx context.Context,
	owner string,
	name string,
	option *RemoteForkOption,
) (Repository, error)

func (*RemoteController) Get 

func (c *RemoteController) Get(
	ctx context.Context,
	owner string,
	name string,
	_ *RemoteGetOption,
) (Repository, error)

func (*RemoteController) List 

func (c *RemoteController) List(
	ctx context.Context,
	option *RemoteListOption,
) (allSpecs []Repository, _ error)

func (*RemoteController) ListAsync added in v2.0.10 

func (c *RemoteController) ListAsync(
	ctx context.Context,
	option *RemoteListOption,
) (<-chan Repository, <-chan error)

type RemoteCreateFromTemplateOption added in v2.1.4 

type RemoteCreateFromTemplateOption struct {
	Owner       string `json:"owner,omitempty"`
	Description string `json:"description,omitempty"`
	Private     bool   `json:"private,omitempty"`
}

type RemoteCreateOption 

type RemoteCreateOption struct {
	Organization        string
	Description         string
	Homepage            string
	Private             bool
	LicenseTemplate     string
	GitignoreTemplate   string
	TeamID              int64
	IsTemplate          bool
	DisableDownloads    bool
	DisableWiki         bool
	AutoInit            bool
	DisableProjects     bool
	DisableIssues       bool
	PreventSquashMerge  bool
	PreventMergeCommit  bool
	PreventRebaseMerge  bool
	DeleteBranchOnMerge bool
}

func (*RemoteCreateOption) GetOrganization 

func (o *RemoteCreateOption) GetOrganization() string

type RemoteDeleteOption 

type RemoteDeleteOption struct{}

type RemoteForkOption 

type RemoteForkOption struct {
	// Organization is the name of the organization that owns the repository.
	Organization string
}

func (*RemoteForkOption) GetOptions 

func (o *RemoteForkOption) GetOptions() *github.RepositoryCreateForkOptions

type RemoteGetOption 

type RemoteGetOption struct{}

type RemoteListOption 

type RemoteListOption struct {
	Private  *bool
	Limit    *int
	IsFork   *bool
	Order    OrderDirection
	Sort     RepositoryOrderField
	Relation []RepositoryRelation
}

func (*RemoteListOption) GetOptions 

func (o *RemoteListOption) GetOptions() *github.RepositoryListOptions

type Repository added in v2.2.0 

type Repository struct {
	UpdatedAt   time.Time `json:"updatedAt"`
	Parent      *Spec     `json:"parent,omitempty"`
	Spec        Spec      `json:"spec"`
	URL         string    `json:"url"`
	Description string    `json:"description,omitempty"`
	Homepage    string    `json:"homepage,omitempty"`
	Language    string    `json:"language,omitempty"`
	Archived    bool      `json:"archived,omitempty"`
	Private     bool      `json:"private,omitempty"`
	IsTemplate  bool      `json:"isTemplate,omitempty"`
	Fork        bool      `json:"fork,omitempty"`
}

func (Repository) Host added in v2.2.0 

func (r Repository) Host() string

func (Repository) Name added in v2.2.0 

func (r Repository) Name() string

func (Repository) Owner added in v2.2.0 

func (r Repository) Owner() string

type RepositoryOrderField added in v2.2.0 

type RepositoryOrderField = githubv4.RepositoryOrderField

type RepositoryRelation added in v2.2.0 

type RepositoryRelation string

func (RepositoryRelation) String added in v2.4.0 

func (r RepositoryRelation) String() string

type Server 

type Server struct {
	// contains filtered or unexported fields
}

func NewServer 

func NewServer(user, token string) (Server, error)

func NewServerFor 

func NewServerFor(host, user, token string) (Server, error)

func (Server) Host 

func (s Server) Host() string

func (Server) String added in v2.0.10 

func (s Server) String() string

func (Server) Token 

func (s Server) Token() string

func (Server) User 

func (s Server) User() string

type Servers 

type Servers struct {
	// contains filtered or unexported fields
}

func NewServers 

func NewServers(defaultServer Server, alternatives ...Server) *Servers

NewServers will build Spec with a default server and alternative servers.

func (*Servers) Default 

func (s *Servers) Default() (Server, error)

func (*Servers) Find 

func (s *Servers) Find(host string) (Server, error)

func (*Servers) List 

func (s *Servers) List() (list []Server, _ error)

func (Servers) MarshalYAML 

func (s Servers) MarshalYAML() (interface{}, error)

func (*Servers) Remove 

func (s *Servers) Remove(host string) error

func (*Servers) Set 

func (s *Servers) Set(host, user, token string) error

func (*Servers) SetDefault 

func (s *Servers) SetDefault(host string) error

func (*Servers) UnmarshalYAML 

func (s *Servers) UnmarshalYAML(unmarshaler func(interface{}) error) error

type Spec 

type Spec struct {
	// contains filtered or unexported fields
}

Spec describes which project is in a root.

func NewSpec 

func NewSpec(host, owner, name string) (Spec, error)

func ParseSiblingSpec added in v2.1.4 

func ParseSiblingSpec(base Spec, s string) (Spec, error)

ParseSiblingSpec parses string as a repository specification in the same host and same owner.

func (Spec) Host 

func (s Spec) Host() string

func (Spec) MarshalJSON added in v2.2.0 

func (s Spec) MarshalJSON() ([]byte, error)

func (Spec) Name 

func (s Spec) Name() string

func (Spec) Owner 

func (s Spec) Owner() string

func (Spec) RelLevels added in v2.1.0 

func (s Spec) RelLevels() []string

func (Spec) String 

func (s Spec) String() string

func (Spec) URL added in v2.1.0 

func (s Spec) URL() string

func (*Spec) UnmarshalJSON added in v2.2.0 

func (s *Spec) UnmarshalJSON(b []byte) error

type SpecParser 

type SpecParser struct {
	// contains filtered or unexported fields
}

SpecParser will parse any string as a Spec.

If it is clear that the string has host, user and name explicitly, use "NewSpec" instead to build Spec.

func NewSpecParser 

func NewSpecParser(servers *Servers) *SpecParser

NewSpecParser will build Spec with a default server and alternative servers.

func (*SpecParser) Parse 

func (p *SpecParser) Parse(s string) (Spec, Server, error)

Parse a string and build a Spec.

If the string does not have a host or a user explicitly, they will be replaced with a default server.

func (*SpecParser) ParseWithAlias added in v2.1.1 

func (p *SpecParser) ParseWithAlias(s string) (Spec, *Spec, Server, error)

ParseWithAlias parses string as a Spec and following alias. We can specify an alias with following '='(equal) and the alias.

If it's not specified, alias will be nil value. If it's specified a value which equals to the spec, alias will be nil value.

Source Files

View all Source files

Directories

Path Synopsis
cmd
gogh
internal
github
Package github provides GitHub API v3 adaptor
 Package github provides GitHub API v3 adaptor
github_mock
Package github_mock is a generated GoMock package.
 Package github_mock is a generated GoMock package.
githubv4
Package githubv4 provides GitHub API v4 adaptor
 Package githubv4 provides GitHub API v4 adaptor
Package view is the view layer of the gogh command.
 Package view is the view layer of the gogh command.
repotab
Package repotab provides a formatter which show repositories as a table in CLI
 Package repotab provides a formatter which show repositories as a table in CLI

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.