from metadata.sdk import configure
from metadata.sdk.entities import Users

configure(
    host="https://your-company.getcollate.io/api",
    jwt_token="your-jwt-token"
)

# List first page
users = Users.list(limit=50)
for user in users.data:
    print(f"{user.fullyQualifiedName}")

# List all with auto-pagination
for user in Users.list_all():
    print(f"{user.fullyQualifiedName}")

# Filter by team with fields
users = Users.list(
    team="Sales",
    fields=["teams", "roles", "domains"],
    limit=50
)

for user in users.data:
    print(f"{user.fullyQualifiedName}")
    if user.teams:
        print(f"  Teams: {[t.name for t in user.teams]}")
    if user.roles:
        print(f"  Roles: {[r.name for r in user.roles]}")

# Filter bot accounts
bots = Users.list(isBot=True, limit=50)

{
  "data": [
    {
      "id": "77655e6e-ad33-49da-bbca-db4ba4d4e2cd",
      "name": "aaron_johnson0",
      "fullyQualifiedName": "aaron_johnson0",
      "displayName": "Aaron Johnson",
      "version": 0.1,
      "updatedAt": 1769982624214,
      "updatedBy": "admin",
      "email": "[email protected]",
      "href": "http://localhost:8585/api/v1/users/77655e6e-ad33-49da-bbca-db4ba4d4e2cd",
      "isBot": false,
      "isAdmin": false,
      "allowImpersonation": false,
      "teams": [
        {
          "id": "7a2b921b-f623-4eb5-9736-649788ad842c",
          "type": "team",
          "name": "Sales",
          "fullyQualifiedName": "Sales",
          "displayName": "Sales",
          "deleted": false
        }
      ],
      "personas": [],
      "deleted": false,
      "roles": [
        {
          "id": "761c2bb2-0b77-4bc5-9af9-cf89536d6a12",
          "type": "role",
          "name": "DataSteward",
          "fullyQualifiedName": "DataSteward",
          "displayName": "Data Steward",
          "deleted": false
        }
      ],
      "domains": []
    }
  ],
  "paging": {
    "after": "...",
    "total": 117
  }
}