connect it to almost any issue tracker, and with a JSON-RPC API you can make

  much more.

- Built-in commit API lets you add, edit and commit files right from Kallithea

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

- Powerful pull request driven review system with inline commenting, changeset

  statuses, and notification system.

- Mako templates let you customize the look and feel of the application.

- Beautiful diffs, annotations and source code browsing all colored by

  pygments. Raw diffs are made in Git-diff format for both VCS systems,

  including Git_ binary-patches.

- Mercurial_ and Git_ DAG graphs and Flot-powered graphs with zooming and

  statistics to track activity for repositories.

.. _Python: http://www.python.org/

.. _Sphinx: http://sphinx.pocoo.org/

.. _Mercurial: http://mercurial.selenic.com/

.. _Bitbucket: http://bitbucket.org/

.. _GitHub: http://github.com/

.. _Git: http://git-scm.com/

.. _Celery: http://celeryproject.org/

.. _Software Freedom Conservancy: http://sfconservancy.org/

.. _Puppet module: https://forge.puppetlabs.com/rauch/kallithea

   dev/dbmigrations

.. _python: http://www.python.org/

.. _django: http://www.djangoproject.com/

.. _mercurial: https://www.mercurial-scm.org/

.. _git: http://git-scm.com/

.. _celery: http://celeryproject.org/

.. _Sphinx: http://sphinx.pocoo.org/

.. _vcs: http://pypi.python.org/pypi/vcs

Cloning remote repositories

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

Kallithea has the ability to clone repositories from given remote locations.

If you need to clone repositories that are protected via basic authentication,

you can pass the credentials in the URL, e.g.

``http://user:passw@remote.example.com/repo``. Kallithea will then try to login and

clone using the given credentials. Please note that the given credentials will

be stored as plaintext inside the database. However, the authentication

from kallithea.config.routing import url

from kallithea.lib import helpers as h

from kallithea.lib.auth import HasPermissionAnyDecorator, LoginRequired

from kallithea.lib.base import BaseController, render

from kallithea.lib.celerylib import tasks

from kallithea.lib.utils import repo2db_mapper, set_app_settings

from kallithea.lib.utils2 import safe_str

from kallithea.lib.vcs import VCSError

from kallithea.model.db import Repository, Setting, Ui

from kallithea.model.forms import ApplicationSettingsForm, ApplicationUiSettingsForm, ApplicationVisualisationForm

from kallithea.model.meta import Session

                sett.ui_active = form_result['hooks_changegroup_repo_size']

                ## EXTENSIONS

                sett = Ui.get_or_create('extensions', 'largefiles')

                sett.ui_active = form_result['extensions_largefiles']

#                sett = Ui.get_or_create('extensions', 'hggit')

#                sett.ui_active = form_result['extensions_hggit']

                Session().commit()

                h.flash(_('Updated VCS settings'), category='success')

            except Exception:

                log.error(traceback.format_exc())

                h.flash(_('Error occurred while updating '

                          'application settings'), category='error')

        defaults = Setting.get_app_settings()

msgid "An error occurred during deletion of repository stats"

msgstr "Адбылася памылка пры выдаленні статыстыкі рэпазітара"

msgid "Updated VCS settings"

msgstr "Абноўлены налады VCS"

msgid "Error occurred while updating application settings"

msgstr "Памылка пры абнаўленні наладаў праграмы"

msgid "Repositories successfully rescanned. Added: %s. Removed: %s."

msgstr "Рэпазітары паспяхова перасканаваныя, дададзена: %s, выдалена: %s."

msgid "Repository group with name \"%(repo)s\" already exists"

msgstr "Група рэпазітароў \"%(repo)s\" ужо існуе"

msgid "Invalid repository URL"

msgstr "Няслушны URL рэпазітара"

msgid "Fork has to be the same type as parent"

msgstr "Тып форка будзе супадаць з бацькоўскім"

msgid "You don't have permissions to create repository in this group"

msgstr "У вас недастаткова правоў для стварэння рэпазітароў у гэтай групе"

msgid "Mercurial extensions"

msgstr "Пашырэнні Mercurial"

msgid "Enable largefiles extension"

msgstr "Уключыць падтрымку вялікіх файлаў"

msgid "Location of repositories"

msgstr "Месцазнаходжанне рэпазітароў"

msgid ""

"Click to unlock. You must restart Kallithea in order to make this setting "

"take effect."

msgid "An error occurred during deletion of repository stats"

msgstr "Der opstod en fejl under sletning af repository statistik"

msgid "Updated VCS settings"

