Skip to main content

No project description provided

Project description

gitautopush

Watch a local git repository for any changes and automatically push them to GitHub.

Useful as a live synchronization tool for teaching. Say you've got a Jupyter notebook (or a markdown file) that you are populating with code while you are teaching a class. As you add content to the file, you'd like students to have access to the "latest" version at any moment in time.

gitautopush lets you automatically track the latest changes to a git repository, and automatically push them to GitHub. You can then ask students to visit a GitHub or nbviewer link, and they will be able to see any changes that you've made.

See the GIF below for an example.

gitautopush demo

Installation

You can install with pip:

pip install gitautopush

Usage

First, make sure that you've got a GitHub repository cloned to a local folder.

Next, run gitautopush and point it to that folder:

gitautopush /path/to/my/repo/folder

gitautopush will begin watching this folder for any changes. When it finds them, it will commit them and push the folder contents to GitHub. It will also display some links that you can share with students to help them follow along.

Parameters

Below are parameters you can use to customize the behavior of Gitautopush.

  • --sleep <INT> - the amount of time (in seconds) to wait in between attempts to synchronize.
  • --path <STRING> - a path to the folder you'd like to watch and synchronize

Tutorial via an example use-case

Here's a common use-case for gitautopush:

You're teaching a Software Carpentry bootcamp and you'd like to do your work in a Jupyter Notebook. You have a "master copy" that you're working from, but you don't want to give the whole thing to students ahead of time. Your plan is to do your work in an empty notebook as students watch, and you'd like students to have access to the latest version of the notebook at all times.

First, you create an empty GitHub repository which we'll call gitautopush-demo. Next, we'll create a folder where we'll be doing our work:

Next, you clone this empty repository to your computer:

git clone https://github.com/choldgraf/gitautopush-demo

Now, run gitautopush and point it to the new folder. We'll tell it to sleep for 10 seconds after each check:

gitautopush --path ./gitautopush-demo --sleep 10

gitautopush will print a few useful links, and begin checking the folder for any changes. When it finds one, it will commit the change to the repository and push the result. It will also print an nbviewer link for any Jupyter notebook that is changed. You can share these links with your students.

Finally, open a new terminal window and use it to launch an application (e.g. Jupyter Lab, Jupyter Notbeook, or your own text editor) to edit the content.

As changes are made, note the links that are provided and share them with your students.

Acknowledgements

This tools was first thought up by John Lee, then adapted as a Python module by Chris Holdgraf.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gitautopush-0.4.0.tar.gz (4.1 kB view details)

Uploaded Source

Built Distribution

gitautopush-0.4.0-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

Details for the file gitautopush-0.4.0.tar.gz.

File metadata

  • Download URL: gitautopush-0.4.0.tar.gz
  • Upload date:
  • Size: 4.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3

File hashes

Hashes for gitautopush-0.4.0.tar.gz
Algorithm Hash digest
SHA256 c24f23f0747ee9f7d2ff6045d273f1b8081efda46a1a43ff9052f1f40597fccb
MD5 232f431764d4ec83de60a9199f7ec47d
BLAKE2b-256 f1119b407d945e6d6888e110608f45a3ecf80c3ac0fb0730dd91e7e22e794987

See more details on using hashes here.

File details

Details for the file gitautopush-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: gitautopush-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 5.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3

File hashes

Hashes for gitautopush-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c8db285d61760b56888035ebb772f83764f29c0ca73a5896555fd18992a67903
MD5 64fd627e38674f3ddfbc7025054b1a91
BLAKE2b-256 a7d99ba59d54f28d3a67b72d43d1b1c35d910cf20a0c3ff39f98a32cd531a369

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page