chore(main): release 0.80.13 (#938)

🤖 I have created a release *beep* *boop*
---


##
[0.80.13](0.80.12...0.80.13)
(2023-07-20)


### Features

* Add autocomplete for file path of artifact files inspect
([#947](#947))
([f72dfce](f72dfce))


### Bug Fixes

* broken symlinks on Kurtosis packages
([#944](#944))
([fbb0aee](fbb0aee)),
closes [#846](#846)
* improve frontend
([#940](#940))
([36153e2](36153e2))
* improved error msg
([#936](#936))
([4f72ae1](4f72ae1))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

---------

Co-authored-by: kurtosisbot <kurtosisbot@users.noreply.github.com>

CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.80.13](https://github.com/kurtosis-tech/kurtosis/compare/0.80.12...0.80.13) (2023-07-20)
+
+
+### Features
+
+* Add autocomplete for file path of artifact files inspect ([#947](https://github.com/kurtosis-tech/kurtosis/issues/947)) ([f72dfce](https://github.com/kurtosis-tech/kurtosis/commit/f72dfce9b755c37dde849f9047ef4a6ca7e59cb2))
+
+
+### Bug Fixes
+
+* broken symlinks on Kurtosis packages ([#944](https://github.com/kurtosis-tech/kurtosis/issues/944)) ([fbb0aee](https://github.com/kurtosis-tech/kurtosis/commit/fbb0aee6edfce4598b0384aebfe71b1e12b9730c)), closes [#846](https://github.com/kurtosis-tech/kurtosis/issues/846)
+* improve frontend ([#940](https://github.com/kurtosis-tech/kurtosis/issues/940)) ([36153e2](https://github.com/kurtosis-tech/kurtosis/commit/36153e2c6e3c332508d6071d2f9101f77cfb6295))
+* improved error msg ([#936](https://github.com/kurtosis-tech/kurtosis/issues/936)) ([4f72ae1](https://github.com/kurtosis-tech/kurtosis/commit/4f72ae12409d6ddd8c2e2c6b61770081d9200bde))
+
 ## [0.80.12](https://github.com/kurtosis-tech/kurtosis/compare/0.80.11...0.80.12) (2023-07-18)
 
 

LICENSE.md

@@ -3,7 +3,7 @@ Business Source License 1.1
 Parameters
 
 Licensor:             Kurtosis Technologies, Inc.
-Licensed Work:        Kurtosis 0.80.12
+Licensed Work:        Kurtosis 0.80.13
 The Licensed Work is (c) 2023 Kurtosis Technologies, Inc.
 Additional Use Grant: You may make use of the Licensed Work, provided that
 you may not use the Licensed Work for an Environment Orchestration Service.
@@ -12,7 +12,7 @@ you may not use the Licensed Work for an Environment Orchestration Service.
                       allows third parties (other than your employees and
                       contractors) to create distributed system environments.
 
-Change Date:          2027-07-18
+Change Date:          2027-07-20
 
 Change License:       AGPLv3 (GNU Affero General Public License Version 3)
 

api/golang/kurtosis_version/kurtosis_version.go

@@ -9,6 +9,6 @@ const (
 	// !!!!!!!!!!! DO NOT UPDATE! WILL BE MANUALLY UPDATED DURING THE RELEASE PROCESS !!!!!!!!!!!!!!!!!!!!!!
 	// This is necessary so that Kurt Core consumers will know if they're compatible with the currently-running
 	//  API container
-	KurtosisVersion = "0.80.12"
+	KurtosisVersion = "0.80.13"
 	// !!!!!!!!!!! DO NOT UPDATE! WILL BE MANUALLY UPDATED DURING THE RELEASE PROCESS !!!!!!!!!!!!!!!!!!!!!!
 )

api/rust/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "kurtosis-sdk"
-version = "0.80.12"
+version = "0.80.13"
 license = "BUSL-1.1"
 description = "Rust SDK for Kurtosis"
 edition = "2021"

api/typescript/package.json

@@ -1,7 +1,7 @@
 {
     "name": "kurtosis-sdk",
     "//": "NOTE: DO NOT UPDATE THIS VERSION MANUALLY - IT WILL BE UPDATED DURING THE RELEASE PROCESS!",
-    "version": "0.80.12",
+    "version": "0.80.13",
     "main": "./build/index",
     "description": "This repo contains a Typescript client for communicating with the Kurtosis Engine server, which is responsible for creating, managing and destroying Kurtosis Enclaves.",
     "types": "./build/index",

api/typescript/src/kurtosis_version/kurtosis_version.ts

@@ -1,5 +1,5 @@
 // !!!!!!!!!!! DO NOT UPDATE! WILL BE MANUALLY UPDATED DURING THE RELEASE PROCESS !!!!!!!!!!!!!!!!!!!!!!
 // This is necessary so that Kurt Core consumers (e.g. modules) will know if they're compatible with the currently-running
 //  API container
-export const KURTOSIS_VERSION: string = "0.80.12"
+export const KURTOSIS_VERSION: string = "0.80.13"
 // !!!!!!!!!!! DO NOT UPDATE! WILL BE MANUALLY UPDATED DURING THE RELEASE PROCESS !!!!!!!!!!!!!!!!!!!!!!

docs/versioned_docs/version-0.80.8/best-practices.md → docs/versioned_docs/version-0.80.13/best-practices.md

@@ -35,6 +35,19 @@ Kurtosis has three different types of waits. Described here are the three, with
     - More complex to configure
     - Cannot be used to short-circuit `Plan.add_services`
 
+Choosing service names in Kurtosis
+----------------------------------
+Kurtosis service names implements [RFC-1035](https://datatracker.ietf.org/doc/html/rfc1035), meaning the names of all services must be a valid [RFC-1035 Label Name](https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#rfc-1035-label-names). Tactically this means a service name must:
+
+* contain at most 63 characters
+* contain only lowercase alphanumeric characters or '-'
+* start with an alphabetic character
+* end with an alphanumeric character
+
+Failure to adhere to the above standards will result in errors when running Kurtosis.
+
+
+
 <!---------------------------------------- ONLY LINKS BELOW HERE!!! ----------------------------------->
 [args-concepts-reference]: ./concepts-reference/args.md
 

docs/versioned_docs/version-0.80.8/changelog.md → docs/versioned_docs/version-0.80.13/changelog.md

@@ -1,5 +1,66 @@
 # Changelog
 
+## [0.80.13](https://github.com/kurtosis-tech/kurtosis/compare/0.80.12...0.80.13) (2023-07-20)
+
+
+### Features
+
+* Add autocomplete for file path of artifact files inspect ([#947](https://github.com/kurtosis-tech/kurtosis/issues/947)) ([f72dfce](https://github.com/kurtosis-tech/kurtosis/commit/f72dfce9b755c37dde849f9047ef4a6ca7e59cb2))
+
+
+### Bug Fixes
+
+* broken symlinks on Kurtosis packages ([#944](https://github.com/kurtosis-tech/kurtosis/issues/944)) ([fbb0aee](https://github.com/kurtosis-tech/kurtosis/commit/fbb0aee6edfce4598b0384aebfe71b1e12b9730c)), closes [#846](https://github.com/kurtosis-tech/kurtosis/issues/846)
+* improve frontend ([#940](https://github.com/kurtosis-tech/kurtosis/issues/940)) ([36153e2](https://github.com/kurtosis-tech/kurtosis/commit/36153e2c6e3c332508d6071d2f9101f77cfb6295))
+* improved error msg ([#936](https://github.com/kurtosis-tech/kurtosis/issues/936)) ([4f72ae1](https://github.com/kurtosis-tech/kurtosis/commit/4f72ae12409d6ddd8c2e2c6b61770081d9200bde))
+
+## [0.80.12](https://github.com/kurtosis-tech/kurtosis/compare/0.80.11...0.80.12) (2023-07-18)
+
+
+### Features
+
+* Service count can go up to 1024 in Docker backend ([#919](https://github.com/kurtosis-tech/kurtosis/issues/919)) ([e1dfff1](https://github.com/kurtosis-tech/kurtosis/commit/e1dfff119a0b6635e732e0e09de68b56d6af7d63))
+
+## [0.80.11](https://github.com/kurtosis-tech/kurtosis/compare/0.80.10...0.80.11) (2023-07-18)
+
+
+### Features
+
+* Add file artifact inspect API do APIC ([#885](https://github.com/kurtosis-tech/kurtosis/issues/885)) ([7ad8155](https://github.com/kurtosis-tech/kurtosis/commit/7ad81553a8056887e1399649536319922a05bdc1))
+* Add file inspect command to the CLI ([#905](https://github.com/kurtosis-tech/kurtosis/issues/905)) ([bb36a46](https://github.com/kurtosis-tech/kurtosis/commit/bb36a469925c3a8c00a88c0f5a16995088d26548))
+* added run python ([#913](https://github.com/kurtosis-tech/kurtosis/issues/913)) ([365f5cf](https://github.com/kurtosis-tech/kurtosis/commit/365f5cf15399dd0e79f7b82d5ab4ad823def00b5))
+* upload files support relative locators ([#930](https://github.com/kurtosis-tech/kurtosis/issues/930)) ([8d60968](https://github.com/kurtosis-tech/kurtosis/commit/8d609686ce78a72f82455592b48eeab94b44c359))
+
+
+### Bug Fixes
+
+* make service labels more restrictive ([#929](https://github.com/kurtosis-tech/kurtosis/issues/929)) ([a8fb599](https://github.com/kurtosis-tech/kurtosis/commit/a8fb5992d0e60bc50efa8585393048c168e878f0)), closes [#928](https://github.com/kurtosis-tech/kurtosis/issues/928)
+
+## [0.80.10](https://github.com/kurtosis-tech/kurtosis/compare/0.80.9...0.80.10) (2023-07-17)
+
+
+### Features
+
+* Added enclave pool for improving performance on enclave creation  ([#787](https://github.com/kurtosis-tech/kurtosis/issues/787)) ([d6efa43](https://github.com/kurtosis-tech/kurtosis/commit/d6efa435efeb9989de8f20f1d2d80603b7ef6827))
+
+## [0.80.9](https://github.com/kurtosis-tech/kurtosis/compare/0.80.8...0.80.9) (2023-07-17)
+
+
+### Features
+
+* added a command that opens the Kurtosis Web UI ([#870](https://github.com/kurtosis-tech/kurtosis/issues/870)) ([5098969](https://github.com/kurtosis-tech/kurtosis/commit/509896934656161002d674fa7c61ccd32c6f899d))
+* allow for relative imports from packages ([#891](https://github.com/kurtosis-tech/kurtosis/issues/891)) ([42bedab](https://github.com/kurtosis-tech/kurtosis/commit/42bedab9d45e4988f019dea7ccb2985f058e8199))
+* Autocomplete file artifact name on download ([#910](https://github.com/kurtosis-tech/kurtosis/issues/910)) ([2cedd08](https://github.com/kurtosis-tech/kurtosis/commit/2cedd0802a8595c3b299cb844fb42e3495991114))
+* Make output directory optional for files download ([#909](https://github.com/kurtosis-tech/kurtosis/issues/909)) ([2543d9a](https://github.com/kurtosis-tech/kurtosis/commit/2543d9ad9c68b86c1c1f09137ca60ddfce785b22))
+* Starlark package arguments will be parsed as a deep Struct when `"_kurtosis_parser": "struct"` is passed in the arguments JSON ([#884](https://github.com/kurtosis-tech/kurtosis/issues/884)) ([39ec8c2](https://github.com/kurtosis-tech/kurtosis/commit/39ec8c2d4a867420a76119523eb302dc652adb9b))
+* updated golang api sdk to 1.19 ([#908](https://github.com/kurtosis-tech/kurtosis/issues/908)) ([fabbb1c](https://github.com/kurtosis-tech/kurtosis/commit/fabbb1cde6b827ef2255bf184356b2f8a3ba9fbf))
+
+
+### Bug Fixes
+
+* fixed the log and file artifact issue ([#890](https://github.com/kurtosis-tech/kurtosis/issues/890)) ([7f7fe7b](https://github.com/kurtosis-tech/kurtosis/commit/7f7fe7b2d5dc91ddaa8b088129c5be8de0d9f396))
+* pinned go version to 1.19.10 for now ([#907](https://github.com/kurtosis-tech/kurtosis/issues/907)) ([847a37c](https://github.com/kurtosis-tech/kurtosis/commit/847a37c756b50588a567459956f49fcd26d99c28))
+
 ## [0.80.8](https://github.com/kurtosis-tech/kurtosis/compare/0.80.7...0.80.8) (2023-07-11)
 
 

docs/versioned_docs/version-0.80.13/cli-reference/engine-restart.md

@@ -0,0 +1,18 @@
+---
+title: engine restart
+sidebar_label: engine restart
+slug: /engine-restart
+---
+
+The CLI interacts with the Kurtosis engine, which is a very lightweight container. The CLI will start the engine container automatically for you and you should never need to start it manually, but you might need to restart the engine after a CLI upgrade. To do so, run:
+
+```bash
+kurtosis engine restart
+```
+
+You may optionally pass in the following flags with this command:
+* `--log-level`: The level that the started engine should log at. Options include: `panic`, `fatal`, `error`, `warning`, `info`, `debug`, or `trace`. The engine logs at the `info` level by default.
+* `--version`: The version (Docker tag) of the Kurtosis engine that should be started. If not set, the engine will start up with the default version.
+* `--enclave-pool-size`: The size of the Kurtosis engine enclave pool. The enclave pool is a component of the Kurtosis engine that allows us to create and maintain 'n' number of idle enclaves for future use. This functionality allows to improve the performance for each new creation enclave request.
+
+CAUTION: The `--enclave-pool-size` flag is only available for Kubernetes.

docs/versioned_docs/version-0.80.8/cli-reference/engine-start.md → docs/versioned_docs/version-0.80.13/cli-reference/engine-start.md

@@ -13,4 +13,7 @@ This command will do nothing if the Kurtosis engine is already running.
 
 You may optionally pass in the following flags with this command:
 * `--log-level`: The level that the started engine should log at. Options include: `panic`, `fatal`, `error`, `warning`, `info`, `debug`, or `trace`. The engine logs at the `info` level by default.
-* `--version`: The version (Docker tag) of the Kurtosis engine that should be started. If not set, the engine will start up with the default version.
+* `--version`: The version (Docker tag) of the Kurtosis engine that should be started. If not set, the engine will start up with the default version.
+* `--enclave-pool-size`: The size of the Kurtosis engine enclave pool. The enclave pool is a component of the Kurtosis engine that allows us to create and maintain 'n' number of idle enclaves for future use. This functionality allows to improve the performance for each new creation enclave request.
+
+CAUTION: The `--enclave-pool-size` flag is only available for Kubernetes.

docs/versioned_docs/version-0.80.8/cli-reference/service-add.md → docs/versioned_docs/version-0.80.13/cli-reference/service-add.md

@@ -11,7 +11,8 @@ kurtosis service add $THE_ENCLAVE_IDENTIFIER $THE_SERVICE_IDENTIFIER $CONTAINER_
 ```
 
 where `$THE_ENCLAVE_IDENTIFIER` and the `$THE_SERVICE_IDENTIFIER` are [resource identifiers](../concepts-reference/resource-identifier.md) for the enclave and service, respectively. 
-Note, the service identifier needs to be formatted according to RFC 1123. Specifically, 1-63 lowercase alphanumeric characters with dashes and cannot start or end with dashes.
+Note, the service identifier needs to be formatted according to RFC 1035. Specifically, 1-63 lowercase alphanumeric characters with dashes and cannot start or end with dashes. Also service names
+have to start with a lowercase alphabet. 
 
 Much like `docker run`, this command has multiple options available to customize the service that's started:
 

docs/versioned_docs/version-0.80.13/cli-reference/web.md

@@ -0,0 +1,11 @@
+---
+title: web(beta)
+sidebar_label: web(beta)
+slug: /web
+---
+
+The following command can be used to open the Kurtosis Web UI. This feature is currently in beta.
+
+```bash
+kurtosis web
+```

docs/versioned_docs/version-0.80.8/concepts-reference/locators.md → docs/versioned_docs/version-0.80.13/concepts-reference/locators.md

@@ -4,20 +4,20 @@ sidebar_label: Locators
 ---
 
 :::info
-Locators are a part of the Kurtosis package system. To read about the package system in detail, [see here][how-do-kurtosis-imports-work-explanation].
+Locators are a part of the [Kurtosis packaging system][packages]. To read about the package system in detail, [see here][how-do-kurtosis-imports-work-explanation].
 :::
 
-A locator is a URL-like string used to locate a resource inside [a Kurtosis package][packages]. For example, this locator:
+A locator is how resources are identified when being imported in a Starlark script - namely by [`import_module`](../starlark-reference/import-module.md) and [`read_file`](../starlark-reference/read-file.md). There are two types of locators: absolute and relative.
+
+### Absolute Locators
+Absolute locators unambiguously identify a resource using a URL-like syntax. For example, this locator:
 
 ```
 github.com/package-author/package-repo/path/to/directory-with-kurtosis.yml/some-file.star
 ```
 
 references a file inside a GitHub repo called `package-repo`, owned by `package-author`, that lives at the path `/path/to/directory-with-kurtosis.yml/some-file.star` relative to the root of the repo.
 
-
-Locators are used for identifying resources that will be used inside a Starlark script - namely by [`import_module`](../starlark-reference/import-module.md) and [`read_file`](../starlark-reference/read-file.md).
-
 :::caution
 A GitHub URL is **not** a valid locator, because GitHub adds extra `/blob/main` paths to the URL that don't reflect the file's path in the repo. For example, a GitHub URL of:
 
@@ -36,22 +36,21 @@ github.com/kurtosis-tech/kurtosis/starlark/test.star
 Only locators pointing to public GitHub repositories are currently allowed.
 :::
 
+### Package Restriction
 Any Starlark script that wishes to use external resources must be
 a part of a [Kurtosis package][packages].
 
-All locators are absolute; "relative" locators do not exist. For a Starlark script to reference a local file (i.e. one that lives next to in the filesystem), the Starlark script must use the name of the package that it lives inside.
-
 For example, suppose we had a [Kurtosis package][packages] like so:
 
 ```
 /
-    package-repo
-        my-package 
+    package-repo/
+        my-package/
             kurtosis.yml
             main.star
-            helpers
+            helpers/
                 random-script.star
-        not-a-package
+        not-a-package/
             random-script.star
 ```
 
@@ -67,13 +66,43 @@ The `main.star` file would import the `random-script.star` from the `helpers` su
 helpers = import_module("github.com/package-author/package-repo/my-package/helpers/random-script.star")
 ```
 
-The import statement below will not succeed, this is because `main.star` cannot import from non-packages.
+The import statement below will not succeed, because `main.star` cannot import from non-packages.
 (see [how import works][how-do-kurtosis-imports-work-explanation] for more information)
 
 ```python
 helpers = import_module("github.com/package-author/package-repo/not-a-package/random-script.star")
 ```
 
+### Relative Locators
+Relative locators like `./helper.star` are allowed as a short alternative to the full absolute locator. However, a relative locator cannot be used to reference files outside the package. In other words, you cannot use a relative locator to reference files above the directory containing the `kurtosis.yml` file.
+
+Suppose we had a [Kurtosis package][packages] like so:
+
+```
+/
+    package-repo/
+        main.star
+        src/
+            lib.star
+```
+
+with a `kurtosis.yml` file like so:
+
+```yaml
+name: github.com/package-author/package-repo
+```
+
+The `main.star` can refer to the `lib.star` file using either relative or absolute imports:
+
+
+```python
+# valid relative import
+lib_via_relative_import = import_module("./src/lib.star")
+
+# valid absolute import
+lib_via_absolute_import = import_module("github.com/kurtosis-tech/package-repo/src/lib.star")
+```
+
 <!------------------ ONLY LINKS BELOW HERE -------------------->
 [packages]: ./packages.md
 [how-do-kurtosis-imports-work-explanation]: ../explanations/how-do-kurtosis-imports-work.md

docs/versioned_docs/version-0.80.8/concepts-reference/packages.md → docs/versioned_docs/version-0.80.13/concepts-reference/packages.md

@@ -59,7 +59,7 @@ A Kurtosis package that has a `main.star` file next to its `kurtosis.yml` file i
 
 ```python
 def run(plan):
-    print("Hello, world.")
+    plan.print("Hello, world.")
 ```
 
 :::info

docs/versioned_docs/version-0.80.8/guides/how-to-local-eth-testnet.md → docs/versioned_docs/version-0.80.13/guides/how-to-local-eth-testnet.md

@@ -26,7 +26,7 @@ In this guide, the Kurtosis eth-network-package spins up a local Ethereum testne
 Before you proceed, make sure you have:
 * [Installed and started the Docker engine](https://docs.kurtosis.com/next/install#i-install--start-docker) on your local machine
 * [Installed the Kurtosis CLI](https://docs.kurtosis.com/next/install#ii-install-the-cli) (or upgraded it to the latest release, if you already have the CLI installed)
-* Installed[Node.js](https://nodejs.org/en), [yarn](https://classic.yarnpkg.com/lang/en/docs/install/#mac-stable), and [npx](https://www.npmjs.com/package/npx) (for your dApp environment)
+* Installed [Node.js](https://nodejs.org/en), [yarn](https://classic.yarnpkg.com/lang/en/docs/install/#mac-stable), and [npx](https://www.npmjs.com/package/npx) (for your dApp environment)
 
 ## Instantiating a local Ethereum testnet
 
@@ -102,11 +102,11 @@ The [smart-contract-example](https://github.com/kurtosis-tech/awesome-kurtosis/t
 * [`contracts/`](https://github.com/kurtosis-tech/awesome-kurtosis/tree/main/smart-contract-example/contracts) contains a few simple smart contracts for a Blackjack dApp
 * [`scripts/`](https://github.com/kurtosis-tech/awesome-kurtosis/tree/main/smart-contract-example/scripts) contains a script to deploy a token contract to your local Ethereum network
 * [`test/`](https://github.com/kurtosis-tech/awesome-kurtosis/tree/main/smart-contract-example/test) contains a simple .js test for your token contract to confirm each player in our Blackjack dApp has 1000 minted for them
-* []`hardhat.config.ts`](https://github.com/kurtosis-tech/awesome-kurtosis/blob/main/smart-contract-example/hardhat.config.ts) configures your Hardhat setup
+* [`hardhat.config.ts`](https://github.com/kurtosis-tech/awesome-kurtosis/blob/main/smart-contract-example/hardhat.config.ts) configures your Hardhat setup
 
 ### Configure Hardhat to use the local testnet
 
-WWith your dApp development environment set up, you will now connect Hardhat to use the local Ethereum testnet generated using Kurtosis. To accomplish this, replace `<$YOUR_PORT>` in the `localnet` struct in your `hardhat.config.ts` config file with the port of the rpc uri output from any `el-client-<num>` service. In this sample case, the port would be `64248`. Your port will be different.
+With your dApp development environment set up, you will now connect Hardhat to use the local Ethereum testnet generated using Kurtosis. To accomplish this, replace `<$YOUR_PORT>` in the `localnet` struct in your `hardhat.config.ts` config file with the port of the rpc uri output from any `el-client-<num>` service. In this sample case, the port would be `64248`. Your port will be different.
 
 Example in `hardhat.config.ts`:
 ```typescript