;
aCc @ s` d Z d k l Z d k l Z l Z l Z d k l Z l Z l Z l
Z
d k l Z d k
l Z l Z d k Z d k Z y
e Z Wn d k Z e i Z n Xd f d YZ d e f d
YZ d e f d YZ d
e f d YZ d e f d YZ d e e e f d YZ d e f d YZ d e e e f d YZ d S( s $Revision: 1.15 $( s ref( s times strftimes gmtime( s loads dumps dumpss loads( s mktemp( s MixIns logNs SessionImplc B sh t Z d Z d Z d Z d Z d Z d Z d Z d Z d Z
d Z d
Z d Z
RS( s abstract implementaion classs PSOServiceIds PSOSessionIds
SESSION_IDc C s | i | i | i Sd S( s session.getServiceId(requestHandler) -> String ~ The service id, set in the HTTP directive, is returned.
This will default to the script's nameN( s
reqHandlers
getEnvirons selfs DEFAULTServiceIdKeys getDefaultServiceId( s selfs
reqHandler( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys getServiceId. s c C s | i Sd S( N( s selfs DEFAULTServiceIdValue( s self( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys getDefaultServiceId3 s c C s | i | i Sd S( s session.getSessionId(requestHandler) -> String | None ~ The current session id returned.
If none return None.
By default will look for a HTTP directive ServiceIdN( s
reqHandlers
getEnvirons selfs DEFAULTSessonIdKey( s selfs
reqHandler( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys getSessionId6 s c C s d S( s' session.load(requestHandler) -> SessionN( ( s selfs
reqHandlers session( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys load; s c C s d S( s- session.session(requestHandler, self) -> NoneN( ( s selfs
reqHandlers session( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys save= s c C s d S( sU session.revert(requestHandler, self) -> None ~reverts the session to last saved copy.N( ( s selfs
reqHandler( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys revert? s c C s d S( s
session.expire(requestHandler, when) -> None ~ if when is evals
to a number will expire the session in when seconds, otherwise will try and parse when as a date.
For more on this format see RFC2068 section 3.3.1
[also RCF822 and
RCF1123]
N( ( s selfs
reqHandlers when( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys expireB s c C s d S( sb session.newSessionId(self.requestHandler) -> String ~ returns a new sessionId, preferably unique.N( ( s self( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys newSessionIdJ s ( s __name__s
__module__s __doc__s DEFAULTServiceIdKeys DEFAULTSessionIdKeys DEFAULTServiceIdValues getServiceIds getDefaultServiceIds getSessionIds loads saves reverts expires newSessionId( ( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys SessionImpl& s s Sessionc B s t Z d Z e d Z d Z d Z d Z e d Z e d Z e d Z
e d Z e d Z d
Z
e d Z e d Z RS(
s Session Bridgec C s+ t i | | i | | | i d S( s session = Session(requestHandler, SessionImplmentor()) ~ ctor's a session with the given
request handler and session implementation instanceN( s mapClasss __init__s selfs inits
reqHandlers impls setup( s selfs
reqHandlers impl( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys __init__O s
c C s@ t | _ t | _ d | _ | | _ t | | _ t | _ d S( sI self.init(reqHandler, impl)-> None ~ template init method called by CTORs newN( s Nones selfs sessionIds serviceIds statuss impls refs
reqHandlers expiresWhen( s selfs
reqHandlers impl( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys initV s c C sM | i | _ | i | _ d G| i GH| i o | i n d S( sh self.setup()-> None ~ template method
used to define relationship between session and requestHandlers is new:N( s selfs getServiceIds serviceIds getSessionIds sessionIds isNews load( s self( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys setupa s c C s | i d j Sd S( s session.new()-> 1|0 ~ returns 1 if session was created on this request, otherwise 0
used to define relationship between session and requestHandlers newN( s selfs status( s self( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys isNewj s c C sL | t j o | i } n | i o | i i | | _ n | i Sd S( s[ session.getServiceId()-> String ~ returns serviceId, request passed on to the implementor.N( s
reqHandlers Nones selfs serviceIds impls getServiceId( s selfs
reqHandler( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys getServiceIdo s
c C s | t j o | i } n | i o | i | i | | _ | i o\ | i i | | _ | i o/ d | _ | i i | | _ | i
| q d | _ q n | i Sd S( s\ session.getSessionId()-> String ~ returns either the current sessionId or a new session id.s news openN( s
reqHandlers Nones selfs sessionIds
getEnvirons getServiceIds impls getSessionIds statuss newSessionIds purge( s selfs
reqHandler( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys getSessionIdw s
c C s | i i | d S( N( s selfs impls purges
reqHandler( s selfs
reqHandler( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys purge s c C s | t j o | i } n yt | i i | | } | oK | i } | t j o
| t j o d | _ d Sn | i
| n
d | _ Wn1 t j
o% } d k
} | i d | _ n Xh Sd S( s7 session.load()-> None ~ loads a session into its self.s newN( s
reqHandlers Nones selfs impls loads sessions getExpires expiress times statuss updates Exceptions es tracebacks print_exc( s selfs
reqHandlers tracebacks es expiress session( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys load s"
c C sO | t j o | i } n t | _ d | _ | i i | | | | _ d S( s$ session.save()-> None ~ saves self.s openN( s
reqHandlers Nones selfs statuss impls save( s selfs
reqHandler( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys save s
c C s | i Sd S( sP session.getExpire()-> float ~ returns when it will expire in secs since epoche.N( s selfs expiresWhen( s self( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys getExpire s c C s) | | _ | i i | | i | d S( s session.expire(when)-> None ~ expires session at time.time() + when,
if eval(when) evalutes, otherwise tries to parse when and expire session at when.
For more on this format see RFC2068 section 3.3.1
[also RCF822 and
RCF1123]
N( s whens selfs
expireWhens impls expires
reqHandler( s selfs when( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys expire s c C s4 | t j o | i } n | i i | | d S( sA session.setSession() -> None ~ adds session to request handler. N( s
reqHandlers Nones selfs impls
setSession( s selfs
reqHandler( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys
setSession s
( s __name__s
__module__s __doc__s Nones __init__s inits setups isNews getServiceIds getSessionIds purges loads saves getExpires expires
setSession( ( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys SessionM s s
BrowserLoaderc B s/ t Z e d Z d Z d Z d Z RS( Nc C s d S( N( ( s selfs
reqHandler( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys purge s c C s t | i | Sd S( N( s loadss sessions getSessionIds
reqHandler( s selfs
reqHandlers session( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys load s c C s d GHy^ d G| G| i | Gt | GH| i | i | t | d G| i | i | GHWn# d k } | i d t i n Xd S( Ns savings
savings
saveds file(
s
reqHandlers sessions getServiceIds dumpss setCookies getCookies tracebacks print_excs syss stdout( s selfs
reqHandlers sessions traceback( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys save s c C s h Sd S( N( ( s selfs
reqHandler( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys newSessionId s ( s __name__s
__module__s Nones purges loads saves newSessionId( ( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys
BrowserLoader s s
FileLoaderc B se t Z d Z d f Z e i i e Z d Z d Z
e d Z d Z
d Z d Z RS( Ns PSOSessionFileLoader_s Pathc C s; | i | } | i | } t i i | | } | Sd S( s\ session.getFileName(requestHandler) -> String ~ returns a fully qualified session file name.N(
s selfs getPaths
reqHandlers paths sessions getSessionIds files oss joins filename( s selfs
reqHandlers sessions filenames files path( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys getFileName s
c C s# | i t | i d | i Sd S( s\ session.getPath(requestHandler) -> String ~ returns the path where sessions will be stored.s PathN( s selfs
getDirectivess
FileLoaders
reqHandlers gets PATH( s selfs
reqHandler( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys getPath s c C s d S( N( ( s selfs
reqHandler( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys purge s c C s) t i i t | i | } | Sd S( s\ session.newSessionId(requestHandler) -> String ~ returns a new sessionId, preferably unique.N( s oss paths basenames mktemps selfs getServiceIds
reqHandlers id( s selfs
reqHandlers id( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys newSessionId s !c C s# t t | i | | d Sd S( s[ session.load(requestHandler) -> session ~ returns session. All thrown expections passed on.s r+bN( s loads opens selfs getFileNames
reqHandlers session( s selfs
reqHandlers session( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys load s c C s2 | i | | } t | d } t | | d S( sW session.save(requestHandler) -> None ~ saves session. All thrown expections passed on.s w+bN( s selfs getFileNames
reqHandlers sessions files opens fs dump( s selfs
reqHandlers sessions fs file( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys save s ( s __name__s
__module__s DIRECTIVEtAGs
DIRECTIVESs oss paths dirnames mktemps PATHs getFileNames getPaths Nones purges newSessionIds loads save( ( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys
FileLoader s s
CookieSessionc B sb t Z d Z d d d d d d d f Z d Z d
Z d Z e d Z d
Z d Z
RS( Ns PSOCookieSession_s expiress Paths Comments Domains Max-Ages secures Versionc C s | i | i } | o y d } | i | d } | i | } | t | 7} | i
d | } | d j o | | } n | | | !} | i SWq t
j
o% } d k } | i | GHt Sq Xn d S( sg self.getCookie(requestHandler) -> String | None ~ returns the session cookie if found
otherwise nonei s =s ;iN( s
reqHandlers
getEnvirons getCookieKeys cookies starts selfs getServiceIds look4s indexs lens finds ends strips Exceptions es tracebacks print_excs None( s selfs
reqHandlers ends tracebacks starts look4s cookies e( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys getCookie s$
c C s | i | Sd S( sp self.getSessionId(requestHandler) -> String | None ~ The current session id returned.
If none return None.N( s selfs getCookies
reqHandler( s selfs
reqHandler( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys getSessionId s c C s t | d o
h | _ n | t j o{ y? t t | } t | } t d t | | i d None ~ utility method to build the correct cookie expire attributes.s attrss %a, %d %b %Y %H:%M:%S GMTs expiress Max-AgeN( s hasattrs selfs attrss whens Nones evals strs times strftimes gmtimes has_key( s selfs when( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys when s
c C s | i | | i | d S( s self.expire(session, requestHandler, when)-> None ~ expires session at time.time() + when,
if eval(when) evalutes, otherwise tries to parse when and expire session at when.
For more on this format see RFC2068 section 3.3.1
[also RCF822 and
RCF1123]
N( s selfs whens
reqHandlers
setSessions session( s selfs sessions
reqHandlers when( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys expire+ s
c C s# t | d o | i Sn h Sd S( sk self.getAttrs() -> Dictionary of cookie attributes ~ utility
method for setting up the session cookies attrsN( s hasattrs selfs attrs( s self( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys getAttrs5 s c C s{ | i | _ | i i | i t | | i d } | o | i | n | i
| i | i
| i d S( s self.setSession(session, reqHandler) -> None ~ adds session to request handler.
Handles setting the cookie when the session is new.
s PSOSessionExpiresN( s selfs getAttrss attrss updates
getDirectivess
CookieSessions
reqHandlers
getEnvirons values whens setCookies sessions getServiceIds getSessionId( s selfs sessions
reqHandlers value( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys
setSession= s ( s __name__s
__module__s DIRECTIVEtAGs
DIRECTIVESs getCookies getSessionIds whens Nones expires getAttrss
setSession( ( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys
CookieSession s
s CookieFileImplc B s t Z d Z RS( s Default session implementation, using temporary files to
store the session, and using a browser cookie to
pass the session id accross requests.( s __name__s
__module__s __doc__( ( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys CookieFileImplI s s FileSessionc B s t Z d Z d Z RS( sH Default session bridge, using CookieFileImpl as the implementaion classc C s t i | | t d S( N( s Sessions inits selfs
reqHandlers CookieFileImpl( s selfs
reqHandlers imp( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys initP s ( s __name__s
__module__s __doc__s init( ( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys FileSessionN s s CookieBrowserImplc B s t Z d Z RS( sj session implementation, using actual browser cookie to
store the session. This is not a first choice.( s __name__s
__module__s __doc__( ( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys CookieBrowserImplT s ( s __version__s weakrefs refs times strftimes gmtimes cPickles loads dumps dumpss loadss tempfiles mktemps utils MixIns logs syss oss dicts mapClasss UserDicts SessionImpls Sessions
BrowserLoaders
FileLoaders
CookieSessions CookieFileImpls FileSessions CookieBrowserImpl( s loads CookieFileImpls dumps FileSessions mktemps logs
FileLoaders SessionImpls mapClasss __version__s refs UserDicts
BrowserLoaders gmtimes syss
CookieSessions MixIns CookieBrowserImpls dumpss Sessions times loadss oss strftime( ( s8 /home/groups/p/ps/pso/htdocs/pso-tutorial/pso/session.pys ? s&
'y!O