Skip to content

Commit d2d086f

Browse files
committed
cleaning and bump version
2 parents 5ff3ae3 + 90fdfa9 commit d2d086f

File tree

12 files changed

+439
-256
lines changed

12 files changed

+439
-256
lines changed

Cargo.lock

Lines changed: 7 additions & 7 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

Cargo.toml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,10 @@ members = ["bagread", "minot", "rat", "ratpub", "mtc", "sea", "wind"]
44
resolver = "2"
55

66
[workspace.package]
7-
version = "0.1.0-rc.6"
7+
version = "0.1.0"
88
keywords = ["robotics"]
99
license = "MIT OR Apache-2.0"
10-
repository = "https://gitlabti.informatik.uni-osnabrueck.de/chsieh/lighthouse/"
10+
repository = "https://github.com/uos/minot"
1111
edition = "2024"
1212
include = ["**/*.rs", "**/*.md", "**/Cargo.toml"]
1313
authors = ["Christopher Sieh <csieh@uos.de>"]

README.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Visit the [Documentation](https://uos.github.io/minot) to find out more.
1111

1212
## Quick Install
1313

14-
For most users, the easiest way to install Minot is using the installation script with a single command. This will install the `minot` binary and `minot-coord` with sensible defaults for getting started.
14+
For most users, the easiest way to install Minot is using the installation script with a single command. This will install the `minot` binaries and libraries into your user directory.
1515

1616
~~~bash
1717
curl -sSLf https://install.steado.tech/minot | sh
@@ -21,10 +21,13 @@ For ROS support, make sure to have your ROS environment sourced before running t
2121

2222
After your first steps with Minot, you may want to use its more advanced features. Check the detailed [install page](https://uos.github.io/minot/installation.html) for that.
2323

24-
## VSCode Extension
24+
## VS Code Extension
2525

2626
Search for "Minot" in your editor an install the package. Running it will require a Minot binary in your `$PATH`. The extension will add syntax highlighting for `.mt` files and automatically activates as soon as you open a Minot file. You will see some buttons in the editor footer. Select some lines and run them with `Run Selection`. Hover over the buttons to see their keybindings.
2727

28+
### Tree-sitter Support
29+
30+
Minot comes with support for Tree-sitter syntax highlighting outside of VS Code. See [this repository](https://github.com/stelzo/tree-sitter-minot) for instructions on how to add Minot support to the Helix editor or use the repository for other editors that support Tree-sitter grammars.
2831

2932
### License
3033

dev.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,5 @@
11
# Development Notes
22

3-
## Could be bugs
4-
5-
- Pelorus dbg timeout receiving ack only waiting or not receiving?
6-
73
## Definitely bugs
84

95
- [ratpub] Long polling subscribers are not cancelled when subscriber disconnects

docs/docs/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Introduction
22

3-
**Minot** [mai·not] provides primitives for developing and verifying robot software with in a single executable binary.
3+
**Minot** [mai·not] provides a versatile toolset for developing and verifying robot perception software with in a single executable binary.
44

55
Its main features are built around Bagfiles from ROS2 that use MCAP for storage.
66

docs/docs/installation.md

Lines changed: 17 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,22 @@
11
## Install Script (Recommended)
22

3-
For most users, the easiest way to install Minot is using the installation script with a single command. This will install the `minot` binary and `minot-coord` with sensible defaults for getting started.
3+
For most users, the easiest way to install Minot is using the installation script with a single command. This will install the `minot` binaries and libraries into your user directory.
44

55
~~~bash
66
curl -sSLf https://install.steado.tech/minot | sh
77
~~~
88

99
For ROS support, make sure to have your ROS environment sourced before running the script.
1010

11-
### VSCode Extension
11+
### VS Code Extension
1212

1313
Search for "Minot" in your editor an install the package. Running it will require a Minot binary in your `$PATH`. The extension will add syntax highlighting for `.mt` files and automatically activates as soon as you open a Minot file. You will see some buttons in the editor footer. Select some lines and run them with `Run Selection`. Hover over the buttons to see their keybindings.
1414

15-
### Detailed Installation
15+
### Tree-sitter Support
16+
17+
Minot comes with support for Tree-sitter syntax highlighting outside of VS Code. See [this repository](https://github.com/stelzo/tree-sitter-minot) for instructions on how to add Minot support to the Helix editor or use the repository for other editors that support Tree-sitter grammars.
18+
19+
### Advanced Installation
1620

1721
You can also download and run the install script manually for more control.
1822
Use `--help` to see all available configurations of Minot.
@@ -28,9 +32,9 @@ The installation script will:
2832
- Automatically detect your operating system and architecture
2933
- Resolve to the newest compatible and stable version
3034
- Download prebuilt binaries from GitHub releases if available
31-
- Fall back to building from source with `cargo install` if needed
32-
- Install binaries to `~/.local/bin` (customizable with `--dir`)
33-
- Offer to install Rust automatically if needed for building from source
35+
- Fall back to building from source using Rust if needed
36+
- Copy binaries and libraries into your local user directory (customizable with `--dir`)
37+
- Add the uninstall script (`minot-uninstall`) to the same directory for easy removal later
3438

3539
**Embedded Components:**
3640

@@ -79,9 +83,9 @@ Archives not specific to a ROS distribution contain builds that can be used inde
7983

8084
While the prebuilt binaries cover many common use cases, you may need to build Minot from source to tailor it to your specific needs. Building from source requires the [Rust toolchain](https://www.rust-lang.org/tools/install) to be installed on your system.
8185

82-
## Minot TUI
86+
## Minot bundled binary
8387

84-
To build the Minot TUI, there are some feature flags for embedding common network participants for convenience. A detailed list of supported flags can be found in the [Minot features definition](https://github.com/uos/minot/blob/main/minot/Cargo.toml#L45).
88+
To build the Minot bundled binary, there are some feature flags for embedding common network participants for convenience. A detailed list of supported flags can be found in the [Minot features definition](https://github.com/uos/minot/blob/main/minot/Cargo.toml#L45).
8589

8690
With default settings, Minot builds with an integrated coordinator. When running the following command with no changes, you will get a `minot` binary with integrated Coordinator and a `minot-coord` binary, that is *just* a Coordinator. The standalone Coordinator is enough for sharing variables [with the rat library](./varshare.md#library).
8791

@@ -102,7 +106,7 @@ cargo install \
102106

103107
---
104108

105-
The next version does not need any ROS1 or ROS2 installation to compile but it expects to find a node in the network if you try to query a Bagfile:
109+
This next version does not need any ROS1 or ROS2 installation to compile but it expects to find a node in the network if you try to query a Bagfile:
106110

107111
~~~bash title="Minimal with embedded Coordinator"
108112
cargo install \
@@ -121,7 +125,7 @@ cargo install \
121125

122126
## Standalone Coordinator
123127

124-
Installing Minot TUI as shown above will also build a standalone variant of the Coordinator. It is called `minot-coord` in your path.
128+
Running `cargo install` as shown above will also build a standalone variant of the Coordinator. It is called `minot-coord` in your path.
125129

126130
## Standalone Wind Turbines (Bagfile Publishers)
127131

@@ -186,7 +190,7 @@ And link with `-lrat`.
186190
For using the Rust library, just add this to your dependencies in `Cargo.toml`.
187191

188192
~~~toml title="Cargo.toml"
189-
rat = { version = "0.1.0-rc.6", git = "https://github.com/uos/minot" }
193+
rat = { version = "0.1.0", git = "https://github.com/uos/minot" }
190194
~~~
191195

192196
## Ratpub (Native Publish/Subscribe)
@@ -195,7 +199,7 @@ Ratpub is only available for Rust. It uses Tokio for async I/O.
195199
For using the library in your project, add these lines to your dependencies in `Cargo.toml`.
196200

197201
~~~toml title="Cargo.toml"
198-
ratpub = { version = "0.1.0-rc.6", git = "https://github.com/uos/minot" }
202+
ratpub = { version = "0.1.0", git = "https://github.com/uos/minot" }
199203
tokio = { version = "1", features = ["full"] }
200204
~~~
201205

@@ -212,6 +216,4 @@ Learn more on how to use it in your Code by visiting the [feature page](./pubsub
212216

213217
## Uninstall
214218

215-
With modern software the word *"installing"* is overloaded. Cargo just compiles the code and moves the finished binaries to a directory in your path. There are no other side effects or files from Minot.
216-
217-
If you want to remove them, you can `minot uninstall` to uninstall minot or minot-coord. Or `cargo uninstall wind` for the manual installed binaries.
219+
If you want to remove every file installed from the install script, you can run `minot-uninstall`. This executes a generated shell script that saved all added files and now removes them (including itself). You can also run `minot uninstall` to uninstall minot and minot-coord. Or `cargo uninstall wind` if you installed binaries with cargo.

0 commit comments

Comments
 (0)