^sql_dumps/

^\.idea$

[main]

host = https://www.transifex.com

[RhodeCode.pot]

source_file = rhodecode/i18n/rhodecode.pot

source_lang = en

trans.pl    = rhodecode/i18n/pl/LC_MESSAGES/rhodecode.po

trans.ru    = rhodecode/i18n/ru/LC_MESSAGES/rhodecode.po

trans.fr    = rhodecode/i18n/fr/LC_MESSAGES/rhodecode.po

trans.ja    = rhodecode/i18n/ja/LC_MESSAGES/rhodecode.po

trans.pt_BR = rhodecode/i18n/pt_BR/LC_MESSAGES/rhodecode.po

trans.zh_CN = rhodecode/i18n/zh_CN/LC_MESSAGES/rhodecode.po

trans.zh_TW = rhodecode/i18n/zh_TW/LC_MESSAGES/rhodecode.po

type = PO

    Simon Lopez <simon.lopez@slopez.org>

  additional explicit forking, repositories group and repository creation permissions.

- User groups for easier permission management.

- Repository groups let you group repos and manage them easier. They come with

  permission delegation features, so you can delegate groups management.

- Built in Gist functionality for sharing code snippets.

## PASTE ##

#use = egg:Paste#http

## nr of worker threads to spawn

## WAITRESS ##

use = egg:waitress#main

## number of worker threads

## MAX BODY SIZE 100GB

## use poll instead of select, fixes fd limits, may not work on old

## windows systems.

#asyncore_use_poll = True

## GUNICORN ##

#use = egg:gunicorn#main

## number of process workers. You must set `instance_id = *` when this option

## is set to more than one worker

#workers = 1

## process name

#proc_name = rhodecode

## type of worker class, one of sync, eventlet, gevent, tornado

## recommended for bigger setup is using of of other than sync one

#worker_class = sync

#max_requests = 5

## COMMON ##

## perform a full repository scan on each server start, this should be

## set to false after first startup, to allow faster server restarts.

initial_repo_scan = true

## 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.rhodecode.org/{gistid}. Empty means use the internal

## RhodeCode url, ie. http[s]://rhodecode.server/_admin/gists/<gistid>

gist_alias_url =

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

## controllers to which access will be enabled by api_key. eg: to enable

## api access to raw_files put `FilesController:raw`, to enable access to patches

## add `ChangesetController:changeset_patch`. This list should be "," separated

## Syntax is <ControllerClass>:<function>. Check debug logs for generated names

api_access_controllers_whitelist =

allow_repo_location_change = True

To make this operation easier, starting from version 1.7.0 there's a white list

of views that will have API access enabled. Simply edit `api_access_controllers_whitelist`

option in your .ini file, and define views that should have API access enabled.

Following example shows how to enable API access to patch/diff raw file and archive

in RhodeCode::

    api_access_controllers_whitelist =

        ChangesetController:changeset_patch,

        ChangesetController:changeset_raw,

        FilesController:raw,

        FilesController:archivefile

enabled on RSS/ATOM feed views. Exposing raw diffs is a good way to integrate with

3rd party services like code review, or build farms that could download archives.

    result : "Caches of repository `<reponame>`"

    result : {

                 "repo": "<reponame>",

                 "locked": "<bool true|false>",

                 "locked_since": "<float lock_time>",

                 "locked_by": "<username>",

                 "msg": "User `<username>` set lock state for repo `<reponame>` to `<false|true>`"

             }

                "api_key" :     "<api_key>",

                "password" :  "<password = Optional(None)>",

                "api_key" :  "<api_key>",

                                "api_key" :  "<api_key>",

                "group_name": "<groupname>",

                "owner" :     "<onwer_name_or_id = Optional(=apiuser)>",

                "active":     "<bool> = Optional(True)"

                                    "api_key" :    "<api_key>",

                                    "api_key" :     "<api_key>",

1.7.0 (**2013-05-XX**)

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

news

++++

- Manage User’s Groups(teams): create, delete, rename, add/remove users inside.

  by delegated user group admins.

- Implemented simple Gist functionality.

- External authentication got special flag to controll user activation.

- Created whitelist for API access. Each view can now be accessed by api_key

  if added to whitelist.

- Added dedicated file history page.

- Added compare option into bookmarks

- Improved diff display for binary files and renames.

- Archive downloading are now stored in main action journal.

- Switch gravatar to always use ssl.

