Prepare 0.17.0-dev.2 release

CHANGELOG.md

@@ -8,6 +8,20 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 ### Removed
 ### Changed
 ### Fixed
+
+## 2024-07-17: v0.17.0-dev.2
+### Added
+- New feature for TryCP to allow logs to be downloaded. This is useful when you are working with remote nodes and need
+  to read the Holochain logs locally. The logs are given back as raw bytes, so you can write them to a file or otherwise
+  further process them. #222
+
+### Removed
+### Changed
+- The TryCP server used to open a new admin websocket for each admin request made to Holochain. A single
+  admin websocket is now used for all requests. It is opened by the first request and closed when the Holochain instance
+  it shut down. #221
+
+### Fixed
 - The `trycp_client` now handles ping/pong messages from the TryCP server to keep the connection alive.
 - The `trycp_client` now handles the `close` event from the TryCP server to close the connection.
 

Cargo.toml

@@ -25,7 +25,7 @@ snafu = "0.6"
 structopt = "0.2"
 tokio = "1.38"
 tokio-tungstenite = "0.21"
-trycp_api = { version = "0.17.0-dev.0", path = "crates/trycp_api" }
+trycp_api = { version = "0.17.0-dev.2", path = "crates/trycp_api" }
 url = "2"
 
 [profile.dev]

crates/trycp_api/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "trycp_api"
-version = "0.17.0-dev.0"
+version = "0.17.0-dev.2"
 description = "conductor provisioner API for tryorama"
 license = "CAL-1.0"
 edition = "2021"

crates/trycp_client/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "trycp_client"
-version = "0.17.0-dev.0"
+version = "0.17.0-dev.2"
 description = "Client for TryCP"
 license = "CAL-1.0"
 edition = "2021"

crates/trycp_server/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "trycp_server"
-version = "0.17.0-dev.0"
+version = "0.17.0-dev.2"
 description = "conductor provisioner for tryorama"
 license = "CAL-1.0"
 keywords = ["holochain", "holo", "p2p", "network", "simulation"]

docs/tryorama.downloadlogsresponse.conductor_stderr.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@holochain/tryorama](./tryorama.md) &gt; [DownloadLogsResponse](./tryorama.downloadlogsresponse.md) &gt; [conductor\_stderr](./tryorama.downloadlogsresponse.conductor_stderr.md)
+
+## DownloadLogsResponse.conductor\_stderr property
+
+**Signature:**
+
+```typescript
+conductor_stderr: Uint8Array;
+```

docs/tryorama.downloadlogsresponse.conductor_stdout.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@holochain/tryorama](./tryorama.md) &gt; [DownloadLogsResponse](./tryorama.downloadlogsresponse.md) &gt; [conductor\_stdout](./tryorama.downloadlogsresponse.conductor_stdout.md)
+
+## DownloadLogsResponse.conductor\_stdout property
+
+**Signature:**
+
+```typescript
+conductor_stdout: Uint8Array;
+```

docs/tryorama.downloadlogsresponse.lair_stderr.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@holochain/tryorama](./tryorama.md) &gt; [DownloadLogsResponse](./tryorama.downloadlogsresponse.md) &gt; [lair\_stderr](./tryorama.downloadlogsresponse.lair_stderr.md)
+
+## DownloadLogsResponse.lair\_stderr property
+
+**Signature:**
+
+```typescript
+lair_stderr: Uint8Array;
+```

docs/tryorama.downloadlogsresponse.md

@@ -0,0 +1,89 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@holochain/tryorama](./tryorama.md) &gt; [DownloadLogsResponse](./tryorama.downloadlogsresponse.md)
+
+## DownloadLogsResponse interface
+
+Response for downloading logs.
+
+**Signature:**
+
+```typescript
+export interface DownloadLogsResponse 
+```
+
+## Properties
+
+<table><thead><tr><th>
+
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[conductor\_stderr](./tryorama.downloadlogsresponse.conductor_stderr.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Uint8Array
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+[conductor\_stdout](./tryorama.downloadlogsresponse.conductor_stdout.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Uint8Array
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+[lair\_stderr](./tryorama.downloadlogsresponse.lair_stderr.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Uint8Array
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>

docs/tryorama.downloadlogsresponsetype.data.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@holochain/tryorama](./tryorama.md) &gt; [DownloadLogsResponseType](./tryorama.downloadlogsresponsetype.md) &gt; [data](./tryorama.downloadlogsresponsetype.data.md)
+
+## DownloadLogsResponseType.data property
+
+**Signature:**
+
+```typescript
+data: DownloadLogsResponse;
+```

docs/tryorama.downloadlogsresponsetype.md

@@ -0,0 +1,72 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@holochain/tryorama](./tryorama.md) &gt; [DownloadLogsResponseType](./tryorama.downloadlogsresponsetype.md)
+
+## DownloadLogsResponseType interface
+
+Enumerated response for downloading logs.
+
+**Signature:**
+
+```typescript
+export interface DownloadLogsResponseType 
+```
+
+## Properties
+
+<table><thead><tr><th>
+
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[data](./tryorama.downloadlogsresponsetype.data.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[DownloadLogsResponse](./tryorama.downloadlogsresponse.md)
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+[type](./tryorama.downloadlogsresponsetype.type.md)
+
+
+</td><td>
+
+
+</td><td>
+
+"download\_logs"
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>

docs/tryorama.downloadlogsresponsetype.type.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@holochain/tryorama](./tryorama.md) &gt; [DownloadLogsResponseType](./tryorama.downloadlogsresponsetype.md) &gt; [type](./tryorama.downloadlogsresponsetype.type.md)
+
+## DownloadLogsResponseType.type property
+
+**Signature:**
+
+```typescript
+type: "download_logs";
+```

docs/tryorama.md

@@ -690,6 +690,28 @@ A TryCP client and its associated players.
 DNA source and additional options.
 
 
+</td></tr>
+<tr><td>
+
+[DownloadLogsResponse](./tryorama.downloadlogsresponse.md)
+
+
+</td><td>
+
+Response for downloading logs.
+
+
+</td></tr>
+<tr><td>
+
+[DownloadLogsResponseType](./tryorama.downloadlogsresponsetype.md)
+
+
+</td><td>
+
+Enumerated response for downloading logs.
+
+
 </td></tr>
 <tr><td>
 
@@ -877,6 +899,17 @@ Request to disconnect a connected app interface from a conductor.
 Request to download a DNA from a URL.
 
 
+</td></tr>
+<tr><td>
+
+[RequestDownloadLogs](./tryorama.requestdownloadlogs.md)
+
+
+</td><td>
+
+Request type for fetching logs from a given conductor.
+
+
 </td></tr>
 <tr><td>
 
@@ -1223,6 +1256,17 @@ Possible responses from the Admin and App APIs.
 Log level for a TryCP conductor.
 
 
+</td></tr>
+<tr><td>
+
+[TryCpControlResponse](./tryorama.trycpcontrolresponse.md)
+
+
+</td><td>
+
+A response from the TryCP server.
+
+
 </td></tr>
 <tr><td>
 

docs/tryorama.requestdownloadlogs.id.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@holochain/tryorama](./tryorama.md) &gt; [RequestDownloadLogs](./tryorama.requestdownloadlogs.md) &gt; [id](./tryorama.requestdownloadlogs.id.md)
+
+## RequestDownloadLogs.id property
+
+**Signature:**
+
+```typescript
+id: ConductorId;
+```