Skip to main content

git-flow

Pure-Python implementation of Git extensions to provide high-level repository operations for Vincent Driessen’s branching model.

https://travis-ci.org/chassing/gitflow.svg?branch=develop

Getting started

For the best introduction to get started with git flow, please read Jeff Kreeftmeijer’s blog post http://jeffkreeftmeijer.com/2010/why-arent-you-using-git-flow.

Or have a look at one of these screen casts:

Installing git-flow

You can install git-flow, using:

pip install nu-gitflow

git-flow requires Python >= 2.7 or Python >= 3.4.

Integration with your shell

For those who use the Bash or ZSH shell, please check out the excellent work on the git-flow-completion project by bobthecow. It offers tab-completion for all git-flow subcommands and branch names.

Please help out

This project is still under development. Feedback and suggestions are very welcome and I encourage you to use the Issues list on Github to provide that feedback.

Feel free to fork this repo and to commit your additions. For a list of all contributors, please see the file AUTHORS.txt.

You will need unittest2 to run the tests.

License terms

git-flow is published under the liberal terms of the BSD License, see the file LICENSE.txt. Although the BSD License does not require you to share any modifications you make to the source code, you are very much encouraged and invited to contribute back your modifications to the community, preferably in a Github fork, of course.

git flow usage

Initialization

To initialize a new repo with the basic branch structure, use:

git flow init [-d]

This will then interactively prompt you with some questions on which branches you would like to use as development and production branches, and how you would like your prefixes be named. You may simply press Return on any of those questions to accept the (sane) default suggestions.

The -d flag will accept all defaults.

Creating feature/release/hotfix/support branches

  • To list/start/finish feature branches, use:

    git flow feature
    git flow feature start <name> [<base>]
    git flow feature finish <name>

    For feature branches, the <base> arg must be a commit on develop.

  • To push/pull a feature branch to the remote repository, use:

    git flow feature publish <name>
    git flow feature pull <remote> <name>
  • To list/start/finish release branches, use:

    git flow release
    git flow release start <release> [<base>]
    git flow release finish <release>

    For release branches, the <base> arg must be a commit on develop.

  • To list/start/finish hotfix branches, use:

    git flow hotfix
    git flow hotfix start <release> [<base>]
    git flow hotfix finish <release>

    For hotfix branches, the <base> arg must be a commit on master.

  • To list/start support branches, use:

    git flow support
    git flow support start <release> <base>

    For support branches, the <base> arg must be a commit on master.

History of the Project

gitflow was originally developed by Vincent Driessen as a set of shell-scripts. In Juni 2007 he started a Python rewrite but did not finish it. In February 2012 Hartmut Goebel started completing the Python rewrite and asked Vincent to pull his changes. But in June 2012 Vincent closed the pull-request and deleted his python-rewrite branch. So Hartmut decided to release the Python rewrite on his own.

In year 2015 Hartmuts gitflow was abandoned and the python 3 support was missing. So Christian Assing decided to fork his version and release it as a new python based gitflow alternative.

Metadata

Release files for nu-gitflow 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distributions (sdists)

Source distribution for nu-gitflow 1.0.2
File Size Uploaded Provenance
nu-gitflow-1.0.2.zip 50.4 kB Without provenance Details
nu-gitflow-1.0.2.tar.gz 31.2 kB Without provenance Details

Release files / nu-gitflow-1.0.2.zip

Download URL nu-gitflow-1.0.2.zip
Size 50.4 kB
Tags Source
SHA-256 checksum
How to use checksums
923aa054b728d7c8c5a649ea20a184b36db4d4ad03dfa05506d93e52ed35d2f4
BLAKE2b-256 checksum
How to use checksums
b2130c76da37cd9ead202a9d982b0981acdb0bc210091b700dab25889bb87d27
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / nu-gitflow-1.0.2.tar.gz

Download URL nu-gitflow-1.0.2.tar.gz
Size 31.2 kB
Tags Source
SHA-256 checksum
How to use checksums
bec2f5d99244e3e0b6587f0dc7fce87e26291724c704f3a771d57f3121c4e1e7
BLAKE2b-256 checksum
How to use checksums
126176bc5752fdddc86ec841e0bd3deecb32e0f1a12c95dca84b674182689dce
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for nu-gitflow 1.0.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page