In category: ← Software Development / Project Management

About Klaus

Simple, easy-to-set-up Git web viewer that Just Works.

1504
0

Github stats:

Commits: N/A
N/A
N/A
Latest commit: N/A

Self-host this app for $0.99/mo only!

Languages/Platforms/Technologies:

Python

Lincenses:

More about Klaus

|travis-badge| |gitter-badge|

.. |travis-badge| image:: https://travis-ci.org/jonashaag/klaus.svg?branch=master :target: https://travis-ci.org/jonashaag/klaus

.. |gitter-badge| image:: https://badges.gitter.im/Join%20Chat.svg :alt: Join the chat at https://gitter.im/jonashaag/klaus :target: https://gitter.im/jonashaag/klaus?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge

klaus: a simple, easy-to-set-up Git web viewer that Just Works™.

(If it doesn't Just Work for you, please file a bug.)

Super easy to set up -- no configuration required
Syntax highlighting
Markdown + RestructuredText rendering support
Pull + push support (Git Smart HTTP)
Code navigation using Exuberant ctags

:Demo: http://klausdemo.lophus.org :Mailing list: http://groups.google.com/group/klaus-users :On PyPI: http://pypi.python.org/pypi/klaus/ :Wiki: https://github.com/jonashaag/klaus/wiki :License: ISC (BSD)

Running with Docker

The easiest way to get started. We maintain a Docker image that has syntax highlighting, Markdown rendering, code navigation, etc. pre-configured::

docker run -v /path/to/your/repos:/repos \ -p 7777:80 \ -it jonashaag/klaus:latest \ klaus --host 0.0.0.0 --port 80 /repos/repo1 /repos/repo2 ...

(Replace /path/to/your/repos with the folder that contains your Git repositories on the Docker host. You can also pass in multiple -v arguments if your repos are in multiple folders on the host.)

Go to http://localhost:7777 on the Docker host et voilà!

The command line above simply runs the klaus script -- for usage details, see the "Using the klaus script" section below.

Local setup

pip install klaus

(Optional dependencies: see Markup rendering <https://github.com/jonashaag/klaus/wiki/Markup-rendering>_ in the wiki.)

Usage

See also: Klaus wiki <https://github.com/jonashaag/klaus/wiki>_

Using the klaus script ^^^^^^^^^^^^^^^^^^^^^^^^^^ NOTE: This is intended for testing/low-traffic local installations only! The klaus script uses wsgiref_ internally which doesn't scale at all (in fact it's single-threaded and non-asynchronous).

To run klaus using the default options:

.. code-block:: bash

# With Docker: docker run ... jonashaag/klaus:latest klaus [repo1 [repo2 ...]] # Local setup: klaus [repo1 [repo2 ...]]

For more options, see:

.. code-block:: bash

# With Docker:

docker run ... jonashaag/klaus:latest klaus --help # Local setup: klaus --help

Using a real server ^^^^^^^^^^^^^^^^^^^ The klaus module contains a make_app function which returns a WSGI app.

An example WSGI helper script is provided with klaus (see klaus/contrib/wsgi.py), configuration being read from environment variables. Use it like this (uWSGI example)::

uwsgi -w klaus.contrib.wsgi \ --env KLAUS_SITE_NAME="Klaus Demo" \ --env KLAUS_REPOS="/path/to/repo1 /path/to/repo2 ..." \ ...

Gunicorn example::

gunicorn --env KLAUS_SITE_NAME="Klaus Demo" \ --env KLAUS_REPOS="/path/to/repo1 /path/to/repo2 ..." \ klaus.contrib.wsgi

The Docker image also has uwsgi preinstalled::

docker run ... jonashaag/klaus:latest uwsgi ...

See also deployment section in the wiki <https://github.com/jonashaag/klaus/wiki#deployment>_.

.. _wsgiref: http://docs.python.org/library/wsgiref.html