rrh

package module
v1.2.0 Latest Latest
Warning

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

 Go to latest Published: Apr 24, 2020 License: Apache-2.0 Imports: 16 Imported by: 0

README

Build Status Coverage Status codebeat badge go report License Version

RRH

RRH is a simple git repository manager.

Table of contents

Description

There are too many repositories. We love programming; however, to manage many repositories is quite hard and bothersome tasks. Therefore, we built a headquarter for managing the git repositories, named RRH. RRH manages repositories by categorizing in groups and execute git command to the groups.

I know the tool ghq, manages the git repositories. However, I cannot use it for the following reasons.

  1. there are quite many repositories in my home directory.
    • To start using ghq, we clone the repositories. However, I did not accept to clone all of the repositories.
  2. The location of repositories is fixed in the config file and is accepted only one location.
    • I decide the directory layout in my home directory.

Additionally, I edit several repositories in a day, when I work hard. Consequently, the progress of each repository is obscured; I cannot remember a lot of things. Therefore, it is glad to see the last modified date of branches.

RRH is now growing. Please hack RRH itself.

Installation

Homebrew

Install rrh via Homebrew, simply run:

$ brew tap tamada/brew
$ brew install rrh
Golang

To install by cli, simply run:

$ go get git@github.com/tamada/rrh.git
Requirements
  • Runtime
    • Bash 4.x or after, for completion.
      • zsh?, and fish?, I do not use them, so I do not know.
      • For macOS user, the default shell of the macOS is bash 3.x, therefore, the completion is not work enough.
        • rrh is maybe work on Windows, and Linux. I do not use them.
  • Development
    • Go 1.12
    • See go.mod

Usage

Getting started

RRH has various subcommands, however, list and add subcommand make you happy.

  • rrh list shows managed repositories.
  • rrh add <REPO> adds the given repository under the RRH management.
  • type cdrrh on Terminal, then type TAB, TAB, TAB!
Command references
rrh [GLOBAL OPTIONS] <SUB COMMANDS> [ARGUMENTS]
GLOBAL OPTIONS
    -h, --help                        print this message.
    -v, --version                     print version.
    -c, --config-file <CONFIG_FILE>   specifies the config file path.
AVAILABLE SUB COMMANDS:
    add          add repositories on the local path to RRH.
    clone        run "git clone" and register it to a group.
    config       set/unset and list configuration of RRH.
    export       export RRH database to stdout.
    fetch        run "git fetch" on the given groups.
    fetch-all    run "git fetch" in the all repositories.
    group        add/list/update/remove groups and show groups of the repository.
    help         print this message.
    import       import the given database.
    list         print managed repositories and their groups.
    mv           move the repositories from groups to another group.
    open         open folder or web page of the given repositories.
    prune        prune unnecessary repositories and groups.
    repository   manages repositories.
    rm           remove given repository from database.
    status       show git status of repositories.
    version      show version.

If the user specified an unknown subcommand (e.g., rrh helloworld), rrh treats it as an external command. In that case, rrh searches an executable file named rrh-helloworld from the PATH environment variable. If rrh found it, rrh executes it, if not found, rrh prints help and exit.

Subcommands
rrh add

Registers the repositories which specified the given paths to the RRH database and categorize to the group (Default no-group, see RRH_DEFAULT_GROUP_NAME).

rrh add [OPTIONS] <REPOSITORY_PATHS...>
OPTIONS
    -g, --group <GROUP>        add repository to RRH database.
    -r, --repository-id <ID>   specified repository id of the given repository path.
                               Specifying this option fails with multiple arguments.
ARGUMENTS
    REPOSITORY_PATHS           the local path list of the git repositories.
rrh clone

Runs git clone command and registers the cloned repository to RRH database. The following steps identify the id of the repository.

  1. If the length of REMOTE_REPOS is 1, and DEST exists, then the last entry of REMOTE_REPOS is repository id by eliminating the suffix .git.
  2. If the length of REMOTE_REPOS is 1, and DEST does not exist, then the last entry of DEST is repository id.
  3. If the length of REMOTE_REPOS is greater than 1, then the last entry of each REMOTE_REPOS is repository ids by eliminating the suffix .git.
