Adding repoaccess.py to README.
1 files changed, 30 insertions(+), 0 deletions(-)

M README.md
M README.md +30 -0
@@ 14,3 14,33 @@ have been pushed to your repository. It'
 call to fit virtually any webhook endpoint.
 
 [tb]: https://hg.code.netlandish.com/~netlandish/django-trello-broker
+
+## repoaccess.py
+
+Simple utility script to grant user access to a repository.
+
+Usage:
+
+```
+$ root:code ~ # repoaccess.py -h
+usage: repoaccess.py [-h] repo_type repository username perms
+
+Give access to hg or git repositories.
+
+positional arguments:
+  repo_type   Repository type (hg or git)
+  repository  Repository name (~username/repo_name)
+  username    Username of user you're giving access to.
+  perms       Permissions being granted (ro or rw)
+
+optional arguments:
+  -h, --help  show this help message and exit
+$
+```
+
+**Note:** The user being granted access has to have at least logged into the
+individual code websites (ie, visited your hg.srht.domain.com). This is because
+the various apps (hg, git, the rest) use a SSO pattern and when initially
+visiting one of the individual apps, the user will be verified and stored in
+the app specific database. This script will not work without the user data
+stored in the database.