Metadata-Version: 2.0
Name: ghp-import2
Version: 1.0.0
Summary: A GitHub Pages import tool.
Home-page: https://github.com/ionelmc/python-ghp-import
Author: Ionel Cristian Mărieș
Author-email: contact@ionelmc.ro
License: TPL
Keywords: github,github pages,ghp,git,pages
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Utilities

===============================
ghp-import2
===============================

A dumb GitHub Pages import tool. Packaging is fixed here.

Warning
-------

This will **DESTROY** your ``gh-pages`` branch. If you love it, you'll want to
take backups before playing with this. This script assumes that `gh-pages` is
100% derivative. You should never edit files in your `gh-pages` branch by hand
if you're using this script because you will lose your work.

Usage
-----

    Usage: ghp-import [OPTIONS] DIRECTORY

    Options:
      -n          Include a .nojekyll file in the branch.
      -m MESG     The commit message to use on the target branch.
      -p          Push the branch to origin/{branch} after committing.
      -r REMOTE   The name of the remote to push to. [origin]
      -b BRANCH   Name of the branch to write to. [gh-pages]
      -h, --help  show this help message and exit

Its pretty simple. Inside your repository just run ``ghp-import $DOCS_DIR``
where ``$DOCS_DIR`` is the path to the **built** documentation. This will write a
commit to your ``gh-pages`` branch with the current documents in it.

If you specify ``-p`` it will also attempt to push the ``gh-pages`` branch to
GitHub. By default it'll just run ``git push origin gh-pages``. You can specify
a different remote using the ``-r`` flag.

You can specify a different branch with ``-b``. This is useful for user and
organization page, which are served from the ``master`` branch.

``ghp-import`` also recognizes the ``GIT_DIR`` environment variable which can be
useful for Git hooks.

License
-------

``ghp-import`` is distributed under the Tumbolia Public License. See the LICENSE
file for more information.


Changelog
=========

1.0.0 (2015-05-09)
-----------------------------------------

* First release on PyPI.


