Package epydoc :: Module apidoc :: Class DottedName

Class DottedName

A sequence of identifiers, separated by periods, used to name a Python variable, value, or argument. The identifiers that make up a dotted name can be accessed using the indexing operator:

>>> name = DottedName('epydoc', 'api_doc', 'DottedName')
>>> print name
epydoc.apidoc.DottedName
>>> name[1]
'api_doc'

Nested Classes

[hide private]

InvalidDottedName
An exception raised by the DottedName constructor when one of its arguments is not a valid dotted name.

Instance Methods

[hide private]

__init__(self, *pieces, **options)
Construct a new dotted name from the given sequence of pieces, each of which can be either a string or a DottedName. source code
call graph

__repr__(self)

source code

__str__(self)
Return the dotted name as a string formed by joining its identifiers with periods:

source code
call graph

__add__(self, other)
Return a new DottedName whose identifier sequence is formed by adding other's identifier sequence to self's. source code
call graph

__radd__(self, other)
Return a new DottedName whose identifier sequence is formed by adding self's identifier sequence to other's. source code
call graph

__getitem__(self, i)
Return the ith identifier in this DottedName. source code
call graph

__hash__(self)

source code
call graph

__cmp__(self, other)
Compare this dotted name to other. source code
call graph

__len__(self)
Return the number of identifiers in this dotted name.

source code
call graph

container(self)
Return the DottedName formed by removing the last identifier from this dotted name's identifier sequence.

source code
call graph

dominates(self, name, strict=False)
Return true if this dotted name is equal to a prefix of name. source code
call graph

DottedName

contextualize(self, context)
If self and context share a common ancestor, then return a name for self, relative to that ancestor. source code
call graph

Class Variables

[hide private]

UNREACHABLE = '??'

_IDENTIFIER_RE = re.compile(r'(?x)(\?\?|(script-)?\w+\'?)(-\d+...

_ok_identifiers = set(['??', '??-1', '??-10', '??-11', '??-12'...
A cache of identifier strings that have been checked against _IDENTIFIER_RE and found to be acceptable.

Method Details

[hide private]

init(self, *pieces, **options)
(Constructor)

source code
call graph

Construct a new dotted name from the given sequence of pieces, each of which can be either a string or a DottedName. Each piece is divided into a sequence of identifiers, and these sequences are combined together (in order) to form the identifier sequence for the new DottedName. If a piece contains a string, then it is divided into substrings by splitting on periods, and each substring is checked to see if it is a valid identifier.

As an optimization, pieces may also contain a single tuple of values. In that case, that tuple will be used as the DottedName's identifiers; it will not be checked to see if it's valid.

Parameters:

strict - if true, then raise an InvalidDottedName if the given name is invalid.

str(self)
(Informal representation operator)

source code
call graph

Return the dotted name as a string formed by joining its identifiers with periods:

>>> print DottedName('epydoc', 'api_doc', DottedName')
epydoc.apidoc.DottedName

getitem(self, i)
(Indexing operator)

source code
call graph

Return the ith identifier in this DottedName. If i is a non-empty slice, then return a DottedName built from the identifiers selected by the slice. If i is an empty slice, return an empty list (since empty DottedNames are not valid).

cmp(self, other)
(Comparison operator)

source code
call graph

Compare this dotted name to other. Two dotted names are considered equal if their identifier subsequences are equal. Ordering between dotted names is lexicographic, in order of identifier from left to right.

container(self)

source code
call graph

Return the DottedName formed by removing the last identifier from this dotted name's identifier sequence. If this dotted name only has one name in its identifier sequence, return None instead.

dominates(self, name, strict=False)

source code
call graph

Return true if this dotted name is equal to a prefix of name. If strict is true, then also require that self!=name.

>>> DottedName('a.b').dominates(DottedName('a.b.c.d'))
True

contextualize(self, context)

source code
call graph

If self and context share a common ancestor, then return a name for self, relative to that ancestor. If they do not share a common ancestor (or if context is UNKNOWN), then simply return self.

This is used to generate shorter versions of dotted names in cases where users can infer the intended target from the context.

Parameters:

context (DottedName)

Returns: DottedName

Class Variable Details

[hide private]

_IDENTIFIER_RE

Value:

re.compile(r'(?x)(\?\?|(script-)?\w+\'?)(-\d+)?$')

_ok_identifiers

A cache of identifier strings that have been checked against _IDENTIFIER_RE and found to be acceptable.

Value:

set(['??',
     '??-1',
     '??-10',
     '??-11',
     '??-12',
     '??-13',
     '??-2',
     '??-3',
...

Class DottedName

__init__(self, *pieces, **options) (Constructor)

__str__(self) (Informal representation operator)

__getitem__(self, i) (Indexing operator)

__cmp__(self, other) (Comparison operator)

container(self)

dominates(self, name, strict=False)

contextualize(self, context)

_IDENTIFIER_RE

_ok_identifiers

init(self, *pieces, **options)
(Constructor)

str(self)
(Informal representation operator)

getitem(self, i)
(Indexing operator)

cmp(self, other)
(Comparison operator)