rrh clone [OPTIONS] <REMOTE_REPOS...>
OPTIONS
    -g, --group <GROUP>   print managed repositories categoried in the group.
    -d, --dest <DEST>     specify the destination. Default is the current directory.
ARGUMENTS
    REMOTE_REPOS          repository urls

The destination of cloned repository is located based on RRH_CLONE_DESTINATION

rrh config

Handles the operations of configuration/environment variables. This subcommand requires sub-sub-command. If sub-sub-command was not specified, it runs list sub-sub-command.

rrh config <COMMAND> [ARGUMENTS]
COMMAND
    set <ENV_NAME> <VALUE>  set ENV_NAME to VALUE
    unset <ENV_NAME>        reset ENV_NAME
    list                    list all of ENVs (default)
rrh export

Exports the data of RRH database by JSON format.

rrh export [OPTIONS]
OPTiONS
    --no-indent      print result as no indented json
    --no-hide-home   not replace home directory to '${HOME}' keyword
rrh fetch

Runs git fetch command in the repositories of the specified group.

rrh fetch [OPTIONS] [GROUPS...]
OPTIONS
    -r, --remote <REMOTE>   specify the remote name. Default is "origin."
ARGUMENTS
    GROUPS                  run "git fetch" command on each repository on the group.
                            if no value is specified, run on the default group.
rrh fetch-all

Runs git fetch command in all repositories of managing in RRH. This command may make heavy network traffic; therefore, we do not recommend to run.

rrh fetch-all [OPTIONS]
OPTIONS
    -r, --remote <REMOTE>   specify the remote name. Default is "origin."
rrh group

Handles the operations of groups of RRH. This subcommand requires sub-sub-command. If sub-sub-command was not specified, it runs list sub-sub-command.

rrh group <SUBCOMMAND>
SUBCOMMAND
    add       add new group.
    info      show information of specified groups.
    list      list groups (default).
    of        shows groups of the specified repository.
    rm        remove group.
    update    update group.
rrh group add

Adds new group to the RRH database.

rrh group add [OPTIONS] <GROUPS...>
OPTIONS
    -d, --desc <DESC>        gives the description of the group.
    -o, --omit-list <FLAG>   gives the omit list flag of the group.
ARGUMENTS
    GROUPS                   gives group names.
rrh group info

Show information of specified groups.

rrh group info <GROUPS...>
ARGUMENTS
    GROUPS           group names to show the information.
rrh group list

Displays group list.

rrh group list [OPTIONS]
OPTIONS
    -d, --desc             show description.
    -r, --repository       show repositories in the group.
    -o, --only-groupname   show only group name. This option is prioritized.
rrh group of

Displays group of the specified repositories.

rrh group of <REPOSITORY_ID>
ARGUMENTS
    REPOSITORY_ID     show the groups of the repository.
rrh group rm

Removes groups.

rrh group rm [OPTIONS] <GROUPS...>
OPTIONS
    -f, --force      force remove.
    -i, --inquery    inquiry mode.
    -v, --verbose    verbose mode.
ARGUMENTS
    GROUPS           target group names.
rrh group update

Update the information of specified group.

rrh group update [OPTIONS] <GROUP>
OPTIONS
    -n, --name <NAME>        change group name to NAME.
    -d, --desc <DESC>        change description to DESC.
    -o, --omit-list <FLAG>   change omit-list of the group. FLAG must be "true" or "false".
ARGUMENTS
    GROUP                    update target group names.
rrh help

Prints the help message.

rrh help [ARGUMENTS...]
ARGUMENTS
    print help message of target command.
rrh import

Import the database to the local environment.

rrh import [OPTIONS] <DATABASE_JSON>
OPTIONS
    --auto-clone    clone the repository, if paths do not exist.
    --overwrite     replace the local RRH database to the given database.
    -v, --verbose   verbose mode.
ARGUMENTS
    DATABASE_JSON   the exported RRH database.
rrh list

Prints the repositories of managing in RRH.

rrh list [OPTIONS] [GROUPS...]
OPTIONS
    -d, --desc          print description of group.
    -p, --path          print local paths (default).
    -r, --remote        print remote urls.
    -A, --all-entries   print all entries of each repository.

    -a, --all           print all repositories, no omit repositories.
    -c, --csv           print result as csv format.
