prefer into()

[wip] unit tests for file module
- testing for `Uploading`
2025-07-15 15:34:23 +00:00 · 2025-07-15 15:00:11 +00:00 · 2025-07-15 14:55:29 +00:00 · 2025-07-15 14:54:27 +00:00 · 2025-07-15 13:10:08 +00:00 · 2025-07-14 21:55:16 +00:00
37 changed files with 3821 additions and 890 deletions
--- a/.cargo/config.toml
+++ b/.cargo/config.toml
@ -1,2 +1,9 @@
 [build]
 target = "x86_64-unknown-linux-musl"
 # rustflags = [
 #   # emit instructions tuned to the current CPU
 #   "-C", "target-cpu=native",
 #   # assume CPU features
 #   "-C", "target-feature=+avx2,+sse4.1,+ssse3,+aes",
 # ]
--- a/.devcontainer/devcontainer.json
+++ b/.devcontainer/devcontainer.json
@ -13,13 +13,21 @@
            "configureZshAsDefaultShell": "true"
        },
 		"ghcr.io/devcontainers/features/rust:1": {
-			"targets": "x86_64-unknown-linux-musl"
+			"targets": "x86_64-unknown-linux-gnu,x86_64-unknown-linux-musl"
 		},
-		"ghcr.io/devcontainers-contrib/features/apt-get-packages:1": {
+		"ghcr.io/lee-orr/rusty-dev-containers/cargo-binstall:0": {
-			"packages": "git-flow, musl-tools"
+			"packages": "cargo-llvm-cov,cargo-edit"
 		},
 		"ghcr.io/devcontainers-extra/features/apt-get-packages:1": {
 			"packages": "git-flow,musl-tools"
 		}
 	},
 	"overrideFeatureInstallOrder": [
 		"ghcr.io/devcontainers/features/rust",
 		"ghcr.io/lee-orr/rusty-dev-containers/cargo-binstall"
 	],
 	// cargo cache persistence
 	"mounts": [
 		{
@ -33,7 +41,7 @@
 	// "forwardPorts": [],
 	// Use 'postCreateCommand' to run commands after the container is created.
-	"postCreateCommand": "rustup target install x86_64-unknown-linux-musl | :",
+	"postCreateCommand": "sudo chown -R \"${USER}:rustlang\" \"${RUSTUP_HOME}\" \"${CARGO_HOME}\"",
 	// Configure tool-specific properties.
 	"customizations": {
@ -42,7 +50,9 @@
 				"terminal.integrated.defaultProfile.linux": "zsh"
 			},
 			"extensions": [
-				"mhutchie.git-graph"
+				"mhutchie.git-graph",
 				"Gruntfuggly.todo-tree",
 				"ryanluker.vscode-coverage-gutters"
 			]
 		}
 	},
--- a/.gitignore
+++ b/.gitignore
@ -1,3 +1,7 @@
 # code coverage reports
 coverage/
 # https://github.com/github/gitignore/raw/refs/heads/main/Rust.gitignore
 # Generated by Cargo
--- a/.vscode/launch.json
+++ b/.vscode/launch.json
@ -22,6 +22,7 @@
            "args": [
                "sharry.yavook.de",
                "G7RYoWME1W7-pcgipemJcr8-39FcMd92gBu-RgufeHc51z6",
                "/lib/x86_64-linux-gnu/libLLVM-14.so",
                "/lib/x86_64-linux-gnu/liblldb-14.so.1",
            ],
            "env": {
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@ -12,6 +12,37 @@
        },
    },
    "rust-analyzer.imports.prefix": "plain",
    "todo-tree.general.tags": [
        "BUG",
        "HACK",
        "FIXME",
        "TODO",
        "XXX",
        "[ ]",
        "[x]",
        "BOOKMARK"
    ],
    "todo-tree.highlights.backgroundColourScheme": [
        "red",
        "orange",
        "yellow",
        "green",
        "blue",
        "indigo",
        "violet",
        "yellow"
    ],
    "todo-tree.highlights.foregroundColourScheme": [
        "white",
        "black",
        "black",
        "white",
        "white",
        "white",
        "black",
        "black"
    ],
    "todo-tree.highlights.useColourScheme": true,
    // // override the default setting (`cargo check --all-targets`) which produces the following error
    // // "can't find crate for `test`" when the default compilation target is a no_std target
    // "rust-analyzer.checkOnSave.allTargets": false,
--- a/.vscode/tasks.json
+++ b/.vscode/tasks.json
@ -5,9 +5,6 @@
            "label": "Build Project",
            "type": "cargo",
            "command": "build",
            "presentation": {
                "reveal": "silent"
            },
            "problemMatcher": "$rustc",
            "group": "build"
        },
@ -27,12 +24,24 @@
            "group": "none"
        },
        {
-            "label": "Clippy Fix Project",
+            "label": "Clippy All Targets",
            "type": "cargo",
            "command": "clippy",
            "args": [
                "--all-targets",
                "--",
                "-Wclippy::pedantic"
            ],
            "problemMatcher": "$rustc",
            "group": "build"
        },
        {
            "label": "Clippy Fix All Targets",
            "type": "cargo",
            "command": "clippy",
            "args": [
                "--fix",
-                "--allow-dirty",
+                "--all-targets",
                "--allow-staged",
                "--",
                "-Wclippy::pedantic"
@ -40,16 +49,16 @@
            "problemMatcher": "$rustc",
            "group": "build"
        },
-        // {
+        {
-        //     "label": "Run Unit Tests",
+            "label": "Run Unit Tests",
-        //     "type": "cargo",
+            "type": "cargo",
-        //     "command": "test",
+            "command": "test",
-        //     "args": [
+            "args": [
-        //         "--lib"
+                "--lib"
-        //     ],
+            ],
-        //     "problemMatcher": "$rustc",
+            "problemMatcher": "$rustc",
-        //     "group": "test"
+            "group": "test"
-        // },
+        },
        // {
        //     "label": "Run Integration Tests",
        //     "type": "cargo",
@ -61,16 +70,77 @@
        //     "problemMatcher": "$rustc",
        //     "group": "test"
        // },
-        // {
+        {
-        //     "label": "Run All Tests",
+            "label": "Test Coverage",
-        //     "type": "shell",
+            "hide": true,
-        //     "command": "echo All Tests successful!",
+            "type": "cargo",
-        //     "dependsOn": [
+            "command": "llvm-cov",
-        //         "Run Unit Tests",
+            "args": [
-        //         "Run Integration Tests"
+                "test",
-        //     ],
+            ],
-        //     "dependsOrder": "sequence",
+            "problemMatcher": "$rustc",
-        //     "group": "test"
+            "group": "test",
-        // }
+        },
        {
            "label": "Report Coverage (html)",
            "hide": true,
            "type": "cargo",
            "command": "llvm-cov",
            "args": [
                "report",
                "--html",
                "--output-dir" ,
                "coverage",
            ],
            "problemMatcher": "$rustc",
            "group": "test"
        },
        {
            "label": "Report Coverage (lcov)",
            "hide": true,
            "type": "cargo",
            "command": "llvm-cov",
            "args": [
                "report",
                "--lcov",
                "--output-path" ,
                "coverage/lcov.info",
            ],
            "problemMatcher": "$rustc",
            "group": "test"
        },
        {
            "label": "Run Coverage",
            "type": "shell",
            "dependsOn": [
                "Test Coverage",
                "Report Coverage (html)",
                "Report Coverage (lcov)",
            ],
            "dependsOrder": "sequence",
            "group": "test"
        },
        {
            "label": "Run All Tests",
            "type": "shell",
            "command": "echo All Tests successful!",
            "dependsOn": [
                "Run Unit Tests",
                // "Run Integration Tests",
                "Run Coverage",
            ],
            "dependsOrder": "parallel",
            "group": "test"
        },
        {
            "label": "Upgrade dependencies",
            "type": "cargo",
            "command": "upgrade",
            "args": [
                "--incompatible",
                "-vv"
            ],
            "group": "none"
        }
    ],
 }
--- a/Cargo.lock
+++ b/Cargo.lock
@ -4,9 +4,9 @@ version = 4
 [[package]]
 name = "adler2"
-version = "2.0.0"
+version = "2.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "512761e0bb2578dd7380c6baaa0f4ce03e84f95e960231d1dec8bf4d7d6e2627"
+checksum = "320119579fcad9c21884f5c4861d16174d0e06250625266f50fe6898340abefa"
 [[package]]
 name = "aho-corasick"
