Boilerplate, CI (#16)

* core(support files): .gitattributes .gitignore .vscode/settings.json

* chore(cargo): align Cargo.toml with Synesis Rust manifest conventions

Bring the manifest in line with the shared Synesis Cargo.toml form:
banded Package/Targets/Features/Dependencies layout, lexicographic
package keys, canonical exclude, general/crate-specific feature
boilerplate, Policy A dependency specs where applicable, docs.rs
comment/form when metadata is present, and library/tool description
endings. Conventions are documented in freelibs rust-standards
(CARGO_TOML).

* chore(rust): declare versions example in Cargo.toml manifests

Add an explicit [[example]] for examples/versions/main.rs across the
fifteen Synesis Rust crates so the shared versions smoke target is
configured consistently with other declared examples.

* EXAMPLES.md

* docs(rust): add NEWS.md Details column from release history

Add a third **Details** column to every Rust-project **NEWS.md**, with a
short phrase per row taken from git tags and **CHANGES.md** highlights
(scaffold notes where no tags exist); keep libCLImate/sistools as
header-only tables until first releases.

* docs(rust): normalise TODO.md TOC, Packaging, and item forms

Align all Rust-project **TODO.md** files to one spine: TOC plus
Functional, Performance, and Packaging sections; use `* \<none>` and
canonical `~~~…~~~ - ✅;` completed items; retain shwild’s historical
and deferred sections ahead of the shared rails.

* chore(rust): adopt gold rustfmt.toml and scripts/fmt across crates

Copy the Synesis gold rustfmt.toml and scripts/fmt (nightly-2026-09-10 via
RUSTFMT + RUSTUP_TOOLCHAIN) into all 15 Rust projects; remove
rust-toolchain.toml; align CI and related pin docs/scripts to the same
dated nightly.

* chore(rust): align CI and editor fmt to nightly-2026-09-10

Point CI rustfmt (and related pin docs/scripts) at nightly-2026-09-10 and
set rust-analyzer.rustfmt.overrideCommand to the same pin with
--unstable-features so format-on-save matches scripts/fmt; include any
gold-config source reformat fallout.

* docs(readme): add MSRV section to all Rust crate READMEs

Add a dedicated Minimum Supported Rust Version (MSRV) section to the
README.md of all 15 Rust projects in freelibs, clarifying MSRV scope:
- MSRV guarantee applies to library code, [dependencies], and
  [build-dependencies];
- [dev-dependencies] (e.g. benchmarking frameworks like criterion) are
  never fetched or compiled by downstream library consumers and do not
  invalidate the MSRV claim;
- Standardise declared MSRV values (1.79 for shwild.Rust and 1.74 for all
  other 14 crates);
- Expand stub READMEs for libCLImate.Rust and sistools.Rust into full
  standard Synesis README structures with TOC, badges, and project info.

* date

* chore(rust): add canonical project checker templates

Add the derive, documentation-width, and test-naming checker exemplars
to the shared Rust template and propagate executable byte-identical copies
to every Rust project;

* TODO

* 0.0.4

Author: synesissoftware

.gitattributes

@@ -0,0 +1,68 @@
+# .gitattributes — Rust (GitHub-hosted)
+#
+# Sources: GitHub Docs (line endings), git-scm gitattributes (diff=rust),
+# gitattributes/gitattributes Rust.gitattributes + Common.gitattributes,
+# github-linguist overrides.
+
+# Default: detect text, normalize to LF in the repository
+* text=auto
+
+# --- Source ---
+*.rs text eol=lf diff=rust
+*.toml text
+Cargo.lock text
+Cargo.toml text
+rust-toolchain text
+rust-toolchain.toml text
+
+# --- Scripts ---
+*.bash text eol=lf
+*.bat text eol=crlf
+*.cmd text eol=crlf
+*.ps1 text eol=crlf
+*.sh text eol=lf
+*.zsh text eol=lf
+
+# --- Docs / meta ---
+*.adoc text
+*.markdown text diff=markdown
+*.md text diff=markdown
+*.txt text
+AUTHORS text
+CHANGELOG text
+CHANGES text
+CONTRIBUTING text
+COPYING text
+LICENSE text
+NEWS text
+README text
+TODO text
+.gitattributes text
+.gitignore text
+
+# --- Serialisation ---
+*.json text
+*.xml text
+*.yaml text
+*.yml text
+
+# --- Binary ---
+*.a binary
+*.dll binary
+*.dylib binary
+*.exe binary
+*.rlib binary
+*.so binary
+
+# --- Archives / images (common) ---
+*.gif binary
+*.gz binary
+*.ico binary
+*.jpeg binary
+*.jpg binary
+*.png binary
+*.tar binary
+*.zip binary
+
+# --- GitHub Linguist ---
+**/target/** linguist-generated

.github/workflows/ci.yml

@@ -48,9 +48,12 @@ jobs:
         run: RUSTDOCFLAGS="-D warnings" cargo doc --no-deps --locked
 
       - name: Install pinned nightly rustfmt
-        run: rustup toolchain install nightly-2026-08-08 --profile minimal --component rustfmt
+        run: rustup toolchain install nightly-2026-09-10 --profile minimal --component rustfmt
 
       - name: rustfmt
+        env:
+          RUSTFMT_TOOLCHAIN: nightly-2026-09-10
+          RUSTUP_TOOLCHAIN: nightly-2026-09-10
         run: ./scripts/fmt --check
 
       - name: DOC_76 checker
@@ -62,12 +65,28 @@ jobs:
       - name: DERIVE_LAYOUT checker
         run: python3 scripts/check_derives.py
 
+      - name: cargo build (examples)
+        run: cargo build --examples --locked
+
       - name: cargo build (libver)
         run: cargo build --bin libver --locked
 
       - name: cargo publish (dry run)
         run: cargo publish --dry-run --locked
 
+  msrv:
+    name: MSRV (1.74)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: dtolnay/rust-toolchain@1.74.0
+
+      - uses: Swatinem/rust-cache@v2
+
+      - name: cargo check (library)
+        run: cargo check --lib --locked
+
   path-semantics:
     name: Path semantics (${{ matrix.os }})
     runs-on: ${{ matrix.os }}
@@ -85,20 +104,7 @@ jobs:
       - uses: Swatinem/rust-cache@v2
 
       - name: cargo test (Unix path semantics)
-        run: cargo test --lib --locked tests::unix::
+        run: 'cargo test --lib --locked tests::unix::'
 
       - name: cargo test (Windows path semantics)
-        run: cargo test --lib --locked tests::windows::
-
-  msrv:
-    name: MSRV (1.74)
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: dtolnay/rust-toolchain@1.74.0
-
-      - uses: Swatinem/rust-cache@v2
-
-      - name: cargo check (library)
-        run: cargo check --lib --locked
+        run: 'cargo test --lib --locked tests::windows::'

.gitignore

@@ -1,24 +1,73 @@
 
 # directories (by name)
 
-/_build/
+/_analyses/
+
+/.idea/
+
+/scratch/
 /target/
 
 
 # directories (by pattern)
 
+**/__pycache__/
+
+**/.mypy_cache/
+**/.pytest_cache/
+**/.ruff_cache/
+
 
 # files (by name)
 
 .DS_Store
+.ruby-version
 
 
 # files (by pattern)
 
 **/*.rs.bk # These are backup files generated by rustfmt
 
 *~
+*.*~
+*.???_obj
+*.a
+*.app
+*.bak
+*.class
+*.diff
+*.dll
+*.dylib
+*.exe
+*.gch
+*.gem
+*.idb
+*.ilk
+*.lib
+*.log
+*.ncb
+*.o
+*.obj
+*.opensdf
+*.opt
+*.org
+*.out
+*.pch
+*.pdb
+*.pyc
+*.pyo
+*.res
+*.sbr
+*.scc
+*.sdf
+*.so
+*.suo
+*.sw[ponm]
 *.swp
+*.test
+*.tlog
 *.tmp
+*.xcuserstate
 *.zip
 
+

.vimrc

@@ -1,4 +1,4 @@
-" Synesis C/C++ project .vimrc — aligned with .sis/.vscode/c_cxx/settings.json
+" Synesis Rust project .vimrc — aligned with .vscode/settings.json (Rust)
 
 set nocompatible
 filetype indent plugin on
@@ -17,12 +17,12 @@ set fixeol
 set list
 set listchars=tab:->,trail:-,extends:>,precedes:<,nbsp:+
 
-" editor.detectIndentation: false — global defaults (editor.tabSize: 2, insertSpaces: false)
-set tabstop=2
-set shiftwidth=2
-set softtabstop=2
-set noexpandtab
+" editor.detectIndentation: false — global defaults (editor.tabSize: 4, insertSpaces: true)
 set colorcolumn=76
+set expandtab
+set shiftwidth=4
+set softtabstop=4
+set tabstop=4
 
 " colorcolumn draws a full-column tint in Vim (not a VS Code-style 1px line).
 " Keep it subtle via the ColorColumn highlight group; reapply after colorscheme changes.
@@ -40,30 +40,30 @@ autocmd ColorScheme * call s:ConfigureColorColumn()
 " files.trimTrailingWhitespace
 autocmd BufWritePre * %s/\s\+$//e
 
-augroup sis_c_cxx
+augroup sis_rust
   autocmd!
 
+  " [bat]
+  autocmd FileType bat,dosbatch setlocal expandtab tabstop=4 shiftwidth=4 softtabstop=4 colorcolumn=60,76
+
   " [c] / [cpp]
   autocmd FileType c,cpp setlocal expandtab tabstop=4 shiftwidth=4 softtabstop=4 colorcolumn=60,64,68,72,76
 
-  " [rust]
-  autocmd FileType rs setlocal expandtab tabstop=4 shiftwidth=4 softtabstop=4 colorcolumn=76
-
   " [cmake]
   autocmd FileType cmake setlocal noexpandtab tabstop=4 shiftwidth=4 softtabstop=4
 
-  " [shellscript]
-  autocmd FileType sh,bash,zsh setlocal expandtab tabstop=2 shiftwidth=2 softtabstop=2 colorcolumn=60,76
-
-  " [bat]
-  autocmd FileType bat,dosbatch setlocal expandtab tabstop=4 shiftwidth=4 softtabstop=4 colorcolumn=60,76
-
   " [json] / [markdown] / [yaml] / [ruby]
   autocmd FileType json,markdown,yaml,ruby setlocal expandtab tabstop=2 shiftwidth=2 softtabstop=2
 
   " [python]
   autocmd FileType python setlocal expandtab tabstop=4 shiftwidth=4 softtabstop=4 colorcolumn=60,76
 
+  " [rust]
+  autocmd FileType rust setlocal expandtab tabstop=4 shiftwidth=4 softtabstop=4 colorcolumn=76
+
+  " [shellscript]
+  autocmd FileType sh,bash,zsh setlocal expandtab tabstop=2 shiftwidth=2 softtabstop=2 colorcolumn=60,76
+
   " [toml]
   autocmd FileType toml setlocal noexpandtab tabstop=2 shiftwidth=2 softtabstop=2
 augroup END

.vscode/settings.json

@@ -1,14 +1,4 @@
 {
-	"[c]": {
-		"editor.insertSpaces": true,
-		"editor.rulers": [ 60, 76 ],
-		"editor.tabSize": 2,
-	},
-	"[cpp]": {
-		"editor.insertSpaces": true,
-		"editor.rulers": [ 60, 76 ],
-		"editor.tabSize": 2,
-	},
 	"[json]": {
 		"editor.insertSpaces": true,
 		"editor.tabSize": 2,
@@ -17,29 +7,58 @@
 		"editor.insertSpaces": true,
 		"editor.tabSize": 2,
 	},
+	"[python]": {
+		"editor.insertSpaces": true,
+		"editor.rulers": [ 60, 76 ],
+		"editor.tabSize": 4,
+	},
 	"[ruby]": {
 		"editor.insertSpaces": true,
 		"editor.rulers": [ 60, 76 ],
 		"editor.tabSize": 2,
 	},
 	"[rust]": {
+		"editor.defaultFormatter": "rust-lang.rust-analyzer",
+		"editor.formatOnSave": true,
 		"editor.insertSpaces": true,
 		"editor.rulers": [ 60, 76 ],
 		"editor.tabSize": 4,
 	},
-	"[toml]": {
+	"[shellscript]": {
 		"editor.insertSpaces": true,
+		"editor.rulers": [ 60, 76 ],
+		"editor.tabSize": 2,
+	},
+	"[toml]": {
+		"editor.insertSpaces": false,
 		"editor.tabSize": 2,
 	},
 	"cmake.configureOnOpen": false,
+	"debug.allowBreakpointsEverywhere": true,
 	"editor.detectIndentation": false,
 	"editor.insertSpaces": false,
-	"editor.renderWhitespace" : "all",
+	"editor.renderWhitespace": "all",
 	"editor.rulers": [ 76 ],
 	"editor.tabSize": 2,
+	"files.insertFinalNewline": true,
 	"files.trimTrailingWhitespace": true,
 	"git.mergeEditor": false,
+	"rust-analyzer.cargo.buildScripts.enable": true,
+	"rust-analyzer.cargo.features": [],
 	"rust-analyzer.cargo.noDefaultFeatures": true,
+	"rust-analyzer.check.allTargets": true,
+	"rust-analyzer.check.command": "clippy",
+	"rust-analyzer.checkOnSave": true,
 	"rust-analyzer.completion.autoimport.enable": false,
+	"rust-analyzer.debug.engine": "vadimcn.vscode-lldb",
+	"rust-analyzer.debug.openDebugPane": true,
+	"rust-analyzer.procMacro.enable": true,
+	"rust-analyzer.rustfmt.overrideCommand": [
+		"rustup",
+		"run",
+		"nightly-2026-09-10",
+		"rustfmt",
+		"--unstable-features",
+	],
 	"rust-analyzer.showUnlinkedFileNotification": false,
 }

CHANGES.md

@@ -1,6 +1,16 @@
 # libpath.Rust - Changes <!-- omit in toc -->
 
 
+## 0.0.4 - 12th September 2026
+
+* refreshed pinned-nightly formatting and added explicit MSRV validation;
+* added example-build coverage and quoted path-semantics test selectors in CI;
+* added the **versions** example and excluded development-only files from packages;
+* canonicalised **Cargo.toml**, editor configuration, ignore rules, and repository metadata;
+* documented the MSRV and added the `_NEVER_TO_BE_ENABLED` placeholder feature;
+* refreshed the test-name checker, formatting driver, and path-library documentation;
+
+
 ## 0.0.3 - 31st August 2026
 
 * Added complete package metadata, release documentation, and CI checks;