^\.coverage$

^kallithea\.db$

^test\.db$

^rc.*\.ini$

^fabfile.py

^\.idea$

    Marcin Kuźmiński <marcin@python-works.com>

    Lukasz Balcerzak <lukaszbalcerzak@gmail.com>

    Jason Harris <jason@jasonfharris.com>

    Jelmer Vernooij <jelmer@samba.org>

    larikale

    SteveCohen

    Sebastian Kreutzberger <sebastian@rhodecode.com>

    thomas <thomas@rhodecode.com>

=========

=========

About

-----

with a built in push/pull server, full text search and code-review.

It works on http/https and has a built in permission/authentication system with

simple API so it's easy integrable with existing external systems.

It is open source and donation ware and focuses more on providing a customized,

self administered interface for Mercurial_ and GIT_  repositories.

that Lukasz Balcerzak and Marcin Kuzminski created to handle multiple

different version control systems.

Installation

------------

    easy_install kallithea

------------------

- Has its own middleware to handle mercurial_ and git_ protocol requests.

- Built in Gist functionality for sharing code snippets.

- Integrates easily with other systems, with custom created mappers you can connect it to almost

  any issue tracker, and with an JSON-RPC API you can make much more

  web interface using simple editor or upload binary files using simple form.

- Powerfull pull-request driven review system with inline commenting,

  changeset statuses, and notification system.

License

-------

Getting help

Online documentation

--------------------

 - http://packages.python.org/Kallithea/

 - http://kallithea.readthedocs.org/

################################################################################

################################################################################

#                                                                              #

# The %(here)s variable will be replaced with the parent directory of this file#

################################################################################

################################################################################

## Uncomment and replace with the address which should receive                ##

## any error reports after application crash                                  ##

################################################################################

#email_to = admin@localhost

#error_email_from = paste_error@localhost

#app_email_from = kallithea-noreply@localhost

#error_message =

#smtp_server = mail.server.com

#smtp_username =

## use cache version of scm repo everywhere

vcs_full_cache = true

force_https = false

## use Strict-Transport-Security headers

## gist URL alias, used to create nicer urls for gist. This should be an

## url that does rewrites to _admin/gists/<gistid>.

## example: http://gist.kallithea.server/{gistid}. Empty means use the internal

gist_alias_url =

## white list of API enabled controllers. This allows to add list of

## {email}        user email

## {md5email}     md5 hash of the user email (like at gravatar.com)

## {size}         size of the image that is expected from the server application

#alternative_gravatar_url = http://myavatarserver.com/getbyemail/{email}/{size}

#alternative_gravatar_url = http://myavatarserver.com/getbymd5/{md5email}?s={size}

#clone_uri = {scheme}://{user}{pass}{netloc}{path}

#bugtracker = https://bitbucket.org/conservancy/kallithea/issues

## issue tracking mapping for commits messages

### [errormator] ###

####################

## http://errormator.com for details how to obtain an account

## you must install python package `errormator_client` to make it work

# Change variables/paths as necessary and place file /etc/init/celeryd.conf

# start/stop/restart as normal upstart job (ie: $ start celeryd)

author		"Matt Zuba <matt.zuba@goodwillaz.org"

start on starting kallithea

##################################################

#

# Recommended default-startup: 2 3 4 5

# Recommended default-stop: 0 1 6

#

LOG_PATH="/var/log/kallithea/kallithea.log"

# replace this with the path to the virtual environment you

PYTHON_PATH="/opt/python_virtualenvironments/kallithea-venv"

RUN_AS="kallithea"

    status_kallithea

    RETVAL=$?

    if [ ! $RETVAL -eq 0 ]; then

    else

    fi

    ;;

  restart)

# Change variables/paths as necessary and place file /etc/init/kallithea.conf

# start/stop/restart as normal upstart job (ie: $ start kallithea)

author		"Matt Zuba <matt.zuba@goodwillaz.org"

start on (local-filesystems and runlevel [2345])

; ##########################

; for help see http://supervisord.org/configuration.html

; ##########################

kallithea.__init__

~~~~~~~~~~~~~~~~~~

versioning implementation: http://www.python.org/dev/peps/pep-0386/

