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

        ``repo``

            object from external api

        ``revisions``

            list of all available revisions' ids, in ascending order

        ``changesets``

            storage dict caching returned changesets

        ``path``

            absolute path to the repository

        ``branches``

            branches as list of changesets

        ``tags``

            tags as list of changesets

    """

    scm = None

    DEFAULT_BRANCH_NAME = None

    EMPTY_CHANGESET = '0' * 40

    def __init__(self, repo_path, create=False, **kwargs):

        """

        Initializes repository. Raises RepositoryError if repository could

        not be find at the given ``repo_path`` or directory at ``repo_path``

        exists and ``create`` is set to True.

        :param repo_path: local path of the repository

        :param create=False: if set to True, would try to craete repository.

        :param src_url=None: if set, should be proper url from which repository

          would be cloned; requires ``create`` parameter to be set to True -

          raises RepositoryError if src_url is set and create evaluates to

          False

        """

        raise NotImplementedError

    def __str__(self):

        return '<%s at %s>' % (self.__class__.__name__, self.path)

    def __repr__(self):

        return self.__str__()

    def __len__(self):

        return self.count()

    @LazyProperty

    def alias(self):

        for k, v in settings.BACKENDS.items():

            if v.split('.')[-1] == str(self.__class__.__name__):

                return k

    @LazyProperty

    def name(self):

        raise NotImplementedError

    @LazyProperty

    def owner(self):

        raise NotImplementedError

    @LazyProperty

    def description(self):

        raise NotImplementedError

    @LazyProperty

    def size(self):

        """

        Returns combined size in bytes for all repository files

        """

        size = 0

        try:

            tip = self.get_changeset()

            for topnode, dirs, files in tip.walk('/'):

                for f in files:

                    size += tip.get_file_size(f.path)

                for dir in dirs:

                    for f in files:

                        size += tip.get_file_size(f.path)

        except RepositoryError, e:

            pass

        return size

    def is_valid(self):

        """

        Validates repository.

        """

        raise NotImplementedError

    def get_last_change(self):

        self.get_changesets()

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

from __future__ import with_statement

import datetime

from base import BackendTestMixin

from conf import SCM_TESTS

from conf import TEST_USER_CONFIG_FILE

from rhodecode.lib.vcs.nodes import FileNode

from rhodecode.lib.vcs.utils.compat import unittest

from rhodecode.lib.vcs.exceptions import ChangesetDoesNotExistError

class RepositoryBaseTest(BackendTestMixin):

    recreate_repo_per_test = False

    @classmethod

    def _get_commits(cls):

        return super(RepositoryBaseTest, cls)._get_commits()[:1]

    def test_get_config_value(self):

        self.assertEqual(self.repo.get_config_value('universal', 'foo',

            TEST_USER_CONFIG_FILE), 'bar')

    def test_get_config_value_defaults_to_None(self):

        self.assertEqual(self.repo.get_config_value('universal', 'nonexist',

            TEST_USER_CONFIG_FILE), None)

    def test_get_user_name(self):

        self.assertEqual(self.repo.get_user_name(TEST_USER_CONFIG_FILE),

            'Foo Bar')

    def test_get_user_email(self):

        self.assertEqual(self.repo.get_user_email(TEST_USER_CONFIG_FILE),

            'foo.bar@example.com')

class RepositoryGetDiffTest(BackendTestMixin):

    @classmethod

    def _get_commits(cls):

        commits = [

            {

                'message': 'Initial commit',

                'author': 'Joe Doe <joe.doe@example.com>',

                'date': datetime.datetime(2010, 1, 1, 20),

                'added': [

                    FileNode('foobar', content='foobar'),

                    FileNode('foobar2', content='foobar2'),

                ],

            },

            {

                'message': 'Changed foobar, added foobar3',

                'author': 'Jane Doe <jane.doe@example.com>',

                'date': datetime.datetime(2010, 1, 1, 21),

                'added': [

                    FileNode('foobar3', content='foobar3'),

                ],

                'changed': [

                    FileNode('foobar', 'FOOBAR'),

                ],

            },

            {

                'message': 'Removed foobar, changed foobar3',

                'author': 'Jane Doe <jane.doe@example.com>',

                'date': datetime.datetime(2010, 1, 1, 22),

                'changed': [

                    FileNode('foobar3', content='FOOBAR\nFOOBAR\nFOOBAR\n'),

                ],

                'removed': [FileNode('foobar')],

            },

        ]

        return commits

    def test_raise_for_wrong(self):

        with self.assertRaises(ChangesetDoesNotExistError):

            self.repo.get_diff('a' * 40, 'b' * 40)

class GitRepositoryGetDiffTest(RepositoryGetDiffTest, unittest.TestCase):

    backend_alias = 'git'

    def test_initial_commit_diff(self):