cubicweb.req

Base class for request/session

exception cubicweb.req.FindEntityError

raised when find_one_entity() can not return one and only one entity

class cubicweb.req.RequestSessionBase(vreg)

base class containing stuff shared by server session and web request

request/session is the main resources accessor, mainly through it’s vreg attribute:

Attribute vreg:the instance’s registry Attribute vreg.schema:  the instance’s schema Attribute vreg.config:  the instance’s configuration

base_url(secure=None)

return the root url of the instance

build_url(*args, **kwargs)

return an absolute URL using params dictionary key/values as URL parameters. Values are automatically URL quoted, and the publishing method to use may be specified or will be guessed.

if __secure__ argument is True, the request will try to build a https url.

raises ValueError if None is found in arguments

build_url_params(**kwargs)

return encoded params to incorporate them in a URL

create_entity(etype, **kwargs)

add a new entity of the given type

Example (in a shell session):

>>> c = create_entity('Company', name=u'Logilab')
>>> create_entity('Person', firstname=u'John', surname=u'Doe',
...               works_for=c)

describe(eid, asdict=False)

return a tuple (type, sourceuri, extid) for the entity with id <eid>

eid_rset(eid, etype=None)

return a result set for the given eid without doing actual query (we have the eid, we can suppose it exists and user has access to the entity)

empty_rset()

return a guaranteed empty result

ensure_ro_rql(rql)

raise an exception if the given rql is not a select query

entity_from_eid(eid, etype=None)

return an entity instance for the given eid. No query is done

etype_rset(etype, size=1)

return a fake result set for a particular entity type

find(etype, **kwargs)

find entities of the given type and attribute values.

Returns:A ResultSet

>>> users = find('CWGroup', name=u"users").one()
>>> groups = find('CWGroup').entities()

format_date(date, date_format=None, time=False)

return a string for a date time according to instance’s configuration

format_float(num)

return a string for floating point number according to instance’s configuration

format_time(time)

return a string for a time according to instance’s configuration

get_cache(cachename)

cachename should be dotted names as in :

• cubicweb.mycache
• cubes.blog.mycache
• etc.

parse_datetime(value, etype='Datetime')

get a datetime or time from a string (according to etype) Datetime formatted as Date are accepted

printable_value(attrtype, value, props=None, displaytime=True, formatters={'Interval': <function print_timedelta at 0x7ff141d4cc80>, 'Decimal': <function print_float at 0x7ff141d4cd70>, 'TZTime': <function print_tztime at 0x7ff141d4cb18>, 'Bytes': <function print_bytes at 0x7ff141d4c8c0>, 'TZDatetime': <function print_tzdatetime at 0x7ff141d4cc08>, 'BigInt': <function print_int at 0x7ff141d4c9b0>, 'Time': <function print_time at 0x7ff141d4caa0>, 'String': <function print_string at 0x7ff141d4c938>, 'Int': <function print_int at 0x7ff141d4c9b0>, 'Float': <function print_float at 0x7ff141d4cd70>, 'Datetime': <function print_datetime at 0x7ff141d4cb90>, 'Boolean': <function print_boolean at 0x7ff141d4ccf8>, 'Date': <function print_date at 0x7ff141d4ca28>})

return a displayablye value (i.e. unicode string)

property_value(key)

return value of the property with the given key, giving priority to user specific value if any, else using site value

rebuild_url(url, **newparams)

return the given url with newparams inserted. If any new params is already specified in the url, it’s overriden by the new value

newparams may only be mono-valued.

set_language(lang)

install i18n configuration for lang translation.

Raises KeyError if translation doesn’t exist.

url_parse_qsl(querystring)

return a list of (key, val) found in the url quoted query string

url_quote(value, safe='')

urllib.quote is not unicode safe, use this method to do the necessary encoding / decoding. Also it’s designed to quote each part of a url path and so the ‘/’ character will be encoded as well.

url_unquote(quoted)

returns a unicode unquoted string

decoding is based on self.encoding which is the encoding used in url_quote

user_data(*args, **kwargs)

returns a dictionary with this user’s information.

The keys are :

login

The user login

name

The user name, returned by user.name()

email

The user principal email

view(_RequestSessionBase__vid, rset=None, _RequestSessionBase__fallback_oid=None, _RequestSessionBase__registry='views', initargs=None, w=None, **kwargs)

Select object with the given id (__oid) then render it. If the object isn’t selectable, try to select fallback object if __fallback_oid is specified.

If specified initargs is expected to be a dictionary containing arguments that should be given to selection (hence to object’s __init__ as well), but not to render(). Other arbitrary keyword arguments will be given to selection and to render(), and so should be handled by object’s call or cell_call method..