msgstr "Opdateret VCS-indstillinger"

msgid "Error occurred while updating application settings"

msgstr "Der opstod en fejl ved opdatering af applikationsindstillinger"

msgid "Repositories successfully rescanned. Added: %s. Removed: %s."

msgstr "Repositories genscannet successfuldt. Tilføjet: %s. Fjernet: %s."

msgid "An error occurred during deletion of repository stats"

msgstr "Während des löschens der Repository Statistiken trat ein Fehler auf"

msgid "Updated VCS settings"

msgstr "VCS-Einstellungen aktualisiert"

msgid "Error occurred while updating application settings"

msgstr ""

"Ein Fehler ist während der Aktualisierung der Applikationseinstellungen "

"aufgetreten"

msgid "Repositories successfully rescanned. Added: %s. Removed: %s."

msgid "Repository group with name \"%(repo)s\" already exists"

msgstr "Eine Repositorygruppe mit dem Namen \"%(repo)s\" existiert bereits"

msgid "Invalid repository URL"

msgstr "Ungültige Repository-URL"

msgid "Fork has to be the same type as parent"

msgstr "Forke um den selben typ wie der Vorgesetze zu haben"

msgid "You don't have permissions to create repository in this group"

msgstr ""

"Du hast nicht die erforderlichen Berechtigungen, um in dieser Gruppe ein "

msgid "Mercurial extensions"

msgstr "Mercurial-Erweiterungen"

msgid "Enable largefiles extension"

msgstr "Erweiterung largefiles aktivieren"

msgid "Location of repositories"

msgstr "Ort der Repositories"

msgid ""

"Click to unlock. You must restart Kallithea in order to make this setting "

"take effect."

msgstr ""

"Παρουσιάστηκε σφάλμα κατά τη διαγραφή των στατιστικών του αποθετηρίου"

msgid "Updated VCS settings"

msgstr "Ενημερωμένες ρυθμίσεις VCS"

msgid "Error occurred while updating application settings"

msgstr "Παρουσιάστηκε σφάλμα κατά την ενημέρωση των ρυθμίσεων της εφαρμογής"

msgid "Repositories successfully rescanned. Added: %s. Removed: %s."

msgstr ""

"Τα αποθετήρια ξανασαρώθηκαν επιτυχώς. Προστέθηκαν: %s. Αφαιρέθηκαν %s."

msgid "Repository group with name \"%(repo)s\" already exists"

msgstr "Η ομάδα αποθετηρίου με το όνομα \"%(repo)s\" υπάρχει ήδη"

msgid "Invalid repository URL"

msgstr "Μη έγκυρη διεύθυνση URL αποθετηρίου"

msgid "You don't have permissions to create repository in this group"

msgstr "Δεν έχετε δικαιώματα δημιουργίας αποθετηρίου σε αυτήν την ομάδα"

msgid "no permission to create repository in root location"

msgstr "Δεν υπάρχει δικαίωμα δημιουργίας αποθετηρίου στη ριζική τοποθεσία"

msgid "Mercurial extensions"

msgstr "Επεκτάσεις Mercurial"

msgid "Enable largefiles extension"

msgstr "Ενεργοποίηση επέκτασης μεγάλων αρχείων"

msgid "Location of repositories"

msgstr "Τοποθεσία αποθετηρίων"

msgid ""

"Click to unlock. You must restart Kallithea in order to make this setting "

"take effect."

msgstr ""

"Une erreur est survenue durant la suppression des statistiques du dépôt"

msgid "Updated VCS settings"

msgstr "Réglages des gestionnaires de versions mis à jour"

msgid "Error occurred while updating application settings"

msgstr ""

"Une erreur est survenue durant la mise à jour des réglages de "

"l'application"

msgid "Repositories successfully rescanned. Added: %s. Removed: %s."

msgid "Repository group with name \"%(repo)s\" already exists"

msgstr "Un groupe de dépôts avec le nom « %(repo)s » existe déjà"

msgid "Invalid repository URL"

msgstr "URL de dépôt invalide"

msgid "Fork has to be the same type as parent"

msgstr "Le fork doit être du même type que le parent"

msgid "You don't have permissions to create repository in this group"

msgstr "Vous n’avez pas la permission de créer un dépôt dans ce"

msgid "Mercurial extensions"

msgstr "Extensions Mercurial"

msgid "Enable largefiles extension"

msgstr "Activer l'extension largefiles"

msgid "Location of repositories"

msgstr "Emplacement des dépôts"

msgid ""

"Click to unlock. You must restart Kallithea in order to make this setting "

