django-anyvcs 2.3.0

Configuration

Add django_anyvcs to your project’s INSTALLED_APPS.

The django_anyvcs.views.access view is used by django-anyvcs-ssh. The URL that maps to this view should be accessible to the host running django-anyvcs-ssh (usually localhost).

The django_anyvcs.views.api_call view is not used by any component of django-anyvcs, but is made available to provide a web API to access the underlying repository. The django_anyvcs.remote module provides a python API to this web API which provides an interface similar to anyvcs.common.VCSRepo objects.

Settings

django-anyvcs looks at the following variables in your project’s settings.py:

VCSREPO_ROOT

String, required. The root directory in which all VCS repositories are stored.

VCSREPO_PATH_FUNCTION

Function, optional. Override the default path given to a repo. The function is given a repo and returns a string (the path).

VCSREPO_CHECK_NESTED_PATHS

Boolean, defaults to True. If true then repo paths are checked against all other repo paths to make sure they aren’t nested inside each other. This is a fairly expensive operation, so if you know this won’t ever happen then set this to False.

VCSREPO_ALLOW_NESTED_PATHS

Boolean, defaults to False. If true then VCS systems that support it will allow path nesting. Currently, only Mercurial supports this.

VCSREPO_USE_USER_RIGHTS

Boolean, defaults to True. If true then the UserRights model will be enabled.

VCSREPO_USE_GROUP_RIGHTS

Boolean, defaults to True. If true then the GroupRights model will be enabled.

VCSREPO_USER_MODEL

String, defaults to AUTH_USER_MODEL or 'auth.User'. Defines the user model that UserRights is tied to.

VCSREPO_GROUP_MODEL

String, defaults to 'auth.Group'. Defines the group model that GroupRights is tied to.

VCSREPO_RIGHTS_FUNCTION

Function, optional. If set, this function is called with two parameters: the repository being accessed, and the user who is accessing the repository (may be None to indicate an anonymous user). The function should return the rights string, which is one of ‘-’ (deny access), ‘r’ (read-only access), or ‘rw’ (read and write access).

VCSREPO_USER_ACL_FUNCTION

Function, optional. If set, this function is called with one parameter which is a repository. The function should return a dict which maps auth.User instances to a rights string, one of ‘-’, ‘r’, or ‘rw’ for the given repository.

VCSREPO_GROUP_ACL_FUNCTION

Function, optional. If set, this function is called with one parameter which is a repository. The function should return a dict which maps auth.Group instances to a rights string, one of ‘-’, ‘r’, or ‘rw’ for the given repository.

When used with django-sshkey, a setting similar to this will tie together the two apps:

SSHKEY_AUTHORIZED_KEYS_OPTIONS = \
  'command="env VCSREPO_ROOT=%s /path/to/django-anyvcs-ssh ' \
  'http://localhost:8000/anyvcs/access {username}",no-agent-forwarding,' \
  'no-port-forwarding,no-pty,no-user-rc,no-X11-forwarding' % VCSREPO_ROOT

Dependencies

• python-anyvcs version 1.1.0 or greater

Although not a strict dependency, django-anyvcs was designed to be used in conjunction with django-sshkey (version 2.0.0 or greater) and would be fairly useless without it or something that provides a similar functionality.