Python: module yahoo.search.parser

Python: module yahoo.search.parser

 
 yahoo.search.parser (version 1.4, Wed Oct 26 11:24:50 PDT 2005)index/home/leif/hack/pysearch.git/yahoo/search/parser.py
Base class for search results parsing
 
This package implements the interface and base class that should be
used for all parsers of the web results. It is used by the DOM parsers
that we provide as defaults.

 
Classes

       

__builtin__.dict(__builtin__.object)
ResultDict
__builtin__.object
ResultParser
exceptions.Exception(exceptions.BaseException)
Error
ClassError
XMLError

 
class ClassError(Error)

   
This can only occur if the APIs aren't installed or configured
properly. If it happens, please contact the author. 
 

Method resolution order:
ClassError
Error
exceptions.Exception
exceptions.BaseException
__builtin__.object

Data descriptors inherited from Error:

__weakref__
list of weak references to the object (if defined)

Methods inherited from exceptions.Exception:

__init__(...)
x.__init__(...) initializes x; see x.__class__.__doc__ for signature

Data and other attributes inherited from exceptions.Exception:

__new__ = <built-in method __new__ of type object at 0x743cf00>
T.__new__(S, ...) -> a new object with type S, a subtype of T

Methods inherited from exceptions.BaseException:

__delattr__(...)
x.__delattr__('name') <==> del x.name
__getattribute__(...)
x.__getattribute__('name') <==> x.name
__getitem__(...)
x.__getitem__(y) <==> x[y]
__getslice__(...)
x.__getslice__(i, j) <==> x[i:j]
 
Use of negative indices is not supported.
__reduce__(...)
__repr__(...)
x.__repr__() <==> repr(x)
__setattr__(...)
x.__setattr__('name', value) <==> x.name = value
__setstate__(...)
__str__(...)
x.__str__() <==> str(x)

Data descriptors inherited from exceptions.BaseException:

__dict__
args
message
exception message

 
class Error(exceptions.Exception)

   
Base class for all Yahoo DOM Parser exceptions. 
 

Method resolution order:
Error
exceptions.Exception
exceptions.BaseException
__builtin__.object

Data descriptors defined here:

__weakref__
list of weak references to the object (if defined)

Methods inherited from exceptions.Exception:

__init__(...)
x.__init__(...) initializes x; see x.__class__.__doc__ for signature

Data and other attributes inherited from exceptions.Exception:

__new__ = <built-in method __new__ of type object at 0x743cf00>
T.__new__(S, ...) -> a new object with type S, a subtype of T

Methods inherited from exceptions.BaseException:

__delattr__(...)
x.__delattr__('name') <==> del x.name
__getattribute__(...)
x.__getattribute__('name') <==> x.name
__getitem__(...)
x.__getitem__(y) <==> x[y]
__getslice__(...)
x.__getslice__(i, j) <==> x[i:j]
 
Use of negative indices is not supported.
__reduce__(...)
__repr__(...)
x.__repr__() <==> repr(x)
__setattr__(...)
x.__setattr__('name', value) <==> x.name = value
__setstate__(...)
__str__(...)
x.__str__() <==> str(x)

Data descriptors inherited from exceptions.BaseException:

__dict__
args
message
exception message

 
class ResultDict(__builtin__.dict)

   
ResultDict - Simple class to wrap the results 
 

Method resolution order:
ResultDict
__builtin__.dict
__builtin__.object

Methods defined here:

__getattr__(self, key)

Data descriptors defined here:

__dict__
dictionary for instance variables (if defined)
__weakref__
list of weak references to the object (if defined)

Methods inherited from __builtin__.dict:

__cmp__(...)
x.__cmp__(y) <==> cmp(x,y)
__contains__(...)
D.__contains__(k) -> True if D has a key k, else False
__delitem__(...)
x.__delitem__(y) <==> del x[y]
__eq__(...)
x.__eq__(y) <==> x==y
__ge__(...)
x.__ge__(y) <==> x>=y
__getattribute__(...)
x.__getattribute__('name') <==> x.name
__getitem__(...)
x.__getitem__(y) <==> x[y]
__gt__(...)
x.__gt__(y) <==> x>y
__hash__(...)
x.__hash__() <==> hash(x)
__init__(...)
x.__init__(...) initializes x; see x.__class__.__doc__ for signature
__iter__(...)
x.__iter__() <==> iter(x)
__le__(...)
x.__le__(y) <==> x<=y
__len__(...)
x.__len__() <==> len(x)
__lt__(...)
x.__lt__(y) <==> x<y
__ne__(...)
x.__ne__(y) <==> x!=y
__repr__(...)
x.__repr__() <==> repr(x)
__setitem__(...)
x.__setitem__(i, y) <==> x[i]=y
clear(...)
D.clear() -> None.  Remove all items from D.
copy(...)
D.copy() -> a shallow copy of D
get(...)
D.get(k[,d]) -> D[k] if k in D, else d.  d defaults to None.
has_key(...)
D.has_key(k) -> True if D has a key k, else False
items(...)
D.items() -> list of D's (key, value) pairs, as 2-tuples
iteritems(...)
D.iteritems() -> an iterator over the (key, value) items of D
iterkeys(...)
D.iterkeys() -> an iterator over the keys of D
itervalues(...)
D.itervalues() -> an iterator over the values of D
keys(...)
D.keys() -> list of D's keys
pop(...)
D.pop(k[,d]) -> v, remove specified key and return the corresponding value
If key is not found, d is returned if given, otherwise KeyError is raised
popitem(...)
D.popitem() -> (k, v), remove and return some (key, value) pair as a
2-tuple; but raise KeyError if D is empty
setdefault(...)
D.setdefault(k[,d]) -> D.get(k,d), also set D[k]=d if k not in D
update(...)
D.update(E, **F) -> None.  Update D from E and F: for k in E: D[k] = E[k]
(if E has keys else: for (k, v) in E: D[k] = v) then: for k in F: D[k] = F[k]
values(...)
D.values() -> list of D's values