"take effect."

msgid "An error occurred during deletion of repository stats"

msgstr "リポジトリステートの削除中にエラーが発生しました"

msgid "Updated VCS settings"

msgstr "VCS設定を更新しました"

msgid "Error occurred while updating application settings"

msgstr "アプリケーション設定の更新中にエラーが発生しました"

msgid "Repositories successfully rescanned. Added: %s. Removed: %s."

msgstr "リポジトリの再スキャンに成功しました。 追加: %s 削除: %s。"

msgid "Mercurial extensions"

msgstr "Mercurialエクステンション"

msgid "Enable largefiles extension"

msgstr "largefilesエクステンションを有効にする"

msgid "Location of repositories"

msgstr "リポジトリの場所"

msgid ""

"Click to unlock. You must restart Kallithea in order to make this setting "

"take effect."

msgid "Update repository after push (hg update)"

msgstr "Aktualizacja repozytorium po wysłaniu zmian (aktualizacja hg)"

msgid "Enable largefiles extension"

msgstr "Rozszerzenia dużych plików"

msgid ""

"Click to unlock. You must restart Kallithea in order to make this setting "

"take effect."

msgstr ""

"Kliknij, aby odblokować. Musisz ponownie uruchomić Kallithea żeby "

"wprowadzić to ustawienie w życie."

msgid "Update repository after push (hg update)"

msgstr "Atualizar repositório após realizar push (hg update)"

msgid "Enable largefiles extension"

msgstr "Ativar extensão largefiles"

msgid ""

"Click to unlock. You must restart Kallithea in order to make this setting "

"take effect."

msgstr ""

"Clique para destravar. Deve reiniciar o Kallithea para que esta "

"configuração tenha efeito."

msgid "Update repository after push (hg update)"

msgstr "Atualizar repositório após realizar push (hg update)"

msgid "Enable largefiles extension"

msgstr "Habilitar extensão largefiles"

msgid ""

"Click to unlock. You must restart Kallithea in order to make this setting "

"take effect."

msgstr ""

"Clique para destravar. Você deve reiniciar o Kallithea para que esta "

"configuração tenha efeito."

msgid "An error occurred during deletion of repository stats"

msgstr "Произошла ошибка при удалении статистики репозитория"

msgid "Updated VCS settings"

msgstr "Обновлены настройки VCS"

msgid "Error occurred while updating application settings"

msgstr "Произошла ошибка при обновлении настроек приложения"

msgid "Repositories successfully rescanned. Added: %s. Removed: %s."

msgstr "Репозитории успешно пересканированы, добавлено: %s, удалено: %s."

msgid "Repository group with name \"%(repo)s\" already exists"

msgstr "Группа репозиториев \"%(repo)s\" уже существует"

msgid "Invalid repository URL"

msgstr "Недопустимый URL репозитория"

msgid "Fork has to be the same type as parent"

msgstr "Форк будет иметь тот же тип, что и родительский"

msgid "You don't have permissions to create repository in this group"

msgstr "У вас недостаточно прав для создания репозиториев в этой группе"

msgid "Mercurial extensions"

msgstr "Расширения Mercurial"

msgid "Enable largefiles extension"

msgstr "Включить поддержку больших файлов"

msgid "Location of repositories"

msgstr "Местонахождение репозиториев"

msgid ""

"Click to unlock. You must restart Kallithea in order to make this setting "

"take effect."

msgid "An error occurred during deletion of repository stats"

msgstr "Під час видалення статистики репозиторію сталася помилка"

msgid "Updated VCS settings"

msgstr "Оновлені налаштування VCS"

msgid "Error occurred while updating application settings"

msgstr "Під час оновлення параметрів застосунку сталася помилка"

msgid "Repositories successfully rescanned. Added: %s. Removed: %s."

msgstr "Репозиторії успішно перескановано. Додано: %s. Видалено: %s."

msgid "Mercurial extensions"

msgstr "Mercurial  розширення"

msgid "Enable largefiles extension"

msgstr "Увімкнути розширення largefiles"

msgid "Location of repositories"

msgstr "Розташування репозиторіїв"

msgid ""

"Click to unlock. You must restart Kallithea in order to make this setting "

