Skip to main content
A Project object describes a Registry Project, and can be created either from an Account via Account.list_projects() or directly using its ID. 
from latch.account import Account, Project

# Get the current account and list all projects
account = Account.current()
projects = account.list_registry_projects()

print(projects)

# Outputs
# [Project(id=123, display_name="Project A"), Project(id=456, display_name="Project B")]
Projects are lazy, in that they don’t perform any network requests without an explicit call to Project.load() or to a property getter.

​
Instance Methods

The only non-getter method on a Project is Project.load(). This method, if called, will perform a network request and cache values for each of the Project’s properties.

​
Property Getters

All property getters have an optional load_if_missing boolean argument which, if True, will call Project.load() if the requested property has not been loaded already. This defaults to True.
  • Project.get_display_name() will return the display_name of the calling Project as a string.
  • Project.list_tables() will return a list of Table objects, each corresponding to a table within the calling Project.

​
Updater

A Project can be modified by using the Project.update() function. Project.update() returns a context manager (and hence must be called using with syntax) with the following methods:
  • upsert_table(name: str) will create a table with name name.
with project.update() as updater:
    updater.upsert_table("New Table")
  • delete_table(id: str) will delete the table with id id. If no such table exists, the method call will be a noop.
with project.update() as updater:
    updater.delete_table("<id>")