git-upstream


Namegit-upstream JSON
Version 0.12.1 PyPI version JSON
download
home_pagehttps://pypi.python.org/pypi/git-upstream
Summarygit tool to help manage upstream repositories
upload_time2016-11-02 16:05:00
maintainer
docs_urlNone
authorDarragh Bailey
requires_python
licenseApache License (2.0)
keywords git upstream workflow
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            - What is git-upstream?

git-upstream is an open source Python application that can be used to keep in
sync with upstream open source projects, mainly OpenStack.

The main usecase for this tool is for people who are doing active contributions
to repositories that are mirrors of OpenStack repositories, with the intention
that most of those contributions will be submitted to review.openstack.org at
some point.
If you are running a public cloud based on OpenStack, having local changes
needed to use it in your environment, you can use git-upstream to stay up to
date with the upstream master in a easier way (with respect to using raw git
commands).

git-upstream provides new git subcommands to support rebasing of local-carried
patches on top of upstream repositories. It provides commands to ease the use
of git for who needs to integrate big upstream projects in their environment.
The operations are performed using Git commands.

See also README.md, and USAGE.md files.

- What git-upstream is not

The name of this tool includes the "git-" prefix because of the Git naming
convention that a Git subcommand must have. So, as git-review (usually invoked
with "git review [...]"), this tool can be invoked using "git upstream [...]".
That said, and even if git-upstream currently uses Change-Ids, it is not
strictly related to git-review.
In other words, git-review can (and most of the time will) be used without even
knowing about git-upstream existence.

- How can I contribute to git-upstream?

Git-upstream is in OpenStack:

  https://git.openstack.org/openstack/git-upstream

As for any other OpenStack project, contributions are submitted thru the Gerrit
review system.

To summarise:

1) create a Gerrit account (that is, a launchpad identity)

  click on the "Sign in" link in the upper right corner here:
  https://review.openstack.org

2) install git-review

  pip install git-review

3) clone the repo

  git clone https://git.openstack.org/openstack/git-upstream

4) setup to work with Gerrit

  cd git-upstream
  git review -s

  git-review will ask the username to use to submit changes to
  review.openstack.org, just enter the name you have registered in 1)

5) add cool features or fix nasty bugs

6) create your commit as usual

  git add/rm <...>
  git commit

7) submit the change for review

  git review

That's it. You can see your change signing in to your review.openstack.org
account.

Hold on tight, someone will come in shortly and will review your change!
Meanwhile, you can join the OpenStack community on IRC. There is also a
specific channel for git-upstream:

  #git-upstream

If you need help, please join us on IRC!

Before writing new code, it is always a good idea to check if the required
change is already in Gerrit:

  https://review.openstack.org/#/q/project:openstack/git-upstream,n,z

More info about OpenStack and the Gerrit review process.

https://wiki.openstack.org/wiki/IRC
http://www.mediawiki.org/wiki/Gerrit/git-review
http://docs.openstack.org/infra/manual/developers.html
http://docs.openstack.org/infra/manual/developers.html#development-workflow
https://review.openstack.org/#/q/status:open,n,z




            