- Implements #842 RhodeCode version disclosure.

- Allow underscore to be the optionally first character of username.

fixes

+++++

- #818: Bookmarks Do Not Display on Changeset View.

- Fixed default permissions population during upgrades.

- Fixed overwrite default user group permission flag.

- Fixed issue with h.person() function returned prematurly giving only email

  info from changeset metadata.

- get_changeset uses now mercurial revrange to filter out branches.

  Switch to branch it's around 20% faster this way.

- Fixed some issues with paginators on chrome.

- Forbid changing of repository type.

- Adde missing permission checks in list of forks in repository settings.

- Fixes #834 hooks error on remote pulling.

- Fixes issues #849. Web Commits functionality failed for non-ascii files.

- Fixed #850. Whoosh indexer should use the default revision when doing index.

- Fixed #851 and #563 make-index crashes on non-ascii files.

- Fixes #852, flash messages had issies with non-ascii messages

- Fixed redirection loop on changelog for empty repository

   and repo admins.

 - Global permission update with "overwrite existing settings" shouldn't

If your user groups are placed in a Organisation Unit (OU) structure the Search Settings configuration differs::

 Search settings

 Base DN              = DC=host,DC=example,DC=org

 LDAP Filter          = (&(memberOf=CN=your user group,OU=subunit,OU=unit,DC=host,DC=example,DC=org)(objectClass=user))

 LDAP Search Scope    = SUBTREE

    issue_pat = (?:^#|\s#)(\w+)

`issue_pat` is the regular expression that will fetch issues from commit messages.

    ## gist alias

    server {

       listen          443;

       server_name     gist.myserver.com;

       access_log      /var/log/nginx/gist.access.log;

       error_log       /var/log/nginx/gist.error.log;

       ssl on;

       ssl_certificate     gist.rhodecode.myserver.com.crt;

       ssl_certificate_key gist.rhodecode.myserver.com.key;

       ssl_session_timeout 5m;

       ssl_protocols SSLv3 TLSv1;

       ssl_ciphers DHE-RSA-AES256-SHA:DHE-RSA-AES128-SHA:EDH-RSA-DES-CBC3-SHA:AES256-SHA:DES-CBC3-SHA:AES128-SHA:RC4-SHA:RC4-MD5;

       ssl_prefer_server_ciphers on;

       rewrite ^/(.+)$ https://rhodecode.myserver.com/_admin/gists/$1;

       rewrite (.*)    https://rhodecode.myserver.com/_admin/gists;

    }

       ## uncomment root directive if you want to serve static files by nginx

       ## requires static_files = false in .ini file

       include         /etc/nginx/proxy.conf;

    client_max_body_size        1024m;

    client_body_buffer_size     128k;

    large_client_header_buffers 8 64k;

Visual settings in admin pannel

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

Visualisation settings in RhodeCode settings view are extra customizations

of server behavior. There are 3 main section in the settings.

General

~~~~~~~

`Use repository extra fields` option allows to set a custom fields for each

repository in the system. Each new field consists of 3 attributes `field key`,

`field label`, `field description`. Example usage of such fields would be to

define company specific information into repositories eg. defining repo_manager

key that would add give info about a manager of each repository. There's no

limit for adding custom fields. Newly created fields are accessible via API.

`Show RhodeCode version` option toggles displaying exact RhodeCode version in

the footer

Dashboard items

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

Number if items in main page dashboard before pagination is displayed

Icons

~~~~~

Show public repo icon / Show private repo icon on repositories - defines if

public/private icons should be shown in the UI.

Meta-Tagging

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

With this option enabled, special metatags that are recognisible by RhodeCode

will be turned into colored tags. Currently available tags are::

    [featured]

    [stale]

    [dead]

    [lang => lang]

    [license => License]

    [requires => Repo]

    [recommends => Repo]

    [see => URI]

## PASTE ##

#use = egg:Paste#http

## nr of worker threads to spawn

## WAITRESS ##

use = egg:waitress#main

## number of worker threads

## MAX BODY SIZE 100GB

## use poll instead of select, fixes fd limits, may not work on old

## windows systems.

#asyncore_use_poll = True

## GUNICORN ##

#use = egg:gunicorn#main

## number of process workers. You must set `instance_id = *` when this option

## is set to more than one worker

#workers = 1

## process name

#proc_name = rhodecode

## type of worker class, one of sync, eventlet, gevent, tornado

## recommended for bigger setup is using of of other than sync one

#worker_class = sync

#max_requests = 5

## COMMON ##

port = 5000

## perform a full repository scan on each server start, this should be

## set to false after first startup, to allow faster server restarts.

initial_repo_scan = true

## 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.rhodecode.org/{gistid}. Empty means use the internal

## RhodeCode url, ie. http[s]://rhodecode.server/_admin/gists/<gistid>

gist_alias_url =

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

## controllers to which access will be enabled by api_key. eg: to enable

## api access to raw_files put `FilesController:raw`, to enable access to patches

## add `ChangesetController:changeset_patch`. This list should be "," separated

## Syntax is <ControllerClass>:<function>. Check debug logs for generated names

api_access_controllers_whitelist =

allow_repo_location_change = True

VERSION = (1, 7, 0)

try:

    from rhodecode.lib import get_current_revision

    _rev = get_current_revision(quiet=True)

    if _rev and len(VERSION) > 3:

        VERSION += ('%s' % _rev[0],)

except ImportError:

    pass

__version__ = ('.'.join((str(each) for each in VERSION[:3])) +

               '.'.join(VERSION[3:]))

__dbversion__ = 13  # defines current db version for migrations

__platform__ = platform.system()

__license__ = 'GPLv3'

__py_version__ = sys.version_info

__author__ = 'Marcin Kuzminski'

__url__ = 'http://rhodecode.org'

is_windows = __platform__ in ['Windows']

is_unix = not is_windows

"""

Base utils for shell scripts

"""

import os

import sys

import random

import urllib2

import pprint

try:

    from rhodecode.lib.ext_json import json

except ImportError:

    try:

        import simplejson as json

    except ImportError:

        import json

CONFIG_NAME = '.rhodecode'

FORMAT_PRETTY = 'pretty'

FORMAT_JSON = 'json'

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

    """

    Api_call wrapper for RhodeCode.

    :param apikey:

    :param apihost:

    :param format: formatting, pretty means prints and pprint of json

     json returns unparsed json

    :param method:

    :returns: json response from server

    """

    def _build_data(random_id):

        """

        Builds API data with given random ID

        :param random_id:

        """

        return {

            "id": random_id,

            "api_key": apikey,

            "method": method,

            "args": kw

        }

    if not method:

        raise Exception('please specify method name !')

    id_ = random.randrange(1, 9999)

    req = urllib2.Request('%s/_admin/api' % apihost,

                      data=json.dumps(_build_data(id_)),

                      headers={'content-type': 'text/plain'})

    ret = urllib2.urlopen(req)

    raw_json = ret.read()

    json_data = json.loads(raw_json)

    id_ret = json_data['id']

    if id_ret == id_:

        return json_data

    else:

        _formatted_json = pprint.pformat(json_data)

        raise Exception('something went wrong. '

                        'ID mismatch got %s, expected %s | %s' % (

                                            id_ret, id_, _formatted_json))

class RcConf(object):

    """

    RhodeCode config for API

    conf = RcConf()

    conf['key']

    """

    def __init__(self, config_location=None, autoload=True, autocreate=False,

                 config=None):

        HOME = os.getenv('HOME', os.getenv('USERPROFILE')) or ''

        HOME_CONF = os.path.abspath(os.path.join(HOME, CONFIG_NAME))

        self._conf_name = HOME_CONF if not config_location else config_location

        self._conf = {}

        if autocreate:

            self.make_config(config)

        if autoload:

            self._conf = self.load_config()

    def __getitem__(self, key):

        return self._conf[key]

    def __nonzero__(self):

        if self._conf:

            return True

        return False

    def __eq__(self):

        return self._conf.__eq__()

    def __repr__(self):

        return 'RcConf<%s>' % self._conf.__repr__()

    def make_config(self, config):

        """

        Saves given config as a JSON dump in the _conf_name location

        :param config:

        """

        update = False

        if os.path.exists(self._conf_name):

            update = True

        with open(self._conf_name, 'wb') as f:

            json.dump(config, f, indent=4)

        if update:

            sys.stdout.write('Updated config in %s\n' % self._conf_name)

        else:

            sys.stdout.write('Created new config in %s\n' % self._conf_name)

    def update_config(self, new_config):

        """

        Reads the JSON config updates it's values with new_config and

        saves it back as JSON dump

        :param new_config:

        """