nappingcat 0.4

nappingcat is a django-inspired framework for routing single-user SSH calls.<br /><br />Useful for implementing software like gitosis.<br /><br />Installation<br /><br /># on the remote:<br />sudo pip install nappingcat<br />useradd -m -U -s/bin/bash -r git<br />sudo su git<br />nappingcat_initconf<br />cat id_rsa.pub > nappingcat_createsuperuser admin<br /><br /># on your local machine<br />sudo pip install -e git+git://github.com/chrisdickinson/thundercat#egg=thundercat<br />thundercat addremote < nickname > < git@remoteurl.com ><br />thundercat add_permission admin kittygit create<br /><br /># now if you cd into a git repo...<br />thundercat create_repo somerepo<br /># it will create the repo on the remote server, and<br /># ask if you want to add a remote.<br /><br />Developer comments<br /><br />For a while now i've been using gitosis -- it's really nice! but really, i had no idea how it worked. so over the last week i've been picking it apart, and i found that really, it's exposing a limited API around git using the ~/.ssh/authorized_keys file to automatically funnel all incoming commands through gitosis-serve, which then checks to see if everything looks kosher before sending things back through git. this is pretty cool! it'd be great if it had a little more functionality, though. nothing crazy -- no branch level permissions or anything -- just a bit more of the sugar from github proper. like being able to create repositories without having to edit a flat file, or being able to fork existing repositories.<br /><br />I realized that i really just wanted a way to write an extensible API for a single-user ssh system. it still seems weird, worded like that, but bare with me.<br /><br />This is the result, at the moment -- it's not done! it's experimental! nappingcat works on the same principle as gitosis, minus some core functionality at the moment. every ssh command coming through the user it's configured under will be passed through a command router that looks a lot like something you'd see in a django app.<br /><br />For example, from kittygit(the app I wrote as a proof-of-concept):<br /><br />From nappingcat.patterns import patterns<br /><br />cmdpatterns = patterns('kittygit.handlers',<br /> (r'^kitty-git fork '(?Pw+).git'', 'fork_repo'),<br /> (r'^kitty-git create-repo '(?P[w\.]+)'', 'create_repo'),<br /> (r'^git(?P[-a-zA-Z_0-9s]+)', 'handle_git'),<br />)<br /><br />Any ssh command that comes through will pass through those regexen until it finds a match, and then it'll delegate out to that function (that looks like the following:)<br /><br />def handle_git(request, action):<br /> # do things<br /> pass<br /><br />Now, they're not required to return anything -- i'm leaning towards having whatever is returned passed back out through sys.stderr -- but you can see that a request object is passed in, and it contains the following:<br /><br />request.user # a string for the received username<br />request.settings # a configparser instance of the settings file<br />request.command # the original command intercepted<br />request.std{in,out,err} # the std streams<br />request.auth_backend # a copy of the auth backend for the session<br /><br />the settings are loaded from ~/nappingcat.conf. An example looks like the following:<br /><br />[kittyconfig]<br />router = kittygit.patterns<br />auth = nappingcat.contrib.sleazy_auth.SleazyAuth<br />paths =<br /> /Users/chris/projects/nappingcat<br /> /Users/chris/projects/kittygit<br /><br />The router parameter defines a python module from which a variable named cmdpatterns can be imported. it looks like the above!<br /><br />The auth parameter defines a module to use for authentication. Right now it only has one backend -- 'sleazy_auth', which just says "yes" to everything. this is a big TODO.<br /><br />Note that you can nest cmdpatterns like in django:<br /><br />from nappingcat.patterns import patterns, include<br />cmdpatterns = patterns('',<br /> (r'^', include('kittygit.patterns')),<br />)<br /><br />So you can build up api's out of separate apps.<br /><br />Again, it's very very very beta.

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Backend,  Cmdpatterns,  Command,  Create,  Defines,  Gitosis,  I039ve,  It039s,  Module,  Nappingcat,  Parameter,  Passed,  Settings
Users rating:	0/10