ARGUMENTS
    GROUPS    print managed repositories categorized in the groups.
              if no groups are specified, all groups are printed.
rrh mv

Move repositories to another group.

rrh mv [OPTIONS] <FROMS...> <TO>
OPTIONS
    -v, --verbose   verbose mode

ARGUMENTS
    FROMS...        specifies move from, formatted in <GROUP_NAME/REPO_ID>, or <GROUP_NAME>
    TO              specifies move to, formatted in <GROUP_NAME>
rrh open

Opens folder or web page of the given repositories.

rrh open [OPTIONS] <REPOSITORIES...>
OPTIONS
    -f, --folder     open the folder of the specified repository (Default).
    -w, --webpage    open the webpage of the specified repository.
    -h, --help       print this message.
ARGUMENTS
    REPOSITORIES     specifies repository names.
rrh prune

Deletes unnecessary groups and repositories. The unnecessary groups are no repositories in them. The unnecessary repositories are to have an invalid path.

rrh prune
rrh repository

Prints/Updates the repository.

rrh repository <SUBCOMMAND>
SUBCOMMAND
    info [OPTIONS] <REPO...>     shows repository information.
    update [OPTIONS] <REPO...>   updates repository information.
    update-remotes [OPTIONS]     update all remote entries.
rrh repository info

prints the repository information.

rrh repository info [OPTIONS] [REPOSITORIES...]
    -G, --color     prints the results with color.
    -c, --csv       prints the results in the csv format.
ARGUMENTS
    REPOSITORIES    target repositories.  If no repositories are specified,
                    this sub command failed.
rrh repository update

update the information of the repository.

rrh repository update [OPTIONS] <REPOSITORY>
OPTIONS
    -i, --id <NEWID>     specifies new repository id.
    -d, --desc <DESC>    specifies new description.
    -p, --path <PATH>    specifies new path.
ARGUMENTS
    REPOSITORY           specifies the repository id.
rrh repository update-remotes

update remote entries in the all repositories.

rrh repository update-remotes [OPTIONS]
OPTIONS
    -d, --dry-run    dry-run mode.
    -v, --verbose    verbose mode.
rrh rm

Removes the specified groups, repositories, and relations. If the group has entries is removed by specifying the option --recursive.

rrh rm [OPTIONS] <REPO_ID|GROUP_ID|GROUP_ID/REPO_ID...>
OPTIONS
    -i, --inquiry       inquiry mode.
    -r, --recursive     recursive mode.
    -v, --verbose       verbose mode.

ARGUMENTS
    REPOY_ID            repository name for removing.
    GROUP_ID            group name. if the group contains repositories,
                        removing will fail without '-r' option.
    GROUP_ID/REPO_ID    remove the relation between the given REPO_ID and GROUP_ID.
rrh status

Prints the last modified times of each branch in the repositories of the specified group.

rrh status [OPTIONS] [GROUPS|REPOS...]
OPTIONS
    -b, --branches  show the status of the local branches.
    -r, --remote    show the status of the remote branches.
    -c, --csv       print result in csv format.
ARGUMENTS
    GROUPS          target groups.
    REPOS           target repositories.
                    If no arguments were specified, this command
                    shows the result of default group.
rrh version

Prints rrh version.

rrh version
Environment variables

We can see those variables by running rrh config sub-command.

RRH_HOME
  • specifies the location of the RRH database and config file.
  • Default: /Users/tamada/.rrh
RRH_CONFIG_PATH
  • specifies the location of the location path.
    • RRH ignores to specify RRH_CONFIG_PATH in the config file. This variable availables only environment variable.
  • Default: ${RRH_HOME}/config.json
RRH_DATABASE_PATH
  • specifies the location of the database path.
  • Default: ${RRH_HOME}/database.json
RRH_DEFAULT_GROUP_NAME
  • specifies the default group name.
  • Default: no-group
RRH_CLONE_DESTINATION
  • specifies the destination by cloning the repository.
  • Default: .
