envd 0.4.3__tar.gz → 1.0.0a3__tar.gz

envd-1.0.0a3/.GIT_TAG_INFO

@@ -0,0 +1 @@
+v1.0.0-alpha.3

{envd-0.4.3 → envd-1.0.0a3}/.goreleaser.yaml

@@ -1,5 +1,6 @@
 # This is an example .goreleaser.yml file with some sensible defaults.
 # Make sure to check the documentation at https://goreleaser.com
+version: 2
 before:
   hooks:
     - go mod tidy
@@ -60,7 +61,7 @@ archives:
 checksum:
   name_template: 'checksums.txt'
 snapshot:
-  name_template: "{{ incpatch .Version }}-next"
+  version_template: "{{ incpatch .Version }}-next"
 changelog:
   use: github
   sort: asc

{envd-0.4.3 → envd-1.0.0a3}/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## v0.4.3 (2025-01-20)
+
+ * [72e3b49](https://github.com/tensorchord/envd/commit/72e3b495ab776b5ba524217099ed7a2c88cbd909) fix(ci): release on ubuntu with wheels from previous steps (#1960)
+
+### Contributors
+
+ * Keming
+
+## v0.4.2 (2025-01-20)
+
+ * [7f31185](https://github.com/tensorchord/envd/commit/7f311854f1103c9bf104bdcc3d2a7fa2a2168b25) feat: update pypi meta, fix macos upload (#1958)
+
+### Contributors
+
+ * Keming
+
+## v0.4.1 (2025-01-20)
+
+ * [f6d9fd2](https://github.com/tensorchord/envd/commit/f6d9fd280221de5ad4d0045e7e50755568ed3ff0) feat: use PyPI OIDC for release (#1957)
+
+### Contributors
+
+ * Keming
+
+## v0.4.0 (2025-01-20)
+
+ * [600e0df](https://github.com/tensorchord/envd/commit/600e0df522b773076fcc2f89600362e23ad4d223) fix: use ubuntu 22.04 for all the dind related tests (#1955)
+ * [e737022](https://github.com/tensorchord/envd/commit/e737022c3fe3af01f8bf391feca6e48b08e71753) feat: support fish shell (#1952)
+ * [1a54052](https://github.com/tensorchord/envd/commit/1a54052e339cb60e2f4efe04ffddd0ffc798af0f) feat: upgrade to ubuntu 22.04 (#1939)
+ * [5ad6168](https://github.com/tensorchord/envd/commit/5ad61681f6d7e699de69020d498f01e6d818eabe) feat: upgrade to python 3.11 (#1940)
+ * [1155c9a](https://github.com/tensorchord/envd/commit/1155c9ae53aca62e61584b49cef45b027b4b9557) docs(readme): fix github markdown callout (#1945)
+
+### Contributors
+
+ * Keming
+
 ## v0.3.47 (2025-01-09)
 
  * [95bb1c3](https://github.com/tensorchord/envd/commit/95bb1c37f177c6e6e4ba49d4429e6e8a1ebc6ea5) feat(cache): update cuda & cudnn version (#1943)

{envd-0.4.3 → envd-1.0.0a3}/Makefile

@@ -188,7 +188,6 @@ e2e-test:
 		-X $(ROOT)/pkg/version.developmentFlag=true" \
 		-race -v -timeout 20m -coverpkg=./pkg/... -coverprofile=e2e-coverage.out ./e2e
 
-
 e2e-cli-test:
 	@go test -ldflags "-s -w -X $(ROOT)/pkg/version.version=$(VERSION) \
 		-X $(ROOT)/pkg/version.buildDate=$(BUILD_DATE) \
@@ -196,7 +195,7 @@ e2e-cli-test:
 		-X $(ROOT)/pkg/version.gitTreeState=$(GIT_TREE_STATE)                     \
 		-X $(ROOT)/pkg/version.gitTag="$(shell git describe --tags --abbrev=0)" \
 		-X $(ROOT)/pkg/version.developmentFlag=true" \
-		-race -v -timeout 20m -coverpkg=./pkg/... -coverprofile=e2e-cli-coverage.out ./e2e/v0/cli
+		-race -v -timeout 20m -coverpkg=./pkg/... -coverprofile=e2e-cli-coverage.out ./e2e/cli
 
 e2e-lang-test:
 	@go test -ldflags "-s -w -X $(ROOT)/pkg/version.version=$(VERSION) \
@@ -205,7 +204,7 @@ e2e-lang-test:
 		-X $(ROOT)/pkg/version.gitTreeState=$(GIT_TREE_STATE)                     \
 		-X $(ROOT)/pkg/version.gitTag="$(shell git describe --tags --abbrev=0)" \
 		-X $(ROOT)/pkg/version.developmentFlag=true" \
-		-race -v -timeout 20m -coverpkg=./pkg/... -coverprofile=e2e-lang-coverage.out ./e2e/v0/language
+		-race -v -timeout 20m -coverpkg=./pkg/... -coverprofile=e2e-lang-coverage.out ./e2e/language
 
 e2e-doc-test:
 	@go test -ldflags "-s -w -X $(ROOT)/pkg/version.version=$(VERSION) \
@@ -214,34 +213,7 @@ e2e-doc-test:
 		-X $(ROOT)/pkg/version.gitTreeState=$(GIT_TREE_STATE)                     \
 		-X $(ROOT)/pkg/version.gitTag="$(shell git describe --tags --abbrev=0)" \
 		-X $(ROOT)/pkg/version.developmentFlag=true" \
-		-race -v -timeout 60m -coverpkg=./pkg/... -coverprofile=e2e-doc-coverage.out ./e2e/v0/docs
-
-e2e-cli-test-v1:
-	@go test -ldflags "-s -w -X $(ROOT)/pkg/version.version=$(VERSION) \
-		-X $(ROOT)/pkg/version.buildDate=$(BUILD_DATE) \
-		-X $(ROOT)/pkg/version.gitCommit=$(GIT_COMMIT) \
-		-X $(ROOT)/pkg/version.gitTreeState=$(GIT_TREE_STATE)                     \
-		-X $(ROOT)/pkg/version.gitTag="$(shell git describe --tags --abbrev=0)" \
-		-X $(ROOT)/pkg/version.developmentFlag=true" \
-		-race -v -timeout 20m -coverpkg=./pkg/... -coverprofile=e2e-cli-v1-coverage.out ./e2e/v1/cli
-
-e2e-lang-test-v1:
-	@go test -ldflags "-s -w -X $(ROOT)/pkg/version.version=$(VERSION) \
-		-X $(ROOT)/pkg/version.buildDate=$(BUILD_DATE) \
-		-X $(ROOT)/pkg/version.gitCommit=$(GIT_COMMIT) \
-		-X $(ROOT)/pkg/version.gitTreeState=$(GIT_TREE_STATE)                     \
-		-X $(ROOT)/pkg/version.gitTag="$(shell git describe --tags --abbrev=0)" \
-		-X $(ROOT)/pkg/version.developmentFlag=true" \
-		-race -v -timeout 20m -coverpkg=./pkg/... -coverprofile=e2e-lang-v1-coverage.out ./e2e/v1/language
-
-e2e-doc-test-v1:
-	@go test -ldflags "-s -w -X $(ROOT)/pkg/version.version=$(VERSION) \
-		-X $(ROOT)/pkg/version.buildDate=$(BUILD_DATE) \
-		-X $(ROOT)/pkg/version.gitCommit=$(GIT_COMMIT) \
-		-X $(ROOT)/pkg/version.gitTreeState=$(GIT_TREE_STATE)                     \
-		-X $(ROOT)/pkg/version.gitTag="$(shell git describe --tags --abbrev=0)" \
-		-X $(ROOT)/pkg/version.developmentFlag=true" \
-		-race -v -timeout 60m -coverpkg=./pkg/... -coverprofile=e2e-doc-v1-coverage.out ./e2e/v1/docs
+		-race -v -timeout 60m -coverpkg=./pkg/... -coverprofile=e2e-doc-coverage.out ./e2e/docs
 
 clean:  ## Clean the outputs and artifacts
 	@-rm -vrf ${OUTPUT_DIR}

{envd-0.4.3 → envd-1.0.0a3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: envd
-Version: 0.4.3
+Version: 1.0.0a3
 Summary: A development environment management tool for data scientists.
 Home-page: https://github.com/tensorchord/envd
 Author: TensorChord
@@ -56,10 +56,13 @@ Environments built with `envd` provide the following features out-of-the-box:
 
 ```python
 def build():
+    base(dev=True)
+    install.conda()
+    install.python()
     install.python_packages(name = [
         "numpy",
     ])
-    shell("zsh")
+    shell("fish")
     config.jupyter()
 ```
 
@@ -111,7 +114,9 @@ Forget copy-pasting Dockerfile instructions - use envd to easily build functions
 envdlib = include("https://github.com/tensorchord/envdlib")
 
 def build():
-    base(os="ubuntu22.04", language="python")
+    base(dev=True)
+    install.conda()
+    install.python()
     envdlib.tensorboard(host_port=8888)
 ```
 
@@ -195,13 +200,15 @@ The build manifest `build.envd` looks like:
 
 ```python title=build.envd
 def build():
-    base(os="ubuntu22.04", language="python3")
+    base(dev=True)
+    install.conda()
+    install.python()
     # Configure the pip index if needed.
     # config.pip_index(url = "https://pypi.tuna.tsinghua.edu.cn/simple")
     install.python_packages(name = [
         "numpy",
     ])
-    shell("zsh")
+    shell("fish")
 ```
 
 *Note that we use Python here as an example but please check out examples for other languages such as R and Julia [here](https://github.com/tensorchord/envd/tree/main/examples).*
@@ -214,29 +221,34 @@ cd envd-quick-start && envd up
 
 ```bash
 $ cd envd-quick-start && envd up
-[+] ⌚ parse build.envd and download/cache dependencies 2.8s ✅ (finished)
- => download oh-my-zsh                                                    2.8s
-[+] 🐋 build envd environment 18.3s (25/25) ✅ (finished)
- => create apt source dir                                                 0.0s
- => local://cache-dir                                                     0.1s
- => => transferring cache-dir: 5.12MB                                     0.1s
-...
- => pip install numpy                                                    13.0s
- => copy /oh-my-zsh /home/envd/.oh-my-zsh                                 0.1s
- => mkfile /home/envd/install.sh                                          0.0s
- => install oh-my-zsh                                                     0.1s
- => mkfile /home/envd/.zshrc                                              0.0s
- => install shell                                                         0.0s
- => install PyPI packages                                                 0.0s
- => merging all components into one                                       0.3s
- => => merging                                                            0.3s
- => mkfile /home/envd/.gitconfig                                          0.0s
- => exporting to oci image format                                         2.4s
- => => exporting layers                                                   2.0s
- => => exporting manifest sha256:7dbe9494d2a7a39af16d514b997a5a8f08b637f  0.0s
- => => exporting config sha256:1da06b907d53cf8a7312c138c3221e590dedc2717  0.0s
- => => sending tarball                                                    0.4s
-envd-quick-start via Py v3.9.13 via 🅒 envd
+[+] ⌚ parse build.envd and download/cache dependencies 6.2s ✅ (finished) 
+[+] build envd environment 19.0s (47/47) FINISHED                                                 
+ => CACHED [internal] setting pip cache mount permissions                                     0.0s
+ => docker-image://docker.io/tensorchord/envd-sshd-from-scratch:v0.4.3                        2.3s
+ => => resolve docker.io/tensorchord/envd-sshd-from-scratch:v0.4.3                            2.3s
+ => docker-image://docker.io/library/ubuntu:22.04                                             0.0s
+......
+ => [internal] pip install numpy                                                              2.5s
+ => CACHED [internal] download fish shell                                                     0.0s
+ => [internal] configure user permissions for /opt/conda                                      1.0s
+ => [internal] create dir for ssh key                                                         0.5s
+ => [internal] install ssh keys                                                               0.2s
+ => [internal] copy fish shell from the builder image                                         0.2s
+ => [internal] install fish shell                                                             0.5s
+......
+ => [internal] create work dir: /home/envd/envd-quick-start                                   0.2s
+ => exporting to image                                                                        7.7s
+ => => exporting layers                                                                       7.7s
+ => => writing image sha256:464a0c12759d3d1732404f217d5c6e06d0ee4890cccd66391a608daf2bd314e4  0.0s
+ => => naming to docker.io/library/envd-quick-start:dev                                       0.0s
+------
+ > importing cache manifest from docker.io/tensorchord/python-cache:envd-v0.4.3:
+------
+⣽ [5/5] attach the environment  [2s]            
+Welcome to fish, the friendly interactive shell
+Type help for instructions on how to use fish
+
+envd-quick-start on git master [!] via Py v3.11.11 via 🅒 envd as sudo 
 ⬢ [envd]❯ # You are in the container-based environment!
 ```
 
@@ -246,13 +258,15 @@ Please edit the `build.envd` to enable jupyter notebook:
 
 ```python title=build.envd
 def build():
-    base(os="ubuntu22.04", language="python3")
+    base(dev=True)
+    install.conda()
+    install.python()
     # Configure the pip index if needed.
     # config.pip_index(url = "https://pypi.tuna.tsinghua.edu.cn/simple")
     install.python_packages(name = [
         "numpy",
     ])
-    shell("zsh")
+    shell("fish")
     config.jupyter()
 ```
 
@@ -265,10 +279,10 @@ NAME                    JUPYTER                 SSH TARGET              CONTEXT
 envd-quick-start        http://localhost:42779   envd-quick-start.envd   /home/gaocegege/code/envd-quick-start   envd-quick-start:dev    false   <none>  <none>  Up 54 seconds   bd3f6a729e94
 ```
 
-## Difference between v0 and v1
+## Difference between v0 and v1 syntax
 
 > [!NOTE]
-> To use the `v1` config file, add `# syntax=v1` to the first line of your `build.envd` file.
+> Start from `envd v1.0`, `v1` syntax is the default syntax for `build.envd` file, and `moby-worker` is the default builder.
 
 | Features | v0 | v1 |
 | --- | --- | --- |
@@ -278,11 +292,7 @@ envd-quick-start        http://localhost:42779   envd-quick-start.envd   /home/g
 | support serving | ⚠️ | ✅ |
 | support custom base image | ⚠️ | ✅ |
 | support installing multiple languages | ⚠️ | ✅ |
-| support `moby` builder | ❌ | ✅ <sup>[(a)](#v1-moby)</sup> |
-
-> [!NOTE]
-> <a name="v1-moby">(a)</a> To use the `moby` builder, you will need to create a new context with `envd context create --name moby-test --builder moby-worker --use`.
-> For more information about the `moby` builder, check the [issue-1693](https://github.com/tensorchord/envd/issues/1693).
+| support `moby` builder | ❌ | ✅ |
 
 > [!IMPORTANT]
 > For more details, check the [upgrade to v1](https://envd.tensorchord.ai/guide/v1.html) doc.

{envd-0.4.3 → envd-1.0.0a3}/README.md

@@ -37,10 +37,13 @@ Environments built with `envd` provide the following features out-of-the-box:
 
 ```python
 def build():
+    base(dev=True)
+    install.conda()
+    install.python()
     install.python_packages(name = [
         "numpy",
     ])
-    shell("zsh")
+    shell("fish")
     config.jupyter()
 ```
 
@@ -92,7 +95,9 @@ Forget copy-pasting Dockerfile instructions - use envd to easily build functions
 envdlib = include("https://github.com/tensorchord/envdlib")
 
 def build():
-    base(os="ubuntu22.04", language="python")
+    base(dev=True)
+    install.conda()
+    install.python()
     envdlib.tensorboard(host_port=8888)
 ```
 
@@ -176,13 +181,15 @@ The build manifest `build.envd` looks like:
 
 ```python title=build.envd
 def build():
-    base(os="ubuntu22.04", language="python3")
+    base(dev=True)
+    install.conda()
+    install.python()
     # Configure the pip index if needed.
     # config.pip_index(url = "https://pypi.tuna.tsinghua.edu.cn/simple")
     install.python_packages(name = [
         "numpy",
     ])
-    shell("zsh")
+    shell("fish")
 ```
 
 *Note that we use Python here as an example but please check out examples for other languages such as R and Julia [here](https://github.com/tensorchord/envd/tree/main/examples).*
@@ -195,29 +202,34 @@ cd envd-quick-start && envd up
 
 ```bash
 $ cd envd-quick-start && envd up
-[+] ⌚ parse build.envd and download/cache dependencies 2.8s ✅ (finished)
- => download oh-my-zsh                                                    2.8s
-[+] 🐋 build envd environment 18.3s (25/25) ✅ (finished)
- => create apt source dir                                                 0.0s
- => local://cache-dir                                                     0.1s
- => => transferring cache-dir: 5.12MB                                     0.1s
-...
- => pip install numpy                                                    13.0s
- => copy /oh-my-zsh /home/envd/.oh-my-zsh                                 0.1s
- => mkfile /home/envd/install.sh                                          0.0s
- => install oh-my-zsh                                                     0.1s
- => mkfile /home/envd/.zshrc                                              0.0s
- => install shell                                                         0.0s
- => install PyPI packages                                                 0.0s
- => merging all components into one                                       0.3s
- => => merging                                                            0.3s
- => mkfile /home/envd/.gitconfig                                          0.0s
- => exporting to oci image format                                         2.4s
- => => exporting layers                                                   2.0s
- => => exporting manifest sha256:7dbe9494d2a7a39af16d514b997a5a8f08b637f  0.0s
- => => exporting config sha256:1da06b907d53cf8a7312c138c3221e590dedc2717  0.0s
- => => sending tarball                                                    0.4s
-envd-quick-start via Py v3.9.13 via 🅒 envd
+[+] ⌚ parse build.envd and download/cache dependencies 6.2s ✅ (finished) 
+[+] build envd environment 19.0s (47/47) FINISHED                                                 
+ => CACHED [internal] setting pip cache mount permissions                                     0.0s
+ => docker-image://docker.io/tensorchord/envd-sshd-from-scratch:v0.4.3                        2.3s
+ => => resolve docker.io/tensorchord/envd-sshd-from-scratch:v0.4.3                            2.3s
+ => docker-image://docker.io/library/ubuntu:22.04                                             0.0s
+......
+ => [internal] pip install numpy                                                              2.5s
+ => CACHED [internal] download fish shell                                                     0.0s
+ => [internal] configure user permissions for /opt/conda                                      1.0s
+ => [internal] create dir for ssh key                                                         0.5s
+ => [internal] install ssh keys                                                               0.2s
+ => [internal] copy fish shell from the builder image                                         0.2s
+ => [internal] install fish shell                                                             0.5s
+......
+ => [internal] create work dir: /home/envd/envd-quick-start                                   0.2s
+ => exporting to image                                                                        7.7s
+ => => exporting layers                                                                       7.7s
+ => => writing image sha256:464a0c12759d3d1732404f217d5c6e06d0ee4890cccd66391a608daf2bd314e4  0.0s
+ => => naming to docker.io/library/envd-quick-start:dev                                       0.0s
+------
+ > importing cache manifest from docker.io/tensorchord/python-cache:envd-v0.4.3:
+------
+⣽ [5/5] attach the environment  [2s]            
+Welcome to fish, the friendly interactive shell
+Type help for instructions on how to use fish
+
+envd-quick-start on git master [!] via Py v3.11.11 via 🅒 envd as sudo 
 ⬢ [envd]❯ # You are in the container-based environment!
 ```
 
@@ -227,13 +239,15 @@ Please edit the `build.envd` to enable jupyter notebook:
 
 ```python title=build.envd
 def build():
-    base(os="ubuntu22.04", language="python3")
+    base(dev=True)
+    install.conda()
+    install.python()
     # Configure the pip index if needed.
     # config.pip_index(url = "https://pypi.tuna.tsinghua.edu.cn/simple")
     install.python_packages(name = [
         "numpy",
     ])
-    shell("zsh")
+    shell("fish")
     config.jupyter()
 ```
 
@@ -246,10 +260,10 @@ NAME                    JUPYTER                 SSH TARGET              CONTEXT
 envd-quick-start        http://localhost:42779   envd-quick-start.envd   /home/gaocegege/code/envd-quick-start   envd-quick-start:dev    false   <none>  <none>  Up 54 seconds   bd3f6a729e94
 ```
 
-## Difference between v0 and v1
+## Difference between v0 and v1 syntax
 
 > [!NOTE]
-> To use the `v1` config file, add `# syntax=v1` to the first line of your `build.envd` file.
+> Start from `envd v1.0`, `v1` syntax is the default syntax for `build.envd` file, and `moby-worker` is the default builder.
 
 | Features | v0 | v1 |
 | --- | --- | --- |
@@ -259,11 +273,7 @@ envd-quick-start        http://localhost:42779   envd-quick-start.envd   /home/g
 | support serving | ⚠️ | ✅ |
 | support custom base image | ⚠️ | ✅ |
 | support installing multiple languages | ⚠️ | ✅ |
-| support `moby` builder | ❌ | ✅ <sup>[(a)](#v1-moby)</sup> |
-
-> [!NOTE]
-> <a name="v1-moby">(a)</a> To use the `moby` builder, you will need to create a new context with `envd context create --name moby-test --builder moby-worker --use`.
-> For more information about the `moby` builder, check the [issue-1693](https://github.com/tensorchord/envd/issues/1693).
+| support `moby` builder | ❌ | ✅ |
 
 > [!IMPORTANT]
 > For more details, check the [upgrade to v1](https://envd.tensorchord.ai/guide/v1.html) doc.

{envd-0.4.3 → envd-1.0.0a3}/base-images/remote-cache/build-and-push-remote-cache.sh

@@ -26,6 +26,7 @@ TAG_SUFFIX="${TAG_SUFFIX:-}"
 
 cd ${ROOT_DIR}
 
+envd context create --name docker --builder docker-container --use
 envd --debug build -f build.envd:${BUILD_FUNC} --export-cache type=registry,ref=docker.io/${DOCKER_HUB_ORG}/python-cache:envd-v${ENVD_VERSION}${TAG_SUFFIX} --force
 
 cd - > /dev/null

envd-1.0.0a3/base-images/remote-cache/build.envd

@@ -0,0 +1,29 @@
+def build():
+    """default"""
+    base(dev=True)
+    install.conda()
+    install.python()
+
+
+def build_gpu_11_8():
+    """cuda 11"""
+    base(dev=True)
+    install.conda()
+    install.python()
+    install.cuda(version="11.8.0", cudnn="8")
+
+
+def build_gpu_12_2():
+    """cuda 12"""
+    base(dev=True)
+    install.conda()
+    install.python()
+    install.cuda(version="12.2.2", cudnn="8")
+
+
+def build_gpu_12_3():
+    """cudnn 9"""
+    base(dev=True)
+    install.conda()
+    install.python()
+    install.cuda(version="12.3.2", cudnn="9")

{envd-0.4.3 → envd-1.0.0a3}/envd/api/v0/__init__.py

@@ -19,6 +19,12 @@ Note that the documentation is automatically generated from [envd/api](https://g
 in [tensorchord/envd](https://github.com/tensorchord/envd/tree/main/envd/api) repo.
 Please update the python file there instead of directly editing file inside envd-docs repo.
 :::
+
+::: warning
+v0 syntax is no longer supported from `envd>=v1.0`. Check the [upgrade guide](https://envd.tensorchord.ai/guide/v1.html).
+
+If you want to use v0 syntax, try `pip install 'envd<1'`.
+:::
 """
 
 from typing import List, Optional

{envd-0.4.3 → envd-1.0.0a3}/envd/api/v0/config.py

@@ -19,6 +19,12 @@ Note that the documentation is automatically generated from [envd/api](https://g
 in [tensorchord/envd](https://github.com/tensorchord/envd/tree/main/envd/api) repo.
 Please update the python file there instead of directly editing file inside envd-docs repo.
 :::
+
+::: warning
+v0 syntax is no longer supported from `envd>=v1.0`. Check the [upgrade guide](https://envd.tensorchord.ai/guide/v1.html).
+
+If you want to use v0 syntax, try `pip install 'envd<1'`.
+:::
 """
 
 from typing import List, Optional
@@ -30,15 +36,15 @@ def apt_source(source: Optional[str]):
     Example usage:
     ```python
     apt_source(source='''
-        deb https://mirror.sjtu.edu.cn/ubuntu focal main restricted
-        deb https://mirror.sjtu.edu.cn/ubuntu focal-updates main restricted
-        deb https://mirror.sjtu.edu.cn/ubuntu focal universe
-        deb https://mirror.sjtu.edu.cn/ubuntu focal-updates universe
-        deb https://mirror.sjtu.edu.cn/ubuntu focal multiverse
-        deb https://mirror.sjtu.edu.cn/ubuntu focal-updates multiverse
-        deb https://mirror.sjtu.edu.cn/ubuntu focal-backports main restricted universe multiverse
-        deb http://archive.canonical.com/ubuntu focal partner
-        deb https://mirror.sjtu.edu.cn/ubuntu focal-security main restricted universe multiverse
+        deb https://mirror.sjtu.edu.cn/ubuntu jammy main restricted
+        deb https://mirror.sjtu.edu.cn/ubuntu jammy-updates main restricted
+        deb https://mirror.sjtu.edu.cn/ubuntu jammy universe
+        deb https://mirror.sjtu.edu.cn/ubuntu jammy-updates universe
+        deb https://mirror.sjtu.edu.cn/ubuntu jammy multiverse
+        deb https://mirror.sjtu.edu.cn/ubuntu jammy-updates multiverse
+        deb https://mirror.sjtu.edu.cn/ubuntu jammy-backports main restricted universe multiverse
+        deb http://archive.canonical.com/ubuntu jammy partner
+        deb https://mirror.sjtu.edu.cn/ubuntu jammy-security main restricted universe multiverse
     ''')
     ```
 

{envd-0.4.3 → envd-1.0.0a3}/envd/api/v0/install.py

@@ -19,6 +19,12 @@ Note that the documentation is automatically generated from [envd/api](https://g
 in [tensorchord/envd](https://github.com/tensorchord/envd/tree/main/envd/api) repo.
 Please update the python file there instead of directly editing file inside envd-docs repo.
 :::
+
+::: warning
+v0 syntax is no longer supported from `envd>=v1.0`. Check the [upgrade guide](https://envd.tensorchord.ai/guide/v1.html).
+
+If you want to use v0 syntax, try `pip install 'envd<1'`.
+:::
 """
 
 from typing import List, Optional

{envd-0.4.3 → envd-1.0.0a3}/envd/api/v0/io.py

@@ -19,6 +19,12 @@ Note that the documentation is automatically generated from [envd/api](https://g
 in [tensorchord/envd](https://github.com/tensorchord/envd/tree/main/envd/api) repo.
 Please update the python file there instead of directly editing file inside envd-docs repo.
 :::
+
+::: warning
+v0 syntax is no longer supported from `envd>=v1.0`. Check the [upgrade guide](https://envd.tensorchord.ai/guide/v1.html).
+
+If you want to use v0 syntax, try `pip install 'envd<1'`.
+:::
 """
 
 from typing import Optional

{envd-0.4.3/envd/api/v1 → envd-1.0.0a3/envd/api/v0}/runtime.py

@@ -21,9 +21,9 @@ Please update the python file there instead of directly editing file inside envd
 :::
 
 ::: warning
-Enable v1 by adding `# syntax=v1` to the 1st line of your envd file.
+v0 syntax is no longer supported from `envd>=v1.0`. Check the [upgrade guide](https://envd.tensorchord.ai/guide/v1.html).
 
-v1 is experimental and may change in the future. Make sure to freeze the envd version for online CI/CD.
+If you want to use v0 syntax, try `pip install 'envd<1'`.
 :::
 """
 

{envd-0.4.3 → envd-1.0.0a3}/envd/api/v1/__init__.py

@@ -19,12 +19,6 @@ Note that the documentation is automatically generated from [envd/api](https://g
 in [tensorchord/envd](https://github.com/tensorchord/envd/tree/main/envd/api) repo.
 Please update the python file there instead of directly editing file inside envd-docs repo.
 :::
-
-::: warning
-Enable v1 by adding `# syntax=v1` to the 1st line of your envd file.
-
-v1 is experimental and may change in the future. Make sure to freeze the envd version for online CI/CD.
-:::
 """
 
 from typing import List, Optional
@@ -47,7 +41,7 @@ def shell(name: str = "bash"):
     """Interactive shell
 
     Args:
-        name (str): shell name (i.e. `zsh`, `bash`)
+        name (str): shell name (i.e. `zsh`, `bash`, `fish`)
     """
 
 

{envd-0.4.3 → envd-1.0.0a3}/envd/api/v1/config.py

@@ -19,12 +19,6 @@ Note that the documentation is automatically generated from [envd/api](https://g
 in [tensorchord/envd](https://github.com/tensorchord/envd/tree/main/envd/api) repo.
 Please update the python file there instead of directly editing file inside envd-docs repo.
 :::
-
-::: warning
-Enable v1 by adding `# syntax=v1` to the 1st line of your envd file.
-
-v1 is experimental and may change in the future. Make sure to freeze the envd version for online CI/CD.
-:::
 """
 
 from typing import List, Optional
@@ -36,15 +30,15 @@ def apt_source(source: Optional[str]):
     Example usage:
     ```python
     apt_source(source='''
-        deb https://mirror.sjtu.edu.cn/ubuntu focal main restricted
-        deb https://mirror.sjtu.edu.cn/ubuntu focal-updates main restricted
-        deb https://mirror.sjtu.edu.cn/ubuntu focal universe
-        deb https://mirror.sjtu.edu.cn/ubuntu focal-updates universe
-        deb https://mirror.sjtu.edu.cn/ubuntu focal multiverse
-        deb https://mirror.sjtu.edu.cn/ubuntu focal-updates multiverse
-        deb https://mirror.sjtu.edu.cn/ubuntu focal-backports main restricted universe multiverse
-        deb http://archive.canonical.com/ubuntu focal partner
-        deb https://mirror.sjtu.edu.cn/ubuntu focal-security main restricted universe multiverse
+        deb https://mirror.sjtu.edu.cn/ubuntu jammy main restricted
+        deb https://mirror.sjtu.edu.cn/ubuntu jammy-updates main restricted
+        deb https://mirror.sjtu.edu.cn/ubuntu jammy universe
+        deb https://mirror.sjtu.edu.cn/ubuntu jammy-updates universe
+        deb https://mirror.sjtu.edu.cn/ubuntu jammy multiverse
+        deb https://mirror.sjtu.edu.cn/ubuntu jammy-updates multiverse
+        deb https://mirror.sjtu.edu.cn/ubuntu jammy-backports main restricted universe multiverse
+        deb http://archive.canonical.com/ubuntu jammy partner
+        deb https://mirror.sjtu.edu.cn/ubuntu jammy-security main restricted universe multiverse
     ''')
     ```
 

{envd-0.4.3 → envd-1.0.0a3}/envd/api/v1/install.py

@@ -19,12 +19,6 @@ Note that the documentation is automatically generated from [envd/api](https://g
 in [tensorchord/envd](https://github.com/tensorchord/envd/tree/main/envd/api) repo.
 Please update the python file there instead of directly editing file inside envd-docs repo.
 :::
-
-::: warning
-Enable v1 by adding `# syntax=v1` to the 1st line of your envd file.
-
-v1 is experimental and may change in the future. Make sure to freeze the envd version for online CI/CD.
-:::
 """
 
 from typing import Optional, Sequence

{envd-0.4.3 → envd-1.0.0a3}/envd/api/v1/io.py

@@ -19,12 +19,6 @@ Note that the documentation is automatically generated from [envd/api](https://g
 in [tensorchord/envd](https://github.com/tensorchord/envd/tree/main/envd/api) repo.
 Please update the python file there instead of directly editing file inside envd-docs repo.
 :::
-
-::: warning
-Enable v1 by adding `# syntax=v1` to the 1st line of your envd file.
-
-v1 is experimental and may change in the future. Make sure to freeze the envd version for online CI/CD.
-:::
 """
 
 from typing import Optional