Part of lp.registry.interfaces.webservice View In Hierarchy
A group of people and other teams.
Launchpadlib example of getting the date a user joined a team:
def get_join_date(team, user):
team = launchpad.people[team]
members = team.members_details
for member in members:
if member.member.name == user:
return member.date_joined
return None
Implementation notes:
Inherited from IPersonPublic (via IPerson):
| Int | id | Undocumented |
| Bool | is_valid_person | Undocumented |
| Method | anyone_can_join | Quick check as to whether a team allows anyone to join. |
| Method | checkAllowVisibility | Is the user allowed to see the visibility field. |
| Method | transitionVisibility | Set visibility of IPerson. |
| Method | isMergePending | Is this person due to be merged with another? |
Inherited from IPrivacy (via IPerson, IPersonPublic):
| Bool | private | Private objects are visible to members or subscribers. |
Inherited from IPersonLimitedView (via IPerson):
| Attribute | displayname | Display name (deprecated) |
| TextLine | unique_displayname | Undocumented |
| IconImageUpload | icon | A small image of exactly 14x14 pixels and at most 5kb in size, that can be used to identify this team. The icon will be displayed whenever the team name is listed - for example in listings of bugs or on a person's membership table. |
| Int | iconID | Undocumented |
| Int | logoID | Undocumented |
| Attribute | title | Person Page Title |
| Method | getPPAByName | Return a PPA with the given name if it exists. |
Inherited from IHasLogo (via IPerson, IPersonLimitedView):
| Attribute | logo | The 64x64 logo. |
Inherited from IPersonViewRestricted (via IPerson):
| Object | account | Undocumented |
| Int | accountID | Undocumented |
| Int | mugshotID | Undocumented |
| Choice | creation_rationale | Undocumented |
| TextLine | creation_comment | This comment may be displayed verbatim in a web page, so it has to follow some structural constraints, that is, it must be of the form: 'when %(action_details)s' (e.g 'when the foo package was imported into Ubuntu Breezy'). The only exception to this is when we allow users to create Launchpad profiles through the /people/+newperson page. |
| Attribute | registrant | The user who created this profile. |
| Attribute | oauth_access_tokens | Non-expired access tokens |
| Attribute | oauth_request_tokens | Non-expired request tokens |
| Attribute | karma_category_caches | The caches of karma scores, by karma category. |
| Attribute | activesignatures | Retrieve own Active CoC Signatures. |
| Attribute | inactivesignatures | Retrieve own Inactive CoC Signatures. |
| Attribute | signedcocs | List of Signed Code Of Conduct |
| Attribute | inactive_gpg_keys | List of inactive OpenPGP keys in LP Context, ordered by ID |
| Attribute | teams_with_icons | Iterable of all Teams that this person is active in that have icons |
| Attribute | guessedemails | List of emails with status NEW. These email addresses probably came from a gina or POFileImporter run. |
| Attribute | unvalidatedemails | Emails this person added in Launchpad but are not yet validated. |
| Attribute | specifications | Any specifications related to this person, either because the are a subscriber, or an assignee, or a drafter, or the creator. Sorted newest-first. |
| Method | findVisibleAssignedInProgressSpecs | List specifications in progress assigned to this person. |
| Int | teamownerID | Undocumented |
| TextLine | safe_email_or_blank | The person's preferred email if they haveone and do not choose to hide it. Otherwisethe empty string. |
| Bool | verbose_bugnotifications | Undocumented |
| Int | merged | When a Person is merged into another Person, this attribute is set on the Person referencing the destination Person. If this is set to None, then this Person has not been merged into another and is still valid |
| Attribute | structural_subscriptions | The structural subscriptions for this person. |
| Attribute | visibilityConsistencyWarning | Warning that a private team may leak membership info. |
| Attribute | administrated_teams | Undocumented |
| Method | personCannotHaveIcon | Only Persons can have icons. |
| Method | convertToTeam | Convert this person into a team owned by the given team_owner. |
| Method | createRecipe | Create a SourcePackageRecipe owned by this person. |
| Method | getRecipe | Return the person's recipe with the given name. |
| Method | getArchiveSubscriptions | Return (private) archives subscription for this person. |
| Method | getArchiveSubscriptionURLs | Return private archive URLs that this person can see. |
| Method | getArchiveSubscriptionURL | Get a text line that is suitable to be used for a sources.list |
| Method | getVisiblePPAs | Return active PPAs for which user has launchpad.View permission. |
| Method | getInvitedMemberships | Return all TeamMemberships of this team with the INVITED status. |
| Method | getInactiveMemberships | Return all inactive TeamMemberships of this team. |
| Method | getProposedMemberships | Return all TeamMemberships of this team with the PROPOSED status. |
| Method | getBugSubscriberPackages | Return the packages for which this person is a bug subscriber. |
| Method | setContactAddress | Set the given email address as this team's contact address. |
| Method | setPreferredEmail | Set the given email address as this person's preferred one. |
| Method | findPathToTeam | Return the teams providing membership to the given team. |
| Attribute | mailing_list | The team's mailing list, if it has one, otherwise None. |
| Method | getProjectsAndCategoriesContributedTo | Return a list of dicts with projects and the contributions made |
| Method | getAffiliatedPillars | Return the pillars that this person directly has a role with. |
| Method | getOwnedProjects | Projects owned by this person or teams to which they belong. |
| Method | isAnyPillarOwner | Is this person the owner of any pillar? |
| Method | getAllCommercialSubscriptionVouchers | Return all commercial subscription vouchers. |
| Method | getRedeemableCommercialSubscriptionVouchers | Return the set of redeemable vouchers. |
| Method | hasCurrentCommercialSubscription | Return if the user has a current commercial subscription. |
| Method | assignKarma | Assign karma for the action named <action_name> to this person. |
| Method | latestKarma | Return the latest karma actions for this person. |
| Method | inTeam | Is this person is a member of team? |
| Method | clearInTeamCache | Clears the person's inTeam cache. |
| Method | getLatestSynchronisedPublishings | Return `SourcePackagePublishingHistory`s synchronised by this |
| Method | getLatestMaintainedPackages | Return `SourcePackageRelease`s maintained by this person. |
| Method | getLatestUploadedButNotMaintainedPackages | Return `SourcePackageRelease`s created by this person but |
| Method | getLatestUploadedPPAPackages | Return `SourcePackageRelease`s uploaded by this person to any PPA. |
| Method | hasSynchronisedPublishings | Are there `SourcePackagePublishingHistory`s synchronised by this |
| Method | hasMaintainedPackages | Are there `SourcePackageRelease`s maintained by this person. |
| Method | hasUploadedButNotMaintainedPackages | Are there `SourcePackageRelease`s created by this person but |
| Method | hasUploadedPPAPackages | Are there `SourcePackageRelease`s uploaded by this person to any |
| Method | validateAndEnsurePreferredEmail | Ensure this person has a preferred email. |
| Method | hasParticipationEntryFor | Return True when this person is a member of the given team. |
| Method | getOwnedTeams | Return the teams that this person owns. |
| Method | getAdministratedTeams | Return the teams that this person/team is an administrator of. |
| Method | getTeamAdminsEmailAddresses | Return a set containing the email addresses of all administrators |
| Method | getLatestApprovedMembershipsForPerson | Return the <limit> latest approved membrships for this person. |
| Method | getPathsToTeams | Return the paths to all teams related to this person. |
| Method | addLanguage | Add a language to this person's preferences. |
| Method | removeLanguage | Remove a language from this person's preferences. |
| Method | isBugContributor | Is the person a contributer to bugs in Launchpad? |
| Method | isBugContributorInTarget | Is the person a contributor to bugs in target? |
| Method | autoSubscribeToMailingList | Subscribe this person to a mailing list. |
| Method | checkRename | Check if a person or team can be renamed. |
| Method | canCreatePPA | Check if a person or team can create a PPA. |
| Method | getAssignedSpecificationWorkItemsDueBefore | Return SpecificationWorkItems assigned to this person (or members |
| Method | getAssignedBugTasksDueBefore | Get all BugTasks assigned to this person (or members of this team) |
| List | participant_ids | Undocumented |
| Attribute | active_member_count | The number of real people who are members of this team. |
| Attribute | activemembers | List of direct members with ADMIN or APPROVED status |
| Attribute | adminmembers | List of this team's admins. |
| Attribute | all_member_count | The total number of real people who are members of this team, including subteams. |
| Attribute | deactivated_member_count | Number of deactivated members |
| Attribute | deactivatedmembers | Former members of the team. |
| Attribute | expired_member_count | Number of EXPIRED members. |
| Attribute | expiredmembers | Expired members of the team. |
| Attribute | inactive_member_count | Number of inactive members |
| Attribute | invited_members | Other teams which have been invited to become members of this team. |
| Attribute | invited_member_count | Number of members with INVITED status |
| Attribute | proposedmembers | People who have applied to join the team. |
| Attribute | proposed_member_count | Number of PROPOSED members |
| Method | getMembersWithPreferredEmails | Returns a result set of persons with precached addresses. |
| Method | getMembersWithPreferredEmailsCount | Returns the count of persons/teams with preferred emails. |
| Method | getDirectAdministrators | Return this team's administrators. |
| Method | getMembersByStatus | Return the people whose membership on this team match :status:. |
Inherited from IHasBranches (via IPerson, IPersonViewRestricted):
| Method | getBranches | Returns all branches with the given lifecycle status. |
Inherited from IHasSpecifications (via IPerson, IPersonViewRestricted):
| Method | valid_specifications | Valid specifications for this target. |
Inherited from IHasMergeProposals (via IPerson, IPersonViewRestricted):
| Method | getMergeProposals | Returns all merge proposals of a given status. |
Inherited from IHasMugshot (via IPerson, IPersonViewRestricted):
| Attribute | mugshot | The 192x192 mugshot. |
Inherited from IHasRequestedReviews (via IPerson, IPersonViewRestricted):
| Method | getRequestedReviews | Returns merge proposals where a person was asked to review. |
| Method | getOwnedAndRequestedReviews | Returns merge proposals for branches owned by a person, or where |
Inherited from IObjectWithLocation (via IPerson, IPersonViewRestricted):
| Attribute | location | An ILocation for this object. |
Inherited from IHasBugs (via IPerson, IPersonViewRestricted):
| Method | searchTasks | Search the IBugTasks reported on this entity. |
| Method | getBugTaskWeightFunction | Return a function that is used to weight the bug tasks. |
Inherited from IHasTranslationImports (via IPerson, IPersonViewRestricted):
| Method | getFirstEntryToImport | Return the first entry of the queue ready to be imported. |
| Method | getTranslationImportQueueEntries | Return entries in the translation import queue for this entity. |
Inherited from IPersonSettingsViewRestricted (via IPerson, IPersonViewRestricted):
| Bool | selfgenerated_bugnotifications | Undocumented |
| Bool | expanded_notification_footers | Some email clients do not allow filtering on arbitrary message headers. If you use one of these, you can set this option to add more information to the end of message bodies. |
Inherited from IQuestionsPerson (via IPerson, IPersonViewRestricted):
| Method | getDirectAnswerQuestionTargets | Return a list of IQuestionTargets that a person is subscribed to. |
| Method | getTeamAnswerQuestionTargets | Return a list of IQuestionTargets that are indirect subscriptions. |
| Method | searchQuestions | Search the person's questions. |
Inherited from IQuestionCollection (via IPerson, IPersonViewRestricted, IQuestionsPerson):
| Method | getQuestionLanguages | Return the set of ILanguage used by all the questions in the |
Inherited from IPersonEditRestricted (via 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. |
Inherited from IPersonSettingsModerate (via IPerson, IPersonModerate):
| Bool | require_strong_email_authentication | If this option is set, Launchpad will only accept incoming emails from you if it can authenticate them using OpenPGP or DKIM. Launchpad administrators may set this if one of your email addresses is being forged as the sender address for incoming spam. |
Inherited from IPersonModerateRestricted (via IPerson):
| Method | setAccountStatus | Set the status of this person's account. |
Inherited from IPersonSpecialRestricted (via IPerson):
| Method | canDeactivate | Verify we safely deactivate this user account. |
| Method | preDeactivate | Perform the easy work in deactivating a user. |
| Method | deactivate | Deactivate this person's Launchpad account. |
| Method | reactivate | Reactivate this person and its account. |
| Method | canAccess | True if this person can access the given attribute of the object. |
| Method | canWrite | True if this person can write the given attribute of the object. |
Inherited from IPersonSettingsViewRestricted (via IPerson, IPersonSettings):
| Bool | selfgenerated_bugnotifications | Undocumented |
| Bool | expanded_notification_footers | Some email clients do not allow filtering on arbitrary message headers. If you use one of these, you can set this option to add more information to the end of message bodies. |
Inherited from IPersonSettingsModerate (via IPerson, IPersonSettings):
| Bool | require_strong_email_authentication | If this option is set, Launchpad will only accept incoming emails from you if it can authenticate them using OpenPGP or DKIM. Launchpad administrators may set this if one of your email addresses is being forged as the sender address for incoming spam. |
Inherited from IHasStanding (via IPerson):
| Choice | personal_standing | The standing of a person for non-member mailing list posting privileges. |
| Text | personal_standing_reason | The reason the person's standing is what it is. |
Inherited from ISetLocation (via IPerson):
| Method | setLocation | Specify the location and time zone of a person. |
Inherited from ITeamPublic:
| Method | defaultRenewalPeriodIsRequiredForSomeTeams | Teams may specify a default renewal period. |
| Attribute | defaultexpirationdate | The date, according to team's default values, in which a newly approved membership will expire. |
| Attribute | defaultrenewedexpirationdate | The date, according to team's default values, in which a just-renewed membership will expire. |
| Method | checkInclusiveMembershipPolicyAllowed | Check whether this team's membership policy can be open. |
| Method | checkExclusiveMembershipPolicyAllowed | Return true if this team's membership policy must be open. |