JOTWeb Documentation: auth.Sessions.Backend

   from jotweb.auth import Sessions
   sessionDir = '/tmp/sessiondir'
   be = Sessions.BackendFilesystem(sessionDir)

   #  add a user
   user = be.useradd('jafo', passwd = 'test1234')
   user['payload']['mydata'] = 'Test data stored in user'
   be.usersave()

   #  add a session
   session = be.sessionadd('jafo')
   session['payload']['mysessiondata'] = 'Test data stored with session.'
   be.sessionsave()

   #  validate user
   if be.userverify('jafo', 'test1234'):
      print 'User validated successfully'
   if not be.userverify('jafo', 'jafo'):
      print 'User didn't verify when we used the wrong password.'

   #  validate session
   newsession, newuser = be.sessionget(session['key'])
   if newsession:
      print 'Session validated successfully'

   #  delete session
   be.sessiondel()

   #  look up and then delete user
   be.userget('jafo')
   be.userdel()

HTML Form for Adding a new user:

Usually, you would never directly call the Backends directly from TAL, but below is an example of using input.SimpleForm.FormHandler() and the auth.Sessions.BackendFilesystem() code to create a form which allows adding users.

Create a file called "newuserform.html", which contains the form HTML:

   <form action="adduserform.html">
      Username: <input type="text" name="UserName" /><br />
      Password: <input type="password" name="Password" /><br />
      Password (Again): <input type="password" name="PasswordAgain" /><br />
      <input type="submit" value="Create User" />
   </form>

Create a file called "adduserform.html", which contains the HTML and code for adding a new user:

   <div tal:define="form adduserform/formvdt">
      <div tal:condition="not:form/geterrors">
         <!-- Form verification successful -->
         <div tal:define="result adduserform/adduser">
            <div tal:condition="not:result/failure">
               <!-- User created successfully -->
               <h1><font color="#ff0000">Added User</font></h1>
               User added successfully.
            </div>
            <div tal:condition="result/failure">
               <!-- User creation failed -->
               <h1><font color="#ff0000">Adding User Failed</font></h1>
               More detailed information: <span
                  tal:replace="result/reason">Failure Reason</span>
            </div>
         </div>
      </div>
      <div tal:condition="form/geterrors">
         <!-- Form had errors, display them -->
         <h1><font color="#ff0000">Form Errors</font></h1>
         <ul>
            <li tal:repeat="value form/geterrors" tal:content="value">Error</li>
         </ul>
      </div>
   </div>

Finally, make the Python code for handling the above, create "adduserform.py":

from jotweb.auth.Sessions import BackendFilesystem
   from jotweb.input import SimpleForm

   def formvdt():
      'Validate form data.'
      form = SimpleForm.FormHandler()
      if form.vdt_required('UserName'):
         form.cvt_makelowercase('UserName')    # conver to lower-case
         form.vdt_length('UserName', 8, 3)     # must have length of 3 to 8
         form.vdt_login('UserName')            # is a unix-like login name
      if form.vdt_required('Password'):
         form.vdt_length('Password', 50, 3)    # must have length of 3 to 50
         form.vdt_passwd('Password')
      form.vdt_equal('Password', 'PasswordAgain')

   def adduser():
      '''Add user.'''
      form = SimpleForm.FormHandler()
      be = BackendFilesystem('/tmp/sessiondata')
      try:
         be.adduser(form['UserName'], passwd = form['Password'])
      except Exception, e:
         return({ 'failure' : 1, reason : 'Received exception "%s"' % str(e) })
      return({ 'success' : 1 })