Managing Repos

Once your Arraylake organization has been fully configured and you have installed the client library, you're ready to start managing data! 🎉

An ArrayLake Repo is a repository for your array data. All the data in a Repo are tracked as part of a shared single version history. Within a Repo, data can easily be moved, renamed, deleted, and updated in a non-destructive way. Moving data from one Repo to another, however, requires a copy to be made.

Create a Repo

If you're just getting started, you probably only need one Repo for your entire organization (see Organizations and Access for more detail). For the purposes of this example, our org name will be earthmover. If running these commands interactively, replace earthmover with your org name.

For this example, we are going to create a Repo called ocean to hold oceanography data 🌊.

CLI

arraylake repo create earthmover/ocean

Python

from arraylake import Client
client = Client()
client.create_repo("earthmover/ocean")

Python (asyncio)

from arraylake import AsyncClient
aclient = AsyncClient()
await aclient.create_repo("earthmover/ocean")

Open a Repo

If you're working in Python, you can open a Repo and start interacting with your data.

Python

repo = client.get_repo("earthmover/ocean")

Python (asyncio)

arepo = await aclient.get_repo("earthmover/ocean")  # returns an AsyncRepo object

List Repos

You can list repos associated with an organization.

CLI

arraylake repo list earthmover

Python

client.list_repos("earthmover")

Python (asyncio)

await aclient.list_repos("earthmover")

Delete a Repo

Finally, we can delete a repo.

warning

Deleting a repo cannot be undone! Use this operation carefully.

CLI

arraylake repo delete earthmover/ocean

Python

client.delete_repo("earthmover/ocean", imsure=True, imreallysure=True)

Python (asyncio)

await aclient.delete_repo("earthmover/ocean", imsure=True, imreallysure=True)