Data and other attributes inherited from __builtin__.dict:

__new__ = <built-in method __new__ of type object at 0x7443680>
T.__new__(S, ...) -> a new object with type S, a subtype of T
fromkeys = <built-in method fromkeys of type object at 0x8561a8c>
dict.fromkeys(S[,v]) -> New dict with keys from S and values equal to v.
v defaults to None.

 
class ResultParser(__builtin__.object)

   
Yahoo Search Web Service Results - base class
 
This is the base class for all Yahoo Search Web Service result parsers.
If you build your own result parser (e.g. non-DOM based), please sub-
class ResultParser.  The following attributes are always available:
 
    total_results_available
    total_results_returned
    first_result_position
 
    results
 
 
Results are a list of dictionaries, which can be a custom class as
required. An interator generator is provided for easy access to the
list of results. For example, to iterate over all results, you would do
something like:
 
    dom = ws.get_results()
    results = ws.parse_results(dom)
    dom.unlink()
 
    for res in results:
        print res['Url']
        print res.Summary
 
 
As you can see, each result is a customizable dictionary. The default
results dict supports accessing each key as a "property", like the
above example (res.Summary).
 
You can also get the list of results directly, using the results
attribute. An optional res_dict argument can be used to provide an
alternative dictionary implementation to use for the results. 
 
Methods defined here:

__init__(self, service, res_dict=<class 'yahoo.search.parser.ResultDict'>)
__iter__(self)
parse_results(self, result_set)
Parse the results.

Data descriptors defined here:

__dict__
dictionary for instance variables (if defined)
__weakref__
list of weak references to the object (if defined)
firstResultPosition
The first result position
first_result_position
The first result position
results
The list of all results
service
The Search Web Service object for this results parser
totalResultsAvailable
Total number of results for the query
totalResultsReturned
The number of results returned
total_results_available
Total number of results for the query
total_results_returned
The number of results returned

 
class XMLError(Error)

   
This exception can occur if, and only if, Yahoo returns malformed
XML results. 
 

Method resolution order:
XMLError
Error
exceptions.Exception
exceptions.BaseException
__builtin__.object

Data descriptors inherited from Error:

__weakref__
list of weak references to the object (if defined)

Methods inherited from exceptions.Exception:

__init__(...)
x.__init__(...) initializes x; see x.__class__.__doc__ for signature

Data and other attributes inherited from exceptions.Exception:

__new__ = <built-in method __new__ of type object at 0x743cf00>
T.__new__(S, ...) -> a new object with type S, a subtype of T

Methods inherited from exceptions.BaseException:

__delattr__(...)
x.__delattr__('name') <==> del x.name
__getattribute__(...)
x.__getattribute__('name') <==> x.name
__getitem__(...)
x.__getitem__(y) <==> x[y]
__getslice__(...)
x.__getslice__(i, j) <==> x[i:j]
 
Use of negative indices is not supported.
__reduce__(...)
__repr__(...)
x.__repr__() <==> repr(x)
__setattr__(...)
x.__setattr__('name', value) <==> x.name = value
__setstate__(...)
__str__(...)
x.__str__() <==> str(x)

Data descriptors inherited from exceptions.BaseException:

__dict__
args
message
exception message

 
Functions

       

string_to_bool(string)
Convert a string to a boolean value

 
Data

       
__author__ = 'Leif Hedstrom <leif@ogre.com>'
__date__ = 'Wed Oct 26 11:24:50 PDT 2005'
__revision__ = '$Id: parser.py,v 1.4 2005-10-26 20:32:27 zwoop Exp $'
__version__ = '$Revision: 1.4 $'

 
Author

       
Leif Hedstrom <leif@ogre.com>

retrieved