Raw data

            {
    "_id": null,
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "cheesecake_code_kwalitee_id": null,
    "keywords": "git upstream workflow",
    "upload_time": "2016-11-02 16:05:00",
    "author": "Darragh Bailey",
    "home_page": "https://pypi.python.org/pypi/git-upstream",
    "download_url": "https://pypi.python.org/packages/61/cc/139a19e5a9da62a6efa179cee96412a83f7b20f6c80a0de50709a105b252/git-upstream-0.12.1.tar.gz",
    "platform": "",
    "version": "0.12.1",
    "cheesecake_documentation_id": null,
    "description": "- What is git-upstream?\n\ngit-upstream is an open source Python application that can be used to keep in\nsync with upstream open source projects, mainly OpenStack.\n\nThe main usecase for this tool is for people who are doing active contributions\nto repositories that are mirrors of OpenStack repositories, with the intention\nthat most of those contributions will be submitted to review.openstack.org at\nsome point.\nIf you are running a public cloud based on OpenStack, having local changes\nneeded to use it in your environment, you can use git-upstream to stay up to\ndate with the upstream master in a easier way (with respect to using raw git\ncommands).\n\ngit-upstream provides new git subcommands to support rebasing of local-carried\npatches on top of upstream repositories. It provides commands to ease the use\nof git for who needs to integrate big upstream projects in their environment.\nThe operations are performed using Git commands.\n\nSee also README.md, and USAGE.md files.\n\n- What git-upstream is not\n\nThe name of this tool includes the \"git-\" prefix because of the Git naming\nconvention that a Git subcommand must have. So, as git-review (usually invoked\nwith \"git review [...]\"), this tool can be invoked using \"git upstream [...]\".\nThat said, and even if git-upstream currently uses Change-Ids, it is not\nstrictly related to git-review.\nIn other words, git-review can (and most of the time will) be used without even\nknowing about git-upstream existence.\n\n- How can I contribute to git-upstream?\n\nGit-upstream is in OpenStack:\n\n  https://git.openstack.org/openstack/git-upstream\n\nAs for any other OpenStack project, contributions are submitted thru the Gerrit\nreview system.\n\nTo summarise:\n\n1) create a Gerrit account (that is, a launchpad identity)\n\n  click on the \"Sign in\" link in the upper right corner here:\n  https://review.openstack.org\n\n2) install git-review\n\n  pip install git-review\n\n3) clone the repo\n\n  git clone https://git.openstack.org/openstack/git-upstream\n\n4) setup to work with Gerrit\n\n  cd git-upstream\n  git review -s\n\n  git-review will ask the username to use to submit changes to\n  review.openstack.org, just enter the name you have registered in 1)\n\n5) add cool features or fix nasty bugs\n\n6) create your commit as usual\n\n  git add/rm <...>\n  git commit\n\n7) submit the change for review\n\n  git review\n\nThat's it. You can see your change signing in to your review.openstack.org\naccount.\n\nHold on tight, someone will come in shortly and will review your change!\nMeanwhile, you can join the OpenStack community on IRC. There is also a\nspecific channel for git-upstream:\n\n  #git-upstream\n\nIf you need help, please join us on IRC!\n\nBefore writing new code, it is always a good idea to check if the required\nchange is already in Gerrit:\n\n  https://review.openstack.org/#/q/project:openstack/git-upstream,n,z\n\nMore info about OpenStack and the Gerrit review process.\n\nhttps://wiki.openstack.org/wiki/IRC\nhttp://www.mediawiki.org/wiki/Gerrit/git-review\nhttp://docs.openstack.org/infra/manual/developers.html\nhttp://docs.openstack.org/infra/manual/developers.html#development-workflow\nhttps://review.openstack.org/#/q/status:open,n,z\n\n\n\n",
    "lcname": "git-upstream",
    "name": "git-upstream",
    "github": false,
    "bugtrack_url": "",
    "license": "Apache License (2.0)",
    "summary": "git tool to help manage upstream repositories",
    "split_keywords": [
        "git",
        "upstream",
        "workflow"
    ],
    "author_email": "dbailey@hpe.com",
    "urls": [
        {
            "has_sig": false,
            "upload_time": "2016-11-02T16:05:00",
            "comment_text": "",
            "python_version": "source",
            "url": "https://pypi.python.org/packages/61/cc/139a19e5a9da62a6efa179cee96412a83f7b20f6c80a0de50709a105b252/git-upstream-0.12.1.tar.gz",
            "md5_digest": "39c6ebd68dd3ee4de21242e387a7654c",
            "downloads": 0,
            "filename": "git-upstream-0.12.1.tar.gz",
            "packagetype": "sdist",
            "path": "61/cc/139a19e5a9da62a6efa179cee96412a83f7b20f6c80a0de50709a105b252/git-upstream-0.12.1.tar.gz",
            "size": 81670
        },
        {
            "has_sig": false,
            "upload_time": "2016-11-02T16:04:57",
            "comment_text": "",
            "python_version": "py2",
            "url": "https://pypi.python.org/packages/86/31/018f96258c6969d6b96d9d7832e8a4e7c46e656ab3d9dc4749e007af57b7/git_upstream-0.12.1-py2-none-any.whl",
            "md5_digest": "04968c0269987a707b7f92a859f38b39",
            "downloads": 0,
            "filename": "git_upstream-0.12.1-py2-none-any.whl",
            "packagetype": "bdist_wheel",
            "path": "86/31/018f96258c6969d6b96d9d7832e8a4e7c46e656ab3d9dc4749e007af57b7/git_upstream-0.12.1-py2-none-any.whl",
            "size": 116224
        }
    ],
    "cheesecake_installability_id": null
}
        
Elapsed time: 0.02425s