Part of lp.registry.interfaces.person View In Hierarchy
Known subclasses: lp.registry.interfaces.webservice.IPerson
Method | join | Join the given team if its membership_policy is not RESTRICTED. |
Method | leave | Leave the given team. |
Method | setMembershipData | Set the attributes of the person's membership on this team. |
Method | addMember | Add the given person as a member of this team. |
Method | acceptInvitationToBeMemberOf | Accept an invitation to become a member of the given team. |
Method | declineInvitationToBeMemberOf | Decline an invitation to become a member of the given team. |
Method | retractTeamMembership | Retract this team's membership in the given team. |
Method | renewTeamMembership | Renew the TeamMembership for this person on the given team. |
Method | security_field_changed | Trigger email when a secured field like preferredemail changes. |
Method | createPPA | Create a PPA. |
Join the given team according to the policies and defaults of that team:
If may_subscribe_to_list is True, then also attempt to subscribe to the team's mailing list, depending on the list status and the person's auto-subscribe settings.
Parameters | requester | The person who requested the membership on behalf of a team or None when a person requests the membership for themselves. |
may_subscribe_to_list | If True, also try subscribing to the team mailing list. |
This is a convenience method for retractTeamMembership() that allows a user to leave the given team, or to cancel a PENDING membership request.
Parameters | team | The team to leave. |
Set the status, dateexpires, reviewer and comment, where reviewer is the user responsible for this status change and comment is the comment left by the reviewer for the change.
This method will ensure that we only allow the status transitions specified in the TeamMembership spec. It's also responsible for filling/cleaning the TeamParticipation table when the transition requires it.
Parameters | person | If the given person is already a member of this team we'll simply change its membership status. Otherwise a new TeamMembership is created with the given status. |
reviewer | The user who made the given person a member of this team. | |
comment | String that will be assigned to the proponent_comment, reviwer_comment, or acknowledger comment. | |
status | TeamMembershipStatus value must be either
Approved, Proposed or Admin.
If the new member is a team, the status will be changed to
Invited unless the user is also an admin of that team. | |
force_team_add | If the person is actually a team and force_team_add is False, the team will actually be invited to join this one. Otherwise the team is added as if it were a person. | |
may_subscribe_to_list | If the person is not a team, and may_subscribe_to_list is True, then the person may be subscribed to the team's mailing list, depending on the list status and the person's auto-subscribe settings. | |
Returns | A tuple containing a boolean indicating when the
membership status changed and the current TeamMembershipStatus .
This depends on the desired status passed as an argument, the
membership policy and the user's privileges. |
There must be a TeamMembership for this person and the given team with the INVITED status. The status of this TeamMembership will be changed to APPROVED.
There must be a TeamMembership for this person and the given team with the INVITED status. The status of this TeamMembership will be changed to INVITATION_DECLINED.
If there's a membership entry for this team on the given team and its status is either APPROVED, ADMIN, PENDING, or INVITED, the status is changed and the relevant entries in TeamParticipation.
APPROVED and ADMIN status are changed to DEACTIVATED. PENDING status is changed to DECLINED. INVITED status is changes to INVITATION_DECLINED.
Parameters | team | The team to leave. |
user | The user making the retraction. | |
comment | An optional explanation about why the change was made. |
The given team's renewal policy must be ONDEMAND and the membership must be active (APPROVED or ADMIN) and set to expire in less than DAYS_BEFORE_EXPIRATION_WARNING_IS_SENT days.
Parameters | recipient_emails | If supplied custom email addresses to notify. This is used when a new preferred email address is set. |
subject | The subject to use. | |
change_description | A textual description to use when notifying about the change. |
Parameters | distribution | The distribution that this archive is for. |
name | The name of the new PPA to create. | |
displayname | The displayname for the new PPA. | |
description | The description for the new PPA. | |
private | Whether or not to create a private PPA. Defaults to False, which means the PPA will be public. | |
suppress_subscription_notifications | Whether or not to suppress emails to new subscribers about their subscriptions. Only meaningful for private PPAs. | |
Returns | a PPA IArchive record. | |
Raises | PPACreationError if an error is encountered |