"take effect."

            ('paths', '/', repo_root_path, True),

            #('phases', 'publish', 'false', False)

            ('hooks', Ui.HOOK_UPDATE, 'hg update >&2', False),

            ('hooks', Ui.HOOK_REPO_SIZE, 'python:kallithea.lib.hooks.repo_size', True),

            ('extensions', 'largefiles', '', True),

            ('largefiles', 'usercache', os.path.join(repo_root_path, '.cache', 'largefiles'), True),

            ('extensions', 'hggit', '', False),

        ]

        for ui_section, ui_key, ui_value, ui_active in ui_config:

            ui_conf = Ui(

                ui_section=ui_section,

                ui_key=ui_key,

class UserCreationError(Exception):

    pass

class InvalidCloneUriException(Exception):

    pass

            try:

                MercurialRepository._check_url(url, ui)

            except urllib.error.URLError as e:

                raise InvalidCloneUriException('URI %s URLError: %s' % (url, e))

            except mercurial.error.RepoError as e:

                raise InvalidCloneUriException('Mercurial %s: %s' % (type(e).__name__, safe_str(bytes(e))))

        elif url.startswith('git+http'):

            raise InvalidCloneUriException('URI type %s not implemented' % (url,))

        else:

            raise InvalidCloneUriException('URI %s not allowed' % (url,))

    elif repo_type == 'git':

            # initially check if it's at least the proper URL

            # or does it pass basic auth

            try:

                GitRepository._check_url(url)

            except urllib.error.URLError as e:

                raise InvalidCloneUriException('URI %s URLError: %s' % (url, e))

        elif url.startswith('hg+http'):

            raise InvalidCloneUriException('URI type %s not implemented' % (url,))

        else:

            raise InvalidCloneUriException('URI %s not allowed' % (url))

    """

    Base Repository for final backends

    **Attributes**

        ``DEFAULT_BRANCH_NAME``

        ``scm``

            alias of scm, i.e. *git* or *hg*

        ``repo``

            object from external api

        ``raw_id``

            raw changeset representation (i.e. full 40 length sha for git

            backend)

        ``short_id``

            shortened (if apply) version of ``raw_id``; it would be simple

        ``revision``

            revision number as integer

        ``files``

            list of ``FileNode`` (``Node`` with NodeKind.FILE) objects

            if resp.code != 200:

                raise Exception('Return Code is not 200')

        except Exception as e:

            # means it cannot be cloned

            raise urllib.error.URLError("[%s] org_exc: %s" % (cleaned_uri, e))

            # now check if it's a proper hg repo

            try:

                mercurial.httppeer.instance(repoui or mercurial.ui.ui(), url, False).lookup(b'tip')

            except Exception as e:

                raise urllib.error.URLError(

                    "url [%s] does not look like an hg repo org_exc: %s"

    def __init__(self, name, url, changeset=None, alias=None):

        # Note: Doesn't call Node.__init__!

        self.path = name.rstrip('/')

        self.kind = NodeKind.SUBMODULE

        self.alias = alias

        # submodules we cannot get from repository

        self.changeset = EmptyChangeset(changeset, alias=alias)

        self.url = url

    def __repr__(self):

        return '<%s %r @ %s>' % (self.__class__.__name__, self.path,

from tg.i18n import lazy_ugettext as _

from webob.exc import HTTPNotFound

import kallithea

from kallithea.lib import ext_json, ssh

from kallithea.lib.exceptions import DefaultUserException

from kallithea.lib.vcs import get_backend

from kallithea.lib.vcs.backends.base import EmptyChangeset

from kallithea.lib.vcs.utils.helpers import get_scm

from kallithea.model.meta import Base, Session

            v.UnicodeString(strip=True, min=1, not_empty=True)

        )

        hooks_changegroup_update = v.StringBoolean(if_missing=False)

        hooks_changegroup_repo_size = v.StringBoolean(if_missing=False)

        extensions_largefiles = v.StringBoolean(if_missing=False)

        extensions_hggit = v.StringBoolean(if_missing=False)

    return _ApplicationUiSettingsForm

def DefaultPermissionsForm(repo_perms_choices, group_perms_choices,

    from kallithea.lib.utils import make_ui

    class _validator(formencode.validators.FancyValidator):

        messages = {

            'clone_uri': _('Invalid repository URL'),

            'invalid_clone_uri': _('Invalid repository URL. It must be a '

        }

        def _validate_python(self, value, state):

            repo_type = value.get('repo_type')

            url = value.get('clone_uri')

                    <div class="checkbox">

                        <label>

                            ${h.checkbox('extensions_largefiles','True')}

                            ${_('Enable largefiles extension')}

                        </label>

                    </div>

                    ##<div class="checkbox">

                    ##    <label>

                    ##        ${h.checkbox('extensions_hggit','True')}

                    ##        ${_('Enable hg-git extension')}

                    ##    </label>

                    ##</div>