https://github.com/bplaat/crates
A collection of minimal Rust crates and tools that I created for myself and others
https://github.com/bplaat/crates
build-system rust sqlite web-development webview
Last synced: 4 months ago
JSON representation
A collection of minimal Rust crates and tools that I created for myself and others
- Host: GitHub
- URL: https://github.com/bplaat/crates
- Owner: bplaat
- License: mit
- Created: 2023-02-15T09:10:38.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2026-02-26T20:41:08.000Z (4 months ago)
- Last Synced: 2026-02-27T00:24:01.052Z (4 months ago)
- Topics: build-system, rust, sqlite, web-development, webview
- Language: Rust
- Homepage: https://crates.bplaat.nl
- Size: 9.94 MB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 38
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Bassie's Rust crates
A collection of minimal Rust crates and tools that I created for myself and others
## Crates
### Published libraries
These crates are published to [crates.io](https://crates.io) and are more polished and documented
- [bsqlite](lib/bsqlite) A simple and minimal Rust SQLite library with an ergonomic API **([crates.io](https://crates.io/crates/bsqlite))**
- [bsqlite_derive](lib/bsqlite_derive) The derive macro's for the [bsqlite](lib/bsqlite) crate **([crates.io](https://crates.io/crates/bsqlite_derive))**
- [simple-useragent](lib/simple-useragent) A simple user agent parser library based on the uap-core regexes **([crates.io](https://crates.io/crates/simple-useragent))**
- [small-http](lib/small-http) A simple and small HTTP/1.1 server/client library **([crates.io](https://crates.io/crates/small-http))**
- [small-router](lib/small-router) A simple and small router for the [small-http](lib/small-http) library **([crates.io](https://crates.io/crates/small-router))**
### Libraries
These libraries are not published to [crates.io](https://crates.io) and are more intended for personal use but can still be useful
- [bwebview](lib/bwebview) A cross-platform webview library for Rust with minimal dependencies
- [from_derive](lib/from_derive) A FromEnum and FromStruct derive macro library
- [ini](lib/ini) A simple INI file parser library
- [js](lib/js) A WIP JavaScript interpreter
- [openapi-generator](lib/openapi-generator) A simple OpenAPI code generator
- [pbkdf2](lib/pbkdf2) A unsecure PBKDF2-HMAC-SHA256 password hashing library
- [small-websocket](lib/small-websocket) A simple and small websocket library for the [small-http](lib/small-http) library
- [validate](lib/validate) A simple struct validation library
- [validate_derive](lib/validate_derive) Validation derive macro's library
### Apps
Some desktop apps written with the [bwebview](lib/bwebview) library
- [2048](bin/game2048) An offline desktop 2048 game app
- [BassieLight](bin/bassielight) A simple lights controller with GUI
- [ManExplorer](bin/manexplorer) A simple man page explorer tool
- [Navidrome](bin/navidrome) A [music.bplaat.nl](https://music.bplaat.nl/) webview wrapper
- [Sequel Explorer](bin/sequelexplorer) A simple SQLite database GUI viewer
### Tools / Websites
Various tools and websites, for the live deployed sites go to [crates.bplaat.nl](https://crates.bplaat.nl/)
- [baksteen](bin/baksteen/) A brick laying robot simulator
- [bob](bin/bob) A simple build system for my projects, because I like the simplicity of Cargo
- [cargo-bundle](bin/cargo-bundle) A simple Cargo plugin the builds macOS app bundles
- [music-dl](bin/music-dl) A tool that downloads complete albums with the correct metadata
- [plaatnotes](bin/plaatnotes) A simple note-taking app
- [webhook-puller](bin/webhook-puller) A small service that pulls a Git repo when requested by a webhook
### Replacement libraries
These libraries are created as minimal / smaller replacements for common used crates
- [anyhow](lib/anyhow) A minimal replacement for the [anyhow](https://crates.io/crates/anyhow) crate
- [chrono](lib/chrono) A minimal replacement for the [chrono](https://crates.io/crates/chrono) crate
- [copy_dir](lib/copy_dir) A minimal replacement for the [copy_dir](https://crates.io/crates/copy_dir) crate
- [directories](lib/directories) A minimal replacement for the [directories](https://crates.io/crates/directories) crate
- [dotenv](lib/dotenv) A minimal replacement for the [dotenv](https://crates.io/crates/dotenv) crate
- [enable-ansi-support](lib/enable-ansi-support) A minimal replacement for the [enable-ansi-support](https://crates.io/crates/enable-ansi-support) crate
- [getrandom](lib/getrandom) A minimal replacement for the [getrandom](https://crates.io/crates/getrandom) crate
- [libsqlite3-sys](lib/libsqlite3-sys) A minimal replacement for the [libsqlite3-sys](https://crates.io/crates/libsqlite3-sys) crate
- [local-ip-address](lib/local-ip-address) A minimal replacement for the [local-ip-address](https://crates.io/crates/local-ip-address) crate
- [mime](lib/mime) A minimal replacement for the [mime](https://crates.io/crates/mime) crate
- [mime_guess](lib/mime_guess) A minimal replacement for the [mime_guess](https://crates.io/crates/mime_guess) crate
- [rust-embed](lib/rust-embed) A minimal replacement for the [rust-embed](https://crates.io/crates/rust-embed) crate
- [rust-embed-impl](lib/rust-embed-impl) A minimal replacement for the [rust-embed-impl](https://crates.io/crates/rust-embed-impl) crate
- [semver](lib/semver) A minimal replacement for the [semver](https://crates.io/crates/semver) crate
- [sha1](lib/sha1) A minimal replacement for the [sha1](https://crates.io/crates/sha1) crate
- [simple_logger](lib/simple_logger) A minimal replacement for the [simple_logger](https://crates.io/crates/simple_logger) crate
- [terminal_size](lib/terminal_size) A minimal replacement for the [terminal_size](https://crates.io/crates/terminal_size) crate
- [threadpool](lib/threadpool) A minimal replacement for the [threadpool](https://crates.io/crates/threadpool) crate
- [url](lib/url) A minimal replacement for the [url](https://crates.io/crates/url) crate
- [uuid](lib/uuid) A minimal replacement for the [uuid](https://crates.io/crates/uuid) crate
- [winresource](lib/winresource) A minimal replacement for the [winresource](https://crates.io/crates/winresource) crate
- [zip](lib/zip) A minimal replacement for the [zip](https://crates.io/crates/zip) crate
## Repo organization
This repo is organized as a monorepo with `Cargo` as the main build system. My personal vision is that monorepo's work vary well when there's only one main build system, that acts a single organization point for the whole project with all it's submodules.
So this all Rust code is contained in a single `Cargo` workspace, that builds everything. Some crates have custom build steps that can run other build scripts / systems like `npm` and `vite`.
The [meta.sh](meta.sh) script is contains all the main tasks, these are used from commandline and also CI. The only modules that use a different build system are the ones in the [bob/examples](bin/bob/examples) directory, but that is also a show case of the [bob](bin/bob) build system.
## Getting Started
- Open a posix shell environment when you are on Windows (e.g. Git Bash)
- Install [Rust](https://rustup.rs/), [Node.js](https://nodejs.org/), [OpenJDK 21](https://adoptium.net/) and [clang-format](https://clang.llvm.org/docs/ClangFormat.html)
- Install Rust nightly `rustfmt`, `cargo-binstall`, `cargo-deny` and `cargo-nextest`:
```sh
rustup toolchain add nightly --component rustfmt
curl -L --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/cargo-bins/cargo-binstall/main/install-from-binstall-release.sh | bash
cargo binstall -y cargo-deny cargo-nextest
```
- Run checks, or run an example:
```sh
./meta.sh check
cargo run --bin example-persons-api
cargo run --bin example-todo-app
```
### Additional tools
- For coverage reports, install the `llvm-tools` and `cargo-llvm-cov` tool:
```sh
rustup component add llvm-tools
cargo binstall -y cargo-llvm-cov
./meta.sh coverage
```
- To build pages, install a wasm target and the `wasm-bindgen-cli` tool:
```sh
rustup target add wasm32-unknown-unknown
cargo binstall -y wasm-bindgen-cli --version 0.2.104
./meta.sh build-pages
```
- To build macOS app bundles, only on macOS, install targets:
```sh
rustup target add aarch64-apple-darwin x86_64-apple-darwin
./meta.sh build-bundle
```
- To build and install bins and GUI applications to your system:
```sh
./meta.sh install
```
## License
Copyright © 2023-2026 [Bastiaan van der Plaat](https://github.com/bplaat)
Licensed under the [MIT](LICENSE) license.
