New tutorials

.gitignore

@@ -1,3 +1,6 @@
 /target
+/examples/**/target/*
 /.vscode
 Cargo.lock
+
+/flamegraph.svg

Cargo.toml

@@ -5,11 +5,73 @@ version = "0.1.0"
 edition = "2021"
 publish = false
 
+[[bin]]
+name = "tokio-panic-handling"
+path = "src/bin/tokio-panic-handling.rs"
+
+[[bin]]
+name = "string-search-heaptrack"
+path = "src/bin/string-search-heaptrack.rs"
+
+[[bin]]
+name = "phrases-randomized"
+path = "src/bin/phrases-randomized.rs"
+
 [dependencies]
+anyhow = "1.0.66"
+futures = "0.3.19"
+hyper = { version = "0.14.16", features = ["full"] }
+hyper-rustls = { version = "0.23.0", features = ["http1", "http2"] }
+tokio = { version = "1.17.0", features = ["full"] }
+tokio-util = "0.7.7"
+rustls = "0.21.0"
 clap = { version = "3", features = ["derive"] }
 dotenv = "0.15.0"
 env_logger = "0.9.0"
 log = "0.4.16"
+http-body = "0.4.5"
+bufstream = "0.1.3"
+base64 = "0.21"
+imap-proto = "0.16.1"
+rustls-connector = { version = "0.18.0", features = ["dangerous-configuration"] }
+hmac = { version = "0.13.0-pre.3" }
+pbkdf2 = { version = "0.13.0-pre.0" }
+sha2 = { version = "0.11.0-pre.3" }
+hex-literal = "^0.4"
+hex = "^0.4"
+aes-gcm-siv = "^0.11"
+aes = "^0.8"
+heapless = "^0.8"
+rand = "0.8.5"
+pin-project = "1.1.7"
+nalgebra = "0.33.2"
+nom = "7.1.3"
+async-trait = "0.1.83"
+reqwest = "0.12.15"
+
+# Misc
+crossbeam = { version = "0.8.4", features = ["crossbeam-channel"] }
+kanal = "0.1.0-pre8"
+
+axum = { version = "0.6.18", features = ["headers", "tower-log"] }
+axum-extra = "0.1.2"
+
+# Axum builds on the types in Tower
+tower = { version = "0.4.13", features = ["limit", "load-shed", "filter", "util"] }
+tower-http = { version = "0.4.0", features = ["trace", "cors", "catch-panic"] }
+tower-layer = "0.3.1"
+tower-service = "0.3.1"
+tower-http_0_2_4 = { package = "tower-http", version = "0.2.4" , features = ["cors"] }
+
+# Logging support
+tracing = "0.1.30"
+tracing-subscriber = { version = "0.3.8", features = ["env-filter"] }
+backon = "1.4.0"
+bytes = "1.10.1"
+thiserror = "2.0.12"
 
 [dev-dependencies]
 test-log = "0.2.10"
+
+[profile.release]
+debug = true

LICENSE

@@ -1,6 +1,7 @@
 The MIT License (MIT)
 
-Copyright (c) 2021 Michael de Silva (https://desilva.io/about)
+Copyright (c) Michael de Silva (https://desilva.io/about)
+Email: [email protected]
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

README.md

@@ -4,6 +4,13 @@
 
 This repo means to serve as a playground for expressing concepts quickly, in a "Rust by Example" format.
 
+## Examples
+
+Run the following with `cargo r --bin <PACKAGE_NAME>`
+
+1. `tokio-panic-handling`
+
+
 
 ## License Information
 

benchmarking/string-search/README.md

@@ -0,0 +1,19 @@
+# string-search
+
+## flamegraph
+
+Run as follows, also works on Mac.
+
+```
+cargo flamegraph --root --flamechart --verbose --bin string-search-heaptrack
+```
+
+This example runs 1 Million invocations of `Entries::search()`
+
+<img src="./flamegraph.svg"/>
+
+## heaptrack
+
+Run `./run_heaptrack.sh`.  Tested on Debian 12.
+
+Connect to a remote host using `ssh -X` to allow forwarding `heaptrack_gui`.