@ -19,9 +19,9 @@ dependencies = [
 [[package]]
 name = "anstream"
-version = "0.6.18"
+version = "0.6.19"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8acc5369981196006228e28809f761875c0327210a891e941f4c683b3a99529b"
+checksum = "301af1932e46185686725e0fad2f8f2aa7da69dd70bf6ecc44d6b703844a3933"
 dependencies = [
 "anstyle",
 "anstyle-parse",
@ -34,24 +34,24 @@ dependencies = [
 [[package]]
 name = "anstyle"
-version = "1.0.10"
+version = "1.0.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "55cc3b69f167a1ef2e161439aa98aed94e6028e5f9a59be9a6ffb47aef1651f9"
+checksum = "862ed96ca487e809f1c8e5a8447f6ee2cf102f846893800b20cebdf541fc6bbd"
 [[package]]
 name = "anstyle-parse"
-version = "0.2.6"
+version = "0.2.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3b2d16507662817a6a20a9ea92df6652ee4f94f914589377d69f3b21bc5798a9"
+checksum = "4e7644824f0aa2c7b9384579234ef10eb7efb6a0deb83f9630a49594dd9c15c2"
 dependencies = [
 "utf8parse",
 ]
 [[package]]
 name = "anstyle-query"
-version = "1.1.2"
+version = "1.1.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "79947af37f4177cfead1110013d678905c37501914fba0efea834c3fe9a8d60c"
+checksum = "6c8bdeb6047d8983be085bab0ba1472e6dc604e7041dbf6fcd5e71523014fae9"
 dependencies = [
 "windows-sys 0.59.0",
 ]
@ -67,6 +67,27 @@ dependencies = [
 "windows-sys 0.59.0",
 ]
 [[package]]
 name = "arrayref"
 version = "0.3.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "76a2e8124351fda1ef8aaaa3bbd7ebbcb486bbcd4225aca0aa0d84bb2db8fecb"
 [[package]]
 name = "arrayvec"
 version = "0.7.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "7c02d123df017efcdfbd739ef81735b36c5ba83ec3c59c80a9d7ecc718f92e50"
 [[package]]
 name = "atomic"
 version = "0.6.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "a89cbf775b137e9b968e67227ef7f775587cde3fd31b0d8599dbd0f598a48340"
 dependencies = [
 "bytemuck",
 ]
 [[package]]
 name = "base64"
 version = "0.22.1"
@ -79,12 +100,29 @@ version = "2.9.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1b8e56985ec62d17e9c1001dc89c88ecd7dc08e47eba5ec7c29c7b5eeecde967"
 [[package]]
 name = "blake2b_simd"
 version = "1.0.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "06e903a20b159e944f91ec8499fe1e55651480c541ea0a584f5d967c49ad9d99"
 dependencies = [
 "arrayref",
 "arrayvec",
 "constant_time_eq",
 ]
 [[package]]
 name = "bumpalo"
 version = "3.17.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1628fb46dfa0b37568d12e5edd512553eccf6a22a78e8bde00bb4aed84d5bdbf"
 [[package]]
 name = "bytemuck"
 version = "1.23.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "5c76a5792e44e4abe34d3abf15636779261d45a7450612059293d1d2cfc63422"
 [[package]]
 name = "bytes"
 version = "1.10.1"
@ -93,18 +131,18 @@ checksum = "d71b6127be86fdcfddb610f7182ac57211d4b18a3e9c82eb2d17662f2227ad6a"
 [[package]]
 name = "cc"
-version = "1.2.24"
+version = "1.2.29"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "16595d3be041c03b09d08d0858631facccee9221e579704070e6e9e4915d3bc7"
+checksum = "5c1599538de2394445747c8cf7935946e3cc27e9625f889d979bfb2aaf569362"
 dependencies = [
 "shlex",
 ]
 [[package]]
 name = "cfg-if"
-version = "1.0.0"
+version = "1.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"
+checksum = "9555578bc9e57714c812a1f84e4fc5b4d21fcb063490c624de019f7464c91268"
 [[package]]
 name = "cfg_aliases"
@ -114,9 +152,9 @@ checksum = "613afe47fcd5fac7ccf1db93babcb082c5994d996f20b8b159f2ad1658eb5724"
 [[package]]
 name = "clap"
-version = "4.5.38"
+version = "4.5.41"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ed93b9805f8ba930df42c2590f05453d5ec36cbb85d018868a5b24d31f6ac000"
+checksum = "be92d32e80243a54711e5d7ce823c35c41c9d929dc4ab58e1276f625841aadf9"
 dependencies = [
 "clap_builder",
 "clap_derive",
@ -124,9 +162,9 @@ dependencies = [
 [[package]]
 name = "clap_builder"
-version = "4.5.38"
+version = "4.5.41"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "379026ff283facf611b0ea629334361c4211d1b12ee01024eec1591133b04120"
+checksum = "707eab41e9622f9139419d573eca0900137718000c517d47da73045f54331c3d"
 dependencies = [
 "anstream",
 "anstyle",
@ -136,9 +174,9 @@ dependencies = [
 [[package]]
 name = "clap_derive"
-version = "4.5.32"
+version = "4.5.41"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "09176aae279615badda0765c0c0b3f6ed53f4709118af73cf4655d85d1530cd7"
+checksum = "ef4f52386a59ca4c860f7393bcf8abd8dfd91ecccc0f774635ff68e92eeef491"
 dependencies = [
 "heck",
 "proc-macro2",
@ -148,15 +186,15 @@ dependencies = [
 [[package]]
 name = "clap_lex"
-version = "0.7.4"
+version = "0.7.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f46ad14479a25103f283c0f10005961cf086d8dc42205bb44c46ac563475dca6"
+checksum = "b94f61472cee1439c0b966b47e3aca9ae07e45d070759512cd390ea2bebc6675"
 [[package]]
 name = "colorchoice"
-version = "1.0.3"
+version = "1.0.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5b63caa9aa9397e2d9480a9b13673856c78d8ac123288526c37d7839f2a86990"
+checksum = "b05b61dc5112cbb17e4b6cd61790d9845d13888356391624cbe7e41efeac1e75"
 [[package]]
 name = "console"
@ -171,6 +209,24 @@ dependencies = [
 "windows-sys 0.59.0",
 ]
 [[package]]
 name = "console"
 version = "0.16.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "2e09ced7ebbccb63b4c65413d821f2e00ce54c5ca4514ddc6b3c892fdbcbc69d"
 dependencies = [
 "encode_unicode",
 "libc",
 "once_cell",
 "windows-sys 0.60.2",
 ]
 [[package]]
 name = "constant_time_eq"
 version = "0.3.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "7c74b8349d32d297c9134b8c88677813a227df8f779daa29bfc29c183fe3dca6"
 [[package]]
 name = "cookie"
 version = "0.18.1"
@ -202,9 +258,9 @@ dependencies = [
 [[package]]
 name = "crc32fast"
-version = "1.4.2"
+version = "1.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a97769d94ddab943e4510d138150169a2758b5ef3eb191a9ee688de3e23ef7b3"
+checksum = "9481c1c90cbf2ac953f07c8d4a58aa3945c425b7185c9154d67a65e4230da511"
 dependencies = [
 "cfg-if",
 ]
@ -234,9 +290,9 @@ version = "0.11.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "658bce805d770f407bc62102fca7c2c64ceef2fbcb2b8bd19d2765ce093980de"
 dependencies = [
- "console",
+ "console 0.15.11",
 "shell-words",
- "thiserror",
+ "thiserror 1.0.69",
 ]
 [[package]]
@ -316,10 +372,26 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "877a4ace8713b0bcf2a4e7eec82529c029f1d0619886d18145fea96c3ffe5c0f"
 [[package]]
-name = "flate2"
+name = "errno"
-version = "1.1.1"
+version = "0.3.13"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7ced92e76e966ca2fd84c8f7aa01a4aea65b0eb6648d72f7c8f3e2764a67fece"
+checksum = "778e2ac28f6c47af28e4907f13ffd1e1ddbd400980a9abd7c8df189bf578a5ad"
 dependencies = [
 "libc",
 "windows-sys 0.60.2",
 ]
 [[package]]
 name = "fastrand"
 version = "2.3.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "37909eebbb50d72f9059c3b6d82c0463f2ff062c9e95845c43a6c9c0355411be"
 [[package]]
 name = "flate2"
 version = "1.1.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "4a3d7db9596fecd151c5f638c0ee5d5bd487b6e0ea232e5dc96d5250f6f94b1d"
 dependencies = [
 "crc32fast",
 "miniz_oxide",
@ -348,14 +420,26 @@ checksum = "335ff9f135e4384c8150d6f27c6daed433577f86b4750418338c01a1a2528592"
 dependencies = [
 "cfg-if",
 "libc",
- "wasi",
+ "wasi 0.11.0+wasi-snapshot-preview1",
 ]
 [[package]]
 name = "getrandom"
 version = "0.3.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "26145e563e54f2cadc477553f1ec5ee650b00862f0a58bcd12cbdc5f0ea2d2f4"
 dependencies = [
 "cfg-if",
 "libc",
 "r-efi",
 "wasi 0.14.2+wasi-0.2.4",
 ]
 [[package]]
 name = "hashbrown"
-version = "0.15.3"
+version = "0.15.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "84b26c544d002229e640969970a2e74021aadf6e2f96372b9c58eff97de08eb3"
+checksum = "5971ac85611da7067dbfcabef3c70ebb5606018acd9e2a3903a0da507521e0d5"
 [[package]]
 name = "heck"
@ -489,9 +573,9 @@ dependencies = [
 [[package]]
 name = "indexmap"
-version = "2.9.0"
+version = "2.10.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cea70ddb795996207ad57735b50c5982d8844f38ba9ee5f1aedcfb708a2aa11e"
+checksum = "fe4cd85333e22411419a0bcae1297d25e58c9443848b11dc6a86fefe8c78a661"
 dependencies = [
 "equivalent",
 "hashbrown",
@ -499,13 +583,13 @@ dependencies = [
 [[package]]
 name = "indicatif"
-version = "0.17.11"
+version = "0.18.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "183b3088984b400f4cfac3620d5e076c84da5364016b4f49473de574b2586235"
+checksum = "70a646d946d06bedbbc4cac4c218acf4bbf2d87757a784857025f4d447e4e1cd"
 dependencies = [
- "console",
+ "console 0.16.0",
 "number_prefix",
 "portable-atomic",
 "unit-prefix",
 "web-time",
 ]
@ -557,9 +641,9 @@ dependencies = [
 [[package]]
 name = "libc"
-version = "0.2.172"
+version = "0.2.174"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d750af042f7ef4f724306de029d18836c26c1765a54a6a3f094cbd23a7267ffa"
+checksum = "1171693293099992e19cddea4e8b849964e9846f4acee11b3948bcc337be8776"
 [[package]]
 name = "libredox"
@ -571,6 +655,12 @@ dependencies = [
 "libc",
 ]
 [[package]]
 name = "linux-raw-sys"
 version = "0.9.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "cd945864f07fe9f5371a27ad7b52a172b4b499999f1d97574c9fa68373937e12"
 [[package]]
 name = "litemap"
 version = "0.8.0"
@ -591,15 +681,15 @@ checksum = "13dc2df351e3202783a1fe0d44375f7295ffb4049267b0f3018346dc122a1d94"
 [[package]]
 name = "memchr"
-version = "2.7.4"
+version = "2.7.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "78ca9ab1a0babb1e7d5695e3530886289c18cf2f87ec19a575a0abdce112e3a3"
+checksum = "32a282da65faaf38286cf3be983213fcf1d2e2a58700e808f83f4ea9a4804bc0"
 [[package]]
 name = "miniz_oxide"
-version = "0.8.8"
+version = "0.8.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3be647b768db090acb35d5ec5db2b0e1f1de11133ca123b9eacf5137868f892a"
+checksum = "1fa76a2c86f704bdb222d66965fb3d63269ce38518b83cb0575fca855ebb6316"
 dependencies = [
 "adler2",
 ]
@ -622,12 +712,6 @@ version = "0.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "51d515d32fb182ee37cda2ccdcb92950d6a3c2893aa280e540671c2cd0f3b1d9"
 [[package]]
 name = "number_prefix"
 version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "830b246a0e5f20af87141b25c173cd1b609bd7779a4617d6ec582abaf90870f3"
 [[package]]
 name = "once_cell"
 version = "1.21.3"
@ -648,9 +732,9 @@ checksum = "e3148f5046208a5d56bcfc03053e3ca6334e51da8dfb19b6cdc8b306fae3283e"
 [[package]]
 name = "portable-atomic"
-version = "1.11.0"
+version = "1.11.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "350e9b48cbc6b0e028b0473b114454c6316e57336ee184ceab6e53f72c178b3e"
+checksum = "f84267b20a16ea918e43c6a88433c2d54fa145c92a811b5b047ccbe153674483"
 [[package]]
 name = "portable-atomic-util"
@ -694,15 +778,21 @@ dependencies = [
 "proc-macro2",
 ]
 [[package]]
 name = "r-efi"
 version = "5.3.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "69cdb34c158ceb288df11e18b4bd39de994f6657d83847bdffdbd7f346754b0f"
 [[package]]
 name = "redox_users"
 version = "0.4.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "ba009ff324d1fc1b900bd1fdb31564febe58a8ccc8a6fdbb93b543d33b13ca43"
 dependencies = [
- "getrandom",
+ "getrandom 0.2.16",
 "libredox",
- "thiserror",
+ "thiserror 1.0.69",
 ]
 [[package]]
@ -742,17 +832,30 @@ checksum = "a4689e6c2294d81e88dc6261c768b63bc4fcdb852be6d1352498b114f61383b7"
 dependencies = [
 "cc",
 "cfg-if",
- "getrandom",
+ "getrandom 0.2.16",
 "libc",
 "untrusted",
 "windows-sys 0.52.0",
 ]
 [[package]]
-name = "rustls"
+name = "rustix"
-version = "0.23.27"
+version = "1.0.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "730944ca083c1c233a75c09f199e973ca499344a2b7ba9e755c457e86fb4a321"
+checksum = "c71e83d6afe7ff64890ec6b71d6a69bb8a610ab78ce364b3352876bb4c801266"
 dependencies = [
 "bitflags",
 "errno",
 "libc",
 "linux-raw-sys",
 "windows-sys 0.59.0",
 ]
 [[package]]
 name = "rustls"
 version = "0.23.29"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "2491382039b29b9b11ff08b76ff6c97cf287671dbb74f0be44bda389fffe9bd1"
 dependencies = [
 "log",
 "once_cell",
@ -783,15 +886,21 @@ dependencies = [
 [[package]]
 name = "rustls-webpki"
-version = "0.103.3"
+version = "0.103.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e4a72fe2bcf7a6ac6fd7d0b9e5cb68aeb7d4c0a0271730218b3e92d43b4eb435"
+checksum = "0a17884ae0c1b773f1ccd2bd4a8c72f16da897310a98b0e84bf349ad5ead92fc"
 dependencies = [
 "ring",
 "rustls-pki-types",
 "untrusted",
 ]
 [[package]]
 name = "rustversion"
 version = "1.0.21"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "8a0d197bd2c9dc6e53b84da9556a69ba4cdfab8619eb41a8bd1cc2027a0f6b1d"
 [[package]]
 name = "ryu"
 version = "1.0.20"
@ -846,24 +955,30 @@ checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"
 name = "shrupl"
 version = "0.1.0-alpha"
 dependencies = [
 "base64",
 "blake2b_simd",
 "clap",
- "console",
+ "console 0.16.0",
 "ctrlc",
 "dialoguer",
 "dirs-next",
 "env_logger",
 "indicatif",
 "log",
 "regex",
 "serde",
 "serde_json",
 "tempfile",
 "thiserror 2.0.12",
 "ureq",
 "uuid",
 ]
 [[package]]
 name = "smallvec"
-version = "1.15.0"
+version = "1.15.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8917285742e9f3e1683f0a9c4e6b57960b7314d0b08d30d1ecd426713ee2eee9"
+checksum = "67b1b7a3b5fe4f1376887184045fcf45c69e92af734b7aaddc05fb777b6fbd03"
 [[package]]
 name = "stable_deref_trait"
@ -885,9 +1000,9 @@ checksum = "13c2bddecc57b384dee18652358fb23172facb8a2c51ccc10d74c157bdea3292"
 [[package]]
 name = "syn"
-version = "2.0.101"
+version = "2.0.104"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8ce2b7fc941b3a24138a0a7cf8e858bfc6a992e7978a068a5c760deb0ed43caf"
+checksum = "17b6f705963418cdb9927482fa304bc562ece2fdd4f616084c50b7023b435a40"
 dependencies = [
 "proc-macro2",
 "quote",
@ -905,13 +1020,35 @@ dependencies = [
 "syn",
 ]
 [[package]]
 name = "tempfile"
 version = "3.20.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "e8a64e3985349f2441a1a9ef0b853f869006c3855f2cda6862a94d26ebb9d6a1"
 dependencies = [
 "fastrand",
 "getrandom 0.3.3",
 "once_cell",
 "rustix",
 "windows-sys 0.59.0",
 ]
 [[package]]
 name = "thiserror"
 version = "1.0.69"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "b6aaf5339b578ea85b50e080feb250a3e8ae8cfcdff9a461c9ec2904bc923f52"
 dependencies = [
- "thiserror-impl",
+ "thiserror-impl 1.0.69",
 ]
 [[package]]
 name = "thiserror"
 version = "2.0.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "567b8a2dae586314f7be2a752ec7474332959c6460e02bde30d702a66d488708"
 dependencies = [
 "thiserror-impl 2.0.12",
 ]
 [[package]]
@ -925,6 +1062,17 @@ dependencies = [
 "syn",
 ]
 [[package]]
 name = "thiserror-impl"
 version = "2.0.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "7f7cf42b4507d8ea322120659672cf1b9dbb93f8f2d4ecfd6e51350ff5b17a1d"
 dependencies = [
 "proc-macro2",
 "quote",
 "syn",
 ]
 [[package]]
 name = "time"
 version = "0.3.41"
@ -974,9 +1122,15 @@ checksum = "5a5f39404a5da50712a4c1eecf25e90dd62b613502b7e925fd4e4d19b5c96512"
 [[package]]
 name = "unicode-width"
-version = "0.2.0"
+version = "0.2.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1fc81956842c57dac11422a97c3b8195a1ff727f06e85c84ed2e8aa277c9a0fd"
+checksum = "4a1a07cc7db3810833284e8d372ccdc6da29741639ecc70c9ec107df0fa6154c"
 [[package]]
 name = "unit-prefix"
 version = "0.5.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "323402cff2dd658f39ca17c789b502021b3f18707c91cdf22e3838e1b4023817"
 [[package]]
 name = "untrusted"
@ -986,9 +1140,9 @@ checksum = "8ecb6da28b8a351d773b68d5825ac39017e680750f980f3a1a85cd8dd28a47c1"
 [[package]]
 name = "ureq"
-version = "3.0.11"
+version = "3.0.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b7a3e9af6113ecd57b8c63d3cd76a385b2e3881365f1f489e54f49801d0c83ea"
+checksum = "9f0fde9bc91026e381155f8c67cb354bcd35260b2f4a29bcc84639f762760c39"
 dependencies = [
 "base64",
 "cookie_store",
@ -1007,9 +1161,9 @@ dependencies = [
 [[package]]
 name = "ureq-proto"
-version = "0.4.1"
+version = "0.4.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fadf18427d33828c311234884b7ba2afb57143e6e7e69fda7ee883b624661e36"
+checksum = "59db78ad1923f2b1be62b6da81fe80b173605ca0d57f85da2e005382adf693f7"
 dependencies = [
 "base64",
 "http",
@ -1046,6 +1200,18 @@ version = "0.2.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "06abde3611657adf66d383f00b093d7faecc7fa57071cce2578660c9f1010821"
 [[package]]
 name = "uuid"
 version = "1.17.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "3cf4199d1e5d15ddd86a694e4d0dffa9c323ce759fea589f00fef9d81cc1931d"
 dependencies = [
 "atomic",
 "getrandom 0.3.3",
 "js-sys",
 "wasm-bindgen",
 ]
 [[package]]
 name = "version_check"
 version = "0.9.5"
@ -1058,6 +1224,15 @@ version = "0.11.0+wasi-snapshot-preview1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9c8d87e72b64a3b4db28d11ce29237c246188f4f51057d65a7eab63b7987e423"
 [[package]]
 name = "wasi"
 version = "0.14.2+wasi-0.2.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9683f9a5a998d873c0d21fcbe3c083009670149a8fab228644b8bd36b2c48cb3"
 dependencies = [
 "wit-bindgen-rt",
 ]
 [[package]]
 name = "wasm-bindgen"
 version = "0.2.100"
@ -1066,6 +1241,7 @@ checksum = "1edc8929d7499fc4e8f0be2262a241556cfc54a0bea223790e71446f2aab1ef5"
 dependencies = [
 "cfg-if",
 "once_cell",
 "rustversion",
 "wasm-bindgen-macro",
 ]
@ -1131,14 +1307,14 @@ version = "0.26.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "521bc38abb08001b01866da9f51eb7c5d647a19260e00054a8c7fd5f9e57f7a9"
 dependencies = [
- "webpki-roots 1.0.0",
+ "webpki-roots 1.0.1",
 ]
 [[package]]
 name = "webpki-roots"
-version = "1.0.0"
+version = "1.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2853738d1cc4f2da3a225c18ec6c3721abb31961096e9dbf5ab35fa88b19cfdb"
+checksum = "8782dd5a41a24eed3a4f40b606249b3e236ca61adf1f25ea4d45c73de122b502"
 dependencies = [
 "rustls-pki-types",
 ]
@ -1171,7 +1347,7 @@ version = "0.52.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "282be5f36a8ce781fad8c8ae18fa3f9beff57ec1b52cb3de0789201425d9a33d"
 dependencies = [
- "windows-targets",
+ "windows-targets 0.52.6",
 ]
 [[package]]
@ -1180,7 +1356,16 @@ version = "0.59.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1e38bc4d79ed67fd075bcc251a1c39b32a1776bbe92e5bef1f0bf1f8c531853b"
 dependencies = [
- "windows-targets",
+ "windows-targets 0.52.6",
 ]
 [[package]]
 name = "windows-sys"
 version = "0.60.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f2f500e4d28234f72040990ec9d39e3a6b950f9f22d3dba18416c35882612bcb"
 dependencies = [
 "windows-targets 0.53.2",
 ]
 [[package]]
@ -1189,14 +1374,30 @@ version = "0.52.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9b724f72796e036ab90c1021d4780d4d3d648aca59e491e6b98e725b84e99973"
 dependencies = [
- "windows_aarch64_gnullvm",
+ "windows_aarch64_gnullvm 0.52.6",
- "windows_aarch64_msvc",
+ "windows_aarch64_msvc 0.52.6",
- "windows_i686_gnu",
+ "windows_i686_gnu 0.52.6",
- "windows_i686_gnullvm",
+ "windows_i686_gnullvm 0.52.6",
- "windows_i686_msvc",
+ "windows_i686_msvc 0.52.6",
- "windows_x86_64_gnu",
+ "windows_x86_64_gnu 0.52.6",
- "windows_x86_64_gnullvm",
+ "windows_x86_64_gnullvm 0.52.6",
- "windows_x86_64_msvc",
+ "windows_x86_64_msvc 0.52.6",
 ]
 [[package]]
 name = "windows-targets"
 version = "0.53.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "c66f69fcc9ce11da9966ddb31a40968cad001c5bedeb5c2b82ede4253ab48aef"
 dependencies = [
 "windows_aarch64_gnullvm 0.53.0",
 "windows_aarch64_msvc 0.53.0",
 "windows_i686_gnu 0.53.0",
 "windows_i686_gnullvm 0.53.0",
 "windows_i686_msvc 0.53.0",
 "windows_x86_64_gnu 0.53.0",
 "windows_x86_64_gnullvm 0.53.0",
 "windows_x86_64_msvc 0.53.0",
 ]
 [[package]]
@ -1205,48 +1406,105 @@ version = "0.52.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "32a4622180e7a0ec044bb555404c800bc9fd9ec262ec147edd5989ccd0c02cd3"
 [[package]]
 name = "windows_aarch64_gnullvm"
 version = "0.53.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "86b8d5f90ddd19cb4a147a5fa63ca848db3df085e25fee3cc10b39b6eebae764"
 [[package]]
 name = "windows_aarch64_msvc"
 version = "0.52.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "09ec2a7bb152e2252b53fa7803150007879548bc709c039df7627cabbd05d469"
 [[package]]
 name = "windows_aarch64_msvc"
 version = "0.53.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "c7651a1f62a11b8cbd5e0d42526e55f2c99886c77e007179efff86c2b137e66c"
 [[package]]
 name = "windows_i686_gnu"
 version = "0.52.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "8e9b5ad5ab802e97eb8e295ac6720e509ee4c243f69d781394014ebfe8bbfa0b"
 [[package]]
 name = "windows_i686_gnu"
 version = "0.53.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "c1dc67659d35f387f5f6c479dc4e28f1d4bb90ddd1a5d3da2e5d97b42d6272c3"
 [[package]]
 name = "windows_i686_gnullvm"
 version = "0.52.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "0eee52d38c090b3caa76c563b86c3a4bd71ef1a819287c19d586d7334ae8ed66"
 [[package]]
 name = "windows_i686_gnullvm"
 version = "0.53.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9ce6ccbdedbf6d6354471319e781c0dfef054c81fbc7cf83f338a4296c0cae11"
 [[package]]
 name = "windows_i686_msvc"
 version = "0.52.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "240948bc05c5e7c6dabba28bf89d89ffce3e303022809e73deaefe4f6ec56c66"
 [[package]]
 name = "windows_i686_msvc"
 version = "0.53.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "581fee95406bb13382d2f65cd4a908ca7b1e4c2f1917f143ba16efe98a589b5d"
 [[package]]
 name = "windows_x86_64_gnu"
 version = "0.52.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "147a5c80aabfbf0c7d901cb5895d1de30ef2907eb21fbbab29ca94c5b08b1a78"
 [[package]]
 name = "windows_x86_64_gnu"
 version = "0.53.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "2e55b5ac9ea33f2fc1716d1742db15574fd6fc8dadc51caab1c16a3d3b4190ba"
 [[package]]
 name = "windows_x86_64_gnullvm"
 version = "0.52.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "24d5b23dc417412679681396f2b49f3de8c1473deb516bd34410872eff51ed0d"
 [[package]]
 name = "windows_x86_64_gnullvm"
 version = "0.53.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "0a6e035dd0599267ce1ee132e51c27dd29437f63325753051e71dd9e42406c57"
 [[package]]
 name = "windows_x86_64_msvc"
 version = "0.52.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec"
 [[package]]
 name = "windows_x86_64_msvc"
 version = "0.53.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "271414315aff87387382ec3d271b52d7ae78726f5d44ac98b4f4030c91880486"
 [[package]]
 name = "wit-bindgen-rt"
 version = "0.39.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "6f42320e61fe2cfd34354ecb597f86f413484a798ba44a8ca1165c58d42da6c1"
 dependencies = [
 "bitflags",
 ]
 [[package]]
 name = "writeable"
 version = "0.6.1"
--- a/Cargo.toml
+++ b/Cargo.toml
@ -5,18 +5,32 @@ edition = "2024"
 description = "ShrUpl is a tool to upload files to a Sharry Instance through a public Alias, leveraging the tus protocol"
 [dependencies]
-clap = { version = "4.5.38", features = ["derive"] }
+base64 = { version = "0.22.1", default-features = false }
-console = { version = "0.15.11", default-features = false }
+blake2b_simd = "1.0.3"
 clap = { version = "4.5.41", features = ["derive"] }
 console = { version = "0.16.0", default-features = false }
 ctrlc = { version = "3.4.7", features = ["termination"] }
 dialoguer = { version = "0.11.0", default-features = false }
 dirs-next = "2.0.0"
 env_logger = "0.11.8"
-indicatif = { version = "0.17.11", default-features = false }
+indicatif = { version = "0.18.0", default-features = false }
 log = "0.4.27"
 regex = "1.11.1"
 serde = { version = "1.0.219", features = ["derive"] }
 serde_json = "1.0.140"
-ureq = { version = "3.0.11", features = ["json"] }
+thiserror = "2.0.12"
 ureq = { version = "3.0.12", features = ["json"] }
 [dev-dependencies]
 tempfile = "3.20.0"
 uuid = { version = "1.17.0", features = ["rng", "std", "v1"] }
 [profile.release]
 # Optimize for speed even more aggressively
 opt-level = "z"
 # better inlining
 codegen-units = 1
 # linker‐time optimization
 lto = true
 debug = false
 panic = "abort"
--- a/doc/duck.ai_2025-06-05_04-03-23.md
+++ b/doc/duck.ai_2025-06-05_04-03-23.md
@ -1,87 +0,0 @@
 Diese Konversation wurde mit Duck.ai (https://duck.ai) unter Verwendung des o3-mini-Modells von OpenAI generiert. KI-Chats zeigen möglicherweise falsche oder anstößige Informationen an (weitere Informationen siehe https://duckduckgo.com/duckai/privacy-terms).
 ====================
 Benutzereingabe 1 von 2 - 5.6.2025, 02:27:36:
 in Rust, what can I use to display multiple progress bars in the terminal?
 o3-mini:
 You can use the indicatif crate, which provides a MultiProgress type that lets you manage and display multiple progress bars concurrently in a terminal.
 Below is a simple example of how to use indicatif’s MultiProgress to display multiple progress bars:
 ```rust
 use indicatif::{MultiProgress, ProgressBar, ProgressStyle};
 use std::{thread, time::Duration};
 fn main() {
    // Create a MultiProgress container.
    let m = MultiProgress::new();
    // Create several progress bars.
    let pb1 = m.add(ProgressBar::new(100));
    pb1.set_style(
        ProgressStyle::default_bar()
            .template("{msg} {bar:40.cyan/blue} {pos:>3}/{len:3}")
            .expect("Failed to set progress bar style"),
    );
    pb1.set_message("Downloading");
    let pb2 = m.add(ProgressBar::new(50));
    pb2.set_style(
        ProgressStyle::default_bar()
            .template("{msg} {bar:40.green/black} {pos:>3}/{len:3}")
            .expect("Failed to set progress bar style"),
    );
    pb2.set_message("Processing");
    // Optionally, spawn threads to update the progress bars concurrently.
    let h1 = std::thread::spawn(move || {
        for i in 0..=100 {
            pb1.set_position(i);
            thread::sleep(Duration::from_millis(50));
        }
        pb1.finish_with_message("Download complete");
    });
    let h2 = std::thread::spawn(move || {
        for i in 0..=50 {
            pb2.set_position(i);
            thread::sleep(Duration::from_millis(100));
        }
        pb2.finish_with_message("Processing complete");
    });
    // Wait for threads to complete. MultiProgress takes care of rendering.
    h1.join().expect("Thread 1 panicked");
    h2.join().expect("Thread 2 panicked");
    // You may also iterate on the multi-progress which blocks until all bars finish:
    // m.join().unwrap();
 }
 ```
 ### Steps Explained
 1. **MultiProgress Container**:  
   Create a `MultiProgress` instance which is used to manage multiple progress bars.
 2. **Progress Bars**:  
   Create individual progress bars using `MultiProgress::add()`. You can customize each progress bar with a message, style, and length.
 3. **Concurrent Updates**:  
   The example spawns two threads – one for each progress bar. Each thread updates its progress bar independently using `set_position()` and finishes the progress bar with `finish_with_message()`.
 4. **Thread Joining**:  
   Ensure the main thread waits for the worker threads to complete to prevent the program from exiting prematurely.
 ### Installation
 Make sure to add indicatif to your Cargo.toml:
 ```toml
 [dependencies]
 indicatif = "0.17"  # or the latest version available on crates.io
 ```
 This crate provides many options for customizing and using progress bars in a concurrent and effective manner. The documentation is available at [indicatif on docs.rs](https://docs.rs/indicatif) for further details and advanced usage.
--- a/doc/notes.md
+++ b/doc/notes.md
@ -1,4 +1,4 @@
-outline of sharry uploading
+# Outline of sharry upload API
 1. POST to "new" route
    - uri: https://sharry.yavook.de/api/v2/alias/upload/new
@ -32,6 +32,16 @@ outline of sharry uploading
    - res.status == 200
    - res_json.success, res_json.message
 hints
- https://stackoverflow.com/questions/59586787/rust-how-to-do-http-put-of-large-files
+# Links
 - yvk repo: https://code.yavook.de/jmm/shrupl
 - sharry issue: https://github.com/eikek/sharry/issues/1659
 # Ideas
 - cli functions
    - "continue" and "new" flags to avoid user interaction
    - "quiet" flag to disable output entirely
    - some switch to change log to "pretty-print"
--- a/src/appstate.rs
+++ b/src/appstate.rs
@ -1,185 +1,153 @@
-use std::{
+use std::{fmt, io, time::Duration};
    collections::VecDeque,
    fs,
    io::{self, Write},
    path::{Path, PathBuf},
 };
-use console::style;
+use indicatif::ProgressBar;
-use indicatif::{ProgressBar, ProgressStyle};
+use log::{debug, warn};
 use log::{debug, trace};
 use serde::{Deserialize, Serialize};
-use super::{
+use crate::{
    cachefile::CacheFile,
    cli::Cli,
-    sharry::{Alias, ChunkState, FileChecked, FileUploading, Share, UploadError},
+    file::{Chunk, FileTrait},
    output::new_progressbar,
    sharry::{Client, ShareID},
 };
 #[derive(Serialize, Deserialize, Debug)]
 pub struct AppState {
    #[serde(skip)]
    file_name: PathBuf,
    #[serde(skip)]
    progress: Option<ProgressBar>,
-
+    http: ureq::Agent,
-    alias: Alias,
+    inner: CacheFile,
    share: Share,
    files: VecDeque<FileState>,
 }
-#[derive(Serialize, Deserialize, Debug)]
+impl fmt::Debug for AppState {
-enum FileState {
+    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
-    C(FileChecked),
+        f.debug_struct("AppState")
-    U(FileUploading),
+            .field("inner", &self.inner)
            .finish_non_exhaustive()
    }
 }
-impl FileState {
+fn new_http(args: &Cli) -> ureq::Agent {
-    fn file_name(&self) -> &str {
+    ureq::Agent::config_builder()
-        match self {
+        .timeout_global(args.get_timeout())
-            FileState::C(checked) => checked.file_name(),
+        .build()
-            FileState::U(uploading) => uploading.file_name(),
+        .into()
-        }
+}
-    }
+
 fn new_share(args: &Cli) -> crate::Result<ShareID> {
    new_http(args).share_create(&args.get_uri(), &args.alias, args.get_share_request())
 }
 impl AppState {
-    fn cache_dir() -> PathBuf {
+    fn new(http: ureq::Agent, inner: CacheFile) -> Self {
        let dir_name = dirs_next::cache_dir()
            .expect("could not determine cache directory")
            .join("shrupl");
        trace!("cachedir: {:?}", dir_name.display());
        dir_name
    }
    fn cache_file(args: &Cli) -> PathBuf {
        let file_name = Self::cache_dir().join(format!("{}.json", args.get_hash()));
        trace!("cachefile: {:?}", file_name.display());
        file_name
    }
    fn load(file_name: impl AsRef<Path>) -> io::Result<Self> {
        let content = fs::read_to_string(file_name)?;
        serde_json::from_str(&content).map_err(io::Error::other)
    }
    pub fn try_resume(args: &Cli) -> Option<Self> {
        let file_name = Self::cache_file(args);
        Self::load(&file_name)
            .inspect_err(|e| debug!("could not resume from {:?}: {e}", file_name.display()))
            .map(|state| {
                debug!("successfully loaded AppState");
        Self {
                    file_name,
            progress: None,
-                    alias: state.alias,
+            http,
-                    share: state.share,
+            inner,
                    files: state.files,
        }
            })
            .ok()
    }
-    pub fn from_args(args: &Cli, http: &ureq::Agent) -> Result<Self, ureq::Error> {
+    pub fn try_resume(args: &Cli) -> crate::Result<Self> {
-        let file_name = Self::cache_file(args);
+        Ok(Self::new(new_http(args), CacheFile::try_resume(args)?))
        let alias = args.get_alias();
        let share = Share::create(http, &alias, args.get_share_request())?;
        let files: VecDeque<_> = args.files.clone().into_iter().map(FileState::C).collect();
        Ok(Self {
            file_name,
            progress: None,
            alias,
            share,
            files,
        })
    }
-    pub fn file_names(&self) -> Vec<&str> {
+    pub fn from_args(args: &Cli) -> crate::Result<Self> {
-        self.files.iter().map(FileState::file_name).collect()
+        Ok(Self::new(
-    }
+            new_http(args),
-
+            CacheFile::from_args(args, new_share)?,
    pub fn upload_chunk(
        &mut self,
        http: &ureq::Agent,
        chunk_size: usize,
    ) -> Result<Option<()>, UploadError> {
        let uploading = match self.files.pop_front() {
            Some(FileState::C(checked)) => checked
                .start_upload(http, &self.alias, &self.share)
                .unwrap(),
            Some(FileState::U(uploading)) => uploading,
            None => return Ok(None),
        };
        debug!("{uploading} chunk {chunk_size}");
        let pb = match self.progress {
            Some(ref pb) => pb,
            None => {
                self.progress = Some({
                    let pb = {
                        let ps = ProgressStyle::with_template(&format!(
                            "{{msg:.yellow}}: {{bar:50.cyan/blue}} {{binary_bytes:.magenta}}{}{{binary_total_bytes:.magenta}} ({{elapsed}})",
                            style("/").magenta(),
        ))
                        .unwrap();
                        ProgressBar::new(uploading.size())
                            .with_style(ps)
                            .with_message(uploading.file_name().to_owned())
                            .with_position(uploading.offset())
                    };
                    pb.tick();
                    pb
                });
                self.progress.as_ref().unwrap()
    }
        };
        pb.tick();
-        match uploading.upload_chunk(http, &self.alias, chunk_size) {
+    fn with_progressbar(&mut self, f: impl FnOnce(&ProgressBar), drop_bar: bool) {
-            ChunkState::Ok(upl) => {
+        let bar = &*self.progress.get_or_insert_with(new_progressbar);
-                pb.set_position(upl.offset());
+
-                self.files.push_front(FileState::U(upl));
+        if let Some(upl) = self.inner.peek_uploading() {
-                Ok(Some(()))
+            if bar.length().is_none() {
                bar.set_length(upl.get_size());
                bar.set_message(upl.get_name().to_string());
                bar.enable_steady_tick(Duration::from_millis(100));
            }
-            ChunkState::Err(upl, e) => {
+
-                self.files.push_front(FileState::U(upl));
+            bar.set_position(upl.get_offset());
-                Err(e)
+            // BUG in `indicatif` crate?
            // `set_position` does not force an immediate redraw like e.g. `inc_length`
        }
-            ChunkState::Finished(path) => {
+
-                debug!("Finished {:?}!", path.display());
+        f(bar);
-                pb.finish();
+
        if drop_bar {
            self.progress = None;
-                self.share.notify(http, &self.alias).unwrap();
+        }
    }
-                Ok(self.files.front().map(drop))
+    fn touch_progressbar(&mut self) {
        self.with_progressbar(|_| (), false);
    }
    fn drop_progressbar(&mut self, f: impl FnOnce(&ProgressBar)) {
        self.with_progressbar(f, true);
    }
    fn next_chunk<'t>(&mut self, buffer: &'t mut [u8]) -> crate::Result<Option<Chunk<'t>>> {
        if self.inner.get_uploading(&self.http)?.is_none() {
            return Ok(None);
        }
        self.touch_progressbar();
        let uploading = self.inner.expect_uploading();
        debug!("{uploading:?}");
        let chunk = uploading.read(buffer)?;
        debug!("{chunk:?}");
        Ok(Some(chunk))
    }
    pub fn upload_chunk(&mut self, buffer: &mut [u8]) -> crate::Result<bool> {
        let Some(chunk) = self.next_chunk(buffer)? else {
            self.inner
                .share_notify(&self.http)
                .unwrap_or_else(|e| warn!("Failed to notify the share: {e}"));
            return Ok(true);
        };
        self.inner.file_patch(&self.http, &chunk)?;
        self.touch_progressbar();
        if let Some(path) = self.inner.check_eof() {
            debug!("Finished {:?}!", path.display());
            self.drop_progressbar(ProgressBar::finish);
        }
        Ok(self.inner.peek_uploading().is_none() && self.inner.queue().is_empty())
    }
    #[must_use]
    pub fn rewind_chunk(mut self) -> Option<Self> {
        self.inner = self.inner.rewind_chunk()?;
        Some(self)
    }
    pub fn abort_upload(&mut self) {
        self.inner.abort_upload();
        self.drop_progressbar(ProgressBar::abandon);
    }
    pub fn rebuild_share(self, args: &Cli) -> crate::Result<Self> {
        Ok(Self::new(self.http, CacheFile::from_args(args, new_share)?))
    }
    pub fn save(&self) -> io::Result<()> {
-        fs::create_dir_all(Self::cache_dir())?;
+        self.inner.save()
        let json = serde_json::to_string_pretty(self).map_err(io::Error::other)?;
        let mut file = fs::File::create(&self.file_name)?;
        file.write_all(json.as_bytes())?;
        trace!("updated {:?}", self.file_name.display());
        Ok(())
    }
-    pub fn clear(self) -> io::Result<()> {
+    pub fn discard(self) -> io::Result<()> {
-        fs::remove_file(&self.file_name)?;
+        self.inner.discard()
    }
-        trace!("removed {:?}", self.file_name.display());
+    pub fn clear_any(args: &Cli) {
-        Ok(())
+        CacheFile::clear_any(args);
    }
 }
--- a/src/bin/shrupl.rs
+++ b/src/bin/shrupl.rs
@ -0,0 +1,142 @@
 use std::{
    process,
    sync::{
        Arc,
        atomic::{AtomicBool, Ordering},
    },
 };
 use clap::Parser;
 use console::{StyledObject, style};
 use log::{info, trace};
 use shrupl::{
    AppState, Cli,
    output::{self, Log, SHRUPL},
 };
 fn main() {
    let args = Cli::parse();
    env_logger::Builder::new()
        .filter_module("shrupl", args.get_level_filter())
        .parse_default_env()
        .init();
    info!("args: {args:#?}");
    println!("{} to {}!", style("Welcome").magenta().bold(), *SHRUPL);
    let resumed = AppState::try_resume(&args);
    let check_ctrlc = {
        let stop = Arc::new(AtomicBool::new(false));
        let stop_ctrlc = stop.clone();
        ctrlc::set_handler(move || {
            stop_ctrlc.store(true, Ordering::SeqCst);
            eprintln!("{} stopping as soon as possible!", *SHRUPL);
        })
        .expect("Error setting Ctrl-C handler");
        move || {
            if stop.load(Ordering::SeqCst) {
                process::exit(255);
            }
        }
    };
    let mut state = resumed
        .inspect_err(|e| {
            AppState::clear_any(&args);
            Log::handle(e);
            info!("could not resume from hash {:?}: {e}", args.get_hash());
        })
        .ok()
        .and_then(|state| output::prompt_continue().then_some(state))
        .unwrap_or_else(|| match AppState::from_args(&args) {
            Ok(state) => {
                state.save().unwrap_or_else(|e| {
                    Log::warning(format_args!("Failed to save state: {e}"));
                });
                state
            }
            Err(e) => {
                Log::handle(&e);
                Log::error(format_args!("Failed to create state: {e}"));
            }
        });
    check_ctrlc();
    info!("continuing with state: {state:#?}");
    let fns_magenta = output::style_all(&args.file_names(), StyledObject::magenta).join(", ");
    println!("{} is uploading: {fns_magenta}", *SHRUPL);
    let mut buffer = vec![0; args.chunk_size * 1024 * 1024];
    let mut tries = 0;
    loop {
        if !args.may_retry(tries) {
            Log::error("Retry limit reached!");
        }
        match state.upload_chunk(&mut buffer) {
            Err(e) => {
                Log::handle(&e);
                if let Some(p) = e.get_invalid_param() {
                    match p {
                        // Error 404 (File not found)
                        shrupl::Parameter::FileID(fid) => {
                            info!("retrying file {fid:?}");
                            state.abort_upload();
                        }
                        // Error 404 (Share not found)
                        shrupl::Parameter::ShareID(sid) => {
                            output::prompt_rebuild_share();
                            info!("rebuilding share {sid:?}");
                            // rebuild share
                            let Ok(s) = state.rebuild_share(&args) else {
                                Log::error("Failed to rebuild share!");
                            };
                            state = s;
                        }
                        p => Log::error(format_args!("Unexpected {p}!")),
                    }
                } else {
                    // retry chunk
                    let Some(s) = state.rewind_chunk() else {
                        Log::error("Failed to retry chunk!");
                    };
                    tries += 1;
                    info!("State rewound, retrying last chunk (tries: {tries})");
                    state = s;
                }
            }
            Ok(false) => {
                trace!("chunk uploaded");
                tries = 0;
            }
            Ok(true) => {
                info!("all uploads done");
                break;
            }
        }
        state.save().unwrap_or_else(|e| {
            Log::warning(format_args!("Failed to save state: {e}"));
        });
        check_ctrlc();
    }
    state.discard().unwrap_or_else(|e| {
        Log::warning(format_args!("Failed to remove state: {e}"));
    });
    println!("{} finished {}", *SHRUPL, style("successfully!").green());
 }
--- a/src/cachefile.rs
+++ b/src/cachefile.rs
@ -0,0 +1,223 @@
 use std::{
    collections::VecDeque,
    fs,
    io::{self, Write},
    path::{Path, PathBuf},
    time::Duration,
 };
 use indicatif::ProgressBar;
 use log::{info, trace};
 use serde::{Deserialize, Serialize};
 use crate::{
    cli::Cli,
    file::{self, Chunk, FileTrait},
    output::new_progressbar,
    sharry::{AliasID, Client, ShareID, Uri},
 };
 #[derive(Serialize, Deserialize, Debug)]
 pub struct CacheFile {
    #[serde(skip)]
    file_name: PathBuf,
    uri: Uri,
    alias_id: AliasID,
    share_id: ShareID,
    uploading: Option<file::Uploading>,
    files: VecDeque<file::Checked>,
 }
 impl CacheFile {
    fn cache_dir() -> PathBuf {
        let dir_name = dirs_next::cache_dir()
            .expect("could not determine cache directory")
            .join("shrupl");
        trace!("cachedir: {:?}", dir_name.display());
        dir_name
    }
    fn cache_file(args: &Cli) -> PathBuf {
        let file_name = Self::cache_dir().join(format!("{}.json", args.get_hash()));
        trace!("cachefile: {:?}", file_name.display());
        file_name
    }
    pub fn try_resume(args: &Cli) -> crate::Result<Self> {
        let file_name = Self::cache_file(args);
        let state: Self = {
            let file = fs::File::open(&file_name)?;
            let reader = io::BufReader::new(file);
            serde_json::from_reader(reader).map_err(io::Error::other)?
        };
        if args.should_hash() {
            fn check_hash(file: &impl FileTrait, bar: &ProgressBar) -> crate::Result<()> {
                bar.set_message(format!("checking {:?}", file.get_name()));
                file.check_hash(|bytes| bar.inc(bytes))
            }
            info!("checking files in {state:?}");
            // BOOKMARK assumption: total file size < 2 EiB
            let total_size = {
                let upl_size = if let Some(upl) = state.peek_uploading() {
                    upl.get_size()
                } else {
                    0
                };
                upl_size + state.queue().iter().map(|&f| f.get_size()).sum::<u64>()
            };
            let bar = new_progressbar();
            bar.set_length(total_size);
            bar.enable_steady_tick(Duration::from_millis(50));
            if let Some(upl) = state.peek_uploading() {
                check_hash(upl, &bar)?;
            }
            for chk in state.queue() {
                check_hash(chk, &bar)?;
            }
            bar.finish_with_message("finished checking files");
        }
        Ok(Self { file_name, ..state })
    }
    pub fn from_args(
        args: &Cli,
        new_share: impl FnOnce(&Cli) -> crate::Result<ShareID>,
    ) -> crate::Result<Self> {
        let mut files = args.files.clone();
        if args.should_hash() {
            info!("hashing files {files:?}");
            let bar = new_progressbar();
            // BOOKMARK assumption: total file size < 2 EiB
            bar.set_length(files.iter().map(FileTrait::get_size).sum());
            bar.enable_steady_tick(Duration::from_millis(50));
            for chk in &mut files {
                bar.set_message(format!("hashing {:?}", chk.get_name()));
                chk.hash(|bytes| bar.inc(bytes))?;
            }
            bar.finish_with_message("finished hashing files");
        }
        Ok(Self {
            file_name: Self::cache_file(args),
            uri: args.get_uri(),
            alias_id: args.alias.clone(),
            share_id: new_share(args)?,
            uploading: None,
            files: files.into(),
        })
    }
    pub fn queue(&self) -> Vec<&file::Checked> {
        self.files.iter().collect()
    }
    pub fn get_uploading(
        &mut self,
        client: &impl Client,
    ) -> crate::Result<Option<&mut file::Uploading>> {
        if self.uploading.is_some() {
            Ok(self.uploading.as_mut())
        } else if let Some(chk) = self.files.pop_front() {
            let upl = chk.start_upload(client, &self.uri, &self.alias_id, &self.share_id)?;
            self.uploading.replace(upl);
            Ok(self.uploading.as_mut())
        } else {
            Ok(None)
        }
    }
    pub fn expect_uploading(&mut self) -> &mut file::Uploading {
        self.uploading
            .as_mut()
            .expect("expect_uploading called while not uploading")
    }
    pub fn peek_uploading(&self) -> Option<&file::Uploading> {
        self.uploading.as_ref()
    }
    pub fn check_eof(&mut self) -> Option<PathBuf> {
        if let Some(upl) = self.uploading.take() {
            match upl.check_eof() {
                Ok(upl) => self.uploading = Some(upl),
                Err(p) => return Some(p),
            }
        }
        None
    }
    pub fn rewind_chunk(mut self) -> Option<Self> {
        let upl = self
            .uploading
            .take()
            .expect("rewind_chunk called while not uploading");
        self.uploading = Some(upl.rewind()?);
        Some(self)
    }
    pub fn abort_upload(&mut self) {
        let upl = self
            .uploading
            .take()
            .expect("abort_upload called while not uploading");
        self.files.push_front(upl.stop());
    }
    pub fn share_notify(&self, client: &impl Client) -> crate::Result<()> {
        client.share_notify(&self.uri, &self.alias_id, &self.share_id)
    }
    pub fn file_patch(&self, client: &impl Client, chunk: &Chunk) -> crate::Result<()> {
        client.file_patch(&self.uri, &self.alias_id, &self.share_id, chunk)
    }
    pub fn save(&self) -> io::Result<()> {
        let cache_dir = self.file_name.parent().ok_or_else(|| {
            io::Error::other(format!("orphan file {:?}", self.file_name.display()))
        })?;
        fs::create_dir_all(cache_dir)?;
        let json = serde_json::to_string_pretty(self).map_err(io::Error::other)?;
        let mut file = fs::File::create(&self.file_name)?;
        file.write_all(json.as_bytes())?;
        trace!("updated {:?}", self.file_name.display());
        Ok(())
    }
    fn remove(path: &Path) -> io::Result<()> {
        fs::remove_file(path)?;
        trace!("removed {:?}", path.display());
        Ok(())
    }
    pub fn clear_any(args: &Cli) {
        let _ = Self::remove(&Self::cache_file(args));
    }
    pub fn discard(self) -> io::Result<()> {
        Self::remove(&self.file_name)
    }
 }
--- a/src/cli.rs
+++ b/src/cli.rs
@ -1,13 +1,16 @@
-use std::{
+use std::{convert::Infallible, fmt, io, time::Duration};
-    hash::{DefaultHasher, Hash, Hasher},
+
-    time::Duration,
+use base64::prelude::{BASE64_URL_SAFE_NO_PAD as BASE64URL, Engine};
 use blake2b_simd::Params as Blake2b;
 use clap::{Parser, builder::TypedValueParser, value_parser};
 use log::LevelFilter;
 use crate::{
    file::{Checked, FileTrait},
    sharry::{AliasID, Uri, json::NewShareRequest},
 };
-use clap::{Parser, builder::PossibleValuesParser};
+#[derive(Parser)]
 use super::sharry::{Alias, FileChecked, NewShareRequest, Uri};
 #[derive(Parser, Debug, Hash)]
 #[command(version, about, long_about = None)]
 pub struct Cli {
    /// Timeout in seconds for HTTP actions (set 0 or invalid to disable)
@ -18,17 +21,13 @@ pub struct Cli {
    )]
    timeout: Duration,
-    /// Protocol for Sharry instance
+    /// Number of times actions are retried
-    #[arg(
+    #[arg(short, long, default_value_t = 5, value_name = "N")]
-        short, long,
+    retry_limit: u32,
        default_value = "https", value_name = "VARIANT",
        value_parser = PossibleValuesParser::new(["http", "https"]),
    )]
    protocol: String,
    /// Name of the new share
    #[arg(short, long, default_value = "ShrUpl Upload", value_name = "TEXT")]
-    name: String,
+    share_name: String,
    /// Description of the new share
    #[arg(short, long, value_name = "TEXT")]
@ -39,52 +38,122 @@ pub struct Cli {
    max_views: u32,
    /// Chunk size for uploading, in MiB
-    #[arg(short, long, default_value_t = 10, value_name = "N")]
+    #[arg(
        short, long,
        default_value_t = 4, value_name = "M",
        value_parser = value_parser!(u32).range(1..).map(|s| s as usize),
    )]
    pub chunk_size: usize,
    /// Don't hash files before uploading
    #[arg(short, long)]
    no_hash: bool,
    /// Increase output verbosity
    #[arg(short, long, action = clap::ArgAction::Count)]
    verbose: u8,
    /// Base URL for Sharry Instance
    url: String,
    /// ID of a public alias to use
-    alias: String,
+    pub alias: AliasID,
    /// Files to upload to the new share
    #[arg(value_name = "FILE", required = true, value_parser = parse_sharry_file)]
-    pub files: Vec<FileChecked>,
+    pub files: Vec<Checked>,
 }
-fn parse_seconds(data: &str) -> Result<Duration, String> {
+impl fmt::Debug for Cli {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.debug_struct("Cli")
            .field("uri", &self.get_uri())
            .field("retry_limit", &self.retry_limit)
            .field("alias", &self.alias)
            .field("timeout", &self.get_timeout())
            .field("chunk_size", &self.chunk_size)
            .field("share_request", &self.get_share_request())
            .field("files", &self.files)
            .field("level_filter", &self.get_level_filter())
            .field("hash", &self.get_hash())
            .finish_non_exhaustive()
    }
 }
 fn parse_seconds(data: &str) -> Result<Duration, Infallible> {
    data.parse().or(Ok(0)).map(Duration::from_secs)
 }
-fn parse_sharry_file(data: &str) -> Result<FileChecked, String> {
+fn parse_sharry_file(data: &str) -> io::Result<Checked> {
-    FileChecked::new(data).map_err(|e| e.to_string())
+    Checked::new(data)
 }
 fn sorted<T>(values: &[T]) -> Vec<&T>
 where
    T: Ord,
 {
    let mut refs: Vec<_> = values.iter().collect();
    refs.sort_unstable();
    refs
 }
 impl Cli {
    #[must_use]
    pub fn get_timeout(&self) -> Option<Duration> {
        (!self.timeout.is_zero()).then_some(self.timeout)
    }
-    pub fn get_alias(&self) -> Alias {
+    #[must_use]
-        Alias::new(Uri::with_protocol(&self.protocol, &self.url), &self.alias)
+    pub fn get_uri(&self) -> Uri {
        self.url.clone().into()
    }
    #[must_use]
    pub fn may_retry(&self, tries: u32) -> bool {
        match self.retry_limit {
            0 => true,
            limit => tries < limit,
        }
    }
    #[must_use]
    pub fn should_hash(&self) -> bool {
        !self.no_hash
    }
    #[must_use]
    pub fn get_share_request(&self) -> NewShareRequest {
-        NewShareRequest::new(&self.name, self.description.as_ref(), self.max_views)
+        NewShareRequest::new(&self.share_name, self.max_views)
            .description(self.description.as_ref())
    }
    #[must_use]
    pub fn get_level_filter(&self) -> LevelFilter {
        match self.verbose {
            0 => LevelFilter::Error,
            1 => LevelFilter::Warn,
            2 => LevelFilter::Info,
            3 => LevelFilter::Debug,
            _ => LevelFilter::Trace,
        }
    }
    pub fn file_names(&self) -> Vec<&str> {
        self.files.iter().map(FileTrait::get_name).collect()
    }
    #[must_use]
    pub fn get_hash(&self) -> String {
-        let file_refs = {
+        let mut hasher = Blake2b::new().hash_length(16).to_state();
            let mut refs: Vec<_> = self.files.iter().collect();
            refs.sort_unstable();
-            refs
+        hasher.update(self.get_uri().as_ref());
-        };
+        hasher.update(self.alias.as_ref().as_bytes());
-        let mut hasher = DefaultHasher::new();
+        for chk in sorted(&self.files) {
-        (self.get_alias(), file_refs).hash(&mut hasher);
+            hasher.update(chk.as_ref());
        }
-        format!("{:x}", hasher.finish())
+        BASE64URL.encode(hasher.finalize())
    }
 }
--- a/src/error.rs
+++ b/src/error.rs
@ -0,0 +1,203 @@
 use std::fmt;
 use crate::sharry;
 #[derive(Debug, thiserror::Error)]
 pub enum Parameter {
    #[error("given URI {0:?}")]
    Uri(sharry::Uri),
    #[error("given Alias ID {0:?}")]
    AliasID(sharry::AliasID),
    #[error("stored Share ID {0:?}")]
    ShareID(sharry::ShareID),
    #[error("stored {0:?}")]
    FileID(sharry::FileID),
 }
 // a helper to generate all the `From<T> for Parameter` impls
 macro_rules! impl_param_from {
    // $typ: the source type; $var: the enum‐variant name
    ( $( $typ:path => $var:ident ),* $(,)? ) => {
        $(
            impl From<$typ> for Parameter {
                fn from(value: $typ) -> Self {
                    Self::$var(value)
                }
            }
        )*
    };
 }
 impl_param_from! {
    sharry::Uri     => Uri,
    sharry::AliasID => AliasID,
    sharry::ShareID => ShareID,
    sharry::FileID  => FileID,
 }
 impl Parameter {
    fn is_fatal(&self) -> bool {
        self.is_uri() || self.is_alias_id()
    }
    #[must_use]
    pub fn is_uri(&self) -> bool {
        matches!(self, Self::Uri(_))
    }
    #[must_use]
    pub fn is_alias_id(&self) -> bool {
        matches!(self, Self::AliasID(_))
    }
    #[must_use]
    pub fn is_share_id(&self) -> bool {
        matches!(self, Self::ShareID(_))
    }
    #[must_use]
    pub fn is_file_id(&self) -> bool {
        matches!(self, Self::FileID(_))
    }
 }
 #[derive(Debug, thiserror::Error)]
 pub enum Error {
    #[error(transparent)]
    StdIo(#[from] std::io::Error),
    #[error("Response error: {0}")]
    Response(String),
    #[error("Invalid {0}")]
    InvalidParameter(Parameter),
    #[error("Mismatch, expected {expected:?} but got {actual:?}")]
    Mismatch { expected: String, actual: String },
    #[error("Unknown error: {0}")]
    Unknown(String),
 }
 pub type Result<T> = std::result::Result<T, Error>;
 // a helper to generate all the `From<T> for Error` impls
 macro_rules! impl_error_from {
    // $typ: the source type
    ( $( $typ:path ),* $(,)? ) => {
        $(
            // // implement for values
            // impl From<$typ> for Error {
            //     fn from(value: $typ) -> Self {
            //         Self::InvalidParameter(value.into())
            //     }
            // }
            // implement for references
            impl From<&$typ> for Error {
                fn from(value: &$typ) -> Self {
                    Self::InvalidParameter(value.clone().into())
                }
            }
        )*
    };
 }
 impl_error_from! {
    sharry::Uri,
    sharry::AliasID,
    sharry::ShareID,
    sharry::FileID,
 }
 #[allow(clippy::needless_pass_by_value)]
 fn into_string(val: impl ToString) -> String {
    val.to_string()
 }
 impl Error {
    pub fn res_status_check<T>(actual: T, expected: T) -> Result<()>
    where
        T: PartialEq + fmt::Display + Copy,
    {
        if actual == expected {
            Ok(())
        } else {
            Err(Self::Response(format!(
                "unexpected status: {actual} (expected {expected})"
            )))
        }
    }
    pub fn response(e: impl ToString) -> Self {
        Self::Response(into_string(e))
    }
    pub fn mismatch<T>(expected: impl ToString, actual: impl ToString) -> Result<T> {
        Err(Self::Mismatch {
            expected: into_string(expected),
            actual: into_string(actual),
        })
    }
    #[must_use]
    pub fn is_stdio_kind(&self, kind: std::io::ErrorKind) -> bool {
        if let Self::StdIo(e) = self {
            e.kind() == kind
        } else {
            false
        }
    }
    pub fn is_mismatch<E, A>(&self, want_expected: E, want_actual: A) -> bool
    where
        E: AsRef<str>,
        A: AsRef<str>,
    {
        if let Self::Mismatch { expected, actual } = self {
            expected == want_expected.as_ref() && actual == want_actual.as_ref()
        } else {
            false
        }
    }
    #[must_use]
    pub fn response_contains(&self, pat: &str) -> bool {
        if let Self::Response(r) = self {
            r.contains(pat)
        } else {
            false
        }
    }
    #[must_use]
    pub fn get_invalid_param(&self) -> Option<&Parameter> {
        if let Self::InvalidParameter(p) = self {
            Some(p)
        } else {
            None
        }
    }
    #[must_use]
    pub fn is_fatal(&self) -> bool {
        match self {
            Self::InvalidParameter(p) => p.is_fatal(),
            Self::Mismatch { .. } | Self::Unknown(_) => true,
            _ => false,
        }
    }
 }
 #[macro_export]
 macro_rules! error_response {
    // Match a format string plus optional arguments
    ($fmt:expr $(, $arg:expr )* $(,)?) => {
        // Expand to constructing the Error::Response variant,
        // wrapping a `format!(...)` call
        Error::Response(format!($fmt $(, $arg )*))
    };
 }
--- a/src/file/checked.rs
+++ b/src/file/checked.rs
@ -0,0 +1,240 @@
 use std::{
    fs, io,
    path::{Path, PathBuf},
 };
 use serde::{Deserialize, Serialize};
 use crate::sharry;
 use super::{FileTrait, Uploading};
 /// Description of an existing, regular file
 ///
 /// - impl `Clone` for `clap` compatibility
 /// - impl `serde` for cachefile handling
 /// - impl `PartialEq..Ord` to handle multiple files given
 /// - impl `AsRef<[u8]>` for hashing with `blake2b_simd`
 #[allow(clippy::unsafe_derive_deserialize)]
 #[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq, PartialOrd, Ord)]
 pub struct Checked {
    /// canonical path to a regular file
    path: PathBuf,
    /// size of that file
    size: u64,
    /// hash of that file
    hash: Option<String>,
 }
 impl AsRef<[u8]> for Checked {
    fn as_ref(&self) -> &[u8] {
        self.path.as_os_str().as_encoded_bytes()
    }
 }
 impl Checked {
    /// create this directly, without any checks
    pub(super) unsafe fn new_unchecked(path: PathBuf, size: u64, hash: Option<String>) -> Self {
        Self { path, size, hash }
    }
    /// create a new checked file from some path reference
    ///
    /// # Errors
    ///
    /// - from `fs::metadata(path)` or `fs::canonicalize`
    /// - given path does not correspond to a regular file
    pub fn new(value: impl AsRef<Path>) -> io::Result<Self> {
        let meta = fs::metadata(&value)?;
        if meta.is_file() {
            Ok(Self {
                path: fs::canonicalize(&value)?,
                size: meta.len(),
                hash: None,
            })
        } else {
            Err(io::Error::new(
                io::ErrorKind::InvalidInput,
                "Not a regular file",
            ))
        }
    }
    /// calculate and store hash for this file
    ///
    /// # Errors
    ///
    /// - from `file::compute_hash`
    /// - Mismatch if file already hashed
    ///
    /// TODO this could use an error variant like `IllegalInvocation`
    pub fn hash(&mut self, on_progress: impl FnMut(u64)) -> crate::Result<()> {
        if self.hash.is_some() {
            return crate::Error::mismatch("unhashed file", self.path.display());
        }
        self.hash = Some(super::compute_hash(&self.path, self.size, on_progress)?);
        Ok(())
    }
    /// start uploading this file
    ///
    /// - try to create a new file using the client
    /// - consume `self` into a `file::Uploading` struct
    ///
    /// # Errors
    ///
    /// - from `sharry::Client::file_create`
    pub fn start_upload(
        self,
        client: &impl sharry::Client,
        uri: &sharry::Uri,
        alias_id: &sharry::AliasID,
        share_id: &sharry::ShareID,
    ) -> crate::Result<Uploading> {
        let file_id = client.file_create(uri, alias_id, share_id, &self)?;
        Ok(unsafe { Uploading::new_unchecked(self.path, self.size, self.hash, file_id) })
    }
 }
 impl FileTrait for Checked {
    fn get_name(&self) -> &str {
        <Self as FileTrait>::extract_file_name(&self.path)
    }
    fn get_size(&self) -> u64 {
        self.size
    }
    fn check_hash(&self, on_progress: impl FnMut(u64)) -> crate::Result<()> {
        super::check_hash(&self.path, self.size, self.hash.as_deref(), on_progress)
    }
 }
 #[cfg(test)]
 mod tests {
    use tempfile::{NamedTempFile, TempDir};
    use crate::{
        sharry::{Client, json::NewShareRequest},
        test_util::{
            MockClient, check_trait, create_file,
            data::{HASHES_STD_GOOD, cases, data},
        },
    };
    use super::*;
    fn create_checked(content: &[u8]) -> (Checked, NamedTempFile) {
        let file = create_file(content);
        let chk = Checked::new(file.path()).unwrap();
        // return both, so the `NamedTempFile` is not auto-deleted here
        (chk, file)
    }
    #[test]
    fn new_on_existing_file_works() {
        for (content, size) in cases() {
            let (chk, file) = create_checked(content);
            let path = file.path().canonicalize().unwrap();
            assert_eq!(chk.path, path);
            assert_eq!(chk.size, size);
            assert!(chk.hash.is_none());
            // `FileTrait`
            assert_eq!(chk.get_name(), file.path().file_name().unwrap());
            assert_eq!(chk.get_size(), size);
            check_trait(
                chk.as_ref(),
                path.as_os_str().as_encoded_bytes(),
                "AsRef<u8>",
                "Checked",
            );
            // new_unchecked
            let chk = unsafe { Checked::new_unchecked(chk.path, chk.size, chk.hash) };
            assert_eq!(chk.path, path);
            assert_eq!(chk.size, size);
            assert!(chk.hash.is_none());
        }
    }
    #[test]
    fn new_on_dir_errors() {
        let tempdir = TempDir::new().unwrap();
        let fs_root = PathBuf::from("/");
        let dirs = [tempdir.path(), fs_root.as_path()];
        for p in dirs {
            let err = Checked::new(p).unwrap_err();
            assert_eq!(err.kind(), io::ErrorKind::InvalidInput);
            #[cfg(target_os = "linux")]
            assert_eq!(err.to_string(), "Not a regular file");
        }
    }
    #[test]
    fn new_on_nex_errors() {
        let tempdir = TempDir::new().unwrap();
        let nex_paths = [0, 1, 2, 3, 4].map(|i| tempdir.path().join(format!("nex_{i}.ext")));
        for p in nex_paths {
            let err = Checked::new(p).unwrap_err();
            assert_eq!(err.kind(), io::ErrorKind::NotFound);
            #[cfg(target_os = "linux")]
            assert_eq!(err.to_string(), "No such file or directory (os error 2)");
        }
    }
    #[test]
    fn hashing_works() {
        for (content, hash) in data().zip(HASHES_STD_GOOD) {
            let (mut chk, _file) = create_checked(content);
            chk.hash(drop).unwrap();
            // `FileTrait`
            chk.check_hash(drop).unwrap();
            assert_eq!(chk.hash, Some(hash.to_string()));
        }
    }
    #[test]
    fn hashing_again_errors() {
        for content in data() {
            let (mut chk, _file) = create_checked(content);
            // fake hash
            chk.hash = Some(String::default());
            let err = chk.hash(drop).unwrap_err();
            assert!(err.is_mismatch("unhashed file", chk.path.display().to_string()));
        }
    }
    #[test]
    fn start_upload_works() {
        let client = MockClient::default();
        let uri = true.into();
        let alias_id = true.into();
        let share_id = client
            .share_create(&uri, &alias_id, NewShareRequest::new("share", 0))
            .unwrap();
        for content in data() {
            let (chk, _file) = create_checked(content);
            assert!(
                chk.start_upload(&client, &uri, &alias_id, &share_id)
                    .is_ok()
            );
        }
    }
 }
--- a/src/file/chunk.rs
+++ b/src/file/chunk.rs
@ -0,0 +1,126 @@
 use std::{any, fmt};
 use crate::sharry;
 /// Chunk of binary data belonging to a currently uploading file
 pub struct Chunk<'t> {
    /// id of the associated file
    file_id: sharry::FileID,
    /// offset of this chunk in bytes
    offset: u64,
    /// data inside this chunk
    data: &'t [u8],
 }
 impl fmt::Debug for Chunk<'_> {
    // chunks are 1 MiB or more, we shouldn't print that
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.debug_struct("Chunk")
            .field("file_id", &self.file_id)
            .field("offset", &self.offset)
            .field("data.len()", &self.data.len())
            .finish_non_exhaustive()
    }
 }
 /// convert usize into other type
 ///
 /// # Panics
 ///
 /// - if the given value does not fit into the target type
 fn from_usize_or_panic<I>(value: usize) -> I
 where
    I: TryFrom<usize>,
    I::Error: std::error::Error,
 {
    value.try_into().unwrap_or_else(|e| {
        let target_type = any::type_name::<I>();
        panic!("usize={value:?} did not fit into {target_type:?}: {e}")
    })
 }
 impl<'t> Chunk<'t> {
    /// create this directly, without any checks
    pub(super) unsafe fn new_unchecked(
        file_id: sharry::FileID,
        offset: u64,
        data: &'t [u8],
    ) -> Self {
        Self {
            file_id,
            offset,
            data,
        }
    }
    /// get a reference to the associated `file_id`
    pub fn get_file_id(&self) -> &sharry::FileID {
        &self.file_id
    }
    /// get the chunk's offset
    pub fn get_offset(&self) -> u64 {
        self.offset
    }
    /// get a reference to the associated data
    pub fn get_data(&self) -> &[u8] {
        self.data
    }
    /// get the chunk's length
    pub fn get_length(&self) -> u64 {
        // BOOKMARK this might **panic** on (hypothetical) platforms where `usize` has more than 64 bit.
        // Also, you've allocated more than 2 EiB ... in ONE chunk.
        // Whoa! Maybe just chill?
        from_usize_or_panic(self.data.len())
    }
 }
 #[cfg(test)]
 mod tests {
    use crate::test_util::{
        check_trait,
        data::{DATA_LENGTHS_BAD, cases_with},
    };
    use super::*;
    #[test]
    fn basic_tests() {
        // items from `DATA_LENGTHS_BAD` used as mock offsets
        for (data, len, mock_offset) in cases_with(DATA_LENGTHS_BAD) {
            let fid = sharry::FileID::default();
            let chunk = unsafe { Chunk::new_unchecked(fid, mock_offset, data) };
            let repr_expect = format!(
                "Chunk {{ file_id: {:?}, offset: {:?}, data.len(): {:?}, .. }}",
                chunk.file_id,
                chunk.offset,
                chunk.data.len()
            );
            check_trait(format!("{chunk:?}"), repr_expect, "Debug", "Chunk");
            assert_eq!(
                chunk.get_file_id().to_string(),
                sharry::FileID::default().to_string()
            );
            assert_eq!(chunk.get_offset(), mock_offset);
            assert_eq!(chunk.get_data(), data);
            assert_eq!(chunk.get_length(), len);
        }
    }
    #[test]
    #[should_panic = "did not fit into \"u32\""]
    fn test_usize_overflow_panics() {
        // works
        assert_eq!(from_usize_or_panic::<u64>(usize::MAX), u64::MAX);
        assert_eq!(from_usize_or_panic::<u32>(u32::MAX as usize), u32::MAX);
        assert_eq!(from_usize_or_panic::<u16>(u16::MAX as usize), u16::MAX);
        assert_eq!(from_usize_or_panic::<u8>(u8::MAX as usize), u8::MAX);
        // panics
        from_usize_or_panic::<u32>(usize::MAX);
    }
 }
--- a/src/file/mod.rs
+++ b/src/file/mod.rs
@ -0,0 +1,214 @@
 mod checked;
 mod chunk;
 mod uploading;
 use std::{ffi::OsStr, fs, io::Read, path::Path};
 use base64::prelude::{BASE64_STANDARD_NO_PAD as BASE64, Engine};
 use blake2b_simd::Params as Blake2b;
 pub use checked::Checked;
 pub use chunk::Chunk;
 use log::{debug, warn};
 pub use uploading::Uploading;
 /// how many bytes to hash at once (default: 4 MiB)
 ///
 /// size must never exceed 2 EiB
 const HASH_CHUNK_SIZE: usize = 4 * 1024 * 1024;
 /// compute hash for a file given its path.
 /// Hash function: `BLAKE2b`, 512 bit
 ///
 /// # Params
 ///
 /// - `path` to the file to hash
 /// - `size` of that file
 /// - `on_progress` will be called for each processed chunk (max. `HASH_CHUNK_SIZE`)
 ///
 /// # Errors
 ///
 /// - from `fs::File::{open, read}`
 /// - Mismatch if given `size` does not match the file's size
 fn compute_hash(path: &Path, size: u64, mut on_progress: impl FnMut(u64)) -> crate::Result<String> {
    let mut file = fs::File::open(path)?;
    // Blake2b-512 hasher (64 * 8 bit)
    let mut hasher = Blake2b::new().hash_length(64).to_state();
    // buffer
    let mut buffer = vec![0; HASH_CHUNK_SIZE];
    let mut bytes_read = 0;
    loop {
        let n = file.read(&mut buffer)?;
        if n == 0 {
            break;
        }
        hasher.update(&buffer[..n]);
        bytes_read += n as u64;
        on_progress(n as u64);
    }
    if bytes_read != size {
        return crate::Error::mismatch(size, bytes_read);
    }
    let result = BASE64.encode(hasher.finalize());
    debug!("hashed {:?}: {result:?}", path.display());
    Ok(result)
 }
 /// check hash for a file given its path, return Ok(()) on success
 ///
 /// # Params
 ///
 /// - everything from `compute_hash`
 /// - optionally, known `hash`
 ///
 /// # Errors
 ///
 /// - from `file::compute_hash`
 /// - Mismatch if `hash` is `None`
 /// - Mismatch if given `hash` does not match the computed hash
 fn check_hash(
    path: &Path,
    size: u64,
    hash: Option<&str>,
    on_progress: impl FnMut(u64),
 ) -> crate::Result<()> {
    // check if hash is None
    let Some(expected) = hash else {
        return crate::Error::mismatch("hash", path.display());
    };
    // compute and check new hash
    let actual = &compute_hash(path, size, on_progress)?;
    if expected == actual {
        debug!("hash matches {expected:?}");
        Ok(())
    } else {
        warn!("hash mismatch for file {:?}", path.display());
        crate::Error::mismatch(expected, actual)
    }
 }
 pub trait FileTrait {
    /// extract the filename part of a `Path` reference
    ///
    /// # Panics
    ///
    /// Expects `path::Path::file_name` and `ffi::OsStr::to_str` to succeed on the given path
    fn extract_file_name(p: &Path) -> &str {
        p.file_name()
            .and_then(OsStr::to_str)
            .expect("bad file name")
    }
    /// get a reference to the file's name
    ///
    /// Uses `file::FileTrait::extract_file_name`, which may **panic**!
    fn get_name(&self) -> &str;
    /// get the file's size
    fn get_size(&self) -> u64;
    /// check this file's hash, return Ok(()) on success
    ///
    /// # Errors
    ///
    /// - from `file::check_hash`
    fn check_hash(&self, on_progress: impl FnMut(u64)) -> crate::Result<()>;
 }
 #[cfg(test)]
 mod tests {
    use tempfile::TempDir;
    use crate::test_util::{
        create_file,
        data::{DATA_LENGTHS_BAD, HASHES_STD_BAD, HASHES_STD_GOOD, cases, cases_with},
    };
    use super::*;
    #[test]
    fn compute_hash_as_expected() {
        for (content, size, expected_hash) in cases_with(HASHES_STD_GOOD) {
            let file = create_file(content);
            // to capture progress updates from `compute_hash`
            let mut read_total = 0;
            let callback = |n| read_total += n;
            let hash = compute_hash(file.path(), size, callback).unwrap();
            assert_eq!(hash, expected_hash);
            assert_eq!(read_total, size);
        }
    }
    #[test]
    fn compute_hash_nonexistent_file() {
        let nex_path = {
            // this is deleted at the end of this block, so will stop to exist
            let nex_file = create_file(&[]);
            nex_file.path().to_owned()
        };
        let err = compute_hash(&nex_path, 0, drop).unwrap_err();
        assert!(err.is_stdio_kind(std::io::ErrorKind::NotFound));
    }
    #[test]
    fn compute_hash_directory() {
        let dir = TempDir::new().unwrap();
        let err = compute_hash(dir.path(), 0, drop).unwrap_err();
        assert!(err.is_stdio_kind(std::io::ErrorKind::IsADirectory));
    }
    #[test]
    fn hash_size_mismatch() {
        for (content, good_size, bad_size) in cases_with(DATA_LENGTHS_BAD) {
            let file = create_file(content);
            {
                // `compute_hash` with bad size
                let err = compute_hash(file.path(), bad_size, drop).unwrap_err();
                assert!(err.is_mismatch(bad_size.to_string(), good_size.to_string()));
            }
            {
                // `check_hash` with bad size
                let err = check_hash(file.path(), bad_size, Some("foobar"), drop).unwrap_err();
                assert!(err.is_mismatch(bad_size.to_string(), good_size.to_string()));
            }
        }
    }
    #[test]
    fn hash_value_none() {
        for (content, size) in cases() {
            let file = create_file(content);
            // `check_hash` with no hash
            let err = check_hash(file.path(), size, None, drop).unwrap_err();
            assert!(err.is_mismatch("hash", file.path().display().to_string()));
        }
    }
    #[test]
    fn hash_value_mismatch() {
        for ((content, size, good_hash), bad_hash) in
            cases_with(HASHES_STD_GOOD).zip(HASHES_STD_BAD)
        {
            let file = create_file(content);
            // `check_hash` with bad hash
            let err = check_hash(file.path(), size, Some(bad_hash), drop).unwrap_err();
            assert!(err.is_mismatch(bad_hash, good_hash));
        }
    }
 }
--- a/src/file/uploading.rs
+++ b/src/file/uploading.rs
@ -0,0 +1,340 @@
 use std::{
    fs,
    io::{self, Read, Seek, SeekFrom},
    path::PathBuf,
 };
 use log::warn;
 use serde::{Deserialize, Serialize};
 use crate::sharry;
 use super::{Checked, Chunk, FileTrait};
 /// Description of a `file::Checked` that is actively being uploaded
 ///
 /// - impl `serde` for cachefile handling
 #[allow(clippy::unsafe_derive_deserialize)]
 #[derive(Serialize, Deserialize, Debug)]
 pub struct Uploading {
    /// canonical path to a regular file
    path: PathBuf,
    /// size of that file
    size: u64,
    /// hash of that file
    hash: Option<String>,
    /// file ID in a Sharry share
    file_id: sharry::FileID,
    /// previous offset, if applicable
    #[serde(skip)]
    previous_offset: Option<u64>,
    /// current reading offset
    offset: u64,
 }
 impl Uploading {
    /// create this directly, without any checks
    pub(super) unsafe fn new_unchecked(
        path: PathBuf,
        size: u64,
        hash: Option<String>,
        file_id: sharry::FileID,
    ) -> Self {
        Self {
            path,
            size,
            hash,
            file_id,
            previous_offset: None,
            offset: 0,
        }
    }
    /// get the current reading offset
    pub fn get_offset(&self) -> u64 {
        self.offset
    }
    /// rewind to the previously read chunk
    ///
    /// - consume self, returning Some(self) on success
    ///
    /// TODO this should take &mut self and return `crate::Result<()>`
    /// TODO this could use an error variant like `IllegalInvocation`
    pub fn rewind(mut self) -> Option<Self> {
        if let Some(offset) = self.previous_offset.take() {
            self.offset = offset;
            Some(self)
        } else {
            warn!("attempted to rewind with no `previous_offset`");
            None
        }
    }
    /// read the next chunk
    ///
    /// # Errors
    ///
    /// - from `fs::File::{open, seek, read}`
    /// - `UnexpectedEof` if `read` returned no bytes
    ///
    /// TODO this should return `crate::Result<Chunk<'t>>`
    /// TODO this could use an error variant like `IllegalInvocation`
    pub fn read<'t>(&mut self, buf: &'t mut [u8]) -> io::Result<Chunk<'t>> {
        let mut f = fs::File::open(&self.path)?;
        f.seek(SeekFrom::Start(self.offset))?;
        let read_len = f.read(buf)?;
        if read_len == 0 {
            return Err(io::Error::new(
                io::ErrorKind::UnexpectedEof,
                format!("could not read from file {:?}", self.path.display()),
            ));
        }
        let chunk =
            unsafe { Chunk::new_unchecked(self.file_id.clone(), self.offset, &buf[..read_len]) };
        self.previous_offset = Some(self.offset);
        self.offset += chunk.get_length();
        Ok(chunk)
    }
    /// check if this file has been completely read
    ///
    /// - consume self, returning Ok(self) if EOF not reached, Err(PathBuf) otherwise
    ///
    /// TODO factor this into `read` and something more explicit like `finish(self) -> PathBuf`
    pub fn check_eof(self) -> Result<Self, PathBuf> {
        if self.offset < self.size {
            Ok(self)
        } else {
            Err(self.path)
        }
    }
    /// stop uploading this file
    ///
    /// - consume self, returning as a `file::Checked`
    pub fn stop(self) -> Checked {
        unsafe { Checked::new_unchecked(self.path, self.size, self.hash) }
    }
 }
 impl FileTrait for Uploading {
    fn get_name(&self) -> &str {
        <Self as FileTrait>::extract_file_name(&self.path)
    }
    fn get_size(&self) -> u64 {
        self.size
    }
    fn check_hash(&self, on_progress: impl FnMut(u64)) -> crate::Result<()> {
        super::check_hash(&self.path, self.size, self.hash.as_deref(), on_progress)
    }
 }
 #[cfg(test)]
 mod tests {
    use tempfile::NamedTempFile;
    use crate::{
        sharry::{Client, json::NewShareRequest},
        test_util::{
            MockClient, create_file,
            data::{DATA_LENGTHS_BAD, cases, cases_with, data},
        },
    };
    use super::*;
    fn create_uploading(content: &[u8]) -> (Uploading, sharry::ShareID, NamedTempFile) {
        let client = MockClient::default();
        let uri = true.into();
        let alias_id = true.into();
        let share_id = client
            .share_create(&uri, &alias_id, NewShareRequest::new("share", 0))
            .expect("");
        let file = create_file(content);
        let upl = Checked::new(file.path())
            .unwrap()
            .start_upload(&client, &uri, &alias_id, &share_id)
            .unwrap();
        // return all, so the `NamedTempFile` is not auto-deleted here
        (upl, share_id, file)
    }
    #[test]
    fn basic_tests() {
        fn check_members(upl: &Uploading, path: &PathBuf, size: u64) {
            assert_eq!(upl.path, *path);
            assert_eq!(upl.size, size);
            assert_eq!(upl.offset, 0);
            assert!(upl.previous_offset.is_none());
            assert!(upl.hash.is_none());
        }
        for (content, size) in cases() {
            let (upl, _share_id, file) = create_uploading(content);
            let path = file.path().canonicalize().unwrap();
            check_members(&upl, &path, size);
            // `get_offset`
            assert_eq!(upl.get_offset(), upl.offset);
            // `FileTrait`
            assert_eq!(upl.get_name(), file.path().file_name().unwrap());
            assert_eq!(upl.get_size(), size);
            assert!(upl.check_hash(drop).is_err());
            // `new_unchecked`
            let upl =
                unsafe { Uploading::new_unchecked(upl.path, upl.size, upl.hash, upl.file_id) };
            check_members(&upl, &path, size);
            // `stop`
            let chk = upl.stop();
            assert_eq!(chk.get_name(), path.file_name().unwrap().to_str().unwrap());
            assert_eq!(chk.get_size(), size);
        }
    }
    #[test]
    fn check_eof_works() {
        for (content, size) in cases() {
            let (upl, _share_id, file) = create_uploading(content);
            let path = file.path().canonicalize().unwrap();
            let eof = upl.check_eof();
            if size > 0 {
                assert!(eof.is_ok());
            } else {
                assert!(eof.is_err());
                assert_eq!(eof.unwrap_err(), path);
            }
        }
    }
    #[test]
    fn check_read_works() {
        for (content, size, extra) in cases_with(DATA_LENGTHS_BAD) {
            let (mut upl, _share_id, _file) = create_uploading(content);
            // use oversized buffer
            let mut buf = vec![0; usize::try_from(size + extra).unwrap()];
            let chunk_res = upl.read(&mut buf);
            if size > 0 {
                assert_eq!(upl.previous_offset, Some(0));
                assert_eq!(upl.offset, size);
                let chunk = chunk_res.unwrap();
                assert_eq!(chunk.get_offset(), 0);
                assert_eq!(chunk.get_length(), size);
                assert_eq!(chunk.get_file_id().to_string(), upl.file_id.to_string());
                assert_eq!(chunk.get_data(), content);
            } else {
                assert!(chunk_res.is_err());
            }
        }
    }
    #[test]
    fn check_rewind_works() {
        let data = cases()
            // ignore "empty" testcase
            .filter(|&(_, size)| size > 0)
            // remove "size"
            .map(|(content, _)| content);
        for content in data {
            let (mut upl, _share_id, _file) = create_uploading(content);
            // read 1 byte and rewind
            upl.read(&mut [0]).unwrap();
            upl = upl.rewind().unwrap();
            // check: read has been rewound
            assert_eq!(upl.offset, 0);
            assert_eq!(upl.previous_offset, None);
            // check: attempting to rewind again will destroy
            assert!(upl.rewind().is_none());
        }
    }
    #[test]
    fn upload_works() {
        let client = MockClient::default();
        let uri = true.into();
        let alias_id = true.into();
        let share_id = client
            .share_create(&uri, &alias_id, NewShareRequest::new("share", 0))
            .unwrap();
        let mut buf = vec![0; 1024 * 1024];
        for content in data() {
            let file = create_file(content);
            let mut upl = Checked::new(file.path())
                .unwrap()
                .start_upload(&client, &uri, &alias_id, &share_id)
                .unwrap();
            while let Ok(chunk) = upl.read(&mut buf) {
                assert!(
                    client
                        .file_patch(&uri, &alias_id, &share_id, &chunk)
                        .is_ok()
                );
            }
            assert_eq!(upl.offset, upl.size);
        }
    }
    #[test]
    fn check_upload_bad_align() {
        let data = cases()
            // ignore "empty" testcase
            .filter(|&(_, size)| size >= 2)
            // remove "size"
            .map(|(content, _)| content);
        let client = MockClient::default();
        let uri = true.into();
        let alias_id = true.into();
        let share_id = client
            .share_create(&uri, &alias_id, NewShareRequest::new("share", 0))
            .unwrap();
        // single-byte buffer to force bad chunk alignment
        let mut buf = [0];
        for content in data {
            let file = create_file(content);
            let mut upl = Checked::new(file.path())
                .unwrap()
                .start_upload(&client, &uri, &alias_id, &share_id)
                .unwrap();
            // first chunk works
            client
                .file_patch(&uri, &alias_id, &share_id, &upl.read(&mut buf).unwrap())
                .unwrap();
            // second chunk misaligned
            let res = client.file_patch(&uri, &alias_id, &share_id, &upl.read(&mut buf).unwrap());
            assert!(res.is_err());
            assert!(res.unwrap_err().response_contains("not aligned to a MiB"));
        }
    }
 }
--- a/src/lib.rs
+++ b/src/lib.rs
@ -0,0 +1,17 @@
 // TODO fix with documentation
 #![allow(clippy::missing_errors_doc)]
 #![allow(clippy::missing_panics_doc)]
 mod appstate;
 mod cachefile;
 mod cli;
 mod error;
 mod file;
 pub mod output;
 mod sharry;
 mod test_util;
 mod ureq_client;
 pub use appstate::AppState;
 pub use cli::Cli;
 pub use error::{Error, Parameter, Result};
--- a/src/main.rs
+++ b/src/main.rs
@ -1,110 +0,0 @@
 mod appstate;
 mod cli;
 mod sharry;
 use std::{
    process::exit,
    sync::{
        Arc,
        atomic::{AtomicBool, Ordering},
    },
 };
 use clap::Parser;
 use console::style;
 use dialoguer::{Confirm, theme::ColorfulTheme};
 use log::{error, info};
 use ureq::Agent;
 use appstate::AppState;
 use cli::Cli;
 fn main() {
    println!(
        "{} to {}!",
        style("Welcome").magenta().bold(),
        style("ShrUpl").yellow().bold(),
    );
    let stop = Arc::new(AtomicBool::new(false));
    let stop_ctrlc = stop.clone();
    ctrlc::set_handler(move || {
        stop_ctrlc.store(true, Ordering::SeqCst);
        info!("stopping as soon as possible ...");
    })
    .expect("Error setting Ctrl-C handler");
    env_logger::init();
    let args = Cli::parse();
    info!("args: {args:?}");
    info!("timeout: {:?}", args.get_timeout());
    let agent: Agent = Agent::config_builder()
        .timeout_global(args.get_timeout())
        .build()
        .into();
    let mut state = AppState::try_resume(&args)
        .and_then(|state| {
            Confirm::with_theme(&ColorfulTheme::default())
                .with_prompt("Continue previously stopped operation?")
                .default(true)
                .interact()
                .map_or(None, |b| b.then_some(state))
        })
        .unwrap_or_else(|| {
            stop.load(Ordering::SeqCst).then(|| exit(0));
            match AppState::from_args(&args, &agent) {
                Ok(state) => {
                    state.save().unwrap();
                    state
                }
                Err(e) => {
                    if let Some(cause) = match e {
                        ureq::Error::StatusCode(403) => Some("Alias ID"),
                        ureq::Error::Io(_) => Some("URL"),
                        _ => None,
                    } {
                        info!("handling error: {e:?}");
                        println!(
                            "{} probably wrong: {} – {:?}",
                            style("Error!").red().bold(),
                            style(cause).cyan().italic(),
                            style(e.to_string()).yellow()
                        );
                    } else {
                        error!("unknown error: {e} – {e:?}");
                        println!("{}", style("Unknown Error!").red().bold());
                    }
                    exit(1);
                }
            }
        });
    println!(
        "{} uploading: {}",
        style("ShrUpl").yellow().bold(),
        style(state.file_names().join(", ")).magenta(),
    );
    info!("continuing with state: {state:?}");
    loop {
        match state.upload_chunk(&agent, args.chunk_size * 1024 * 1024) {
            Err(e) => error!("error: {e:?}"),
            Ok(None) => {
                info!("all uploads done");
                state.clear().unwrap();
                break;
            }
            _ => (),
        }
        state.save().unwrap();
        stop.load(Ordering::SeqCst).then(|| exit(0));
    }
 }
--- a/src/output.rs
+++ b/src/output.rs
@ -0,0 +1,104 @@
 use std::{fmt, process, sync::LazyLock};
 use console::{StyledObject, style};
 use dialoguer::{Confirm, Select, theme::ColorfulTheme};
 use indicatif::{ProgressBar, ProgressStyle};
 use log::{info, warn};
 type StaticStyled<'t> = LazyLock<StyledObject<&'t str>>;
 pub static SHRUPL: StaticStyled = LazyLock::new(|| style("ShrUpl").yellow().bold());
 #[must_use]
 pub fn prompt_continue() -> bool {
    let prompt = format!(
        "This operation has previously been stopped. {}",
        style("How to proceed?").cyan()
    );
    let choices = [
        format!("Load and {}", style("continue operation").green().bold()),
        format!("Start a {}", style("new operation").cyan().bold()),
        format!("Quit {}", *SHRUPL),
    ];
    let selection = Select::with_theme(&ColorfulTheme::default())
        .with_prompt(prompt)
        .default(0)
        .items(&choices)
        .interact()
        .unwrap_or(2);
    if selection == 2 {
        process::exit(0);
    }
    selection == 0
 }
 pub fn prompt_rebuild_share() {
    let prompt = format!(
        "Target Share cannot be accessed. {}",
        style("Completely restart upload?").cyan()
    );
    let selection = Confirm::with_theme(&ColorfulTheme::default())
        .with_prompt(prompt)
        .default(true)
        .interact()
        .unwrap_or(false);
    if !selection {
        process::exit(0);
    }
 }
 pub fn style_all<'t, F>(strs: &[&'t str], f: F) -> Vec<String>
 where
    F: Fn(StyledObject<&'t str>) -> StyledObject<&'t str>,
 {
    strs.iter().map(|&s| f(style(s)).to_string()).collect()
 }
 #[must_use]
 pub fn new_progressbar() -> ProgressBar {
    ProgressBar::no_length().with_style(
        ProgressStyle::with_template(&format!(
            concat!(
                "{{bar:50.cyan/blue}} {{msg:.magenta}}: ",
                "{{binary_bytes:.yellow}}{}{{binary_total_bytes:.yellow}} ",
                "({{eta}})",
            ),
            style("/").magenta(),
        ))
        .expect("invalid style template"),
    )
 }
 pub enum Log {}
 impl Log {
    fn eprintln(kind: impl fmt::Display, msg: impl fmt::Display) {
        eprintln!("{} {}: {}", *SHRUPL, kind, style(msg).cyan().italic(),);
    }
    pub fn warning(msg: impl fmt::Display) {
        Self::eprintln(style("Warning").magenta().bold(), msg);
    }
    pub fn error(msg: impl fmt::Display) -> ! {
        Self::eprintln(style("Error").red().bold(), msg);
        process::exit(1);
    }
    pub fn handle(e: &crate::Error) {
        if e.is_fatal() {
            // react to fatal error
            warn!("fatal error: {e:?}");
            Self::error(e);
        }
        // handle recoverable error
        info!("recoverable error: {e:?}");
    }
 }
--- a/src/sharry/alias.rs
+++ b/src/sharry/alias.rs
@ -1,36 +0,0 @@
 use std::fmt::{Debug, Display};
 use log::debug;
 use serde::{Deserialize, Serialize};
 use ureq::RequestBuilder;
 use super::api::Uri;
 #[derive(Serialize, Deserialize, Debug, Hash)]
 pub struct Alias {
    pub(super) uri: Uri,
    pub(super) id: String,
 }
 pub(super) trait SharryAlias {
    fn sharry_header(self, alias: &Alias) -> Self;
 }
 impl<B> SharryAlias for RequestBuilder<B> {
    fn sharry_header(self, alias: &Alias) -> Self {
        self.header("Sharry-Alias", &alias.id)
    }
 }
 impl Alias {
    pub fn new(uri: Uri, id: impl Into<String>) -> Self {
        Self { uri, id: id.into() }
    }
    pub(super) fn get_endpoint(&self, endpoint: impl Display + Debug) -> String {
        let uri = format!("{}/{}", self.uri, endpoint);
        debug!("endpoint uri: {uri:?}");
        uri
    }
 }
--- a/src/sharry/api.rs
+++ b/src/sharry/api.rs
@ -1,64 +0,0 @@
 use std::fmt::Display;
 use serde::{Deserialize, Serialize};
 #[derive(Serialize, Deserialize, Debug, Hash)]
 pub struct Uri {
    protocol: String,
    base_url: String,
 }
 impl Uri {
    pub fn with_protocol(protocol: impl Into<String>, base_url: impl Into<String>) -> Self {
        Self {
            protocol: protocol.into(),
            base_url: base_url.into(),
        }
    }
 }
 impl Display for Uri {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{}://{}/api/v2", self.protocol, self.base_url)
    }
 }
 #[derive(Serialize)]
 #[allow(non_snake_case)]
 pub struct NewShareRequest {
    name: String,
    validity: u32,
    description: Option<String>,
    maxViews: u32,
    password: Option<String>,
 }
 impl NewShareRequest {
    pub fn new(
        name: impl Into<String>,
        description: Option<impl Into<String>>,
        max_views: u32,
    ) -> Self {
        Self {
            name: name.into(),
            validity: 0,
            description: description.map(Into::into),
            maxViews: max_views,
            password: None,
        }
    }
 }
 #[derive(Deserialize, Debug)]
 pub(super) struct NewShareResponse {
    pub success: bool,
    pub message: String,
    pub id: String,
 }
 #[derive(Deserialize, Debug)]
 #[allow(dead_code)]
 pub(super) struct NotifyShareResponse {
    pub success: bool,
    pub message: String,
 }
--- a/src/sharry/file/checked.rs
+++ b/src/sharry/file/checked.rs
@ -1,75 +0,0 @@
 use std::{
    ffi::OsStr,
    fs,
    io::{self, ErrorKind},
    path::{Path, PathBuf},
 };
 use log::debug;
 use serde::{Deserialize, Serialize};
 use ureq::http::StatusCode;
 use super::{Alias, FileUploading, Share, SharryAlias};
 #[derive(Debug, Clone, Hash, Serialize, Deserialize, PartialEq, Eq, PartialOrd, Ord)]
 pub struct FileChecked {
    path: PathBuf,
 }
 impl FileChecked {
    pub fn new(value: impl AsRef<Path>) -> io::Result<Self> {
        let meta = fs::metadata(&value)?;
        if meta.is_file() {
            Ok(Self {
                path: fs::canonicalize(&value)?,
            })
        } else {
            Err(io::Error::new(
                ErrorKind::InvalidInput,
                "Not a regular file",
            ))
        }
    }
    pub fn file_name(&self) -> &str {
        self.path.file_name().unwrap().to_str().unwrap()
    }
    pub fn start_upload(
        self,
        http: &ureq::Agent,
        alias: &Alias,
        share: &Share,
    ) -> io::Result<FileUploading> {
        let size = usize::try_from(fs::metadata(&self.path)?.len()).map_err(io::Error::other)?;
        let res = {
            let endpoint = alias.get_endpoint(format!("alias/upload/{}/files/tus", share.id));
            let name = (self.path.file_name().and_then(OsStr::to_str))
                .ok_or_else(|| io::Error::new(ErrorKind::NotFound, "bad file name"))?
                .to_string();
            (http.post(endpoint))
                .sharry_header(alias)
                .header("Sharry-File-Name", &name)
                .header("Upload-Length", size)
                .send_empty()
                .map_err(io::Error::other)?
        };
        if res.status() != StatusCode::CREATED {
            return Err(io::Error::other("unexpected response status"));
        }
        let location = (res.headers().get("Location"))
            .ok_or_else(|| io::Error::other("Location header not found"))?
            .to_str()
            .map_err(|_| io::Error::other("Location header invalid"))?
            .to_string();
        debug!("patch uri: {location}");
        Ok(FileUploading::new(self.path, size, location))
    }
 }
--- a/src/sharry/file/mod.rs
+++ b/src/sharry/file/mod.rs
@ -1,7 +0,0 @@
 mod checked;
 mod uploading;
 pub use checked::FileChecked;
 pub use uploading::{ChunkState, FileUploading, UploadError};
 use super::{Alias, Share, alias::SharryAlias};
--- a/src/sharry/file/uploading.rs
+++ b/src/sharry/file/uploading.rs
@ -1,133 +0,0 @@
 use std::{
    fmt::{Debug, Display},
    fs::File,
    io::{self, Read, Seek, SeekFrom},
    path::PathBuf,
 };
 use log::debug;
 use serde::{Deserialize, Serialize};
 use ureq::http::{HeaderValue, StatusCode};
 use super::{Alias, SharryAlias};
 #[derive(Serialize, Deserialize, Debug)]
 pub struct FileUploading {
    path: PathBuf,
    size: usize,
    uri: String,
    offset: usize,
 }
 #[derive(Debug)]
 pub enum UploadError {
    FileIO(io::Error),
    Request,
    ResponseStatus,
    ResponseOffset,
 }
 pub enum ChunkState {
    Ok(FileUploading),
    Err(FileUploading, UploadError),
    Finished(PathBuf),
 }
 impl Display for FileUploading {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(
            f,
            "Uploading ({:?}, {}, {})",
            self.path.display(),
            self.size,
            self.offset
        )
    }
 }
 impl FileUploading {
    pub(super) fn new(path: PathBuf, size: usize, uri: String) -> Self {
        Self {
            path,
            size,
            uri,
            offset: 0,
        }
    }
    fn read_chunk(&self, chunk_size: usize) -> io::Result<Vec<u8>> {
        let offset = u64::try_from(self.offset).map_err(io::Error::other)?;
        let mut f = File::open(&self.path)?;
        f.seek(SeekFrom::Start(offset))?;
        let mut bytes = vec![0; chunk_size];
        let read_len = f.read(&mut bytes)?;
        bytes.truncate(read_len);
        Ok(bytes)
    }
    pub fn file_name(&self) -> &str {
        self.path.file_name().unwrap().to_str().unwrap()
    }
    pub fn offset<T>(&self) -> T
    where
        T: TryFrom<usize>,
        <T as TryFrom<usize>>::Error: Debug,
    {
        self.offset.try_into().unwrap()
    }
    pub fn size<T>(&self) -> T
    where
        T: TryFrom<usize>,
        <T as TryFrom<usize>>::Error: Debug,
    {
        self.size.try_into().unwrap()
    }
    pub fn upload_chunk(
        mut self,
        http: &ureq::Agent,
        alias: &Alias,
        chunk_size: usize,
    ) -> ChunkState {
        let chunk = match self.read_chunk(chunk_size) {
            Err(e) => return ChunkState::Err(self, UploadError::FileIO(e)),
            Ok(value) => value,
        };
        let Ok(res) = (http.patch(&self.uri))
            .sharry_header(alias)
            .header("Upload-Offset", self.offset)
            .send(&chunk)
        else {
            return ChunkState::Err(self, UploadError::Request);
        };
        if res.status() != StatusCode::NO_CONTENT {
            return ChunkState::Err(self, UploadError::ResponseStatus);
        }
        let Some(Ok(Ok(res_offset))) = (res.headers().get("Upload-Offset"))
            .map(HeaderValue::to_str)
            .map(|v| v.map(str::parse::<usize>))
        else {
            return ChunkState::Err(self, UploadError::ResponseOffset);
        };
        if self.offset + chunk.len() != res_offset {
            return ChunkState::Err(self, UploadError::ResponseOffset);
        }
        self.offset = res_offset;
        if self.offset == self.size {
            return ChunkState::Finished(self.path);
        }
        ChunkState::Ok(self)
    }
 }
--- a/src/sharry/ids.rs
+++ b/src/sharry/ids.rs
@ -0,0 +1,203 @@
 use std::{fmt, sync::LazyLock};
 use log::{debug, trace};
 use regex::Regex;
 use serde::{Deserialize, Serialize};
 /// ID of a public Sharry alias
 ///
 /// - impl `From<String>` and `Clone` as this is just a String
 /// - impl `serde` for cachefile handling
 /// - impl `Default` while testing for value generation
 /// - impl `AsRef<str>` for using in a `ureq` header and hashing support
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[cfg_attr(test, derive(Default))]
 pub struct AliasID(String);
 impl AsRef<str> for AliasID {
    fn as_ref(&self) -> &str {
        self.0.as_ref()
    }
 }
 impl From<String> for AliasID {
    fn from(value: String) -> Self {
        Self(value)
    }
 }
 /// ID of a Sharry share
 ///
 /// - impl `From<String>` and `Clone` as this is just a String
 /// - impl `serde` for cachefile handling
 /// - impl `Default` while testing for value generation
 /// - impl `Display` for formatting compatibility
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[cfg_attr(test, derive(Default))]
 pub struct ShareID(String);
 impl fmt::Display for ShareID {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.write_str(&self.0)
    }
 }
 impl From<String> for ShareID {
    fn from(value: String) -> Self {
        Self(value)
    }
 }
 /// ID of a file in a Sharry share
 ///
 /// - impl `Clone` as this is just a String
 /// - impl `serde` for cachefile handling
 /// - impl `Default` while testing for value generation
 /// - impl `Display` for formatting compatibility
 /// - impl `TryFrom<String>` for extracting from matching a "PATCH" uri
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[cfg_attr(test, derive(Default))]
 pub struct FileID(String);
 impl FileID {
    #[cfg(test)]
    /// create a new `FileID` for testing purposes
    pub fn new_test(value: impl Into<String>) -> Self {
        Self(value.into())
    }
 }
 impl fmt::Display for FileID {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.write_str(&self.0)
    }
 }
 /// Pattern breakdown:
 /// - `^([^:/?#]+)://`          - scheme (anything but `:/?#`) + `"://"`
 /// - `([^/?#]+)`               - authority/host (anything but `/?#`)
 /// - `/api/v2/alias/upload/`   - literal path segment
 /// - `([^/]+)`                 - capture SID (one or more non-slash chars)
 /// - `/files/tus/`             - literal path segment
 /// - `(?P<fid>[^/]+)`          - capture FID (one or more non-slash chars)
 /// - `$`                       - end of string
 static UPLOAD_URL_RE: LazyLock<Regex> = LazyLock::new(|| {
    trace!("compiling UPLOAD_URL_RE");
    Regex::new(r"^([^:/?#]+)://([^/?#]+)/api/v2/alias/upload/[^/]+/files/tus/(?P<fid>[^/]+)$")
        .expect("Regex compilation failed")
 });
 impl TryFrom<String> for FileID {
    type Error = crate::Error;
    fn try_from(value: String) -> crate::Result<Self> {
        trace!("TryFrom {value:?}");
        if let Some(fid) = UPLOAD_URL_RE
            .captures(&value)
            .and_then(|caps| caps.name("fid").map(|m| m.as_str()))
        {
            let result = Self(fid.to_string());
            debug!("{result:?}");
            Ok(result)
        } else {
            crate::Error::mismatch(
                "<proto>://<host>/api/v2/alias/upload/<share>/files/tus/<file>",
                value,
            )
        }
    }
 }
 #[cfg(test)]
 mod tests {
    use super::*;
    use crate::test_util::check_trait;
    #[test]
    fn basic_traits_working() {
        let inputs = [
            "",
            "abcd",
            "12345",
            "8woeurx09wp",
            "6NHNiSVFhZF-dSGbX8iD8ib-Pdb7TbzpsvC-uBBSCyExxb",
        ];
        for input in inputs {
            {
                // check AliasID
                let aid = AliasID::from(input.to_string());
                check_trait(&aid.0, input, "From<String>", "AliasID");
                check_trait(aid.as_ref(), input, "AsRef<str>", "AliasID");
            }
            {
                // check ShareID
                let sid = ShareID::from(input.to_string());
                check_trait(&sid.0, input, "From<String>", "ShareID");
                check_trait(sid.to_string(), input, "Display", "ShareID");
            }
            {
                // check FileID
                let fid = FileID(input.to_string());
                check_trait(fid.to_string(), input, "Display", "FileID");
                let fid_test = FileID::new_test(input);
                assert_eq!(fid_test.0, fid.0);
            }
        }
    }
    #[test]
    fn valid_urls_produce_expected_file_id() {
        // a handful of valid‐looking URLs
        let cases = [
            (
                "http://example.com/api/v2/alias/upload/SID123/files/tus/FID456",
                "FID456",
            ),
            (
                "https://my-host:8080/api/v2/alias/upload/another-SID/files/tus/some-file-id",
                "some-file-id",
            ),
            (
                "custom+scheme://host/api/v2/alias/upload/x/files/tus/y",
                "y",
            ),
        ];
        for (good, expected_fid) in cases {
            let file_id = FileID::try_from(good.to_string()).unwrap();
            assert_eq!(file_id.0, expected_fid);
        }
    }
    #[test]
    fn invalid_urls_return_error() {
        let bad_inputs = [
            // missing /api/v2/alias/upload
            "http://example.com/files/tus/FID",
            // missing /files/tus
            "http://example.com/api/v2/alias/upload/SID123/FID456",
            // trailing slash (doesn't match `$`)
            "http://example.com/api/v2/alias/upload/SID/files/tus/FID/",
            // empty fid
            "http://example.com/api/v2/alias/upload/SID/files/tus/",
            // random string
            "just-a-random-string",
        ];
        for bad in bad_inputs {
            let err = FileID::try_from(bad.to_string()).unwrap_err();
            // make sure it's the Mismatch variant, and that it contains the original input
            assert!(err.is_mismatch(
                "<proto>://<host>/api/v2/alias/upload/<share>/files/tus/<file>",
                bad
            ));
        }
    }
 }
--- a/src/sharry/json.rs
+++ b/src/sharry/json.rs
@ -0,0 +1,119 @@
 use serde::{Deserialize, Serialize};
 /// Request Body sent to the Sharry API for creating a new share
 ///
 /// - impl `Serialize` to send in a HTTP request
 #[derive(Serialize, Debug)]
 pub struct NewShareRequest {
    name: String,
    validity: u32,
    description: Option<String>,
    #[serde(rename = "maxViews")]
    max_views: u32,
    password: Option<String>,
 }
 impl NewShareRequest {
    pub fn new(name: impl Into<String>, max_views: u32) -> Self {
        Self {
            name: name.into(),
            // apparently, the "validity" param doesn't make any difference
            validity: 0,
            description: None,
            max_views,
            // new shares are private by default, setting a password doesn't really make sense
            password: None,
        }
    }
    /// set a human‐readable description
    pub fn description(mut self, desc: Option<impl Into<String>>) -> Self {
        self.description = desc.map(Into::into);
        self
    }
 }
 /// Request Body received from the Sharry API when creating a new share
 ///
 /// - impl `Deserialize` to parse from a HTTP request
 #[derive(Deserialize, Debug)]
 pub struct NewShareResponse {
    pub success: bool,
    pub message: String,
    pub id: String,
 }
 /// Request Body received from the Sharry API when pinging a share's notification hook
 ///
 /// - impl `Deserialize` to parse from a HTTP request
 #[derive(Deserialize, Debug)]
 #[allow(dead_code)]
 pub struct NotifyShareResponse {
    pub success: bool,
    pub message: String,
 }
 #[cfg(test)]
 mod tests {
    use super::*;
    #[test]
    fn nsreq_new_sets_fields_correctly() {
        let cases = [
            // simple ASCII name, small view count
            ("alice", 1),
            // underscores, mid-range views
            ("bob_smith", 10),
            // unicode in the name
            ("漢字ユーザー", 5),
            // empty name edge case
            ("", 3),
            // zero views
            ("charlie", 0),
            // very large view count
            ("delta", u32::MAX),
            // name with spaces and punctuation
            ("user name!", 42),
            // name with mixed case
            ("FooBar", 7),
        ];
        for (name, views) in cases {
            let req = NewShareRequest::new(name, views);
            assert_eq!(req.name, name);
            assert_eq!(req.max_views, views);
            // unset fields
            assert_eq!(req.validity, 0);
            assert!(req.description.is_none());
            assert!(req.password.is_none());
        }
    }
    #[test]
    fn nsreq_new_allows_setting_description() {
        let longstr = "y".repeat(256);
        let cases = [
            // simple alphanumeric
            "A simple test user",
            // whitespace & punctuation
            "Bob’s description: loves Rust!",
            // unicode
            "日本語の説明",
            // long string
            longstr.as_str(),
            // empty
            "",
            // only whitespace
            "    ",
        ];
        for desc in cases {
            let req = NewShareRequest::new("whatever", 0).description(Some(desc));
            assert!(req.description.is_some());
            assert_eq!(req.description.unwrap(), desc);
        }
    }
 }
--- a/src/sharry/mod.rs
+++ b/src/sharry/mod.rs
@ -1,11 +1,45 @@
-#![allow(unused_imports)]
+mod ids;
 pub mod json;
 mod uri;
-mod alias;
+pub use ids::{AliasID, FileID, ShareID};
-mod api;
+pub use uri::Uri;
 mod file;
 mod share;
-pub use alias::Alias;
+use crate::file;
-pub use api::{NewShareRequest, Uri};
+
-pub use file::{ChunkState, FileChecked, FileUploading, UploadError};
+pub trait Client {
-pub use share::Share;
+    fn share_create(
        &self,
        uri: &Uri,
        alias_id: &AliasID,
        data: json::NewShareRequest,
    ) -> crate::Result<ShareID>;
    fn share_notify(&self, uri: &Uri, alias_id: &AliasID, share_id: &ShareID) -> crate::Result<()>;
    /// create a new file in a Sharry share
    ///
    /// - try to use endpoint from `Uri::file_create`
    /// - try to extract `FileID` from the response
    /// - return the new `FileID`
    ///
    /// # Errors from
    ///
    /// - request to endpoint
    /// - parsing the response
    fn file_create(
        &self,
        uri: &Uri,
        alias_id: &AliasID,
        share_id: &ShareID,
        file: &file::Checked,
    ) -> crate::Result<FileID>;
    fn file_patch(
        &self,
        uri: &Uri,
        alias_id: &AliasID,
        share_id: &ShareID,
        chunk: &file::Chunk,
    ) -> crate::Result<()>;
 }
--- a/src/sharry/share.rs
+++ b/src/sharry/share.rs
@ -1,48 +0,0 @@
 use log::debug;
 use serde::{Deserialize, Serialize};
 use super::{
    alias::{Alias, SharryAlias},
    api::{NewShareRequest, NewShareResponse, NotifyShareResponse},
 };
 #[derive(Serialize, Deserialize, Debug)]
 pub struct Share {
    pub(super) id: String,
 }
 impl Share {
    pub fn create(
        http: &ureq::Agent,
        alias: &Alias,
        data: NewShareRequest,
    ) -> Result<Self, ureq::Error> {
        let res = (http.post(alias.get_endpoint("alias/upload/new")))
            .sharry_header(alias)
            .send_json(data)?
            .body_mut()
            .read_json::<NewShareResponse>()?;
        debug!("response: {res:?}");
        if !(res.success && (res.message == "Share created.")) {
            return Err(ureq::Error::Other("unexpected json response".into()));
        }
        Ok(Self { id: res.id })
    }
    pub fn notify(&self, http: &ureq::Agent, alias: &Alias) -> Result<(), ureq::Error> {
        let endpoint = alias.get_endpoint(format!("alias/mail/notify/{}", self.id));
        let res = (http.post(endpoint))
            .sharry_header(alias)
            .send_empty()?
            .body_mut()
            .read_json::<NotifyShareResponse>()?;
        debug!("response: {res:?}");
        Ok(())
    }
 }
--- a/src/sharry/uri.rs
+++ b/src/sharry/uri.rs
@ -0,0 +1,239 @@
 use std::{fmt, sync::LazyLock};
 use log::{debug, trace};
 use regex::{Captures, Regex};
 use serde::{Deserialize, Serialize};
 /// ID of a file in a Sharry share
 ///
 /// - impl `Clone` as this is just a String
 /// - impl `serde` for cachefile handling
 /// - impl `Display` for formatting compatibility
 /// - impl `AsRef<[u8]>` for hashing with `blake2b_simd`
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[cfg_attr(test, derive(Default))]
 pub struct Uri(String);
 impl fmt::Display for Uri {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.write_str(&self.0)
    }
 }
 impl AsRef<[u8]> for Uri {
    fn as_ref(&self) -> &[u8] {
        self.0.as_bytes()
    }
 }
 fn captured(caps: &Captures, name: &str) -> String {
    caps.name(name)
        .unwrap_or_else(|| panic!("{name:?} not captured"))
        .as_str()
        .to_string()
 }
 /// Pattern breakdown:
 /// - `^(?P<scheme>[^:/?#]+)://`    - capture scheme (anything but `:/?#`) + `"://"`
 /// - `(?P<host>[^/?#]+)`           - capture authority/host (anything but `/?#`)
 /// - `(/.*)?`                      - maybe trailing slash and some path
 /// - `$`                           - end of string
 static SHARRY_URI_RE: LazyLock<Regex> = LazyLock::new(|| {
    trace!("compiling SHARRY_URI_RE");
    Regex::new(r"^(?P<scheme>[^:/?#]+)://(?P<host>[^/?#]+)(/.*)?$")
        .expect("Regex compilation failed")
 });
 fn parse_url(value: &str) -> Option<(String, String)> {
    SHARRY_URI_RE
        .captures(value)
        .map(|caps| (captured(&caps, "scheme"), captured(&caps, "host")))
 }
 impl From<String> for Uri {
    fn from(value: String) -> Self {
        trace!("TryFrom {value:?}");
        if let Some((scheme, host)) = parse_url(&value) {
            let result = Self(format!("{scheme}://{host}"));
            debug!("{result:?}");
            result
        } else {
            Self(value)
        }
    }
 }
 impl Uri {
    /// arbitrary endpoint in the Sharry API v2
    fn endpoint(&self, path: fmt::Arguments) -> String {
        let uri = format!("{}/api/v2/{path}", self.0);
        trace!("endpoint: {uri:?}");
        uri
    }
    /// Sharry API endpoint to create a new share
    pub fn share_create(&self) -> String {
        self.endpoint(format_args!("alias/upload/new"))
    }
    /// Sharry API endpoint to ping a share's notification hook
    pub fn share_notify(&self, share_id: &super::ShareID) -> String {
        self.endpoint(format_args!("alias/mail/notify/{share_id}"))
    }
    /// Sharry API endpoint to create a new file inside a share
    pub fn file_create(&self, share_id: &super::ShareID) -> String {
        self.endpoint(format_args!("alias/upload/{share_id}/files/tus"))
    }
    /// Sharry API endpoint to push data into a file inside a share
    pub fn file_patch(&self, share_id: &super::ShareID, file_id: &super::FileID) -> String {
        self.endpoint(format_args!("alias/upload/{share_id}/files/tus/{file_id}"))
    }
 }
 #[cfg(test)]
 mod tests {
    use super::*;
    use crate::{
        sharry::{FileID, ShareID},
        test_util::check_trait,
    };
    #[test]
    fn check_captured_works() {
        let cases = [
            // simple http host
            ("http://example.com", "http", "example.com"),
            // https host with port
            ("https://my-host:8080", "https", "my-host:8080"),
            // trailing slash
            ("scheme://host/", "scheme", "host"),
            // with path
            ("scheme://host/path/to/whatever", "scheme", "host"),
            // custom scheme
            ("custom+scheme://host", "custom+scheme", "host"),
        ];
        for (good, scheme, host) in cases {
            let caps = SHARRY_URI_RE.captures(good).unwrap();
            assert_eq!(captured(&caps, "scheme"), scheme);
            assert_eq!(captured(&caps, "host"), host);
        }
    }
    #[test]
    #[should_panic = "\"foo\" not captured"]
    fn make_captured_panic() {
        let caps = SHARRY_URI_RE.captures("http://example.com").unwrap();
        captured(&caps, "foo");
    }
    #[test]
    fn basic_traits_working() {
        let cases = [
            // simple http host
            "http://example.com",
            // https host with port
            "https://my-host:8080",
            // custom scheme
            "custom+scheme://host",
        ];
        for uri_data in cases {
            let uri = Uri(uri_data.to_string());
            check_trait(uri.to_string(), uri_data, "Display", "Uri");
            check_trait(uri.as_ref(), uri_data.as_bytes(), "AsRef<[u8]>", "Uri");
        }
    }
    #[test]
    fn valid_urls_produce_expected_uri() {
        let cases = [
            // simple http host
            ("http://example.com", "http://example.com"),
            // https host with port
            ("https://my-host:8080", "https://my-host:8080"),
            // trailing slash
            ("scheme://host/", "scheme://host"),
            // with path
            ("scheme://host/path/to/whatever", "scheme://host"),
            // custom scheme
            ("custom+scheme://host", "custom+scheme://host"),
        ];
        for (good, expected) in cases {
            let uri = Uri::from(good.to_string());
            check_trait(uri.0, expected, "From<String>", "Uri");
        }
    }
    #[test]
    fn invalid_urls_passed_through() {
        let cases = [
            // missing “://”
            "http:/example.com",
            // missing scheme
            "://example.com",
            // missing host
            "http://",
            "ftp://?query",
            // totally malformed
            "just-a-string",
            "",
            "///",
        ];
        for bad in cases {
            let uri = Uri::from(bad.to_string());
            check_trait(uri.0, bad, "From<String>", "Uri");
        }
    }
    #[test]
    fn test_endpoint() {
        let cases = [
            // simple path
            ("path/to/something", "/api/v2/path/to/something"),
            // underscores, hyphens, dots
            ("bob_smith-son.eve", "/api/v2/bob_smith-son.eve"),
            // unicode
            ("漢字ユーザー", "/api/v2/漢字ユーザー"),
            // empty path
            ("", "/api/v2/"),
            // leading/trailing spaces
            ("  frank  ", "/api/v2/  frank  "),
            // uppercase
            ("GUEST", "/api/v2/GUEST"),
            // numeric
            ("12345", "/api/v2/12345"),
        ];
        let uri = Uri::default();
        for (path, expected) in cases {
            assert_eq!(&expected, &uri.endpoint(format_args!("{path}")));
        }
    }
    #[test]
    fn test_pub_endpoints() {
        let uri = Uri::default();
        let share_id = ShareID::from("sid".to_string());
        let file_id = FileID::new_test("fid".to_string());
        assert_eq!("/api/v2/alias/upload/new", uri.share_create());
        assert_eq!("/api/v2/alias/mail/notify/sid", uri.share_notify(&share_id));
        assert_eq!(
            "/api/v2/alias/upload/sid/files/tus",
            uri.file_create(&share_id)
        );
        assert_eq!(
            "/api/v2/alias/upload/sid/files/tus/fid",
            uri.file_patch(&share_id, &file_id)
        );
    }
 }
--- a/src/test_util/data.rs
+++ b/src/test_util/data.rs
@ -0,0 +1,118 @@
 /// test dataset
 const DATA: [&[u8]; 8] = [
    // empty slice
    b"",
    // single-byte
    b"x",
    // common ascii pangram
    b"The quick brown fox jumps over the lazy dog",
    // ascii with punctuation and digits
    b"Rust v1.65.0 - Memory Safety, Speed, Concurrency!",
    // simple unicode (utf-8) greeting
    "こんにちは世界".as_bytes(),
    // pseudo-random bytes with embedded nuls
    &[
        0x3C, 0xA7, 0x5D, 0xE1, 0x4F, 0x99, 0x00, 0x20, 0x7F, 0xB3, 0xCD, 0x8A, 0x10, 0x55, 0xAA,
        0xFF, 0x5E, 0xA3, 0x1F, 0xC8, 0x72, 0x4D, 0x99, 0x00, 0xB7, 0x3C, 0x8E, 0xAD, 0x26, 0xF1,
    ],
    // long run of identical bytes (1 KiB of ascii 'A')
    &[b'A'; 1024],
    // very large slice (10 MiB of zeroes)
    &[0u8; 10 * 1024 * 1024],
 ];
 /// lengths of the test dataset
 const DATA_LENGTHS: [u64; 8] = [
    DATA[0].len() as u64,
    DATA[1].len() as u64,
    DATA[2].len() as u64,
    DATA[3].len() as u64,
    DATA[4].len() as u64,
    DATA[5].len() as u64,
    DATA[6].len() as u64,
    DATA[7].len() as u64,
 ];
 /// anything but the lengths of the test dataset
 pub const DATA_LENGTHS_BAD: [u64; 8] = [36, 12, 1, 0, 9, 24, 13, 10];
 /// known good hashes of the test dataset
 ///
 /// using `BLAKE2b`, 512 bit, with unpadded Base64 (standard variant)
 pub const HASHES_STD_GOOD: [&str; 8] = [
    // empty slice
    "eGoC90IBWQPGxv2FJVLScpEvR0DhWEdhiobiF/cfVBnSXhAxr+5YUxOJZESTTrBLkDpoWxRIt1XVb3Aa/pvizg",
    // single-byte
    "CQk3etNREMr7KQnhhWcrfyco0fUJT4rWjW+sYnS/H0mUhagOo2TATtAG0pRZ6jy3xgAoDi+D4DJSmQb4iuMNCg",
    // common ascii pangram
    "qK3Uvd39k+SHfSdG5igXsRY2Sh+nvBSNlQkLxzM7NnP4JAHPeqLkyx7NkCluPxTLVBP47Xe+cwRbE5FM3NapGA",
    // ascii with punctuation and digits
    "NOtceHp9LrSYpXvSP3ayPbgMUyX4hynBYt4KtHuwJDsv1ELco5QeUj9aJTYTqbw4KzRKY+RjsbR26N3smUeCmA",
    // simple unicode (utf-8) greeting
    "h3xQg25wr/XqaXgqXWJivbVgN89XQoZUN/JcSZB0jxOtkbVStY7hnO+pm3PnLv6yZ4ZDLrxzYpoBk05BR7Wo1A",
    // pseudo-random bytes with embedded nuls
    "kiUYjOegDM9n1ryWtZhukpTuZ8oZbhi2onpXNl6pg16R+JZj5ty4uJZs44YbCu0A9m35Xs3bi/mxfbSulbo5Rg",
    // long run of identical bytes (1 kib of ascii 'a')
    "xwGOG01h2kco4CgjJlD9T2v5bM8XVuCrYzKTM4D0s7rCnOH+HR1H2S2Tmg43M+ym1A+AEPTE4J7iGljgntTdZA",
    // very large slice (10 mib of zeroes)
    "xsHH9h63e1+254TSCQoWCl6L5eGOo0Zg+ubtQC8Inwj7dwW7oxg0kYCrnkuTRj+7bVYNjlRSDOa8OIdInp73wA",
 ];
 /// known bad version of `HASHES_STD_GOOD`
 pub const HASHES_STD_BAD: [&str; 8] = [
    // off by one character (last “z” -> “y”)
    "eGoC90IBWQPGxv2FJVLScpEvR0DhWEdhiobiF/cfVBnSXhAxr+5YUxOJZESTTrBLkDpoWxRIt1XVb3Aa/pviyg",
    // truncated by dropping the final 4 chars
    "CQk3etNREMr7KQnhhWcrfyco0fUJT4rWjW+sYnS/H0mUhagOo2TATtAG0pRZ6jy3xgAoDi+D4DJSmQb4iu",
    // contains a non‐Base64 character (“#”)
    "qK3Uvd39k+SHfSdG5igXsRY2Sh+nvBSNlQkLxzM7NnP4JAHPeqLkyx7NkCluPxTLVBP47Xe+cwRbE5FM3NapG#",
    // too long, extra “AA” at end
    "NOtceHp9LrSYpXvSP3ayPbgMUyX4hynBYt4KtHuwJDsv1ELco5QeUj9aJTYTqbw4KzRKY+RjsbR26N3smUeCmAAA",
    // one byte altered at the front (“h” -> “H”)
    "H3xQg25wr/XqaXgqXWJivbVgN89XQoZUN/JcSZB0jxOtkbVStY7hnO+pm3PnLv6yZ4ZDLrxzYpoBk05BR7Wo1A",
    // garbled mid‐section
    "kiUYjOegDM9n1ryWtZhukpTuZ8oZbhi2onpXYZ6pg16R+JZj5ty4uJZs44YbCu0A9m35Xs3bi/mxfbSulbo5Rg",
    // entirely different length (too short)
    "xwGOG01h2kco4CgjJlD9T2v5bM8XVuCrYzKTM4D0s7rCnO",
    // correct length, but all “A”s (obviously wrong)
    "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
 ];
 // /// known good hashes of the test dataset
 // ///
 // /// using BLAKE2b, 128 bit, with unpadded Base64 (url safe variant)
 // const HASHES_URL_GOOD: [&str; 8] = [
 //     // empty slice
 //     "########################################################",
 //     // single-byte
 //     "########################################################",
 //     // common ascii pangram
 //     "",
 //     // ascii with punctuation and digits
 //     "",
 //     // simple unicode (utf-8) greeting
 //     "",
 //     // pseudo-random bytes with embedded nuls
 //     "",
 //     // long run of identical bytes (1 kib of ascii 'a')
 //     "",
 //     // very large slice (10 mib of zeroes)
 //     "",
 // ];
 pub fn data() -> impl Iterator<Item = &'static [u8]> {
    DATA.iter().copied()
 }
 pub fn cases() -> impl Iterator<Item = (&'static [u8], u64)> {
    data().zip(DATA_LENGTHS)
 }
 pub fn cases_with<T>(addons: T) -> impl Iterator<Item = (&'static [u8], u64, T::Item)>
 where
    T: IntoIterator,
 {
    cases()
        .zip(addons)
        .map(|((data, len), addon)| (data, len, addon))
 }
--- a/src/test_util/mock_client.rs
+++ b/src/test_util/mock_client.rs
@ -0,0 +1,330 @@
 use std::{
    cell::{RefCell, RefMut},
    collections::{HashMap, hash_map::Entry},
 };
 use crate::{
    Error, Result, error_response,
    file::{self, FileTrait},
    sharry::{AliasID, Client, FileID, ShareID, Uri, json},
 };
 use super::mock_ids::CheckID;
 #[derive(Debug, Default)]
 pub struct MockClient {
    shares: RefCell<HashMap<String, MockShare>>,
 }
 #[derive(Debug, Default)]
 struct MockShare {
    files: HashMap<String, MockFile>,
 }
 #[derive(Debug, Default)]
 struct MockFile {
    size: u64,
    offset: u64,
 }
 impl From<&file::Checked> for MockFile {
    fn from(value: &file::Checked) -> Self {
        Self {
            size: value.get_size(),
            offset: 0,
        }
    }
 }
 impl MockClient {
    fn insert_share(&self, share_id: &ShareID, share: MockShare) -> Result<()> {
        let mut shares = self.shares.borrow_mut();
        let Entry::Vacant(entry) = shares.entry(share_id.to_string()) else {
            return Err(error_response!("can't insert share {share_id:?}!"));
        };
        entry.insert(share);
        Ok(())
    }
    fn insert_file(&self, share_id: &ShareID, file_id: &FileID, file: MockFile) -> Result<()> {
        let mut share = self.get_share(share_id)?;
        let Entry::Vacant(entry) = share.files.entry(file_id.to_string()) else {
            return Err(error_response!("can't insert file {file_id:?}!"));
        };
        entry.insert(file);
        Ok(())
    }
    fn get_share<'t>(&'t self, share_id: &ShareID) -> Result<RefMut<'t, MockShare>> {
        let share_id = &share_id.to_string();
        let shares = self.shares.borrow_mut();
        // check share exists
        shares
            .get(share_id)
            .ok_or_else(|| error_response!("can't find share {share_id:?}!"))?;
        Ok(RefMut::map(shares, |shares| {
            shares.get_mut(share_id).unwrap()
        }))
    }
    fn get_file<'t>(
        &'t self,
        share_id: &ShareID,
        file_id: &FileID,
    ) -> Result<RefMut<'t, MockFile>> {
        let file_id = &file_id.to_string();
        let share = self.get_share(share_id)?;
        // check file exists
        share
            .files
            .get(file_id)
            .ok_or_else(|| error_response!("can't find file {file_id:?}!"))?;
        Ok(RefMut::map(share, move |share| {
            share.files.get_mut(file_id).unwrap()
        }))
    }
 }
 impl Client for MockClient {
    fn share_create(
        &self,
        uri: &Uri,
        alias_id: &AliasID,
        _: json::NewShareRequest,
    ) -> Result<ShareID> {
        (uri, alias_id).check()?;
        let share_id = true.into();
        self.insert_share(&share_id, MockShare::default())?;
        Ok(share_id)
    }
    fn share_notify(&self, uri: &Uri, alias_id: &AliasID, share_id: &ShareID) -> crate::Result<()> {
        (uri, alias_id).check()?;
        share_id.check()?;
        let _share = self.get_share(share_id)?;
        Ok(())
    }
    fn file_create(
        &self,
        uri: &Uri,
        alias_id: &AliasID,
        share_id: &ShareID,
        file: &file::Checked,
    ) -> Result<FileID> {
        (uri, alias_id).check()?;
        share_id.check()?;
        let file_id = true.into();
        self.insert_file(share_id, &file_id, file.into())?;
        Ok(file_id)
    }
    fn file_patch(
        &self,
        uri: &Uri,
        alias_id: &AliasID,
        share_id: &ShareID,
        chunk: &file::Chunk,
    ) -> Result<()> {
        (uri, alias_id).check()?;
        (share_id, chunk.get_file_id()).check()?;
        let file = self.get_file(share_id, chunk.get_file_id())?;
        if chunk.get_length() == 0 {
            return Err(error_response!("chunk {chunk:?} empty!"));
        } else if chunk.get_offset() % (1024 * 1024) != 0 {
            return Err(error_response!("chunk {chunk:?} not aligned to a MiB!"));
        } else if chunk.get_offset() != file.offset {
            return Error::mismatch(file.offset, chunk.get_offset());
        } else if file.offset + chunk.get_length() > file.size {
            return Err(error_response!("chunk {chunk:?} too long!"));
        }
        let mut file = file;
        file.offset += chunk.get_length();
        Ok(())
    }
 }
 // technically redundant, but kept for refactoring purposes
 #[cfg(test)]
 mod tests {
    use std::collections::HashSet;
    use super::*;
    fn check_tostr_eq<L, R>(left: L, right: R)
    where
        L: ExactSizeIterator,
        L::Item: ToString,
        R: ExactSizeIterator,
        R::Item: ToString,
    {
        assert_eq!(left.len(), right.len());
        let l_strings: HashSet<_> = left.map(|s| s.to_string()).collect();
        let r_strings: HashSet<_> = right.map(|s| s.to_string()).collect();
        assert_eq!(l_strings, r_strings);
    }
    fn add_share(client: &MockClient) -> ShareID {
        let share_id = true.into();
        client
            .insert_share(&share_id, MockShare::default())
            .unwrap();
        share_id
    }
    fn add_file(client: &MockClient, share_id: &ShareID) -> FileID {
        let file_id = true.into();
        client
            .insert_file(share_id, &file_id, MockFile::default())
            .unwrap();
        file_id
    }
    #[test]
    fn insert_share_works() {
        let client = MockClient::default();
        let share_ids: [_; 10] = std::array::from_fn(|_| true.into());
        for share_id in share_ids.as_ref() {
            assert!(client.insert_share(share_id, MockShare::default()).is_ok());
        }
        check_tostr_eq(client.shares.borrow().keys(), share_ids.iter());
    }
    #[test]
    fn insert_share_double_errors() {
        let client = MockClient::default();
        let share_ids: [_; 10] = std::array::from_fn(|_| add_share(&client));
        for share_id in share_ids.as_ref() {
            let res = client.insert_share(share_id, MockShare::default());
            assert!(res.is_err());
            assert!(res.unwrap_err().response_contains("can't insert share"));
        }
    }
    #[test]
    fn get_share_works() {
        let client = MockClient::default();
        let share_ids: [_; 10] = std::array::from_fn(|_| add_share(&client));
        for share_id in share_ids.as_ref() {
            assert!(client.get_share(share_id).is_ok());
        }
    }
    #[test]
    fn get_share_nex_errors() {
        let client = MockClient::default();
        add_share(&client);
        let share_ids_nex: [_; 10] = std::array::from_fn(|_| true.into());
        for share_id_nex in share_ids_nex.as_ref() {
            let res = client.get_share(share_id_nex);
            assert!(res.is_err());
            assert!(res.unwrap_err().response_contains("can't find share"));
        }
    }
    #[test]
    fn insert_file_works() {
        let client = MockClient::default();
        let share_id = add_share(&client);
        let file_ids: [_; 10] = std::array::from_fn(|_| true.into());
        for file_id in file_ids.as_ref() {
            assert!(
                client
                    .insert_file(&share_id, file_id, MockFile::default())
                    .is_ok()
            );
        }
        let shares = client.shares.borrow();
        let share = shares.get(&share_id.to_string()).unwrap();
        check_tostr_eq(share.files.keys(), file_ids.iter());
    }
    #[test]
    fn insert_file_nex_share_errors() {
        let client = MockClient::default();
        add_share(&client);
        let share_id_nex = ShareID::default();
        let res = client.insert_file(&share_id_nex, &true.into(), MockFile::default());
        assert!(res.is_err());
        assert!(res.unwrap_err().response_contains("can't find share"));
    }
    #[test]
    fn insert_file_double_errors() {
        let client = MockClient::default();
        let share_id = add_share(&client);
        let file_ids: [_; 10] = std::array::from_fn(|_| add_file(&client, &share_id));
        for file_id in file_ids.as_ref() {
            let res = client.insert_file(&share_id, file_id, MockFile::default());
            assert!(res.is_err());
            assert!(res.unwrap_err().response_contains("can't insert file"));
        }
    }
    #[test]
    fn get_file_works() {
        let client = MockClient::default();
        let share_id = add_share(&client);
        let file_ids: [_; 10] = std::array::from_fn(|_| add_file(&client, &share_id));
        for file_id in file_ids.as_ref() {
            assert!(client.get_file(&share_id, file_id).is_ok());
        }
    }
    #[test]
    fn get_file_nex_errors() {
        let client = MockClient::default();
        let share_id = add_share(&client);
        add_file(&client, &share_id);
        let file_ids_nex: [_; 10] = std::array::from_fn(|_| true.into());
        for file_id_nex in file_ids_nex.as_ref() {
            let share_id_nex = true.into();
            let res = client.get_file(&share_id_nex, file_id_nex);
            assert!(res.is_err());
            assert!(res.unwrap_err().response_contains("can't find share"));
            let res = client.get_file(&share_id, file_id_nex);
            assert!(res.is_err());
            assert!(res.unwrap_err().response_contains("can't find file"));
        }
    }
 }
--- a/src/test_util/mock_ids.rs
+++ b/src/test_util/mock_ids.rs
@ -0,0 +1,176 @@
 use uuid::Uuid;
 use crate::{
    Result,
    sharry::{AliasID, FileID, ShareID, Uri},
 };
 const VALID_URI: &str = "scheme://valid.uri";
 const VALID_ALIAS: &str = "valid-alias";
 const VALID_SHARE: &str = "valid-share";
 const VALID_FILE: &str = "valid-file";
 fn make_invalid(valid: &str) -> String {
    let invalid = valid.replace("valid", "invalid");
    assert_ne!(invalid, valid);
    invalid
 }
 fn make_valid(valid: &str) -> String {
    let invalid = make_invalid(valid);
    let valid = {
        let id = Uuid::now_v1(&[4, 8, 15, 16, 23, 42]);
        valid.replace("valid", &id.to_string())
    };
    assert_ne!(valid, invalid);
    valid
 }
 pub trait CheckID {
    fn check(self) -> Result<()>;
 }
 impl CheckID for (&Uri, &AliasID) {
    fn check(self) -> Result<()> {
        if self.0.to_string() == make_invalid(VALID_URI) {
            Err(self.0.into())
        } else if self.1.as_ref() == make_invalid(VALID_ALIAS) {
            Err(self.1.into())
        } else {
            Ok(())
        }
    }
 }
 impl CheckID for &ShareID {
    fn check(self) -> Result<()> {
        if self.to_string() == make_invalid(VALID_SHARE) {
            Err(self.into())
        } else {
            Ok(())
        }
    }
 }
 impl CheckID for (&ShareID, &FileID) {
    fn check(self) -> Result<()> {
        self.0.check()?;
        if self.1.to_string() == make_invalid(VALID_FILE) {
            Err(self.1.into())
        } else {
            Ok(())
        }
    }
 }
 impl From<bool> for Uri {
    fn from(value: bool) -> Self {
        if value {
            make_valid(VALID_URI).into()
        } else {
            make_invalid(VALID_URI).into()
        }
    }
 }
 impl From<bool> for AliasID {
    fn from(value: bool) -> Self {
        if value {
            make_valid(VALID_ALIAS).into()
        } else {
            make_invalid(VALID_ALIAS).into()
        }
    }
 }
 impl From<bool> for ShareID {
    fn from(value: bool) -> Self {
        if value {
            make_valid(VALID_SHARE).into()
        } else {
            make_invalid(VALID_SHARE).into()
        }
    }
 }
 impl From<bool> for FileID {
    fn from(value: bool) -> Self {
        if value {
            Self::new_test(make_valid(VALID_FILE))
        } else {
            Self::new_test(make_invalid(VALID_FILE))
        }
    }
 }
 // technically redundant, but kept for refactoring purposes
 #[cfg(test)]
 mod tests {
    use super::*;
    #[test]
    fn true_makes_valids() {
        let uri = Uri::from(true);
        let alias_id = AliasID::from(true);
        let share_id = ShareID::from(true);
        let file_id = FileID::from(true);
        assert!((&uri, &alias_id).check().is_ok());
        assert!(share_id.check().is_ok());
        assert!((&share_id, &file_id).check().is_ok());
    }
    #[test]
    fn default_is_valid() {
        let uri = Uri::default();
        let alias_id = AliasID::default();
        let share_id = ShareID::default();
        let file_id = FileID::default();
        assert!((&uri, &alias_id).check().is_ok());
        assert!(share_id.check().is_ok());
        assert!((&share_id, &file_id).check().is_ok());
    }
    #[test]
    fn false_makes_invalids() {
        use crate::Parameter;
        fn test_check(value: impl CheckID, callback: impl FnOnce(&Parameter) -> bool) {
            let check = value.check().unwrap_err();
            let p = check.get_invalid_param().unwrap();
            assert!(callback(p));
        }
        // valid ids
        let uri = Uri::from(true);
        let alias_id = AliasID::from(true);
        let share_id = ShareID::from(true);
        let file_id = FileID::from(true);
        // invalid ids
        let uri_i = Uri::from(false);
        let alias_id_i = AliasID::from(false);
        let share_id_i = ShareID::from(false);
        let file_id_i = FileID::from(false);
        // uri + alias
        test_check((&uri_i, &alias_id_i), Parameter::is_uri);
        test_check((&uri_i, &alias_id), Parameter::is_uri);
        test_check((&uri, &alias_id_i), Parameter::is_alias_id);
        // share
        test_check(&share_id_i, Parameter::is_share_id);
        // share + file
        test_check((&share_id_i, &file_id_i), Parameter::is_share_id);
        test_check((&share_id_i, &file_id), Parameter::is_share_id);
        test_check((&share_id, &file_id_i), Parameter::is_file_id);
    }
 }
--- a/src/test_util/mod.rs
+++ b/src/test_util/mod.rs
@ -0,0 +1,42 @@
 #![cfg(test)]
 pub mod data;
 mod mock_client;
 mod mock_ids;
 pub use mock_client::MockClient;
 use std::{fmt, io::Write};
 use tempfile::NamedTempFile;
 #[allow(clippy::needless_pass_by_value)]
 pub fn check_trait<A, E>(actual: A, expected: E, tr: &str, ty: &str)
 where
    A: fmt::Debug + PartialEq<E>,
    E: fmt::Debug,
 {
    assert_eq!(
        actual, expected,
        "`impl {tr} for {ty}` expected: {expected:?}, actual: {actual:?}",
    );
 }
 /// Helper to create a temp file from `data`
 pub fn create_file(data: &[u8]) -> NamedTempFile {
    let mut tmp = NamedTempFile::new().unwrap();
    tmp.write_all(data).unwrap();
    tmp
 }
 // technically redundant, but kept for refactoring purposes
 #[cfg(test)]
 mod tests {
    use super::*;
    #[test]
    #[should_panic = "`impl foo for bar` expected: 1, actual: 0"]
    fn make_check_trait_panic() {
        check_trait(0, 1, "foo", "bar");
    }
 }
--- a/src/ureq_client.rs
+++ b/src/ureq_client.rs
@ -0,0 +1,179 @@
 use log::{debug, trace};
 use crate::{
    file::{self, FileTrait},
    sharry::{self, AliasID, FileID, ShareID, Uri},
 };
 fn find_cause(
    uri: &Uri,
    alias_id: &AliasID,
    share_id: Option<&ShareID>,
    file_id: Option<&FileID>,
 ) -> impl FnOnce(ureq::Error) -> crate::Error {
    move |error| match error {
        ureq::Error::StatusCode(403) => {
            trace!("HTTP Error 403: Alias not found!");
            alias_id.into()
        }
        ureq::Error::StatusCode(404) => {
            trace!("HTTP Error 404: Share and/or file may have been deleted!");
            if let Some(file_id) = file_id {
                file_id.into()
            } else if let Some(share_id) = share_id {
                share_id.into()
            } else {
                uri.into()
            }
        }
        ureq::Error::Io(error) => {
            trace!("std::io::Error {error:?}");
            if let Some(msg) = error.get_ref().map(ToString::to_string) {
                if msg.starts_with("failed to lookup address information") {
                    uri.into()
                } else {
                    error.into()
                }
            } else {
                error.into()
            }
        }
        error => crate::Error::Unknown(error.to_string()),
    }
 }
 impl sharry::Client for ureq::Agent {
    fn share_create(
        &self,
        uri: &Uri,
        alias_id: &AliasID,
        data: sharry::json::NewShareRequest,
    ) -> crate::Result<ShareID> {
        let res = {
            let endpoint = uri.share_create();
            let mut res = self
                .post(&endpoint)
                .header("Sharry-Alias", alias_id.as_ref())
                .send_json(data)
                .map_err(find_cause(uri, alias_id, None, None))?;
            trace!("{endpoint:?} response: {res:?}");
            crate::Error::res_status_check(res.status(), ureq::http::StatusCode::OK)?;
            res.body_mut()
                .read_json::<sharry::json::NewShareResponse>()
                .map_err(crate::Error::response)?
        };
        debug!("{res:?}");
        if res.success && (res.message == "Share created.") {
            trace!("new share id: {:?}", res.id);
            Ok(res.id.into())
        } else {
            crate::Error::mismatch("success/\"Share created.\"", format_args!("{res:?}"))
        }
    }
    fn share_notify(&self, uri: &Uri, alias_id: &AliasID, share_id: &ShareID) -> crate::Result<()> {
        let res = {
            let endpoint = uri.share_notify(share_id);
            let mut res = self
                .post(&endpoint)
                .header("Sharry-Alias", alias_id.as_ref())
                .send_empty()
                .map_err(find_cause(uri, alias_id, Some(share_id), None))?;
            trace!("{endpoint:?} response: {res:?}");
            crate::Error::res_status_check(res.status(), ureq::http::StatusCode::OK)?;
            res.body_mut()
                .read_json::<sharry::json::NotifyShareResponse>()
                .map_err(crate::Error::response)?
        };
        debug!("{res:?}");
        Ok(())
    }
    fn file_create(
        &self,
        uri: &Uri,
        alias_id: &AliasID,
        share_id: &ShareID,
        file: &file::Checked,
    ) -> crate::Result<FileID> {
        let res = {
            let endpoint = uri.file_create(share_id);
            let res = self
                .post(&endpoint)
                .header("Sharry-Alias", alias_id.as_ref())
                .header("Sharry-File-Name", file.get_name())
                .header("Upload-Length", file.get_size())
                .send_empty()
                .map_err(find_cause(uri, alias_id, Some(share_id), None))?;
            trace!("{endpoint:?} response: {res:?}");
            crate::Error::res_status_check(res.status(), ureq::http::StatusCode::CREATED)?;
            res
        };
        let location = (res.headers().get("Location"))
            .ok_or_else(|| crate::Error::response("Location header not found"))?
            .to_str()
            .map_err(crate::Error::response)?
            .to_string();
        FileID::try_from(location)
    }
    fn file_patch(
        &self,
        uri: &Uri,
        alias_id: &AliasID,
        share_id: &ShareID,
        chunk: &file::Chunk,
    ) -> crate::Result<()> {
        let res = {
            let endpoint = uri.file_patch(share_id, chunk.get_file_id());
            let res = self
                .patch(&endpoint)
                .header("Sharry-Alias", alias_id.as_ref())
                .header("Upload-Offset", chunk.get_offset())
                .send(chunk.get_data())
                .map_err(find_cause(
                    uri,
                    alias_id,
                    Some(share_id),
                    Some(chunk.get_file_id()),
                ))?;
            trace!("{endpoint:?} response: {res:?}");
            crate::Error::res_status_check(res.status(), ureq::http::StatusCode::NO_CONTENT)?;
            res
        };
        let res_offset = (res.headers().get("Upload-Offset"))
            .ok_or_else(|| crate::Error::response("Upload-Offset header not found"))?
            .to_str()
            .map_err(crate::Error::response)?
            .parse::<u64>()
            .map_err(crate::Error::response)?;
        let next_offset = chunk.get_offset() + chunk.get_length();
        if res_offset == next_offset {
            Ok(())
        } else {
            crate::Error::mismatch(format_args!("Upload-Offset {next_offset:?}"), res_offset)
        }
    }
 }
Author	SHA1	Message	Date
Jörn-Michael Miehe	6e0baa138a	prefer `into()`	2025-07-15 15:34:23 +00:00
Jörn-Michael Miehe	a5ecf19f70	[wip] unit tests for `file` module - testing for `Uploading`	2025-07-15 15:00:11 +00:00
Jörn-Michael Miehe	aa76c7efda	clippy fix	2025-07-15 14:55:29 +00:00
Jörn-Michael Miehe	147c78377a	better error assertions	2025-07-15 14:54:27 +00:00
Jörn-Michael Miehe	9e56779378	fix devcontainer	2025-07-15 13:10:08 +00:00
Jörn-Michael Miehe	5358d8e68f	[wip] unit tests for `mock_client` module	2025-07-14 21:55:16 +00:00
Jörn-Michael Miehe	66f59b4b3b	[wip] unit tests - re-added redundant `tests` submodules for good form	2025-07-14 20:58:28 +00:00
Jörn-Michael Miehe	22eeada52a	[wip] unit tests for `mock_share` module	2025-07-14 15:48:37 +00:00
Jörn-Michael Miehe	1ac4db28ed	[wip] unit tests - strip unneeded mod `test_util::mock_ids::tests` - coverage for `sharry::uri`	2025-07-14 15:20:21 +00:00
Jörn-Michael Miehe	037e59df4f	cargo upgrade	2025-07-13 16:40:57 +00:00
Jörn-Michael Miehe	98e4e96073	fix linter issues	2025-07-13 16:23:22 +00:00
Jörn-Michael Miehe	50098edc81	[wip] unit tests for `file` module - testing/coverage for module	2025-07-12 02:04:30 +00:00
Jörn-Michael Miehe	910d95230f	Merge branch 'develop' into feature/unit_tests	2025-07-12 01:33:17 +00:00
Jörn-Michael Miehe	117faee583	use `devcontainers-extra` repo	2025-07-12 01:33:08 +00:00
Jörn-Michael Miehe	2900715a74	[wip] unit testing - styling, `test_util::make_check_trait_panic`	2025-07-12 01:32:10 +00:00
Jörn-Michael Miehe	6167ebc98a	[wip] unit tests for `file` module - testing for `Uploading`	2025-07-12 01:31:28 +00:00
Jörn-Michael Miehe	47ad51f860	Merge branch 'develop' into feature/unit_tests	2025-07-10 13:24:13 +00:00
Jörn-Michael Miehe	b77ab83ae0	de-nesting and `LazyLock` usage	2025-07-10 13:23:28 +00:00
Jörn-Michael Miehe	53fdb6cc97	[wip] unit tests - use `unwrap` while testing	2025-07-10 13:19:27 +00:00
Jörn-Michael Miehe	bd9aa77d6c	[wip] unit tests for `file` module - testing for `Uploading`	2025-07-10 12:59:38 +00:00
Jörn-Michael Miehe	ab76563b83	`new_direct` -> unsafe `new_unchecked`	2025-07-10 11:00:35 +00:00
Jörn-Michael Miehe	2248d8fdd1	[wip] unit testing - tooling for code coverage measurement	2025-07-10 02:59:02 +00:00
Jörn-Michael Miehe	7bbb2bbc19	[wip] unit tests for `file` module - finalize `Chunk` coverage	2025-07-10 02:48:11 +00:00
Jörn-Michael Miehe	b2c032d846	[wip] unit tests for `file` module - testing for `Checked`	2025-07-10 02:04:29 +00:00
Jörn-Michael Miehe	cb5873b732	[wip] unit testing - tooling for code coverage measurement	2025-07-10 01:50:46 +00:00
Jörn-Michael Miehe	96ea0ddab9	[wip] unit testing - tooling for code coverage measurement	2025-07-09 17:02:37 +00:00
Jörn-Michael Miehe	4d47530326	[wip] unit testing - doc for `file` module	2025-07-09 17:02:12 +00:00
Jörn-Michael Miehe	b3bccbbf65	[wip] unit testing - minor refactoring	2025-07-09 15:57:47 +00:00
Jörn-Michael Miehe	d4cc102a0f	[wip] unit tests for `file` module - test for `Checked::start_upload`	2025-07-09 15:57:43 +00:00
Jörn-Michael Miehe	3257a97351	[wip] unit testing - mock impl for `sharry::Client` and associated IDs	2025-07-08 21:41:38 +00:00
Jörn-Michael Miehe	908e0031e2	[wip] unit testing - mock impl for `sharry::Client` and associated IDs	2025-07-08 16:17:41 +00:00
Jörn-Michael Miehe	f03bcb46b6	move TODO to lib	2025-07-07 19:41:28 +00:00
Jörn-Michael Miehe	655db21ef4	clippy fix	2025-07-07 19:40:56 +00:00
Jörn-Michael Miehe	11515a4158	[wip] unit testing - refactored mock impl for IDs	2025-07-07 19:33:31 +00:00
Jörn-Michael Miehe	51cf212bb6	[wip] unit testing - mock impl for `sharry::Client` and associated IDs	2025-07-07 16:26:10 +00:00
Jörn-Michael Miehe	65f1e5d083	minor fixes	2025-07-07 16:11:38 +00:00
Jörn-Michael Miehe	c609f51c6a	doc for `file::Chunk`	2025-07-06 00:02:51 +00:00
Jörn-Michael Miehe	f573b61ad1	`crate::Error::mismatch` refactor	2025-07-06 00:01:46 +00:00
Jörn-Michael Miehe	4ad9e28bc7	[wip] unit tests for `file` module - test value generation for `sharry::{id, uri}` - testing for `Chunk`	2025-07-05 23:03:42 +00:00
Jörn-Michael Miehe	4ff1f34b08	refactor `check_trait` function	2025-07-05 23:00:54 +00:00
Jörn-Michael Miehe	3f5fa86f3a	rename `impl_ureq` -> `ureq_client`	2025-07-05 01:39:38 +00:00
Jörn-Michael Miehe	f988c80854	[wip] unit tests for `file` module - move test data to `test_util::data`	2025-07-05 01:37:00 +00:00
Jörn-Michael Miehe	389e33e512	[wip] unit tests for `file` module - testing for `Checked` - better place for test-only utilities	2025-07-04 23:55:26 +00:00
Jörn-Michael Miehe	1ac110ddfb	[wip] unit tests for `file` module - testing for `Checked`	2025-07-04 17:13:48 +00:00
Jörn-Michael Miehe	95dcc25e0d	[wip] unit tests for `file` module - testing for `Checked`	2025-07-04 17:06:01 +00:00
Jörn-Michael Miehe	a34aa968b4	[wip] documentation and minor refactoring	2025-07-03 22:55:33 +00:00
Jörn-Michael Miehe	6ba17d57df	clippy fix	2025-07-03 19:15:35 +00:00
Jörn-Michael Miehe	52d455e219	Merge branch 'develop' into feature/unit_tests	2025-07-03 19:12:37 +00:00
Jörn-Michael Miehe	7e4bd398c2	elided lifetimes	2025-07-03 19:10:22 +00:00
Jörn-Michael Miehe	5a34a8d791	[wip] documentation for `file` module	2025-07-03 18:31:13 +00:00
Jörn-Michael Miehe	61d62d731e	[wip] unit tests for `file` module - testing for `compute_hash` and `check_hash`	2025-07-03 17:20:56 +00:00
Jörn-Michael Miehe	6814f74484	`base64` usage	2025-07-03 16:20:39 +00:00
Jörn-Michael Miehe	6c385ffeea	[wip] unit tests for `file` module - testing for `compute_hash` and `check_hash`	2025-07-03 16:18:46 +00:00
Jörn-Michael Miehe	cab6d13d28	test data in arrays, not `vec!`	2025-07-03 15:43:26 +00:00
Jörn-Michael Miehe	cca35e1ae8	[wip] unit tests for `file` module - testing for `compute_hash`	2025-07-03 15:39:29 +00:00
Jörn-Michael Miehe	aa16cc9ede	Merge branch 'develop' into feature/unit_tests	2025-07-03 14:21:41 +00:00
Jörn-Michael Miehe	0efde0e134	clippy fix	2025-07-03 14:21:02 +00:00
Jörn-Michael Miehe	b9e553f112	use `base64` crate instead of `base64ct`, no constant time necessary	2025-07-03 14:20:30 +00:00
Jörn-Michael Miehe	ea453da433	[wip] unit tests for `sharry` module - doc + testing for `uri` module	2025-07-03 13:10:19 +00:00
Jörn-Michael Miehe	b01eb69e95	Merge branch 'develop' into feature/unit_tests	2025-07-03 13:07:20 +00:00
Jörn-Michael Miehe	fada53044d	`sharry::ids` formatting	2025-07-03 13:07:09 +00:00
Jörn-Michael Miehe	67b048f9ac	use `to_string` instead of `to_owned` where applicable	2025-07-03 13:05:56 +00:00
Jörn-Michael Miehe	a7cddf3205	Merge branch 'develop' into feature/unit_tests	2025-07-03 13:05:09 +00:00
Jörn-Michael Miehe	46913e93b9	use `to_string` instead of `to_owned` where applicable	2025-07-03 13:02:13 +00:00
Jörn-Michael Miehe	470ebc4305	`uri::Uri` creation	2025-07-03 12:58:53 +00:00
Jörn-Michael Miehe	f4e0bc5be4	[wip] unit tests for `sharry` module - doc + testing for `uri` module	2025-07-03 11:07:32 +00:00
Jörn-Michael Miehe	abf76c9df7	move `check_trait` to crate root	2025-07-03 10:32:46 +00:00
Jörn-Michael Miehe	2cc13f24e7	minor refactoring - untangle `CacheFile::{rewind_chunk, abort_upload}` - change `file::Uploading::rewind` signature to a more "builder"esque pattern	2025-07-02 12:01:07 +00:00
Jörn-Michael Miehe	ad1854dfb8	[wip] unit tests for `sharry` module - makeover for `json` module	2025-07-02 11:39:49 +00:00
Jörn-Michael Miehe	d891e6d1c4	[wip] unit tests for `sharry` module - `ids` done	2025-07-01 19:12:48 +00:00
Jörn-Michael Miehe	91085a9eec	Merge branch 'develop' into feature/unit_tests	2025-07-01 18:56:33 +00:00
Jörn-Michael Miehe	d55684096f	remove unneeded macro param in `error::impl_error_from`	2025-07-01 18:51:49 +00:00
Jörn-Michael Miehe	de208a20d5	clippy fix	2025-07-01 15:24:26 +00:00
Jörn-Michael Miehe	3bfdf87277	Merge branch 'develop' into feature/unit_tests	2025-07-01 15:20:18 +00:00
Jörn-Michael Miehe	0d68d139d5	improved error handling	2025-07-01 15:20:07 +00:00
Jörn-Michael Miehe	2eb651f919	[wip] doc for `sharry` module	2025-06-28 09:24:46 +00:00
Jörn-Michael Miehe	903fbc3480	[wip] unit tests for `sharry` module	2025-06-27 16:59:31 +00:00
Jörn-Michael Miehe	bc4c15d17c	consolidate `sharry` module	2025-06-27 08:34:13 +00:00
Jörn-Michael Miehe	c10d86ff65	Merge branch 'feature/api_structs' into develop	2025-06-27 08:30:18 +00:00
Jörn-Michael Miehe	3f00e08422	consolidate `sharry::api` module	2025-06-27 08:29:57 +00:00
Jörn-Michael Miehe	357f455ec0	import strategy for error module (cont.)	2025-06-27 02:03:49 +00:00
Jörn-Michael Miehe	e3fc06b019	Merge branch 'develop' into feature/api_structs	2025-06-27 02:02:36 +00:00
Jörn-Michael Miehe	2315c9cd2e	import strategy for error module	2025-06-27 01:55:43 +00:00
Jörn-Michael Miehe	c7b24b1250	add `id::{AliasID, ShareID}`	2025-06-27 01:47:38 +00:00
Jörn-Michael Miehe	d8c48b74ca	remove unnecessary `impl AsRef<str> for FileID`	2025-06-26 10:15:54 +00:00
Jörn-Michael Miehe	d37797d2ec	clippy fix	2025-06-26 10:13:23 +00:00
Jörn-Michael Miehe	e0c5b5517f	better unit testing for `FileID`	2025-06-26 10:06:43 +00:00
Jörn-Michael Miehe	087cef5d6f	Merge branch 'develop' into feature/api_structs	2025-06-26 09:59:59 +00:00
Jörn-Michael Miehe	b17f239801	create `Error::Mismatch` variant	2025-06-26 09:56:29 +00:00
Jörn-Michael Miehe	9de8f948dc	update notes	2025-06-26 00:28:08 +00:00
Jörn-Michael Miehe	5adbf8cb38	ProgressBar handling simplification	2025-06-26 00:08:18 +00:00
Jörn-Michael Miehe	3258b8fb74	prompt user before rebuilding share	2025-06-25 23:52:16 +00:00
Jörn-Michael Miehe	c9c21aa128	split `api.rs` into modules - `id` for multiple "ID" types - `json` for types directly interacting with the Sharry API - `uri` for the `Uri` type - activate testing	2025-06-25 23:43:57 +00:00
Jörn-Michael Miehe	f1c6eb5d75	create `struct sharry::api::FileID`	2025-06-25 23:20:57 +00:00
Jörn-Michael Miehe	f2b063ba85	minor changes - adjust `main` log levels - lower default upload chunk size to utilize common cache sizes	2025-06-25 22:52:46 +00:00
Jörn-Michael Miehe	4c88ea7291	Merge branch 'feature/hashing' into develop	2025-06-25 22:48:53 +00:00
Jörn-Michael Miehe	465c857126	implement better hashing - move hashing back into `cachefile` to correctly handle the `rebuild_share` case - add `-n` / `--no-hash` CLI switch to explicitly skip hashing	2025-06-25 22:47:55 +00:00
Jörn-Michael Miehe	1f9c247439	Merge branch 'develop' into feature/hashing - with "clippy fix" and "cargo fmt"	2025-06-25 21:07:24 +00:00
Jörn-Michael Miehe	e391821fe5	adjust crate structure - move `sharry::client::ClientError` to `error::Error`	2025-06-25 16:48:00 +00:00
Jörn-Michael Miehe	9000c8a46b	clippy fix	2025-06-25 16:34:32 +00:00
Jörn-Michael Miehe	d1d7b55585	adjust crate structure	2025-06-25 16:34:22 +00:00
Jörn-Michael Miehe	78fb04403c	`main` adjust log levels	2025-06-25 16:12:52 +00:00
Jörn-Michael Miehe	0b8bebad6e	implement better hashing - actually, calling `file::Checked::hash` in `AppState::from_args` was correct: If `AppState::rebuild_share` is called, hashes are in a known state. - call `check_hash` in `AppState::try_resume` - minor renamings	2025-06-25 10:44:36 +00:00
Jörn-Michael Miehe	11a5106473	implement better hashing - call `file::Checked::hash` in `CacheFile::from_args` instead	2025-06-24 22:25:22 +00:00
Jörn-Michael Miehe	ea5ef1fa10	implement better hashing - call `file::Checked::hash` in `AppState::from_args`	2025-06-24 19:34:11 +00:00
Jörn-Michael Miehe	2bcbc0d71c	implement better hashing - use `blake2b_simd` crate and optimize	2025-06-24 19:27:13 +00:00
Jörn-Michael Miehe	97e9e41117	error 404 defaults to "bad URI"	2025-06-24 16:31:31 +00:00
Jörn-Michael Miehe	6e553cc185	implement better hashing - use Blake2b128 for the CLI arguments hash	2025-06-24 16:29:38 +00:00
Jörn-Michael Miehe	ece742a1e3	ureq error message parsing	2025-06-24 02:08:35 +00:00
Jörn-Michael Miehe	1e05155cc1	minor refactoring	2025-06-24 02:05:27 +00:00
Jörn-Michael Miehe	005c5f7cfa	move `AppState::is_done` into `AppState::upload_chunk`	2025-06-24 01:53:27 +00:00
Jörn-Michael Miehe	14e1bed708	unwrap `AppState::progress` RefCell	2025-06-24 01:35:21 +00:00
Jörn-Michael Miehe	72e9a5d40f	styling/doc	2025-06-24 01:28:09 +00:00
Jörn-Michael Miehe	a8ff354a51	fix some progressbar issues	2025-06-24 01:11:36 +00:00
Jörn-Michael Miehe	686e0c3e5c	Merge branch 'feature/rebuild_share' into develop	2025-06-24 00:25:19 +00:00
Jörn-Michael Miehe	5b403ea129	Merge branch 'develop' into feature/rebuild_share	2025-06-24 00:23:09 +00:00
Jörn-Michael Miehe	540953e4a9	notes	2025-06-24 00:18:36 +00:00
Jörn-Michael Miehe	c734355ebb	file names from args, not from appstate - remove `AppState::file_names`, `CacheFile::file_names`, `FileState::file_name` - add `Cli::file_names` - clippy fix	2025-06-24 00:18:26 +00:00
Jörn-Michael Miehe	393feec125	[wip] implement handling "missing share" - rework `CacheFile` API - fix `AppState` using new `CacheFile` - fix `main` using new `AppState` - logging enhancement	2025-06-24 00:11:24 +00:00
Jörn-Michael Miehe	df055fc4e9	[wip] implement handling "missing share" - rework `CacheFile` API - fix `AppState::{next_chunk, is_done}`	2025-06-19 10:34:28 +00:00
Jörn-Michael Miehe	865566ad0c	[wip] implement handling "missing share" - rework `CacheFile` API	2025-06-18 23:40:27 +00:00
Jörn-Michael Miehe	3b46d228f4	impl `AppState::requeue_file`	2025-06-18 20:03:26 +00:00
Jörn-Michael Miehe	79bc8e67a7	"verbose" CLI param	2025-06-18 18:58:49 +00:00
Jörn-Michael Miehe	4eb0627a5f	"retry-limit" CLI param	2025-06-18 18:44:24 +00:00
Jörn-Michael Miehe	a4bef827d1	fix clippy lint without `drop`	2025-06-18 18:14:39 +00:00
Jörn-Michael Miehe	a633f4e228	move most printing/styling into own file	2025-06-18 18:14:09 +00:00
Jörn-Michael Miehe	01bcf92d9c	clippy fix	2025-06-18 14:49:30 +00:00
Jörn-Michael Miehe	783346c888	major refactoring - `sharry::Client` fn signatures - `sharry::ClientError` rework - `file::Uploading` saves `file_id` instead of `patch_uri` - `impl sharry::Client for ureq::Agent` into separate file	2025-06-18 14:21:25 +00:00
Jörn-Michael Miehe	de07d556a2	minor refactoring - `use crate::` where appropriate - cleanup CLI parsing - `Uri::with_protocol` -> `Uri::new`	2025-06-18 13:04:04 +00:00
Jörn-Michael Miehe	6ca3e6c9dd	[wip] documentation - added more notes - minor cleanup	2025-06-15 00:56:58 +00:00
Jörn-Michael Miehe	4bf18631d4	bug: don't allow `chunk_size` of 0	2025-06-15 00:46:02 +00:00
Jörn-Michael Miehe	56223b3ae8	[wip] documentation - added more notes - `main.rs` logging - clearer matching of `ClientError::ResponseStatus`	2025-06-15 00:44:28 +00:00
Jörn-Michael Miehe	205af655e5	remove unnecessary `Uri::endpoint` call	2025-06-14 12:34:58 +00:00
Jörn-Michael Miehe	10bb4feef5	logging improvements	2025-06-14 00:07:43 +00:00
Jörn-Michael Miehe	e257d1cf8c	CLI ergonomy	2025-06-13 23:50:42 +00:00
Jörn-Michael Miehe	5b018cf84b	minor cleanups	2025-06-13 23:11:40 +00:00
Jörn-Michael Miehe	876869b073	Merge branch 'feature/retry_chunk' into develop	2025-06-13 23:05:16 +00:00
Jörn-Michael Miehe	e2151b592c	show "cargo build", program completion	2025-06-13 23:02:41 +00:00
Jörn-Michael Miehe	30855ed8ff	[wip] retry chunks - `AppState::rewind` impl - error handling in `main`	2025-06-13 23:00:36 +00:00
Jörn-Michael Miehe	0a8e5cf3f0	[wip] retry chunks - move buffer into main function again, avoiding `unsafe` code - partially revert `Chunk` changes, removing `unsafe` parts	2025-06-13 22:32:41 +00:00
Jörn-Michael Miehe	f05e112040	[wip] retry chunks - make `Chunk` lifetime agnostic by using a raw pointer - add `fn Uploading::rewind` - add `fn AppState::{next_chunk, is_done}`	2025-06-13 17:03:25 +00:00
Jörn-Michael Miehe	5556a658f5	minor refactoring - var names - logging	2025-06-13 16:07:25 +00:00
Jörn-Michael Miehe	09d22a0ad9	minor renamings	2025-06-12 23:43:03 +00:00
Jörn-Michael Miehe	f77acc1afd	cleanup some `unwrap()`	2025-06-12 23:28:42 +00:00
Jörn-Michael Miehe	4b650fd82f	Merge branch 'feature/sharry_client' into develop	2025-06-12 23:07:25 +00:00
Jörn-Michael Miehe	9f1e0cfc6c	[wip] impl `Client` for `ureq::Agent` - Client is now owned by `AppState` - minor cleanups	2025-06-12 23:01:16 +00:00
Jörn-Michael Miehe	b9a0e1eeb0	[wip] impl `Client` for `ureq::Agent` - progress bar handling - share notify timing	2025-06-12 22:29:01 +00:00
Jörn-Michael Miehe	2edc690331	[wip] impl `Client` for `ureq::Agent` - clippy fix	2025-06-12 16:25:15 +00:00
Jörn-Michael Miehe	ed10f269c8	[wip] impl `Client` for `ureq::Agent` - wip: factor out `SavedState`	2025-06-12 16:24:17 +00:00
Jörn-Michael Miehe	fb06725f05	[wip] impl `Client` for `ureq::Agent` - wip: factor out `SavedState`	2025-06-12 09:26:11 +00:00
Jörn-Michael Miehe	67da081ef9	[wip] impl `Client` for `ureq::Agent` - error handling refactoring	2025-06-12 00:54:26 +00:00
Jörn-Michael Miehe	9b1f7f872c	[wip] impl `Client` for `ureq::Agent` - minor refactorings	2025-06-11 18:17:16 +00:00
Jörn-Michael Miehe	592e7bf76e	[wip] impl `Client` for `ureq::Agent` - `AppState` creation	2025-06-11 00:28:23 +00:00
Jörn-Michael Miehe	0993679641	[wip] impl `Client` for `ureq::Agent` - clippy fix	2025-06-11 00:06:08 +00:00
Jörn-Michael Miehe	dc2a330d58	[wip] impl `Client` for `ureq::Agent` - Chunk implementation	2025-06-10 23:39:20 +00:00
Jörn-Michael Miehe	d607380659	[wip] impl `Client` for `ureq::Agent` - factored out `file` module - renamed some stuff - decoupled `sharry::client` from `file`	2025-06-10 18:20:52 +00:00
Jörn-Michael Miehe	69bef4e994	[wip] impl `Client` for `ureq::Agent` - impl `sharry_file_patch` - completely rework chunking logic	2025-06-10 01:17:17 +00:00
Jörn-Michael Miehe	c9528a9ac1	[wip] impl `Client` for `ureq::Agent` - use `sharry_file_create` in `AppState`	2025-06-09 00:05:58 +00:00
Jörn-Michael Miehe	09af480379	[wip] impl `Client` for `ureq::Agent` - remove `sharry::alias` and `sharry::share` (reduced to IDs) - use `sharry_share_create` in `AppState`	2025-06-08 21:31:50 +00:00
Jörn-Michael Miehe	90cecd015e	[wip] impl `Client` for `ureq::Agent`	2025-06-08 17:13:01 +00:00
Jörn-Michael Miehe	51ecab41bb	[wip] impl `Client` for `ureq::Agent`	2025-06-08 01:20:41 +00:00
Jörn-Michael Miehe	5b6fa3eaf7	minor imports refactoring	2025-06-08 00:40:29 +00:00
Jörn-Michael Miehe	e208df9711	move simplified SharryFile trait back into mod.rs	2025-06-06 23:48:22 +00:00
Jörn-Michael Miehe	e908c09beb	refactor: minimize `usize` usage	2025-06-06 23:42:18 +00:00
Jörn-Michael Miehe	3dc39edcab	minor refactoring and fixes	2025-06-06 22:25:39 +00:00
Jörn-Michael Miehe	e98001f4a4	implement SharryFile trait	2025-06-06 15:21:49 +00:00
Jörn-Michael Miehe	39560eeeed	mark and eliminate some unwrap	2025-06-05 22:08:24 +00:00
Jörn-Michael Miehe	faea74241d	progress bar refactoring	2025-06-05 21:37:52 +00:00
Jörn-Michael Miehe	8537684656	ideas	2025-06-05 17:47:42 +00:00
Jörn-Michael Miehe	e746256fdc	Merge tag '0.1.0-alpha' into develop First working version - distinct lack of comments - no testing (needs trait oriented implementation) - all `UploadError`s are treated equally	2025-06-05 17:47:17 +00:00