This file was forked by the Kallithea project in July 2014.

kallithea.bin.__init__

~~~~~~~~~~~~~~~~~~~~~~

This file was forked by the Kallithea project in July 2014.

Original author and date, and relevant copyright and licensing information is below:

def api_call(apikey, apihost, method=None, **kw):

    """

    :param apikey:

    :param apihost:

class RcConf(object):

    """

    conf = RcConf()

    conf['key']

kallithea.bin.api

~~~~~~~~~~~~~~~~~

This file was forked by the Kallithea project in July 2014.

Original author and date, and relevant copyright and licensing information is below:

      "Create config file: kallithea-api --apikey=<key> --apihost=http://your.kallithea.server --save-config"

    )

                                     usage=usage)

    ## config

kallithea.bin.kallithea_config

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This file was forked by the Kallithea project in July 2014.

Original author and date, and relevant copyright and licensing information is below:

    )

    parser = argparse.ArgumentParser(

        usage=usage

    )

kallithea.bin.kallithea_gist

~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This file was forked by the Kallithea project in July 2014.

Original author and date, and relevant copyright and licensing information is below:

      "Create config file: kallithea-gist --apikey=<key> --apihost=http://your.kallithea.server --save-config"

    )

                                     usage=usage)

    ## config

        }

    def post(self, method, args):

        This will generate the UUID for validation check after the

        response is returned. Handle errors and get the result back.

        return response["result"]

    def create_group(self, name, active=True):

        args = {

            "group_name": name,

            "active": str(active)

                                          config.get("default", "api_key"))

    def update_groups_from_ldap(self):

        added = existing = 0

        groups = self.ldap_client.get_groups()

        for group in groups:

<%text>

################################################################################

################################################################################

# Built-in functions and variables                                             #

# The ${here} variable will be replaced with the parent directory of this file #

# ${uuid()} function will generate a unique hash                               #

################################################################################

## Uncomment and replace with the address which should receive                ##

## any error reports after application crash                                  ##

################################################################################

</%text>

#email_to = admin@localhost

#error_email_from = paste_error@localhost

#app_email_from = kallithea-noreply@localhost

#error_message =

#smtp_server = mail.server.com

#smtp_username =

<%text>## use cache version of scm repo everywhere</%text>

vcs_full_cache = true

force_https = false

<%text>## use Strict-Transport-Security headers</%text>

<%text>## gist URL alias, used to create nicer urls for gist. This should be an</%text>

<%text>## url that does rewrites to _admin/gists/<gistid>.</%text>

<%text>## example: http://gist.kallithea.server/{gistid}. Empty means use the internal</%text>

gist_alias_url =

<%text>## white list of API enabled controllers. This allows to add list of</%text>

<%text>## {email}        user email</%text>

<%text>## {md5email}     md5 hash of the user email (like at gravatar.com)</%text>

<%text>## {size}         size of the image that is expected from the server application</%text>

#alternative_gravatar_url = http://myavatarserver.com/getbyemail/{email}/{size}

#alternative_gravatar_url = http://myavatarserver.com/getbymd5/{md5email}?s={size}

#clone_uri = {scheme}://{user}{pass}{netloc}{path}

#bugtracker = https://bitbucket.org/conservancy/kallithea/issues

<%text>## issue tracking mapping for commits messages</%text>

### [errormator] ###

####################

## http://errormator.com for details how to obtain an account

## you must install python package `errormator_client` to make it work

</%text>

kallithea.config.conf

~~~~~~~~~~~~~~~~~~~~~

This file was forked by the Kallithea project in July 2014.

Original author and date, and relevant copyright and licensing information is below:

################################################################################

################################################################################

#                                                                              #

# The %(here)s variable will be replaced with the parent directory of this file#

################################################################################

################################################################################

## Uncomment and replace with the address which should receive                ##

## any error reports after application crash                                  ##

################################################################################

#email_to = admin@localhost

#error_email_from = paste_error@localhost

#app_email_from = kallithea-noreply@localhost

#error_message =

#smtp_server = mail.server.com

#smtp_username =

## use cache version of scm repo everywhere

vcs_full_cache = true

force_https = false

## use Strict-Transport-Security headers

