from metadata.sdk import configure, Users
from metadata.generated.schema.api.teams.createUser import CreateUserRequest

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

user = Users.create(
    CreateUserRequest(
        name="alice.smith",
        email="alice.smith@example.com",
        displayName="Alice Smith",
        description="Data Engineer",
    )
)
print(user.fullyQualifiedName)  # "alice.smith"

# By ID
user = Users.retrieve("user-uuid")

# By username
user = Users.retrieve_by_name("alice.smith")

# With fields
user = Users.retrieve_by_name("alice.smith", fields=["teams", "roles", "follows"])

# Single page
page = Users.list(limit=50)

# All users
all_users = Users.list_all()
print(f"Total users: {len(all_users)}")

user = Users.retrieve_by_name("alice.smith")
user.description = "Senior Data Engineer"
Users.update(user)

Users.delete("user-uuid")
Users.delete("user-uuid", hard_delete=True)

results = Users.search("alice", size=5)
for user in results:
    print(f"{user.name} <{user.email}>")

from metadata.sdk import configure, Users, Tables, to_entity_reference

configure(host="...", jwt_token="...")

user = Users.retrieve_by_name("alice.smith")
table = Tables.retrieve_by_name("my_service.my_db.public.orders")
table.owners = [to_entity_reference(user)]
Tables.update(table)

versions = Users.get_versions("user-uuid")
v = Users.get_specific_version("user-uuid", "0.2")