~jimmy-sigint/mailman/restapi_additional_attributes

« back to all changes in this revision

Viewing changes to src/mailman/model/docs/domains.txt

Committer: Barry Warsaw
Date: 2010-09-09 02:35:20 UTC
Revision ID: barry@list.org-20100909023520-juyyjewh3t0w11pz

Many documentation fixes for better Sphinx output.

files modified:
src/mailman/app/docs/bounces.txt

src/mailman/app/docs/chains.txt

src/mailman/app/docs/hooks.txt

src/mailman/app/docs/lifecycle.txt

src/mailman/app/docs/message.txt

src/mailman/app/docs/styles.txt

src/mailman/app/docs/system.txt

src/mailman/bin/docs/master.txt

src/mailman/commands/docs/create.txt

src/mailman/commands/docs/echo.txt

src/mailman/commands/docs/import.txt

src/mailman/commands/docs/info.txt

src/mailman/commands/docs/inject.txt

src/mailman/commands/docs/lists.txt

src/mailman/commands/docs/members.txt

src/mailman/commands/docs/membership.txt

src/mailman/commands/docs/qfile.txt

src/mailman/commands/docs/remove.txt

src/mailman/commands/docs/unshunt.txt

src/mailman/commands/docs/version.txt

src/mailman/commands/docs/withlist.txt

src/mailman/model/docs/addresses.txt

src/mailman/model/docs/autorespond.txt

src/mailman/model/docs/domains.txt

src/mailman/model/docs/languages.txt

src/mailman/model/docs/listmanager.txt

src/mailman/model/docs/mailinglist.txt

src/mailman/model/docs/membership.txt

src/mailman/model/docs/messagestore.txt

src/mailman/model/docs/mlist-addresses.txt

src/mailman/model/docs/pending.txt

src/mailman/model/docs/registration.txt

src/mailman/model/docs/requests.txt

src/mailman/model/docs/usermanager.txt

src/mailman/model/docs/users.txt

src/mailman/pipeline/docs/ack-headers.txt

Show diffs side-by-side

added added

removed removed

src/mailman/model/docs/domains.txt

Domains

=======

# The test framework starts out with an example domain, so let's delete

.. # The test framework starts out with an example domain, so let's delete

# that first.

>>> from mailman.interfaces.domain import IDomainManager

>>> from zope.component import getUtility

Domains are how Mailman interacts with email host names and web host names.

>>> from operator import attrgetter

>>> def show_domains():

contact_address: postmaster@example.com>

Domains can have explicit descriptions and contact addresses.

>>> manager.add(

... 'example.net',

contact_address: postmaster@example.com>

In the global domain manager, domains are indexed by their email host name.

>>> for domain in sorted(manager, key=attrgetter('email_host')):

... print domain.email_host

KeyError: u'doesnotexist.com'

As with a dictionary, you can also get the domain. If the domain does not

exist, None or a default is returned.

exist, ``None`` or a default is returned.

>>> print manager.get('example.net')

<Domain example.net, The example domain,

Older »