Git Sync

Clones all repositories, public or private, of a specified user or organization.

Credentials are required, they are present in a file named .gitsync.json place in the home folder.

Installation:

~$ sudo npm install -g @deliverymanager/gitsync

Usage:

For pull:

~$ gitsync --pull

---

For clone:

~$ gitsync --clone

---

For both:

~$ gitsync --all

Or:

~$ gitsync -a

---

To (re)initialize credentials:

~$ gitsync --init

---

To checkout to stable branches (production/prod):

~$ gitsync --checkout

---

The description is used to determine the exact path to which the repository will be cloned.

If the description is not a valid path, a warning appears.

Examples:

Repository description: path/to/folder -> Will clone the repository in ./path/to/folder/<repository name>

Repository description: Some description -> Will show a warning and not clone

Authentication:

The following file, .gitsync.json, must be placed in the home folder and is required for authentication with the GitHub API:

For only public repositories:

{
  "user": <github username>,
  "user_agent": <github user_agent>,
  "sync_account": <account from which to sync>,
  "org": <true/false> // whether the sync_account is an organization
}

For private repositories as well:

{
  "user": <github username>,
  "user_agent": <github user_agent>,
  "sync_account": <account from which to sync>,
  "org": <true/false> // whether the sync_account is an organization,
  "at": <github API access token>
}

To run the tests as well, the file must look like this:

{
  "user": <github username>,
  "at": <github API access token>,
  "test_repo_1": {
    "name": <repo name>,
    "full_name": <repo full name>,
    "local_path": <local path to which the repo will be cloned>
  },
  "test_repo_2": {
    "name": <repo name>,
    "full_name": <repo full name>,
    "local_path": <local path to which the repo will be cloned>
  },
  "user_agent": <github user_agent>,
  "sync_account": <account from which to sync>,
  "org": <true/false> // whether the sync_account is an organization
}

You can place the file yourself or you could run ~$ gitsync --init which will prompt for user name and Github API access token.

~$ gitsync --init

If you try to use the script without the .gitsync.json file present in the home folder, you will be prompted to initialize it, and execution will continue after the file is created.

Note: You could omit the access token. The script will still work but only for public repositories.

API Reference

---

Clone

init_cred

Initializes/updates git credentials

module.exports([cred]) ⇒ Promise ⏏

Kind: Exported function
Returns: Promise - Resolves to the the output of fs.writeFile or to message: 'Credentials not updated'

Param	Type	Default	Description
[cred]	object	{}	Credentials to keep Reads file with credentials, prompts for creation if not found and for update if found. Creates/Updates credentials.

get_all_repos_names

Gets all user's or org's repos names

module.exports(name, org, user, at) ⇒ repos ⏏

Kind: Exported function
Returns: repos - Mapped to have attributes name, full_name, local_path

Param	Type	Description
name	string	Github username
org	boolean	Whether the account belongs to an organization
user	string	User-Agent Header
at	string	Github authentication token

is_path_valid

Checks for validity of path, must be string and satisfy

module.exports(path) ⇒ boolean ⏏

Kind: Exported function
Returns: boolean - Whether path is valid

Param	Type	Description
path	string	Path under which to clone a repo

clone_repo

Clones a repo in path specified if path is valid. Else, clones to cwd

module.exports(repo, at) ⇒ Promise ⏏

Kind: Exported function
Returns: Promise - Resolves to the path under which the repo was cloned

Param	Type	Description
repo	object	Repository info
repo.name	string
repo.full_name	string
repo.local_path	string	local path to which the repo will be cloned
at	string	Github authentication token

---

Pull

get_existing_repos

Finds all repository folder paths under cwd. Used to update repos status

module.exports() ⇒ Array.<string> ⏏

Kind: Exported function
Returns: Array.<string> - The repository folder paths under cwd

get_status

Updates refs for cwd

module.exports(path) ⇒ string ⏏

Kind: Exported function
Returns: string - Repo status: diverged, fast-forward, up-to-date

Param	Type	Description
path	string	The absolute path to use as an cwd with exec

pull_all

Pulls all branches for repo

module.exports(path) ⇒ string ⏏

Kind: Exported function
Returns: string - Success message

Param	Type	Description
path	string	The absolute path to use as an cwd with exec

get_all_branches

Returns all repo branches

module.exports(path) ⇒ Array.<string> ⏏

Kind: Exported function
Returns: Array.<string> - The branch names

Param	Type	Description
path	string	The absolute path to use as an cwd with exec

track_missing_branches

Creates local branches production and branches with prodv prefix, if not found

module.exports(path, branches) ⇒ Array.<string> ⏏

Kind: Exported function
Returns: Array.<string> - The branches that were added

Param	Type	Description
path	string	The absolute path to use as an cwd with exec
branches	Array.<string>	All repo branches