API docs for “spamfighter.core.domain.BaseDomain”

Домен - единица настроек, привязки локальных элементов внутренного устройства СпамоБорца.

Все домены связаны в дерево, начинающееся главным доменом (глобально известным серверу).

Базовый класс доменов представляет домены "в памяти", без какого-либо сохранения, а также без "детей".

Instance Variables	_name	имя домена (type: `str` )
	_key	ключ домена (type: `str` )
	_parent	предок данного домена (type: `IDomain` )
	_dict	хеш (словарь) атрибутов, заданных в данном домене (type: `dict` )
	_children	хэш поддоменов по их именам (type: `dict` )

Method	__init__	Конструктор.
Method	name	Имя домена (относительно пути).
Method	key	Ключ домена. Уникальное и постоянное свойство
Method	parent	Получить предка данного домена.
Method	children	Получить список "дочерних" доменов.
Method	createSubdomain	Создать дочерний поддомен.
Method	walk	"Пройти" по пути от текущего домена.
Method	get	Получить значение свойства домена.
Method	has	Есть ли у домена указанное свойство?
Method	delete	Удалить свойство из домена.
Method	set	Установить значение свойства в домене.
Method	list	Получить список имён свойств домена.

def __init__(self, key=None, name=None, parent=None, dict=None): (source)

Конструктор.

Parameters	parent	предок текущего домена (type: `IDomain` )
	dict	начальное значение домена (type: `dict` )

def name(self): (source)

Имя домена (относительно пути).

Если домен корневой или не содержится в пути, имя может быть None.

Returns имя домена (type: str )

def parent(self): (source)

Получить предка данного домена.

Если предка нет, будет возвращено None.

Returns (type: IDomain )

def children(self): (source)

Получить список "дочерних" доменов.

Returns Deferred, результат - хэш (имя домена: домен) (dict(IDomain)) (type: twisted.internet.defer.Deferred )

def createSubdomain(self, name): (source)

Создать дочерний поддомен.

Parameters	name	имя поддомена (type: `str` )
Returns	Deferred с созданным поддоменом, `IDomain` (type: `twisted.internet.defer.Deferred` )
Raises	DomainDuplicateError	два поддомена с одинаковым именем не могут существовать

def walk(self, path): (source)

"Пройти" по пути от текущего домена.

Parameters	path	путь относительно текущего домена, строка со слэшами (type: `str` )
Returns	Deferred, найденный домен (`IDomain`) (type: `twisted.internet.defer.Deferred` )
Raises	DomainPathError	домен не найден

def get(self, property): (source)

Получить значение свойства домена.

Если текущий домен не содержит информацию о данном свойстве, будет предпринято обращение к предку домена за данным свойством.

Parameters	property	имя свойства (type: `str` )
Returns	значение свойства

def has(self, property): (source)

Есть ли у домена указанное свойство?

Parameters	property	имя свойства (type: `str` )
Returns	(type: `bool` )

def delete(self, property): (source)

Удалить свойство из домена.

При следующем обращении к свойству оно будет получено через предка домена, т.е. это эквивалентно сбросу на "значение по умолчанию".

Parameters	property	имя свойства (type: `str` )
Returns	Deferred о результате операции (type: `twisted.internet.defer.Deferred` )

def set(self, property, value): (source)

Установить значение свойства в домене.

Данный метод может также создать свойство, если оно ранее не существовало и переопределить свойство домена-предка.

Parameters	property	имя свойства (type: `str` )
	value	значение свойства
Returns	Deferred о результате операции (type: `twisted.internet.defer.Deferred` )

Class s.c.d.BaseDomain(object):