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/

pgs -p /var/www/html

Serve the gh-pages branch of this repo from http://localhost:8083

pgs -g $VIRTUAL_ENV/src/pgs -r gh-pages -P 8083

Further Usage:

$ 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

develop (2018-02-10 16:49:59 -0500)

git log --reverse --pretty=format:'* %s [%h]' v0.1.3..develop

MRG: Merge tag ‘v0.1.3’ into develop [587b2ae]
DOC: HISTORY.rst: git-changelog.py –develop [141d436]

v0.1.3 (2018-02-10 16:39:21 -0500)

git log --reverse --pretty=format:'* %s [%h]' v0.1.2..v0.1.3

Merge tag ‘v0.1.2’ into develop [f0d9ad0]
DOC: setup.py: BSD License -> MIT License [7744a0a]
DOC: setup.py: description [905ff64]
MRG: Merge branch ‘master’ of ssh://github.com/westurner/pgs into release/0.1.3 [82f3ab9]
DOC: __init__.py, setup.py: v0.1.3, rm email [3945696]
MRG: Merge branch ‘release/0.1.3’ [c8b3b9e]

v0.1.2 (2015-04-17 08:26:35 -0500)

git log --reverse --pretty=format:'* %s [%h]' v0.1.1..v0.1.2

BLD: requirements.txt: comment out bottle requirement [e1416df]
BLD: setup.py: codecs.open(encoding=’UTF8’) [75edc38]
TST: tests/www [b332875]
BUG,TST,REF: unit tests, WebTest WSGI tests [f08480d]
RLS: setup.py, __init__.py: version=0.1.2 [2edc3a4]
Merge branch ‘release/0.1.2’ [0bf19d3]

v0.1.1 (2015-04-16 19:45:18 -0500)

git log --reverse --pretty=format:'* %s [%h]' 148d848..v0.1.1

BLD: app.py, bottle.py: import bottle.py, static files w/ try files .html [eed09fc]
TODO: ENH: add *FS objects [e80d75e]
ENH: app.py: host a git branch/revision/tag over HTTP [3487e53]
Initial commit [f124283]
Merge branch ‘master’ of ssh://github.com/westurner/pygitpages [69b278c]
DOC,CLN: pygitpages.py/app.py [552017e]
BLD: cookiecutter gh:audreyr/cookiecutter-pypackage <pgs> [d791e95]
Merge pgs cookiecutter [13edcb9]
REF: pygitpages/app.py, bottle.py -> pgs/ [1f9ce1d]
CLN: rm pygitpages/ [2ab456e]
DOC: app.py: pgs, description [d4d46af]
BLD: requirements.txt: add ‘bottle’ (though it is also vendored) [c224ef1]
BLD: setup.py: add pgs console_script entry_point to pgs.app:main [01848bd]
REF: pygitpages -> pgs [1a781af]
DOC: README.rst, app.py: usage, features [259bd0c]
DOC: README.rst: RST formatting [8beee37]
DOC: README.rst: Caveat Emptor [ec590d1]

Metadata

Release files for pgs 0.1.4

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

Source distribution (sdist)

Source distribution for pgs 0.1.4
File	Size	Uploaded
pgs-0.1.4.tar.gz	63.6 kB	Feb 10, 2018	Details

Built distribution (wheel)

Table of built distributions (wheels) for pgs 0.1.4
File	Interpreter	ABI	Platform	Reset
pgs-0.1.4-py2.py3-none-any.whl 54.3 kB Feb 10, 2018	Python 3, Python 2	none	any	Details

Total release size: 117.9 kB

Release files / pgs-0.1.4.tar.gz

Download URL	pgs-0.1.4.tar.gz
Size	63.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`66f021f8357073a26eea6b4a9f55ab210d8624ca19b4923aff580f62332e19f6`
BLAKE2b-256 checksum How to use checksums	`fc8ff3420709b35d7e47f12ad0f4b8c182b01739a0b60f3889a70f469585b0ed`
Upload date	Feb 10, 2018
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / pgs-0.1.4-py2.py3-none-any.whl

Download URL	pgs-0.1.4-py2.py3-none-any.whl
Size	54.3 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`b91867f84e5e9255fe5cfd32d5531e82dfbe1160cc5768247adfd337eeaff5ba`
BLAKE2b-256 checksum How to use checksums	`83f1bcbbf78a12ceab88ef11f46171c5a58c49991d959d39a4843ee24ea34378`
Upload date	Feb 10, 2018
Uploaded using Trusted Publishing? What is trusted publishing?	No