dbapi.py
changeset 9821 2077c8da1893
parent 9774 b7b71be569cf
child 9830 465d8151b92d
equal deleted inserted replaced
9819:95902c0b991b 9821:2077c8da1893
   116 
   116 
   117     `database` may be:
   117     `database` may be:
   118 
   118 
   119     * a simple instance id for in-memory connection
   119     * a simple instance id for in-memory connection
   120 
   120 
   121     * an uri like scheme://host:port/instanceid where scheme may be one of
   121     * a uri like scheme://host:port/instanceid where scheme may be one of
   122       'pyro', 'inmemory' or 'zmqpickle'
   122       'pyro', 'inmemory' or 'zmqpickle'
   123 
   123 
   124       * if scheme is 'pyro', <host:port> determine the name server address. If
   124       * if scheme is 'pyro', <host:port> determine the name server address. If
   125         not specified (e.g. 'pyro:///instanceid'), it will be detected through a
   125         not specified (e.g. 'pyro:///instanceid'), it will be detected through a
   126         broadcast query. The instance id is the name of the instance in the name
   126         broadcast query. The instance id is the name of the instance in the name
   341         else:
   341         else:
   342             del self._eid_cache[eid]
   342             del self._eid_cache[eid]
   343 
   343 
   344     # low level session data management #######################################
   344     # low level session data management #######################################
   345 
   345 
       
   346     @deprecated('[3.19] use session or transaction data')
   346     def get_shared_data(self, key, default=None, pop=False, txdata=False):
   347     def get_shared_data(self, key, default=None, pop=False, txdata=False):
   347         """see :meth:`Connection.get_shared_data`"""
   348         """see :meth:`Connection.get_shared_data`"""
   348         return self.cnx.get_shared_data(key, default, pop, txdata)
   349         return self.cnx.get_shared_data(key, default, pop, txdata)
   349 
   350 
       
   351     @deprecated('[3.19] use session or transaction data')
   350     def set_shared_data(self, key, value, txdata=False, querydata=None):
   352     def set_shared_data(self, key, value, txdata=False, querydata=None):
   351         """see :meth:`Connection.set_shared_data`"""
   353         """see :meth:`Connection.set_shared_data`"""
   352         if querydata is not None:
   354         if querydata is not None:
   353             txdata = querydata
   355             txdata = querydata
   354             warn('[3.10] querydata argument has been renamed to txdata',
   356             warn('[3.10] querydata argument has been renamed to txdata',
   407 
   409 
   408     def execute(self, rql, args=None, build_descr=True):
   410     def execute(self, rql, args=None, build_descr=True):
   409         """execute a rql query, return resulting rows and their description in
   411         """execute a rql query, return resulting rows and their description in
   410         a :class:`~cubicweb.rset.ResultSet` object
   412         a :class:`~cubicweb.rset.ResultSet` object
   411 
   413 
   412         * `rql` should be an Unicode string or a plain ASCII string, containing
   414         * `rql` should be a Unicode string or a plain ASCII string, containing
   413           the rql query
   415           the rql query
   414 
   416 
   415         * `args` the optional args dictionary associated to the query, with key
   417         * `args` the optional args dictionary associated to the query, with key
   416           matching named substitution in `rql`
   418           matching named substitution in `rql`
   417 
   419