## gist URL alias, used to create nicer urls for gist. This should be an

## url that does rewrites to _admin/gists/<gistid>.

## example: http://gist.kallithea.server/{gistid}. Empty means use the internal

gist_alias_url =

## white list of API enabled controllers. This allows to add list of

## {email}        user email

## {md5email}     md5 hash of the user email (like at gravatar.com)

## {size}         size of the image that is expected from the server application

#alternative_gravatar_url = http://myavatarserver.com/getbyemail/{email}/{size}

#alternative_gravatar_url = http://myavatarserver.com/getbymd5/{md5email}?s={size}

#clone_uri = {scheme}://{user}{pass}{netloc}{path}

#bugtracker = https://bitbucket.org/conservancy/kallithea/issues

## issue tracking mapping for commits messages

### [errormator] ###

####################

## http://errormator.com for details how to obtain an account

## you must install python package `errormator_client` to make it work

    # Initialize config with the basic options

    config.init_app(global_conf, app_conf, package='kallithea', paths=paths)

    kallithea.CELERY_ON = str2bool(config['app_conf'].get('use_celery'))

    kallithea.CELERY_EAGER = str2bool(config['app_conf'].get('celery.always.eager'))

def main():

    if kallithea is None:

        # this allows simply push to this repo even without

        sys.exit(0)

    repo_path = os.path.abspath('.')

    push_data = sys.stdin.readlines()

    # os.environ is modified here by a subprocess call that

    # runs git and later git executes this hook.

    # like IP or username from basic-auth

    _handler(repo_path, push_data, os.environ)

    sys.exit(0)

def main():

    if kallithea is None:

        # this allows simply push to this repo even without

        sys.exit(0)

    repo_path = os.path.abspath('.')

    push_data = sys.stdin.readlines()

    # os.environ is modified here by a subprocess call that

    # runs git and later git executes this hook.

    # like IP or username from basic-auth

    _handler(repo_path, push_data, os.environ)

    sys.exit(0)

#==============================================================================

# this function will be executed after each push it's executed after the

def _pushhook(*args, **kwargs):

    """

    Post push hook

#==============================================================================

# this function will be executed after each push it's executed after the

def _pullhook(*args, **kwargs):

    """

    Post pull hook

kallithea.controllers.admin.admin

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This file was forked by the Kallithea project in July 2014.

Original author and date, and relevant copyright and licensing information is below:

kallithea.controllers.admin.auth_settings

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This file was forked by the Kallithea project in July 2014.

Original author and date, and relevant copyright and licensing information is below:

kallithea.controllers.admin.defaults

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This file was forked by the Kallithea project in July 2014.

Original author and date, and relevant copyright and licensing information is below:

kallithea.controllers.admin.gist

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This file was forked by the Kallithea project in July 2014.

Original author and date, and relevant copyright and licensing information is below:

kallithea.controllers.admin.my_account

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This file was forked by the Kallithea project in July 2014.

Original author and date, and relevant copyright and licensing information is below:

kallithea.controllers.admin.notifications

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This file was forked by the Kallithea project in July 2014.

Original author and date, and relevant copyright and licensing information is below:

kallithea.controllers.admin.permissions

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This file was forked by the Kallithea project in July 2014.

Original author and date, and relevant copyright and licensing information is below:

kallithea.controllers.admin.repo_groups

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This file was forked by the Kallithea project in July 2014.

Original author and date, and relevant copyright and licensing information is below:

kallithea.controllers.admin.repos

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This file was forked by the Kallithea project in July 2014.

Original author and date, and relevant copyright and licensing information is below:

kallithea.controllers.admin.settings

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This file was forked by the Kallithea project in July 2014.

Original author and date, and relevant copyright and licensing information is below:

        c.active = 'email'

        if request.POST:

            test_email = request.POST.get('test_email')

            if not test_email:

                h.flash(_('Please enter email address'), category='error')

                return redirect(url('admin_settings_email'))

            ver = kallithea.__version__

            log.debug('Checking for upgrade on `%s` server' % _update_url)

            opener = urllib2.build_opener()

            response = opener.open(_update_url)

            response_data = response.read()

            data = json.loads(response_data)

    def create(self):