https://github.com/alvinwan/poosh

Automatically find and update remote copies of your local Git repository
https://github.com/alvinwan/poosh

developer servers version-control

Last synced: about 2 months ago
JSON representation

Automatically find and update remote copies of your local Git repository

• Host: GitHub
• URL: https://github.com/alvinwan/poosh
• Owner: alvinwan
• License: mit
• Created: 2018-09-06T07:41:35.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2018-09-16T23:10:34.000Z (over 6 years ago)
• Last Synced: 2024-10-12T13:44:36.913Z (3 months ago)
• Topics: developer, servers, version-control
• Language: Python
• Homepage:
• Size: 13.7 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Poosh

Automatically find and update remote copies of your local Git repository.

This small utility allows you sync a local Git repository with a remote Git

repository at an unspecified location on arbitrary server(s), *without git

commits*. This allows you to, say, verify code works on a remote server with

heavyweight GPUs, before committing.

by [Alvin Wan](http://alvinwan.com)

# Usage

To automatically navigate to your server's copy of your local git repository, use

```

poosh go 

```

![poosh-demo-go-2](https://user-images.githubusercontent.com/2068077/45601808-e7007f00-b9c7-11e8-85bc-037916fbfe0e.gif)

To push all untracked and modified files to multiple remote servers' copies of your local repository

```

poosh to    ...

```

![poosh-demo-to](https://user-images.githubusercontent.com/2068077/45601812-e8ca4280-b9c7-11e8-8b98-c8c13f20cf07.gif)

Note that `poosh`, without the `to   ...` arguments, will default to the servers listed in its default list of servers.

Use `poosh set`, `poosh list`, `poosh unset`, and `poosh config` to manage your default list of servers. Each server features a working directory setting: this is the root of your working directory on the server. Poosh will search this working directory for a copy of your local git repository.

```

usage: poosh [-h] [--path PATH] {go,to,set,unset,list,config} ...

This small utility allows you sync a local Git repository with a remote Git

repository at an unspecified location on arbitrary server(s), *without git

commits. This allows you to, say, verify code works on a remote server with

heavyweight GPUs, before committing.

positional arguments:

  {go,to,set,unset,list,config}

                        Sub-command help

    go                  Go to location on server

    to                  Push all files to specified server(s)

    set                 Add default server or set value for existing server

    unset               Remove server

    list                List default servers

    config              Edit configuration file

optional arguments:

  -h, --help            show this help message and exit

  --path PATH           Path to search in

```

# How it Works

Every `.git` directory contains `objects` representing the commit tree for your Git repository. Each object is initially stored *loosely* as files in `.git/objects/<2-character prefix>/`. Periodically, git then packages sets of objects into `.git/objects/pack/.{idx,pak}`. Poosh depends on the existence of one or the other in every copy of the Git repository: Poosh first extracts the hash corresponding to the Git repository's first commit, then searches the listed server(s) for a filename with the specified hash. In that regard, Poosh could technically synchronize directories identified by a unique name.