_idents module¶
-
exception
pyflyby._idents.
BadDottedIdentifierError
¶
-
class
pyflyby._idents.
DottedIdentifier
¶ -
classmethod
_from_name
(name)¶
-
parent
¶ Computes attribute value and caches it in instance.
Example:
class MyClass(object): @cached_attribute def myMethod(self): # ...
Use “del inst.myMethod” to clear cache.
-
prefixes
¶ Computes attribute value and caches it in instance.
Example:
class MyClass(object): @cached_attribute def myMethod(self): # ...
Use “del inst.myMethod” to clear cache.
-
startswith
(o)¶
-
classmethod
-
pyflyby._idents.
brace_identifiers
(text)¶ Parse a string and yield all tokens of the form “{some_token}”.
>>> list(brace_identifiers("{salutation}, {your_name}.")) ['salutation', 'your_name']
-
pyflyby._idents.
dotted_prefixes
(dotted_name, reverse=False)¶ Return the prefixes of a dotted name.
>>> dotted_prefixes("aa.bb.cc") ['aa', 'aa.bb', 'aa.bb.cc']
>>> dotted_prefixes("aa.bb.cc", reverse=True) ['aa.bb.cc', 'aa.bb', 'aa']
- Parameters
reverse – If False (default), return shortest to longest. If True, return longest to shortest.
- Return type
list
ofstr
-
pyflyby._idents.
is_identifier
(s, dotted=False, prefix=False)¶ Return whether
s
is a valid Python identifier name.>>> is_identifier("foo") True
>>> is_identifier("foo+bar") False
>>> is_identifier("from") False
By default, we check whether
s
is a single valid identifier, meaning dots are not allowed. Ifdotted=True
, then we check each dotted component:>>> is_identifier("foo.bar") False >>> is_identifier("foo.bar", dotted=True) True >>> is_identifier("foo..bar", dotted=True) False >>> is_identifier("foo.from", dotted=True) False
By default, the string must comprise a valid identifier. If
prefix=True
, then allow strings that are prefixes of valid identifiers. Prefix=False excludes the empty string, strings with a trailing dot, and strings with a trailing keyword component, but prefix=True does not exclude these.>>> is_identifier("foo.bar.", dotted=True) False
>>> is_identifier("foo.bar.", dotted=True, prefix=True) True
>>> is_identifier("foo.or", dotted=True) False
>>> is_identifier("foo.or", dotted=True, prefix=True) True
- Parameters
dotted – If
False
(default), then the input must be a single name such as “foo”. IfTrue
, then the input can be a single name or a dotted name such as “foo.bar.baz”.prefix – If
False
(Default), then the input must be a valid identifier. IfTrue
, then the input can be a valid identifier or the prefix of a valid identifier.
- Return type
bool