Documentación del modulo Qtr

class qtr.QClient(qnamattr=None, parent=None)

Esta clase realiza las peticiones a servidores HTTP

Ejemplo de uso:

>>> from qtr import QClient
>>> from PySide import QtGui
>>> QtGui.QApplication([])
>>> client = QClient()
>>> client.addstep_seturl("http://www.gnu.org")
>>> client.addstep_setscraper(scraper)
>>> client.do()
>>> results = client.getinternaldata()

Revise la documentación para descubrir que otros pasos más tiene disponible.

_QClient__add_step(**kwords)

Método de bajo nivel que añade pasos dentro de la pila de pasos

Parámetros:kwords (dict) – debe contener al menos el la llave method, puede ser una cadena o un método o función de Python. Actualmente la única cadena que tiene significado para este método es get, el verbo para hacer peticiones a servidores web.

_QClient__execute_step()

Ejecuta el paso actual directamente de la pila

cada paso debe contener la llave method. Este método busca también por los siguientes llaves:

Parámetros:

• block (bool) – indica si este paso bloquea el flujo de ejecución hasta que algo le indique terminar. False por defecto.
• store (bool) – indica que lo devuelto por este paso, debe ser almacenado en __internaldata. False por defecto.
• isScrap (bool) – indica que este paso es un raspador. False por defecto.
• args (tuple) – indica que el paso contiene una llave con una tupla dentro. tuple() por defecto.
• passargs (bool) – indica que hay que pasar args a method. False por defecto.
• passkwords (bool) – indica que hay que pasar step a method. True por defecto.
• passselfattribute (bool) – indica que hay que pasar un atributo de la instancia del objeto QClient. False por defecto.
• selfattributename (str) – indica el nombre del atributo de la instancia del objeto QClient. None por defecto.
• selfattribute (classmethod) – contiene el atributo tomado de la instancia del objeto QClient. No existe si passselfattribute es False
• selfattributeismethod (bool) – indica que el atributo no es un atributo, sino un método que retorna algo. False por defecto.

_accumulatedata()

Acumula los datos para guardarlos de forma segura y evitar que sean sobre-escritos.

_endrequest(reply)

Almacena los datos devueltos por el servidor web.

Este método hace que el loop de eventos se rompa y el flujo de la ejecución pueda continuar.

_executerequest(**kwords)

Ejecuta la petición al servidor web.

Parámetros:kwords (dict) – debe contener la llave verb que indica el verbo HTTP que se usara para la petición. Este método usa qtr.QClient.__request previamente modificado para realizar la petición.

Si la instancia QClient es hija de un objeto QtObject, establece como origen de la petición a sí misma.

_setpagescraper(**kwords)

Establece el raspador que raspara el contenido de cada enlace

Este método es usado por qtr.QClient.addstep_setscraperpageurls() y no hay razón para usarlo directamente.

_seturl(**kwords)

Método privado que estable la URL

Parámetros:

• kwords (dict) – debe contener las llaves fromscraped, url y query.
• fromscraped (bool) – indica si la URL a establecer se encuentra en el almacenamiento interno qtr.QClient.__internaldata.
• url (str) – La URL a usar.
• query (dict) – los queries a establecer en la URL.

abort(message, exception)

Aborta la ejecución de la secuencia de ordenes.

abortexecution = <PySide.QtCore.Signal object at 0x7f7847ed18b8>

accumulate = <PySide.QtCore.Signal object at 0x7f7847ed18f0>

addstep_setrequest(verb)

Establecerá el verbo de la petición web

addstep_setscraper(method)

Establece el método que raspara el contenido web

addstep_setscraperpageurls(method, perpagescraper)

Establece el raspador que extraerá la lista de URLs en una lista y la función que repasara cada enlace raspando su contenido.

Parámetros:

• method (classmethod) – el raspador de URLs.
• perpagescraper (classmethod) – el raspador que raspa el contenido de cada URL

addstep_seturl(url, query={})

Establecerá la URL sobre la cual realizar la petición web.

Se debe usar este método antes que qtr.QClient.addstep_setrequest().

do()

Inicia la secuencia de ordenes pre-programadas.

error()

Retorna el código de error de la petición realizada

Devuelve:código de error Return type:int

finished = <PySide.QtCore.Signal object at 0x7f7847ed1880>

getinternaldata(accumulated=False)

Retorna los datos internos.

Parámetros:accumulated (bool) – si es True, retorna los datos acumulados internos en vez de los internos. Devuelve:una cadena, o una lista.

geturl()

Retorna la URL actual

Devuelve:url Return type:unicode

nextstep = <PySide.QtCore.Signal object at 0x7f7847ed1848>

staticMetaObject = <PySide.QtCore.QMetaObject object at 0x7f7847ed2cf8>

status()

Retorna el código HTTP de la petición realizada

Devuelve:código HTTP Return type:int

step()

Emite una señal para que se ejecute un paso. Este método es llamado de forma recursiva hasta que se alcanza el final de la pila.