Part of lp.registry.interfaces.mailinglist View In Hierarchy
| Method | getPendingActions | Get all pending mailing list actions. |
| Method | reportStatus | Report the status of mailing list actions. |
| Method | getMembershipInformation | Get membership information for the listed teams. |
| Method | isTeamPublic | Is the team with the given name public? |
| Method | isRegisteredInLaunchpad | Whether the address is a Launchpad member. |
| Method | inGoodStanding | Whether the address is a Launchpad member in good standing. |
| Method | holdMessage | Hold the message for approval though the Launchpad u/i. |
| Method | getMessageDispositions | Get all new message dispositions. |
In addition, any mailing list for which there are actions pending will have their states transitioned to the next node in the workflow. For example, an APPROVED mailing list will be transitioned to CONSTRUCTING, and a MODIFIED mailing list will be transitioned to UPDATING.
Actions are strings, with the following valid values:
For the 'deactivate' action, the value items are just the team name for the list being deactivated. For the 'create' and 'modify' actions, the value items are 2-tuples where the first item is the team name and the second item is a dictionary of the list attributes to modify, for example 'welcome_message'.
There will be at most one action per team.
| Returns | A dictionary with keys being the action names and values being a sequence of values describing the details of each action. | |
When Mailman processes the actions requested in getPendingActions(), it will report the status of those actions back to Launchpad.
In addition, any mailing list for which a status is being reported will have its state transitioned to the next node in the workflow. For example, a CONSTRUCTING or UPDATING mailing list will be transitioned to ACTIVE or FAILED depending on the status.
| Parameters | statuses | A dictionary mapping team names to result strings. The result strings may be either 'success' or 'failure'. |
The return value is of the format:
{team_name: [(address, realname, flags, status), ...], ...}
And each value contains an entry for all addresses that are subscribed to the mailing list linked to the named team.
| Parameters | teams | The list of team names for which Mailman is requesting membership information. |
| Returns | A data structure representing the requested information. See below for the format of that data structure. The records in values are sorted by email address. | |
| Raises | NoSuchPersonWithName | If there's no team with the given name. |
| Parameters | address | The text email address to check. |
| Returns | True if the address is a validated or preferred email address owned by a Launchpad member. | |
| Parameters | address | The text email address to check. |
| Returns | True if the address is a member of Launchpad in good or better standing (e.g. GOOD or EXCELLENT). False is returned if the address is not registered in Launchpad, or is assigned to a team. | |
| Parameters | team_name | The name of the team/mailing list that this message was posted to. |
| bytes | The original text of the message as bytes. | |
| Returns | True | |
This returns a dictionary mapping message ids to their disposition, which will either be 'accept', 'decline' or 'discard'. This only returns message-ids of disposed messages since the last time this method was called. Because this also acknowledges the pending states of such messages, it changes the state on the Launchpad server.
| Returns | A dictionary mapping message-ids to the disposition tuple. This tuple is of the form (team-name, action), where the action is either the string 'accept' or 'decline'. | |