RRH_ON_ERROR
  • specifies the behaviors of RRH on error.
  • Default: WARN
  • Available values: FAIL_IMMEDIATELY, FAIL, WARN, and IGNORE
    • FAIL_IMMEDIATELY
      • reports error immediately and quits RRH with a non-zero status.
    • FAIL
      • runs through all targets and reports errors if needed, then quits RRH with a non-zero status.
    • WARN
      • runs through all targets and reports errors if needed, then quits RRH successfully.
    • IGNORE
      • runs all targets and no reports errors.
RRH_TIME_FORMAT
  • specifies the time format for status command.
  • Default: relative
  • Available value: relative and the time format for Go lang.
    • relative
      • shows times by humanized format (e.g., 2 weeks ago)
    • Other strings
      • regard as formatting layout and give to Format method of the time.
RRH_AUTO_CREATE_GROUP
  • specifies to create the group when the not existing group was specified, and it needs to create.
  • Default: false
RRH_AUTO_DELETE_GROUP
  • specifies to delete the group when some group was no more needed.
  • Default: false
RRH_SORT_ON_UPDATING
  • specifies to sort database entries on updating database.
  • Default: false
RRH_COLOR
  • specifies the colors of the output.
  • Default: "repository:fg=red+group:fg=magenta+label:op=bold+configValue:fg=green"
  • Format: "repository:fg=<COLOR>;bg=<COLOR>;op=<STYLE>+group:fg=<COLOR>;bg=<COLOR>;op=<STYLE>+label:fg=<COLOR>;bg=<COLOR>;op=<STYLE>+configValue:fg=<COLOR>;bg=<COLOR>;op=<STYLE>"
    • Available COLORs
      • red, cyan, blue, black, green, white, yellow, magenta.
    • Available STYLEs
      • bold, underscore.
    • Delimiter of repository, group and label is +, delimiter of type and value is :, delimiter of each label is ;, and delimiter of each value is ,.
  • Examples:
    • RRH_COLOR: repository:fg=red+group:fg=cyan;op=bold,underscore
      • Repository: red, Group: cyan in bold with underscore.
RRH_ENABLE_COLORIZED
  • specifies to colorize the output. The colors of output were specified on RRH_COLOR
  • Default: false

Development

Database

The database for managed repositories is formatted in JSON. The JSON format is as follows. The JSON file is placed on $RRH_HOME/database.json. If $RRH_HOME was not set, $HOME/.rrh is used as $RRH_HOME. Also, the configuration file is on $RRH_HOME/config.json

{
    last-modified: '2019-01-01T',
    repositories: [
        {
            repository_id: 'rrh', // unique key of repository.
            repository_path: 'absolute/path/of/repository',
            repository_desc: 'description of the repository.',
            remotes: [
                {
                    Name: "origin",
                    URL: "git@github.com:tamada/rrh.git"
                }
            ]
        },
        ....
    ]
    groups: [
        {
            group_name: 'no-group',
            group_desc: 'The description of the group.',
            omit_list: false
        },
        ....
    ],
    relations: [
        {
            repository_id: 'rrh',
            group_name: 'no-group'
        }
    ]
}

Utilities

Write the following script to $HOME/.bash_profile, then restart shell, then we can use cdrrh and rrhpeco command in the terminal.

cdrrh

changes directory to the specified repository.

cdrrh(){
    path=$(rrh repository list --path $1)
    if [ $? -eq 0 ]; then
        cd $path
        pwd
    else
        echo "$1: repository not found"
    fi
}
rrhpeco

list repositories, and filtering them by peco, then change directory to the filtering result.

rrhpeco(){
  csv=$(rrh list --path --csv | peco)
  cd $(echo $csv | awk -F , '{ print $3 }')
  pwd
}

About the Project

Contribution Code of Conduct License Gitter Gitter misc_ja

