Metadata-Version: 1.1
Name: pgs
Version: 0.1.3
Summary: A bottle webapp for serving static files from a git branch, or from the local filesystem.
Home-page: https://github.com/westurner/pgs
Author: Wes Turner
Author-email: wes@wrd.nu
License: BSD
Description: ===============================
        pgs
        ===============================
        
        .. .. image:: https://img.shields.io/travis/westurner/pgs.svg
        ..         :target: https://travis-ci.org/westurner/pgs
        
        .. .. image:: https://img.shields.io/pypi/v/pgs.svg
        ..        :target: https://pypi.python.org/pypi/pgs
        
        A bottle webapp for serving static files from a git branch,
        or from the local filesystem.
        
        * Free software: MIT license
        * Source: https://github.com/westurner/pgs
        
        
        Features
        --------
        
        * [x] Serve static files from a filesystem directory
        * [x] Serve static files from a git branch,
          with Last-Modified headers according to git timestamps
        * [x] Guess MIME-types from paths
        * [x] subprocess bindings to ``git cat-file`` and ``git show``
        * [ ] dulwich
        * [ ] pygit2
        
        
        Usage
        ------
        
        Serve ``/var/www/html`` from http://localhost:8082/
        
        .. code:: bash
        
           pgs -p /var/www/html
        
        Serve the ``gh-pages`` branch of this repo from http://localhost:8083
        
        .. code:: bash
        
           pgs -g $VIRTUAL_ENV/src/pgs -r gh-pages -P 8083
        
        
        Further Usage:
        
        .. code:: bash
        
            $ pgs --help
            Usage: pgs [-p <path>] [-g <repopath>] [-r <rev/tag/branch>]
        
            Serve a directory or a git revision over HTTP with Bottle, WSGI, MIME types,
            and Last-Modified headers
        
            Options:
              -h, --help            show this help message and exit
              -p ROOT_FILEPATH, --path=ROOT_FILEPATH, --root_filepath=ROOT_FILEPATH
              -g GIT_REPO_PATH, --git=GIT_REPO_PATH
                                    Path to git repo to serve files from
              -r GIT_REPO_REV, --rev=GIT_REPO_REV
                                    Git repo revision (commit hash, branch, tag)
              -H HOST, --host=HOST  
              -P PORT, --port=PORT  
              --debug               set bottle debug=False
              --reload              set bottle reload=False
              -v, --verbose         
              -q, --quiet           
              -t, --test
        
        
        Caveat Emptor
        ---------------
        * Upstream caching would be necessary for all but the most local use
          cases
        * True git bindings would likely do less buffering of
          ``subprocess.check_output``
        
        
        
        
        History
        -------
        
        0.1.1 (2015-04-16)
        ---------------------
        
        * First release on PyPI.
        
Keywords: pgs
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
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
