Commit

Message

Changed Files (7)

• modified CHANGELOG.md

  diff --git a/CHANGELOG.md b/CHANGELOG.md

  index 022d456..6955439 100644

  --- a/CHANGELOG.md

  +++ b/CHANGELOG.md

  @@ -5,6 +5,7 @@

  - Add parallel builder execution

  - Enable parallel cargo builds

  - Add Markdown builder and template

  +- *(cli)* Add UsageSpec command with clap_usage

  ## [0.5.1] - 2026-06-02

  ### 🚀 Features

• modified Cargo.lock

  diff --git a/Cargo.lock b/Cargo.lock

  index ec7cd37..acd4852 100644

  --- a/Cargo.lock

  +++ b/Cargo.lock

  @@ -17,6 +17,7 @@ dependencies = [

  "indicatif",

  "miette",

  "pulldown-cmark",

  + "reqwest",

  "schemars",

  "semver",

  "serde",

  @@ -154,6 +155,12 @@ dependencies = [

  "bytemuck",

  ]

  +[[package]]

  +name = "atomic-waker"

  +version = "1.1.2"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "1505bd5d3d116872e7271a6d4e16d81d0c8570876c8de68093a09ac269d8aac0"

  +

  [[package]]

  name = "autocfg"

  version = "1.5.1"

  @@ -184,6 +191,12 @@ dependencies = [

  "backtrace",

  ]

  +[[package]]

  +name = "base64"

  +version = "0.22.1"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "72b3254f16251a8381aa12e40e3c4d2f0199f8c6508fbecb9d91f575e0fbb8c6"

  +

  [[package]]

  name = "bitflags"

  version = "2.11.1"

  @@ -431,6 +444,17 @@ dependencies = [

  "crypto-common",

  ]

  +[[package]]

  +name = "displaydoc"

  +version = "0.2.6"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "1ac70aa55017e108007fbaf5aa0f54b021c98f92ff8af59d42eda9da96e3dd4f"

  +dependencies = [

  + "proc-macro2",

  + "quote",

  + "syn",

  +]

  +

  [[package]]

  name = "duct"

  version = "1.1.1"

  @@ -529,6 +553,24 @@ version = "0.1.5"

  source = "registry+https://github.com/rust-lang/crates.io-index"

  checksum = "d9c4f5dac5e15c24eb999c26181a6ca40b39fe946cbe4c263c7209467bc83af2"

  +[[package]]

  +name = "form_urlencoded"

  +version = "1.2.2"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "cb4cb245038516f5f85277875cdaa4f7d2c9a0fa0468de06ed190163b1581fcf"

  +dependencies = [

  + "percent-encoding",

  +]

  +

  +[[package]]

  +name = "futures-channel"

  +version = "0.3.32"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "07bbe89c50d7a535e539b8c17bc0b49bdb77747034daa8087407d655f3f7cc1d"

  +dependencies = [

  + "futures-core",

  +]

  +

  [[package]]

  name = "futures-core"

  version = "0.3.32"

  @@ -579,8 +621,24 @@ source = "registry+https://github.com/rust-lang/crates.io-index"

  checksum = "ff2abc00be7fca6ebc474524697ae276ad847ad0a6b3faa4bcb027e9a4614ad0"

  dependencies = [

  "cfg-if",

  + "js-sys",

  "libc",

  "wasi",

  + "wasm-bindgen",

  +]

  +

  +[[package]]

  +name = "getrandom"

  +version = "0.3.4"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "899def5c37c4fd7b2664648c28120ecec138e4d395b459e5ca34f9cce2dd77fd"

  +dependencies = [

  + "cfg-if",

  + "js-sys",

  + "libc",

  + "r-efi 5.3.0",

  + "wasip2",

  + "wasm-bindgen",

  ]

  [[package]]

  @@ -591,7 +649,7 @@ checksum = "0de51e6874e94e7bf76d726fc5d13ba782deca734ff60d5bb2fb2607c7406555"

  dependencies = [

  "cfg-if",

  "libc",

  - "r-efi",

  + "r-efi 6.0.0",

  "wasip2",

  "wasip3",

  ]

  @@ -659,6 +717,45 @@ dependencies = [

  "windows 0.61.3",

  ]

  +[[package]]

  +name = "http"

  +version = "1.4.1"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "8be7462df143984c4598a256ef469b251d7d7f9e271135073e78fc535414f3d0"

  +dependencies = [

  + "bytes",

  + "itoa",

  +]

  +

  +[[package]]

  +name = "http-body"

  +version = "1.0.1"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "1efedce1fb8e6913f23e0c92de8e62cd5b772a67e7b3946df930a62566c93184"

  +dependencies = [

  + "bytes",

  + "http",

  +]

  +

  +[[package]]

  +name = "http-body-util"

  +version = "0.1.3"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "b021d93e26becf5dc7e1b75b1bed1fd93124b374ceb73f43d4d4eafec896a64a"

  +dependencies = [

  + "bytes",

  + "futures-core",

  + "http",

  + "http-body",

  + "pin-project-lite",

  +]

  +

  +[[package]]

  +name = "httparse"

  +version = "1.10.1"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "6dbf3de79e51f3d586ab4cb9d5c3e2c14aa28ed23d180cf89b4df0454a69cc87"

  +

  [[package]]

  name = "human-panic"

  version = "2.0.5"

  @@ -684,6 +781,65 @@ dependencies = [

  "libm",

  ]

  +[[package]]

  +name = "hyper"

  +version = "1.10.1"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "55281c53a1894c864990125767da440a4e630446785086f52523b20033b74498"

  +dependencies = [

  + "atomic-waker",

  + "bytes",

  + "futures-channel",

  + "futures-core",

  + "http",

  + "http-body",

  + "httparse",

  + "itoa",

  + "pin-project-lite",

  + "smallvec",

  + "tokio",

  + "want",

  +]

  +

  +[[package]]

  +name = "hyper-rustls"

  +version = "0.27.9"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "33ca68d021ef39cf6463ab54c1d0f5daf03377b70561305bb89a8f83aab66e0f"

  +dependencies = [

  + "http",

  + "hyper",

  + "hyper-util",

  + "rustls",

  + "tokio",

  + "tokio-rustls",

  + "tower-service",

  + "webpki-roots",

  +]

  +

  +[[package]]

  +name = "hyper-util"

  +version = "0.1.20"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "96547c2556ec9d12fb1578c4eaf448b04993e7fb79cbaad930a656880a6bdfa0"

  +dependencies = [

  + "base64",

  + "bytes",

  + "futures-channel",

  + "futures-util",

  + "http",

  + "http-body",

  + "hyper",

  + "ipnet",

  + "libc",

  + "percent-encoding",

  + "pin-project-lite",

  + "socket2",

  + "tokio",

  + "tower-service",

  + "tracing",

  +]

  +

  [[package]]

  name = "iana-time-zone"

  version = "0.1.65"

  @@ -708,12 +864,114 @@ dependencies = [

  "cc",

  ]

  +[[package]]

  +name = "icu_collections"

  +version = "2.1.1"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "4c6b649701667bbe825c3b7e6388cb521c23d88644678e83c0c4d0a621a34b43"

  +dependencies = [

  + "displaydoc",

  + "potential_utf",

  + "yoke",

  + "zerofrom",

  + "zerovec",

  +]

  +

  +[[package]]

  +name = "icu_locale_core"

  +version = "2.1.1"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "edba7861004dd3714265b4db54a3c390e880ab658fec5f7db895fae2046b5bb6"

  +dependencies = [

  + "displaydoc",

  + "litemap",

  + "tinystr",

  + "writeable",

  + "zerovec",

  +]

  +

  +[[package]]

  +name = "icu_normalizer"

  +version = "2.1.1"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "5f6c8828b67bf8908d82127b2054ea1b4427ff0230ee9141c54251934ab1b599"

  +dependencies = [

  + "icu_collections",

  + "icu_normalizer_data",

  + "icu_properties",

  + "icu_provider",

  + "smallvec",

  + "zerovec",

  +]

  +

  +[[package]]

  +name = "icu_normalizer_data"

  +version = "2.1.1"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "7aedcccd01fc5fe81e6b489c15b247b8b0690feb23304303a9e560f37efc560a"

  +

  +[[package]]

  +name = "icu_properties"

  +version = "2.1.2"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "020bfc02fe870ec3a66d93e677ccca0562506e5872c650f893269e08615d74ec"

  +dependencies = [

  + "icu_collections",

  + "icu_locale_core",

  + "icu_properties_data",

  + "icu_provider",

  + "zerotrie",

  + "zerovec",

  +]

  +

  +[[package]]

  +name = "icu_properties_data"

  +version = "2.1.2"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "616c294cf8d725c6afcd8f55abc17c56464ef6211f9ed59cccffe534129c77af"

  +

  +[[package]]

  +name = "icu_provider"

  +version = "2.1.1"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "85962cf0ce02e1e0a629cc34e7ca3e373ce20dda4c4d7294bbd0bf1fdb59e614"

  +dependencies = [

  + "displaydoc",

  + "icu_locale_core",

  + "writeable",

  + "yoke",

  + "zerofrom",

  + "zerotrie",

  + "zerovec",

  +]

  +

  [[package]]

  name = "id-arena"

  version = "2.3.0"

  source = "registry+https://github.com/rust-lang/crates.io-index"

  checksum = "3d3067d79b975e8844ca9eb072e16b31c3c1c36928edf9c6789548c524d0d954"

  +[[package]]

  +name = "idna"

  +version = "1.1.0"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "3b0875f23caa03898994f6ddc501886a45c7d3d62d04d2d90788d47be1b1e4de"

  +dependencies = [

  + "idna_adapter",

  + "smallvec",

  + "utf8_iter",

  +]

  +

  +[[package]]

  +name = "idna_adapter"

  +version = "1.2.1"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "3acae9609540aa318d1bc588455225fb2085b9ed0c4f6bd0d9d5bcd86f1a0344"

  +dependencies = [

  + "icu_normalizer",

  + "icu_properties",

  +]

  +

  [[package]]

  name = "ignore"

  version = "0.4.25"

  @@ -762,6 +1020,12 @@ version = "0.1.15"

  source = "registry+https://github.com/rust-lang/crates.io-index"

  checksum = "c8fae54786f62fb2918dcfae3d568594e50eb9b5c25bf04371af6fe7516452fb"

  +[[package]]

  +name = "ipnet"

  +version = "2.12.0"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "d98f6fed1fde3f8c21bc40a1abb88dd75e67924f9cffc3ef95607bad8017f8e2"

  +

  [[package]]

  name = "is_ci"

  version = "1.2.0"

  @@ -842,6 +1106,12 @@ version = "0.12.1"

  source = "registry+https://github.com/rust-lang/crates.io-index"

  checksum = "32a66949e030da00e8c7d4434b251670a91556f4144941d37452769c25d58a53"

  +[[package]]

  +name = "litemap"

  +version = "0.8.2"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "92daf443525c4cce67b150400bc2316076100ce0b3686209eb8cf3c31612e6f0"

  +

  [[package]]

  name = "lock_api"

  version = "0.4.14"

  @@ -857,6 +1127,12 @@ version = "0.4.30"

  source = "registry+https://github.com/rust-lang/crates.io-index"

  checksum = "616ec5685824bcc94416c6d4a7a446eea774a31efd7062c8480ba6fd06d7a6e5"

  +[[package]]

  +name = "lru-slab"

  +version = "0.1.2"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "112b39cec0b298b6c1999fee3e31427f74f676e4cb9879ed1a121b43661a4154"

  +

  [[package]]

  name = "matchers"

  version = "0.2.0"

  @@ -1218,7 +1494,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"

  checksum = "3c80231409c20246a13fddb31776fb942c38553c51e871f8cbd687a4cfb5843d"

  dependencies = [

  "phf_shared",

  - "rand",

  + "rand 0.8.6",

  ]

  [[package]]

  @@ -1242,6 +1518,15 @@ version = "1.13.1"

  source = "registry+https://github.com/rust-lang/crates.io-index"

  checksum = "c33a9471896f1c69cecef8d20cbe2f7accd12527ce60845ff44c153bb2a21b49"

  +[[package]]

  +name = "potential_utf"

  +version = "0.1.5"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "0103b1cef7ec0cf76490e969665504990193874ea05c85ff9bab8b911d0a0564"

  +dependencies = [

  + "zerovec",

  +]

  +

  [[package]]

  name = "ppv-lite86"

  version = "0.2.21"

  @@ -1302,6 +1587,61 @@ version = "0.11.0"

  source = "registry+https://github.com/rust-lang/crates.io-index"

  checksum = "007d8adb5ddab6f8e3f491ac63566a7d5002cc7ed73901f72057943fa71ae1ae"

  +[[package]]

  +name = "quinn"

  +version = "0.11.9"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "b9e20a958963c291dc322d98411f541009df2ced7b5a4f2bd52337638cfccf20"

  +dependencies = [

  + "bytes",

  + "cfg_aliases",

  + "pin-project-lite",

  + "quinn-proto",

  + "quinn-udp",

  + "rustc-hash",

  + "rustls",

  + "socket2",

  + "thiserror",

  + "tokio",

  + "tracing",

  + "web-time",

  +]

  +

  +[[package]]

  +name = "quinn-proto"

  +version = "0.11.14"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "434b42fec591c96ef50e21e886936e66d3cc3f737104fdb9b737c40ffb94c098"

  +dependencies = [

  + "bytes",

  + "getrandom 0.3.4",

  + "lru-slab",

  + "rand 0.9.4",

  + "ring",

  + "rustc-hash",

  + "rustls",

  + "rustls-pki-types",

  + "slab",

  + "thiserror",

  + "tinyvec",

  + "tracing",

  + "web-time",

  +]

  +

  +[[package]]

  +name = "quinn-udp"

  +version = "0.5.14"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "addec6a0dcad8a8d96a771f815f0eaf55f9d1805756410b39f5fa81332574cbd"

  +dependencies = [

  + "cfg_aliases",

  + "libc",

  + "once_cell",

  + "socket2",

  + "tracing",

  + "windows-sys 0.60.2",

  +]

  +

  [[package]]

  name = "quote"

  version = "1.0.45"

  @@ -1311,6 +1651,12 @@ 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 = "r-efi"

  version = "6.0.0"

  @@ -1324,8 +1670,18 @@ source = "registry+https://github.com/rust-lang/crates.io-index"

  checksum = "5ca0ecfa931c29007047d1bc58e623ab12e5590e8c7cc53200d5202b69266d8a"

  dependencies = [

  "libc",

  - "rand_chacha",

  - "rand_core",

  + "rand_chacha 0.3.1",

  + "rand_core 0.6.4",

  +]

  +

  +[[package]]

  +name = "rand"

  +version = "0.9.4"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "44c5af06bb1b7d3216d91932aed5265164bf384dc89cd6ba05cf59a35f5f76ea"

  +dependencies = [

  + "rand_chacha 0.9.0",

  + "rand_core 0.9.5",

  ]

  [[package]]

  @@ -1335,7 +1691,17 @@ source = "registry+https://github.com/rust-lang/crates.io-index"

  checksum = "e6c10a63a0fa32252be49d21e7709d4d4baf8d231c2dbce1eaa8141b9b127d88"

  dependencies = [

  "ppv-lite86",

  - "rand_core",

  + "rand_core 0.6.4",

  +]

  +

  +[[package]]

  +name = "rand_chacha"

  +version = "0.9.0"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "d3022b5f1df60f26e1ffddd6c66e8aa15de382ae63b3a0c1bfc0e4d3e3f325cb"

  +dependencies = [

  + "ppv-lite86",

  + "rand_core 0.9.5",

  ]

  [[package]]

  @@ -1347,6 +1713,15 @@ dependencies = [

  "getrandom 0.2.17",

  ]

  +[[package]]

  +name = "rand_core"

  +version = "0.9.5"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "76afc826de14238e6e8c374ddcc1fa19e374fd8dd986b0d2af0d02377261d83c"

  +dependencies = [

  + "getrandom 0.3.4",

  +]

  +

  [[package]]

  name = "redox_syscall"

  version = "0.5.18"

  @@ -1405,6 +1780,58 @@ version = "0.8.10"

  source = "registry+https://github.com/rust-lang/crates.io-index"

  checksum = "dc897dd8d9e8bd1ed8cdad82b5966c3e0ecae09fb1907d58efaa013543185d0a"

  +[[package]]

  +name = "reqwest"

  +version = "0.12.28"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "eddd3ca559203180a307f12d114c268abf583f59b03cb906fd0b3ff8646c1147"

  +dependencies = [

  + "base64",

  + "bytes",

  + "futures-core",

  + "http",

  + "http-body",

  + "http-body-util",

  + "hyper",

  + "hyper-rustls",

  + "hyper-util",

  + "js-sys",

  + "log",

  + "percent-encoding",

  + "pin-project-lite",

  + "quinn",

  + "rustls",

  + "rustls-pki-types",

  + "serde",

  + "serde_json",

  + "serde_urlencoded",

  + "sync_wrapper",

  + "tokio",

  + "tokio-rustls",

  + "tower",

  + "tower-http",

  + "tower-service",

  + "url",

  + "wasm-bindgen",

  + "wasm-bindgen-futures",

  + "web-sys",

  + "webpki-roots",

  +]

  +

  +[[package]]

  +name = "ring"

  +version = "0.17.14"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "a4689e6c2294d81e88dc6261c768b63bc4fcdb852be6d1352498b114f61383b7"

  +dependencies = [

  + "cc",

  + "cfg-if",

  + "getrandom 0.2.17",

  + "libc",

  + "untrusted",

  + "windows-sys 0.52.0",

  +]

  +

  [[package]]

  name = "roff"

  version = "0.2.2"

  @@ -1417,6 +1844,12 @@ version = "0.1.27"

  source = "registry+https://github.com/rust-lang/crates.io-index"

  checksum = "b50b8869d9fc858ce7266cce0194bd74df58b9d0e3f6df3a9fc8eb470d95c09d"

  +[[package]]

  +name = "rustc-hash"

  +version = "2.1.2"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "94300abf3f1ae2e2b8ffb7b58043de3d399c73fa6f4b73826402a5c457614dbe"

  +

  [[package]]

  name = "rustix"

  version = "1.1.4"

  @@ -1430,12 +1863,53 @@ dependencies = [

  "windows-sys 0.61.2",

  ]

  +[[package]]

  +name = "rustls"

  +version = "0.23.40"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "ef86cd5876211988985292b91c96a8f2d298df24e75989a43a3c73f2d4d8168b"

  +dependencies = [

  + "once_cell",

  + "ring",

  + "rustls-pki-types",

  + "rustls-webpki",

  + "subtle",

  + "zeroize",

  +]

  +

  +[[package]]

  +name = "rustls-pki-types"

  +version = "1.14.1"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "30a7197ae7eb376e574fe940d068c30fe0462554a3ddbe4eca7838e049c937a9"

  +dependencies = [

  + "web-time",

  + "zeroize",

  +]

  +

  +[[package]]

  +name = "rustls-webpki"

  +version = "0.103.13"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "61c429a8649f110dddef65e2a5ad240f747e85f7758a6bccc7e5777bd33f756e"

  +dependencies = [

  + "ring",

  + "rustls-pki-types",

  + "untrusted",

  +]

  +

  [[package]]

  name = "rustversion"

  version = "1.0.22"

  source = "registry+https://github.com/rust-lang/crates.io-index"

  checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d"

  +[[package]]

  +name = "ryu"

  +version = "1.0.23"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "9774ba4a74de5f7b1c1451ed6cd5285a32eddb5cccb8cc655a4e50009e06477f"

  +

  [[package]]

  name = "same-file"

  version = "1.0.6"

  @@ -1554,6 +2028,18 @@ dependencies = [

  "serde_core",

  ]

  +[[package]]

  +name = "serde_urlencoded"

  +version = "0.7.1"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "d3491c14715ca2294c4d6a88f15e84739788c1d030eed8c110436aafdaa2f3fd"

  +dependencies = [

  + "form_urlencoded",

  + "itoa",

  + "ryu",

  + "serde",

  +]

  +

  [[package]]

  name = "sha2"

  version = "0.10.9"

  @@ -1678,6 +2164,12 @@ dependencies = [

  "windows-sys 0.61.2",

  ]

  +[[package]]

  +name = "stable_deref_trait"

  +version = "1.2.1"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "6ce2be8dc25455e1f91df71bfa12ad37d7af1092ae736f3a6cd0e37bc7810596"

  +

  [[package]]

  name = "strsim"

  version = "0.11.1"

  @@ -1705,6 +2197,12 @@ dependencies = [

  "syn",

  ]

  +[[package]]

  +name = "subtle"

  +version = "2.6.1"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "13c2bddecc57b384dee18652358fb23172facb8a2c51ccc10d74c157bdea3292"

  +

  [[package]]

  name = "supports-color"

  version = "3.0.2"

  @@ -1737,6 +2235,26 @@ dependencies = [

  "unicode-ident",

  ]

  +[[package]]

  +name = "sync_wrapper"

  +version = "1.0.2"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "0bf256ce5efdfa370213c1dabab5935a12e49f2c58d15e9eac2870d3b4f27263"

  +dependencies = [

  + "futures-core",

  +]

  +

  +[[package]]

  +name = "synstructure"

  +version = "0.13.2"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "728a70f3dbaf5bab7f0c4b1ac8d7ae5ea60a4b5549c8a5914361c99147a709d2"

  +dependencies = [

  + "proc-macro2",

  + "quote",

  + "syn",

  +]

  +

  [[package]]

  name = "sysinfo"

  version = "0.34.2"

  @@ -1788,7 +2306,7 @@ dependencies = [

  "percent-encoding",

  "pest",

  "pest_derive",

  - "rand",

  + "rand 0.8.6",

  "regex",

  "serde",

  "serde_json",

  @@ -1845,6 +2363,31 @@ dependencies = [

  "cfg-if",

  ]

  +[[package]]

  +name = "tinystr"

  +version = "0.8.3"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "c8323304221c2a851516f22236c5722a72eaa19749016521d6dff0824447d96d"

  +dependencies = [

  + "displaydoc",

  + "zerovec",

  +]

  +

  +[[package]]

  +name = "tinyvec"

  +version = "1.11.0"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "3e61e67053d25a4e82c844e8424039d9745781b3fc4f32b8d55ed50f5f667ef3"

  +dependencies = [

  + "tinyvec_macros",

  +]

  +

  +[[package]]

  +name = "tinyvec_macros"

  +version = "0.1.1"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "1f3ccbac311fea05f86f61904b462b55fb3df8837a366dfc601a0161d0532f20"

  +

  [[package]]

  name = "tokio"

  version = "1.52.3"

  @@ -1873,6 +2416,16 @@ dependencies = [

  "syn",

  ]

  +[[package]]

  +name = "tokio-rustls"

  +version = "0.26.4"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "1729aa945f29d91ba541258c8df89027d5792d85a8841fb65e8bf0f4ede4ef61"

  +dependencies = [

  + "rustls",

  + "tokio",

  +]

  +

  [[package]]

  name = "toml"

  version = "0.8.23"

  @@ -1974,6 +2527,51 @@ version = "1.1.1+spec-1.1.0"

  source = "registry+https://github.com/rust-lang/crates.io-index"

  checksum = "756daf9b1013ebe47a8776667b466417e2d4c5679d441c26230efd9ef78692db"

  +[[package]]

  +name = "tower"

  +version = "0.5.3"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "ebe5ef63511595f1344e2d5cfa636d973292adc0eec1f0ad45fae9f0851ab1d4"

  +dependencies = [

  + "futures-core",

  + "futures-util",

  + "pin-project-lite",

  + "sync_wrapper",

  + "tokio",

  + "tower-layer",

  + "tower-service",

  +]

  +

  +[[package]]

  +name = "tower-http"

  +version = "0.6.11"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "4cfcf7e2740e6fc6d4d688b4ef00650406bb94adf4731e43c096c3a19fe40840"

  +dependencies = [

  + "bitflags",

  + "bytes",

  + "futures-util",

  + "http",

  + "http-body",

  + "pin-project-lite",

  + "tower",

  + "tower-layer",

  + "tower-service",

  + "url",

  +]

  +

  +[[package]]

  +name = "tower-layer"

  +version = "0.3.3"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "121c2a6cda46980bb0fcd1647ffaf6cd3fc79a013de288782836f6df9c48780e"

  +

  +[[package]]

  +name = "tower-service"

  +version = "0.3.3"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "8df9b6e13f2d32c91b9bd719c00d1958837bc7dec474d94952798cc8e69eeec3"

  +

  [[package]]

  name = "tracing"

  version = "0.1.44"

  @@ -2036,6 +2634,12 @@ dependencies = [

  "tracing-log",

  ]

  +[[package]]

  +name = "try-lock"

  +version = "0.2.5"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "e421abadd41a4225275504ea4d6566923418b7f05506fbc9c0fe86ba7396114b"

  +

  [[package]]

  name = "typenum"

  version = "1.20.1"

  @@ -2099,6 +2703,24 @@ version = "0.2.6"

  source = "registry+https://github.com/rust-lang/crates.io-index"

  checksum = "ebc1c04c71510c7f702b52b7c350734c9ff1295c464a03335b00bb84fc54f853"

  +[[package]]

  +name = "untrusted"

  +version = "0.9.0"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "8ecb6da28b8a351d773b68d5825ac39017e680750f980f3a1a85cd8dd28a47c1"

  +

  +[[package]]

  +name = "url"

  +version = "2.5.8"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "ff67a8a4397373c3ef660812acab3268222035010ab8680ec4215f38ba3d0eed"

  +dependencies = [

  + "form_urlencoded",

  + "idna",

  + "percent-encoding",

  + "serde",

  +]

  +

  [[package]]

  name = "usage-lib"

  version = "2.18.2"

  @@ -2123,6 +2745,12 @@ dependencies = [

  "xx",

  ]

  +[[package]]

  +name = "utf8_iter"

  +version = "1.0.4"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "b6c140620e7ffbb22c2dee59cafe6084a59b5ffc27a8859a5f0d494b5d52b6be"

  +

  [[package]]

  name = "utf8parse"

  version = "0.2.2"

  @@ -2170,6 +2798,15 @@ dependencies = [

  "winapi-util",

  ]

  +[[package]]

  +name = "want"

  +version = "0.3.1"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "bfa7760aed19e106de2c7c0b581b509f2f25d3dacaf737cb82ac61bc6d760b0e"

  +dependencies = [

  + "try-lock",

  +]

  +

  [[package]]

  name = "wasi"

  version = "0.11.1+wasi-snapshot-preview1"

  @@ -2207,6 +2844,16 @@ dependencies = [

  "wasm-bindgen-shared",

  ]

  +[[package]]

  +name = "wasm-bindgen-futures"

  +version = "0.4.72"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "9473dbd2991ae90b6291c3c32c30c6187ac49aa32f9905d1cce280ec1e110b0f"

  +dependencies = [

  + "js-sys",

  + "wasm-bindgen",

  +]

  +

  [[package]]

  name = "wasm-bindgen-macro"

  version = "0.2.122"

  @@ -2273,6 +2920,16 @@ dependencies = [

  "semver",

  ]

  +[[package]]

  +name = "web-sys"

  +version = "0.3.99"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "6d621441cfc37b84979402712047321980c178f299193a3589d05b99e8763436"

  +dependencies = [

  + "js-sys",

  + "wasm-bindgen",

  +]

  +

  [[package]]

  name = "web-time"

  version = "1.1.0"

  @@ -2283,6 +2940,15 @@ dependencies = [

  "wasm-bindgen",

  ]

  +[[package]]

  +name = "webpki-roots"

  +version = "1.0.7"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "52f5ee44c96cf55f1b349600768e3ece3a8f26010c05265ab73f945bb1a2eb9d"

  +dependencies = [

  + "rustls-pki-types",

  +]

  +

  [[package]]

  name = "widestring"

  version = "1.2.1"

  @@ -2512,6 +3178,15 @@ dependencies = [

  "windows-link 0.2.1",

  ]

  +[[package]]

  +name = "windows-sys"

  +version = "0.52.0"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "282be5f36a8ce781fad8c8ae18fa3f9beff57ec1b52cb3de0789201425d9a33d"

  +dependencies = [

  + "windows-targets 0.52.6",

  +]

  +

  [[package]]

  name = "windows-sys"

  version = "0.59.0"

  @@ -2795,6 +3470,12 @@ dependencies = [

  "wasmparser",

  ]

  +[[package]]

  +name = "writeable"

  +version = "0.6.3"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "1ffae5123b2d3fc086436f8834ae3ab053a283cfac8fe0a0b8eaae044768a4c4"

  +

  [[package]]

  name = "xattr"

  version = "1.6.1"

  @@ -2826,6 +3507,29 @@ version = "1.0.1"

  source = "registry+https://github.com/rust-lang/crates.io-index"

  checksum = "cfe53a6657fd280eaa890a3bc59152892ffa3e30101319d168b781ed6529b049"

  +[[package]]

  +name = "yoke"

  +version = "0.8.2"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "abe8c5fda708d9ca3df187cae8bfb9ceda00dd96231bed36e445a1a48e66f9ca"

  +dependencies = [

  + "stable_deref_trait",

  + "yoke-derive",

  + "zerofrom",

  +]

  +

  +[[package]]

  +name = "yoke-derive"

  +version = "0.8.2"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "de844c262c8848816172cef550288e7dc6c7b7814b4ee56b3e1553f275f1858e"

  +dependencies = [

  + "proc-macro2",

  + "quote",

  + "syn",

  + "synstructure",

  +]

  +

  [[package]]

  name = "zerocopy"

  version = "0.8.50"

  @@ -2846,6 +3550,66 @@ dependencies = [

  "syn",

  ]

  +[[package]]

  +name = "zerofrom"

  +version = "0.1.8"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "0ec05a11813ea801ff6d75110ad09cd0824ddba17dfe17128ea0d5f68e6c5272"

  +dependencies = [

  + "zerofrom-derive",

  +]

  +

  +[[package]]

  +name = "zerofrom-derive"

  +version = "0.1.7"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "11532158c46691caf0f2593ea8358fed6bbf68a0315e80aae9bd41fbade684a1"

  +dependencies = [

  + "proc-macro2",

  + "quote",

  + "syn",

  + "synstructure",

  +]

  +

  +[[package]]

  +name = "zeroize"

  +version = "1.8.2"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "b97154e67e32c85465826e8bcc1c59429aaaf107c1e4a9e53c8d8ccd5eff88d0"

  +

  +[[package]]

  +name = "zerotrie"

  +version = "0.2.4"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "0f9152d31db0792fa83f70fb2f83148effb5c1f5b8c7686c3459e361d9bc20bf"

  +dependencies = [

  + "displaydoc",

  + "yoke",

  + "zerofrom",

  +]

  +

  +[[package]]

  +name = "zerovec"

  +version = "0.11.6"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "90f911cbc359ab6af17377d242225f4d75119aec87ea711a880987b18cd7b239"

  +dependencies = [

  + "yoke",

  + "zerofrom",

  + "zerovec-derive",

  +]

  +

  +[[package]]

  +name = "zerovec-derive"

  +version = "0.11.3"

  +source = "registry+https://github.com/rust-lang/crates.io-index"

  +checksum = "625dc425cab0dca6dc3c3319506e6593dcb08a9f387ea3b284dbd52a92c40555"

  +dependencies = [

  + "proc-macro2",

  + "quote",

  + "syn",

  +]

  +

  [[package]]

  name = "zmij"

  version = "1.0.21"

• modified Cargo.toml

  diff --git a/Cargo.toml b/Cargo.toml

  index 3163d3c..23242b1 100644

  --- a/Cargo.toml

  +++ b/Cargo.toml

  @@ -36,6 +36,11 @@ toml = { version = "1.1.2", features = ["serde"] }

  tracing = { version = "0.1.44", features = ["log"] }

  tracing-subscriber = { version = "0.3", features = ["env-filter"] }

  +[dependencies.reqwest]

  +version = "0.12"

  +default-features = false

  +features = ["rustls-tls"]

  +

  [profile.release]

  opt-level = "z"

  strip = true

• added build.rs

  diff --git a/build.rs b/build.rs

  new file mode 100644

  index 0000000..441c1ae

  --- /dev/null

  +++ b/build.rs

  @@ -0,0 +1,6 @@

  +fn main() {

  + // Expose the compile-time target triple so the binary knows which artifact to download.

  + let target = std::env::var("TARGET").unwrap();

  + println!("cargo:rustc-env=TARGET={target}");

  + println!("cargo:rerun-if-changed=build.rs");

  +}

• modified src/cli.rs

  diff --git a/src/cli.rs b/src/cli.rs

  index 1656e91..50aef4d 100644

  --- a/src/cli.rs

  +++ b/src/cli.rs

  @@ -33,6 +33,12 @@ pub enum CliCommand {

  /// point your editor or TOML language server at it to get field descriptions and

  /// auto-completion while editing `abbaye.toml`.

  DumpSchema,

  + /// Check for a newer version of abbaye and update the binary if one is available.

  + SelfUpdate {

  + /// Only check whether an update is available; do not download or replace the binary.

  + #[arg(short, long)]

  + check: bool,

  + },

  /// Print a usage spec (https://usage.jdx.dev) to stdout.

  ///

  /// Pipe the output to the `usage` CLI to generate shell completions, man pages, or docs:

• modified src/main.rs

  diff --git a/src/main.rs b/src/main.rs

  index 14a380d..a59108a 100644

  --- a/src/main.rs

  +++ b/src/main.rs

  @@ -145,6 +145,8 @@ mod cli;

  pub mod config;

  /// Generates the site from the configuration and builds it.

  pub mod site;

  +/// Self-update logic: fetches the release feed and replaces the binary when a newer version exists.

  +mod updater;

  /// Extracts current version information from different sources (ex: git tags, cargo metadata, etc.).

  pub mod version_extractors;

  @@ -333,6 +335,9 @@ async fn main() -> Result<()> {

  serde_json::to_string_pretty(&schema).into_diagnostic()?

  );

  }

  + cli::CliCommand::SelfUpdate { check } => {

  + updater::self_update(check).await?;

  + }

  cli::CliCommand::UsageSpec => {

  let mut cmd = cli::CliArgs::command();

  clap_usage::generate(&mut cmd, "abbaye", &mut std::io::stdout());

• added src/updater.rs

  diff --git a/src/updater.rs b/src/updater.rs

  new file mode 100644

  index 0000000..37e1e71

  --- /dev/null

  +++ b/src/updater.rs

  @@ -0,0 +1,153 @@

  +//! Self-update logic for the `abbaye self-update` command.

  +//!

  +//! Fetches the project's Atom feed, finds the latest release version,

  +//! compares it against the running binary's version, and – unless `--check`

  +//! was passed – downloads the appropriate pre-built binary and atomically

  +//! replaces the current executable.

  +

  +use miette::{IntoDiagnostic, Result, miette};

  +use semver::Version;

  +use tracing::info;

  +

  +/// Compile-time target triple (e.g. `x86_64-unknown-linux-musl`).

  +const TARGET: &str = env!("TARGET");

  +/// Version baked in at compile time (e.g. `0.5.1`).

  +const CURRENT_VERSION: &str = env!("CARGO_PKG_VERSION");

  +/// Root URL of the release site.

  +const BASE_URL: &str = "https://vit.am/~ololduck/abbaye";

  +/// Atom feed URL.

  +const FEED_URL: &str = "https://vit.am/~ololduck/abbaye/releases.atom";

  +

  +/// Extract all semver-parseable versions from the `<title>` elements inside

  +/// `<entry>` blocks of an Atom feed.

  +///

  +/// The feed is generated by abbaye itself and has a predictable structure:

  +/// each entry's title appears on its own line as ` <title>X.Y.Z</title>`.

  +/// The feed-level `<title>Abbaye Releases</title>` will not parse as semver

  +/// and is silently ignored.

  +fn parse_versions_from_feed(xml: &str) -> Vec<Version> {

  + let mut versions = Vec::new();

  + let mut in_entry = false;

  +

  + for line in xml.lines() {

  + let trimmed = line.trim();

  + if trimmed.starts_with("<entry>") {

  + in_entry = true;

  + } else if trimmed == "</entry>" {

  + in_entry = false;

  + } else if in_entry {

  + if let Some(rest) = trimmed.strip_prefix("<title>") {

  + if let Some(title) = rest.strip_suffix("</title>") {

  + // Strip a leading 'v' in case the title ever includes it.

  + let v = title.strip_prefix('v').unwrap_or(title);

  + if let Ok(version) = Version::parse(v) {

  + versions.push(version);

  + }

  + }

  + }

  + }

  + }

  +

  + versions

  +}

  +

  +/// Check for a newer version and – unless `check_only` is `true` – download

  +/// and atomically replace the running binary.

  +///

  +/// # Errors

  +///

  +/// Returns an error if the feed cannot be fetched or parsed, the download

  +/// fails, or the binary cannot be replaced (e.g. insufficient permissions).

  +pub async fn self_update(check_only: bool) -> Result<()> {

  + let current = Version::parse(CURRENT_VERSION).into_diagnostic()?;

  +

  + info!("Checking for updates (current: v{current})…");

  + println!("Checking for updates (current: v{current})…");

  +

  + let client = reqwest::Client::builder()

  + .user_agent(format!("abbaye/{CURRENT_VERSION}"))

  + .build()

  + .into_diagnostic()?;

  +

  + let response = client.get(FEED_URL).send().await.into_diagnostic()?;

  +

  + if !response.status().is_success() {

  + return Err(miette!(

  + "Failed to fetch release feed (HTTP {}): {FEED_URL}",

  + response.status()

  + ));

  + }

  +

  + let feed_xml = response.text().await.into_diagnostic()?;

  + let mut versions = parse_versions_from_feed(&feed_xml);

  +

  + if versions.is_empty() {

  + return Err(miette!(

  + "No versions found in the release feed at {FEED_URL}"

  + ));

  + }

  +

  + versions.sort();

  + let latest = versions.into_iter().max().unwrap();

  +

  + if latest <= current {

  + println!("Already up to date (v{current}).");

  + return Ok(());

  + }

  +

  + println!("Update available: v{current} → v{latest}");

  +

  + if check_only {

  + println!("Run `abbaye self-update` without --check to apply the update.");

  + return Ok(());

  + }

  +

  + let exe_suffix = std::env::consts::EXE_SUFFIX; // ".exe" on Windows, "" elsewhere

  + let artifact_name = format!("abbaye-{latest}-{TARGET}{exe_suffix}");

  + let download_url = format!("{BASE_URL}/{latest}/dist/{artifact_name}");

  +

  + println!("Downloading {artifact_name}…");

  + info!("Downloading from {download_url}");

  +

  + let dl_response = client.get(&download_url).send().await.into_diagnostic()?;

  +

  + if !dl_response.status().is_success() {

  + return Err(miette!(

  + "Download failed (HTTP {}): {download_url}",

  + dl_response.status()

  + ));

  + }

  +

  + let bytes = dl_response.bytes().await.into_diagnostic()?;

  +

  + // Using the same directory as the current exe guarantees we stay on the

  + // same filesystem, making the subsequent rename(2) atomic.

  + let current_exe = std::env::current_exe()

  + .into_diagnostic()?

  + .canonicalize()

  + .into_diagnostic()?;

  +

  + let exe_dir = current_exe

  + .parent()

  + .ok_or_else(|| miette!("Could not determine the directory of the current executable"))?;

  +

  + let tmp_path = exe_dir.join(format!("abbaye.new{exe_suffix}"));

  +

  + std::fs::write(&tmp_path, &bytes).into_diagnostic()?;

  +

  + // Make the new binary executable on Unix.

  + #[cfg(unix)]

  + {

  + use std::os::unix::fs::PermissionsExt;

  + let perms = std::fs::Permissions::from_mode(0o755);

  + std::fs::set_permissions(&tmp_path, perms).into_diagnostic()?;

  + }

  +

  + // Atomically replace the running binary.

  + std::fs::rename(&tmp_path, &current_exe).into_diagnostic()?;

  +

  + println!("Successfully updated to v{latest}!");

  + info!("Updated to v{latest}");

  +

  + Ok(())

  +}