Contribution
  1. Fork the project. (https://github.com/tamada/rrh/fork)
  2. Create a feature branch. (git checkout -b FEATURE_BRANCH_NAME)
  3. Edit the source files and Commit your changes.
  4. Create tests and commit them.
  5. Rebase your local changes against the master branch.
  6. Run the test suite with the make test and confirm that passes.
  7. Create a new pull request.
  8. Confirm all checks pass.

See also the contribution guideline.

Code of Conduct

Code of Conduct

License

Apache Version 2.0

License

Discussion

Gitter Gitter misc_ja

Join our Gitter channel if you have any problem or suggestions to rrh.

For Japanese user, misc_ja channel has discussions in Japanese. The public language of other channels and GitHub pages are English.

Author
Why the project name RRH

At first, the name of this project was GRIM (Git Repository Integrated Manager). However, the means of grim is not good, and there are many commands which start with gr. Therefore, we changed the project name to RRH. RRH means "Repositories, Ready to Hack" or "Remote Repositories Head," are not the abbreviation of the Red Riding Hood.

Attributions
Icon of RRH

icon of rrh by iconpon.com

Version histories
  • v1.1.0 (18 Dec, 2018)
    • #79 (add rrh group info sub command)
    • #77 (introduce rrh repository update-remotes sub command)
    • #81 (introduce options for rrh prune command)
  • v1.0.4 (13 Jul, 2018)
    • #74 (permission of created README.md by rrh-new was invalid (204))
    • #75 (Introduce --dry-run option to rrh new command)
  • v1.0.3 (29 Jun, 2018)
    • #72 (Print belonging groups on rrh repository info)
  • v1.0.2 (29 Jun, 2018)
    • #67 (implements rrh new sub command)
  • v1.0.1 (26 Jun, 2018)
    • #68 (rrh group prints rrh config list)
  • v1.0.0 (18 Jun, 2018)
    • The first public release.

Table of Contents

Documentation

Index

Examples

Constants

View Source 
const (
	AutoDeleteGroup  = "RRH_AUTO_DELETE_GROUP"
	AutoCreateGroup  = "RRH_AUTO_CREATE_GROUP"
	CloneDestination = "RRH_CLONE_DESTINATION"
	ColorSetting     = "RRH_COLOR"
	ConfigPath       = "RRH_CONFIG_PATH"
	DatabasePath     = "RRH_DATABASE_PATH"
	DefaultGroupName = "RRH_DEFAULT_GROUP_NAME"
	EnableColorized  = "RRH_ENABLE_COLORIZED"
	Home             = "RRH_HOME"
	OnError          = "RRH_ON_ERROR"
	SortOnUpdating   = "RRH_SORT_ON_UPDATING"
	TimeFormat       = "RRH_TIME_FORMAT"
)

The environment variable names.

View Source 
const (
	Default    = "default"
	ConfigFile = "config_file"
	Env        = "environment"
	NotFound   = "not found"
)

The the 2nd return value of GetString method (ReadFrom).

View Source 
const (
	Fail            = "FAIL"
	FailImmediately = "FAIL_IMMEDIATELY"
	Warn            = "WARN"
	Ignore          = "IGNORE"
)

The values of RrhOnError.

View Source 
const Relative = "relative"

Relative shows the default value of RrhTimeFormat.

View Source 
const VERSION = "1.2.0"

VERSION shows the version of RRH.

Variables

View Source 
var AvailableLabels = []string{
	AutoCreateGroup, AutoDeleteGroup, CloneDestination, ColorSetting,
	ConfigPath, DatabasePath, DefaultGroupName, EnableColorized,
	Home, OnError, SortOnUpdating, TimeFormat,
}

AvailableLabels represents the labels availables in the config.

Functions

func CaptureStdout 

func CaptureStdout(f func()) string

CaptureStdout is referred from https://qiita.com/kami_zh/items/ff636f15da87dabebe6c.

func CreateParentDir 

func CreateParentDir(path string) error

CreateParentDir create the parent directories of the given path.

func GivesStringAsStdin 

func GivesStringAsStdin(inputFromStdin string, f func())

GivesStringAsStdin treats given inputFromStdin string as a byte stream from stdin.

func HumanizeTime 

func HumanizeTime(time time.Time) string

HumanizeTime convert the given time to human friendly formatted string.

func IsExistAndGitRepository 

func IsExistAndGitRepository(absPath string, path string) error

IsExistAndGitRepository checks the given absPath is exist and shows the git repository.

func IsInputYes 

func IsInputYes(prompt string) bool

IsInputYes print the given prompt and returns TRUE if the user inputs "yes".

func ReplaceNewline 

func ReplaceNewline(originalString, replaceTo string) string

ReplaceNewline trims spaces and converts the return codes in `originalString` to `replaceTo` string.

func Rollback 

func Rollback(dbFile, configFile string, f func(config *Config, db *Database)) string

Rollback rollbacks database after executing function f.

func Strftime 

func Strftime(time time.Time, config *Config) string

Strftime returns the string of the given time.

Types

type Color 

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

Color struct shows the color settings of RRH.

func InitializeColor 

func InitializeColor(config *Config) *Color

InitializeColor is the initialization function of the colorized output. The function is automatically called on loading the config file.

func (*Color) ClearColorize 

func (c *Color) ClearColorize()

ClearColorize clears the color settings.

func (*Color) ColorizeConfigValue 

func (c *Color) ColorizeConfigValue(value string) string

ColorizeConfigValue returns the coloried config value from configuration.

func (*Color) ColorizedGroupName 

func (c *Color) ColorizedGroupName(groupName string) string

ColorizedGroupName returns the colorized group name string from configuration.

func (*Color) ColorizedLabel 

func (c *Color) ColorizedLabel(label string) string

ColorizedLabel returns the colorized label string from configuration.

func (*Color) ColorizedRepositoryID 

func (c *Color) ColorizedRepositoryID(repoID string) string

ColorizedRepositoryID returns the colorized repository id string from configuration.

func (*Color) SetColorize 

func (c *Color) SetColorize(enable bool)

SetColorize sets to enable colorization.

type Config 

type Config struct {
	Color *Color
	// contains filtered or unexported fields
}

Config shows the values of configuration variables.

func NewConfig 

func NewConfig() *Config

NewConfig generates the new Config instance.

func OpenConfig 

func OpenConfig() *Config

OpenConfig reads the config file and returns it. The load path is based on `RrhConfigPath` of the environment variables.

func (*Config) GetDefaultValue 

func (config *Config) GetDefaultValue(label string) string

GetDefaultValue returns the default value of the given variable name.

func (*Config) GetString 

func (config *Config) GetString(label string) (string, ReadFrom)

GetString returns the value of the given variable name and the definition part of the value.

func (*Config) GetValue 

func (config *Config) GetValue(label string) string

GetValue returns the value of the given variable name.

func (*Config) IsSet 

func (config *Config) IsSet(label string) bool

IsSet returns the bool value of the given label. If the label is not RrhAutoCreateGroup, RrhAutoDeleteGroup, and RrhSortOnUpdating, this method always returns false.

func (*Config) PrintErrors 

func (config *Config) PrintErrors(errs ...error) int

PrintErrors prints errors and returns the status code by following the value of RrhOnError. If the value of RrhOnError is Ignore or Warn, this method returns 0, otherwise, non-zero value.

func (*Config) StoreConfig 

func (config *Config) StoreConfig() error

StoreConfig saves the store.

func (*Config) Unset 

func (config *Config) Unset(label string) error

Unset method deletes the specified config value.

func (*Config) Update 

func (config *Config) Update(label string, value string) error

Update method updates the config value with the given `value`.

type Database 

type Database struct {
	Timestamp    RrhTime      `json:"last_modified"`
	Repositories []Repository `json:"repositories"`
	Groups       []Group      `json:"groups"`
	Relations    []Relation   `json:"relations"`
	Config       *Config      `json:"-"`
}

Database represents the whole database of RRH.

func Open 

func Open(config *Config) (*Database, error)

Open function is to read rrh database from a certain path.

How to call this function 

var db *Database
db = common.Open()

func (*Database) AutoCreateGroup 

func (db *Database) AutoCreateGroup(groupID string, description string, omitList bool) (*Group, error)

AutoCreateGroup returns the group by creating the given parameters and store it to the database by satisfying the config value of RrhAutoCreateGroup is true.

func (*Database) BelongingCount 

func (db *Database) BelongingCount(repoID string) int

BelongingCount returns the number of groups belonging given repoID.

func (*Database) ContainsCount 

func (db *Database) ContainsCount(groupID string) int

ContainsCount returns the number of repositories in the given groupID.

func (*Database) CreateGroup 

func (db *Database) CreateGroup(groupID string, description string, omitList bool) (*Group, error)

CreateGroup returns the group by creating the given parameters and store it to database. If db has the group with the given groupID, this method returns error.

func (*Database) CreateRepository 

func (db *Database) CreateRepository(repoID string, path string, desc string, remotes []Remote) (*Repository, error)

CreateRepository returns the repository by creating the given parameters and store it to database.

func (*Database) DeleteGroup 

func (db *Database) DeleteGroup(groupID string) error

DeleteGroup removes the group of the given groupId from DB. If the group has some repositories, the function fails to remove.

func (*Database) DeleteRepository 

func (db *Database) DeleteRepository(repoID string) error

DeleteRepository function removes the repository of given repoID from DB. Also, the relation between the repository and groups are removed.

func (*Database) FindGroup 

func (db *Database) FindGroup(groupID string) *Group

FindGroup returns the group which name is given `groupID.`

func (*Database) FindRelationsOfGroup 

func (db *Database) FindRelationsOfGroup(groupID string) []string

FindRelationsOfGroup returns the repository ids belonging to the specified group.

func (*Database) FindRelationsOfRepository 

func (db *Database) FindRelationsOfRepository(repositoryID string) []string

FindRelationsOfRepository returns the group names of the specified repository.

func (*Database) FindRepository 

func (db *Database) FindRepository(repoID string) *Repository

FindRepository returns the repository which ID is given `repoID.`

func (*Database) ForceDeleteGroup 

func (db *Database) ForceDeleteGroup(groupID string) error

ForceDeleteGroup removes the group of the given groupID from DB. Even if the group has some repositories, the function forcely remove the group.

func (*Database) HasGroup 

func (db *Database) HasGroup(groupID string) bool

HasGroup returns true if the db has the group of groupID.

func (*Database) HasRelation 

func (db *Database) HasRelation(groupID string, repoID string) bool

HasRelation returns true if the group and the repository has relation. The group and the repository are specified by the given parameters.

func (*Database) HasRepository 

func (db *Database) HasRepository(repoID string) bool

HasRepository returns true if the db has the repository of repoID.

func (*Database) Prune 

func (db *Database) Prune() (int, int)

Prune eliminates unnecessary repositories, and groups from db.

func (*Database) PruneTargets 

func (db *Database) PruneTargets() ([]Repository, []Group)

PruneTargets returns the pruned (unnecessary) repositories and groups from db.

func (*Database) Relate 

func (db *Database) Relate(groupID string, repoID string) error

Relate create the relation between the group and the repository. The group and the repository are specified by the given parameters. If the group and the repository have the relation, this function returns `nil` (successfully create relation).

func (*Database) StoreAndClose 

func (db *Database) StoreAndClose() error

StoreAndClose stores the database to file and close the database. The database path is defined in RRH_DATABASE_PATH of config.

func (*Database) Unrelate 

func (db *Database) Unrelate(groupID string, repoID string)

Unrelate deletes the relation between the group and the repository. The group and the repository are specified by the given parameters. If the group and the repository do not have the relation, this function returns `nil` (successfully delete relation).

func (*Database) UnrelateFromGroup 

func (db *Database) UnrelateFromGroup(groupID string)

UnrelateFromGroup deletes all relations about the specified group.

func (*Database) UnrelateRepository 

func (db *Database) UnrelateRepository(repoID string)

UnrelateRepository deletes all relations of the specified repository.

func (*Database) UpdateGroup 

func (db *Database) UpdateGroup(groupID string, newGroup Group) bool

UpdateGroup updates found group with `newGroupID` and `newDescription`. The return value is that the update is success or not.

func (*Database) UpdateRepository 

func (db *Database) UpdateRepository(repositoryID string, newRepo Repository) bool

UpdateRepository updates the repository information.

type Group 

type Group struct {
	Name        string `json:"group_name"`
	Description string `json:"group_desc"`
	OmitList    bool   `json:"omit_list"`
}

Group represents the groups of the Git repositories.

type LogLevel 

type LogLevel int

LogLevel represent the level for logging. 

const (
	VERBOSE LogLevel = iota + 1
	/*
	   INFO shows info level of log level.
	*/
	INFO
	/*
	   WARN shows warning level of log level.
	*/
	WARN
	/*
	   SEVERE shows severe level of log level.
	*/
	SEVERE
)

VERBOSE shows verbose level of log level.

type MessageCenter 

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

MessageCenter manages log entries.

Example 
var mc = NewMessageCenter()
mc.PushLog("info level")
mc.PushVerbose("verbose level")
mc.Push("warn level", WARN)
mc.Push("severe level", SEVERE)

mc.PrintLog(os.Stdout)

Output:

info level
warn level
severe level

func NewMessageCenter 

func NewMessageCenter() *MessageCenter

NewMessageCenter creates an instance of MessageCenter.

func (*MessageCenter) FindMessages 

func (mc *MessageCenter) FindMessages(level LogLevel) []string

FindMessages returns messages in the receiver MessageCenter with greater than given log level.

func (*MessageCenter) Print 

func (mc *MessageCenter) Print(out io.Writer, level LogLevel)

Print prints greater than given level messages in the receiver MessageCenter to the given writer.

func (*MessageCenter) PrintLog 

func (mc *MessageCenter) PrintLog(out io.Writer)

PrintLog prints messages of INFO, WARN, and SEVERE log level in the receiver MessageCenter to the given writer.

func (*MessageCenter) PrintVerbose 

func (mc *MessageCenter) PrintVerbose(out io.Writer)

PrintVerbose prints messages of VERBOSE, INFO, WARN, and SEVERE log level in the receiver MessageCenter to the given writer.

func (*MessageCenter) Push 

func (mc *MessageCenter) Push(message string, level LogLevel)

Push append given message to receiver MessageCenter as given level.

func (*MessageCenter) PushLog 

func (mc *MessageCenter) PushLog(message string)

PushLog append given message to receiver MessageCenter as INFO level.

func (*MessageCenter) PushVerbose 

func (mc *MessageCenter) PushVerbose(message string)

PushVerbose append given message to receiver MessageCenter as VERBOSE level.

type ReadFrom 

type ReadFrom string

ReadFrom shows the value of config load from. The available values are default, config_file, environment, and not found.

type Relation 

type Relation struct {
	RepositoryID string `json:"repository_id"`
	GroupName    string `json:"group_name"`
}

Relation represents the relation between group and the repository.

func FindTargets 

func FindTargets(db *Database, groupNames []string) []Relation

FindTargets returns instances of Relation objects with given groupNames.

func (*Relation) String 

func (relation *Relation) String() string

type Remote 

type Remote struct {
	Name string `json:"name"`
	URL  string `json:"url"`
}

Remote represents remote of the git repository.

func FindRemotes 

func FindRemotes(path string) ([]Remote, error)

FindRemotes function returns the remote of the given git repository.

func (*Remote) String 

func (r *Remote) String() string

type Repository 

type Repository struct {
	ID          string   `json:"repository_id"`
	Path        string   `json:"repository_path"`
	Description string   `json:"repository_desc"`
	Remotes     []Remote `json:"remotes"`
}

Repository represents a Git repository.

type RrhTime 

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

RrhTime represents the time for RRH command, for marshaling a specific format.

func Now 

func Now() RrhTime

Now returns now time.

func Unix 

func Unix(sec int64, nsec int64) RrhTime

Unix creates and returns the time by specifying the unix time.

func (RrhTime) MarshalJSON 

func (rt RrhTime) MarshalJSON() ([]byte, error)

MarshalJSON is called on marshaling JSON.

func (*RrhTime) UnmarshalJSON 

func (rt *RrhTime) UnmarshalJSON(data []byte) error

UnmarshalJSON is called on unmarshaling JSON.

type Status 

type Status struct {
	Relation     *Relation
	BranchName   string
	LastModified *time.Time
	Description  string
}

Status shows the result of the `rrh status` command.

type StatusOption 

type StatusOption struct {
	BranchStatus bool
	RemoteStatus bool
}

StatusOption represents for getting status of branches in a repository.

func NewStatusOption 

func NewStatusOption() *StatusOption

NewStatusOption generates an instance of StatusOption.

func (*StatusOption) StatusOfRepository 

func (status *StatusOption) StatusOfRepository(db *Database, name *Relation) ([]Status, error)

StatusOfRepository returns statuses of a given repository.

Source Files

View all Source files

Directories

Path Synopsis
cmd
rrh
rrh-helloworld
rrh-new

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.