roundlet 0.2.4__tar.gz

roundlet-0.2.4/.builds/readthedocs-webhook.yml

@@ -0,0 +1,16 @@
+# SPDX-FileCopyrightText: Peter Pentchev <roam@ringlet.net>
+# SPDX-License-Identifier: BSD-2-Clause
+
+image: alpine/latest
+secrets:
+    - 1caf0d15-6373-4eca-b33f-8ac10a759f9a
+packages:
+    - curl
+sources:
+    - https://git.sr.ht/~ppentchev/roundlet
+tasks:
+    - trigger-webhook: |
+        ls -l ~/.config/secrets/roundlet-readthedocs-api-token.txt
+        set +x
+        curl -s -v -d "token=$(cat ~/.config/secrets/roundlet-readthedocs-api-token.txt)" 'https://app.readthedocs.org/api/v2/webhook/roundlet/319380/'
+        set -x

roundlet-0.2.4/.builds/test-on-alpine-edge.yml

@@ -0,0 +1,35 @@
+# SPDX-FileCopyrightText: Peter Pentchev <roam@ringlet.net>
+# SPDX-License-Identifier: BSD-2-Clause
+
+image: alpine/edge
+repositories:
+    ringlet-edge: >
+        https://devel.ringlet.net/repo/alpine/ringlet/edge
+        https://devel.ringlet.net/repo/alpine/ringlet/edge/keys/roam@ringlet.net-6a32fb63.rsa.pub
+        roam@ringlet.net-6a32fb63.rsa.pub
+packages:
+    - cargo
+    - cargo-feature-combinations
+    - cargo-nextest
+    - execline
+    - git
+    - jq
+    - musl-locales
+    - py3-tox
+    - rust-clippy
+    - rustfmt
+    - uv
+sources:
+    - https://git.sr.ht/~ppentchev/roundlet
+tasks:
+    - test-uvoxen: |
+        cd roundlet
+        uv venv ../venv-uvoxen
+        sh -c 'set -e; . ../venv-uvoxen/bin/activate; uv pip install uvoxen'
+        env UVOXEN="$PWD/../venv-uvoxen/bin/uvoxen" UV="$PWD/../venv-uvoxen/bin/uv" python/tests/run-uvoxen.sh
+    - test-tox: |
+        cd roundlet
+        tox run-parallel
+    - test-rust: |
+        cd roundlet
+        tools/rust/build-and-test

roundlet-0.2.4/.builds/test-on-alpine.yml

@@ -0,0 +1,35 @@
+# SPDX-FileCopyrightText: Peter Pentchev <roam@ringlet.net>
+# SPDX-License-Identifier: BSD-2-Clause
+
+image: alpine/3.24
+repositories:
+    ringlet-edge: >
+        https://devel.ringlet.net/repo/alpine/ringlet/edge
+        https://devel.ringlet.net/repo/alpine/ringlet/edge/keys/roam@ringlet.net-6a32fb63.rsa.pub
+        roam@ringlet.net-6a32fb63.rsa.pub
+packages:
+    - cargo
+    - cargo-feature-combinations
+    - cargo-nextest
+    - execline
+    - git
+    - jq
+    - musl-locales
+    - py3-tox
+    - rust-clippy
+    - rustfmt
+    - uv
+sources:
+    - https://git.sr.ht/~ppentchev/roundlet
+tasks:
+    - test-uvoxen: |
+        cd roundlet
+        uv venv ../venv-uvoxen
+        sh -c 'set -e; . ../venv-uvoxen/bin/activate; uv pip install uvoxen'
+        env UVOXEN="$PWD/../venv-uvoxen/bin/uvoxen" UV="$PWD/../venv-uvoxen/bin/uv" python/tests/run-uvoxen.sh
+    - test-tox: |
+        cd roundlet
+        tox run-parallel
+    - test-rust: |
+        cd roundlet
+        tools/rust/build-and-test

roundlet-0.2.4/.editorconfig

@@ -0,0 +1,43 @@
+# https://editorconfig.org/
+#
+# SPDX-FileCopyrightText: Peter Pentchev <roam@ringlet.net>
+# SPDX-License-Identifier: BSD-2-Clause
+
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+charset = utf-8
+
+[*.ini]
+indent_style = space
+indent_size = 2
+
+[*.md]
+indent_style = space
+indent_size = 4
+
+[*.py]
+indent_style = space
+indent_size = 4
+
+[*.rs]
+indent_style = space
+indent_size = 4
+
+[*.sh]
+indent_style = tab
+tab_width = 8
+
+[*.toml]
+indent_style = space
+indent_size = 2
+
+[*.yaml]
+indent_style = space
+indent_size = 4
+
+[*.yml]
+indent_style = space
+indent_size = 4

roundlet-0.2.4/.gitignore

@@ -0,0 +1,12 @@
+# SPDX-FileCopyrightText: Peter Pentchev <roam@ringlet.net>
+# SPDX-License-Identifier: BSD-2-Clause
+
+**/__pycache__/
+/.jj/
+/.mypy_cache/
+/.pytest_cache/
+/.ruff_cache/
+/.tox/
+/.venv/
+/site/
+/target/

roundlet-0.2.4/.readthedocs.yaml

@@ -0,0 +1,17 @@
+# SPDX-FileCopyrightText: Peter Pentchev <roam@ringlet.net>
+# SPDX-License-Identifier: BSD-2-Clause
+
+version: 2
+
+build:
+    os: ubuntu-22.04
+    tools:
+        python: "3.12"
+    jobs:
+        build:
+            html:
+                - python3 -m venv --upgrade-deps .zensical-venv
+                - .zensical-venv/bin/python3 -m pip install -r python/requirements/docs.txt
+                - .zensical-venv/bin/zensical build
+                - mkdir -p $READTHEDOCS_OUTPUT/html/
+                - cp -r site/docs/* $READTHEDOCS_OUTPUT/html/

roundlet-0.2.4/LICENSES/BSD-2-Clause.txt

@@ -0,0 +1,9 @@
+Copyright (c) <year> <owner> 
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

roundlet-0.2.4/PKG-INFO

@@ -0,0 +1,48 @@
+Metadata-Version: 2.5
+Name: roundlet
+Version: 0.2.4
+Summary: Random collection of helper libraries used by Ringlet software
+License-Expression: BSD-2-Clause
+License-File: LICENSES/BSD-2-Clause.txt
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Programming Language :: Python :: 3.16
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+<!--
+SPDX-FileCopyrightText: Peter Pentchev <roam@ringlet.net>
+SPDX-License-Identifier: BSD-2-Clause
+-->
+
+# roundlet - a random collection of helper libraries used by Ringlet software
+
+\[[Home][ringlet-home] | [sourcehut][sourcehut] | [crates.io][crates-io] | [ReadTheDocs][readthedocs]\]
+
+## Overview
+
+A couple of helper functions for Rust programs developed at Ringlet.
+
+## Contact
+
+The `roundlet` library was written by [Peter Pentchev][roam].
+It is developed in [a Sourcehut repository][sourcehut]. This documentation is
+hosted at [Ringlet][ringlet-home] with a copy at [ReadTheDocs][readthedocs].
+
+[roam]: mailto:roam@ringlet.net "Peter Pentchev"
+[sourcehut]: https://git.sr.ht/~ppentchev/roundlet "The roundlet Sourcehut repository"
+[crates-io]: https://crates.io/crates/roundlet "The roundlet crate on crates.io"
+[readthedocs]: https://roundlet.readthedocs.io/ "The roundlet ReadTheDocs page"
+[ringlet-home]: https://devel.ringlet.net/devel/roundlet/ "The Ringlet roundlet homepage"

roundlet-0.2.4/README.md

@@ -0,0 +1,24 @@
+<!--
+SPDX-FileCopyrightText: Peter Pentchev <roam@ringlet.net>
+SPDX-License-Identifier: BSD-2-Clause
+-->
+
+# roundlet - a random collection of helper libraries used by Ringlet software
+
+\[[Home][ringlet-home] | [sourcehut][sourcehut] | [crates.io][crates-io] | [ReadTheDocs][readthedocs]\]
+
+## Overview
+
+A couple of helper functions for Rust programs developed at Ringlet.
+
+## Contact
+
+The `roundlet` library was written by [Peter Pentchev][roam].
+It is developed in [a Sourcehut repository][sourcehut]. This documentation is
+hosted at [Ringlet][ringlet-home] with a copy at [ReadTheDocs][readthedocs].
+
+[roam]: mailto:roam@ringlet.net "Peter Pentchev"
+[sourcehut]: https://git.sr.ht/~ppentchev/roundlet "The roundlet Sourcehut repository"
+[crates-io]: https://crates.io/crates/roundlet "The roundlet crate on crates.io"
+[readthedocs]: https://roundlet.readthedocs.io/ "The roundlet ReadTheDocs page"
+[ringlet-home]: https://devel.ringlet.net/devel/roundlet/ "The Ringlet roundlet homepage"

roundlet-0.2.4/REUSE.toml

@@ -0,0 +1,16 @@
+# SPDX-FileCopyrightText: Peter Pentchev <roam@ringlet.net>
+# SPDX-License-Identifier: BSD-2-Clause
+
+version = 1
+SPDX-PackageName = "roundlet"
+SPDX-PackageSupplier = "Peter Pentchev <roam@ringlet.net>"
+SPDX-PackageDownloadLocation = "https://git.sr.ht/~ppentchev/roundlet"
+
+[[annotations]]
+path = [
+  "Cargo.lock",
+  "uv.lock",
+]
+precedence = "aggregate"
+SPDX-FileCopyrightText = "Peter Pentchev <roam@ringlet.net>"
+SPDX-License-Identifier = "BSD-2-Clause"

roundlet-0.2.4/docs/changes.md

@@ -0,0 +1,216 @@
+<!--
+SPDX-FileCopyrightText: Peter Pentchev <roam@ringlet.net>
+SPDX-License-Identifier: BSD-2-Clause
+-->
+
+# Changelog
+
+All notable changes to the roundlet project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.2.4] - 2026-11-10
+
+### Fixes
+
+- The `.gitignore` file:
+    - add some more Python linter dot-dirs
+- Python implementation:
+    - tell `hatchling` exactly what to include in the sdist
+
+### Other changes
+
+- Rust implementation:
+    - push the Rust source files down into `rust/`
+
+## [0.2.3] - 2026-11-10
+
+### Fixes
+
+- The `.gitignore` file:
+    - add leading slashes
+    - add the `.jj/` directory so we don't accidentally ship the Jujutsu repo
+- CI:
+    - explicitly specify `alpine/3.24` instead of `alpine/latest`
+
+### Additions
+
+- Add an EditorConfig file.
+- Python implementation:
+    - add a `roundlet` Python module:
+        - `cli_basic`: the `handle_basic_options()` function
+        - `env`: the `UTF8_VARS` dictionary with a caveat in the docstring
+        - `logging`: the `build_logger()` function
+- Test suite:
+    - add `uvoxen` definitions for the `reuse` and `docs` test environments
+- CI:
+    - add sourcehut CI definitions for `alpine/edge`
+
+### Other changes
+
+- Rust implementation:
+    - move the helper tools to the `tools/rust/` directory and drop the `el-` prefix
+    - drop the recipe for creating a test container; the `sim-ci` tool can handle that
+
+## [0.2.2] - 2026-09-23
+
+### Additions
+
+- cli-basic-clap:
+    - add a doctest for `handle_basic_options`
+- env-utf8:
+    - add doctests for `c_utf8_vars` and `utf8_path`
+
+### Other changes
+
+- test-exe-path:
+    - use our own `env::utf8_path` helper function
+- test-temp-paths:
+    - use our own `env::utf8_path` helper function
+- Test suite:
+    - minor formatting changes to the `el-build-and-test` tool
+
+## [0.2.1] - 2026-08-17
+
+### Fixes
+
+- Test suite:
+    - use `/usr/bin/env` on the hasbang line of `el-run-clippy`
+    - make sure `charset-normalizer` is installed when running `reuse`
+
+### Additions
+
+- env-utf8-path:
+    - new feature: add the `utf8_path()` and `utf8_pathbuf()` helpers for
+      the common task of converting `Path/PathBuf` to `Utf8Path/Utf8PathBuf` with
+      a sensible error message
+- test-temp-paths:
+    - new feature: add the `Paths` and `CopyTo` structs for easier creation of
+      temporary directory trees during unit/integration testing
+- Test suite:
+    - make sure `cargo test` can be run in the packaged crate
+- sourcehut CI:
+    - run `el-build-and-test` instead of just `cargo nextest run`
+    - run `tox run-parallel` for the documentation and the `reuse` check
+
+### Other changes
+
+- Documentation:
+    - switch from the unmaintained `mkdocs` to a pinned version of `zensical`
+
+## [0.2.0] - 2026-08-03
+
+### INCOMPATIBLE CHANGES
+
+- test-exe-path:
+    - switch from `eyre` to `anyhow` for the returned errors
+
+### Fixes
+
+- Drop the unneeded per-crate `README.md` files.
+
+## [0.1.5] - 2026-08-03
+
+### Fixes
+
+- Cargo metadata:
+    - no longer declare `no-std` and `no-std::no-alloc` for the `roundlet` crate
+- test-exe-path:
+    - handle the new build dir layout on nightly
+- Test suite:
+    - drop `default` from the feature combinations's excluded list;
+      we don't even have such a feature
+
+### Additions
+
+- cli-basic-clap:
+    - accept `IntoIterator` instead of `Iterator`
+
+### Other changes
+
+- Cargo metadata:
+    - switch to workspace package definitions
+- test-exe-path:
+    - fall back to the current executable's directory on any errors
+
+## [0.1.4] - 2026-07-20
+
+### Additions
+
+- Point the `package.homepage` Cargo field to our Ringlet homepage.
+
+## [0.1.3] - 2026-07-20
+
+### Semi-incompatible changes
+
+- Drop the `std` feature that was enabled by all of the other features;
+  everything we do depends on the standard library, so admit it.
+
+### Fixes
+
+- Do not use the `bail` macro as an expression.
+- Run `clippy` with all feature flags enabled to test all code paths.
+
+### Additions
+
+- Add the `env-utf8` feature flag that enables the `env` module
+  containing the `c_utf8_vars()` and `c_utf8_add_vars()` functions.
+  They prepare an environment for running child processes in
+  a UTF-8-capable locale in a way that will work on most modern
+  systems.
+  If older systems that do not define the `C.UTF-8` locale need to
+  be supported, see the `utf8-locale` crate.
+
+### Other changes
+
+- Drop the version suffixes for the crates we depend on.
+  If we ever need to support more than one version of a crate at
+  a time, we will deal with it then.
+- Use workspace dependencies to avoid repetition.
+- Explicitly mark the `test-roundlet-cmd` crate as unpublishable to
+  avoid mistakes.
+
+## [0.1.2] - 2026-07-11
+
+### Fixes
+
+- Bump MSRV to 1.88 for `time` pulled in by `simple_logger`.
+- Test suite:
+    - override Clippy's "inline modules" check
+
+### Other changes
+
+- Allow `itertools` 0.15.x with no changes.
+- sourcehut CI:
+    - install `cargo-feature-combinations` from the Ringlet edge repo
+
+## [0.1.1] - 2026-02-09
+
+### Fixes
+
+- Documentation:
+    - add `README.md` files to the two crates
+    - correct an internal Markdown reference
+    - add some `docs.rs` configuration settings
+
+## [0.1.0] - 2026-02-09
+
+### Started
+
+- First public release.
+
+[Unreleased]: https://git.sr.ht/~ppentchev/roundlet
+[0.2.4]: https://git.sr.ht/~ppentchev/roundlet/refs/release/0.2.4
+[0.2.3]: https://git.sr.ht/~ppentchev/roundlet/refs/release/0.2.3
+[0.2.2]: https://git.sr.ht/~ppentchev/roundlet/refs/release/0.2.2
+[0.2.1]: https://git.sr.ht/~ppentchev/roundlet/refs/release/0.2.1
+[0.2.0]: https://git.sr.ht/~ppentchev/roundlet/refs/release/0.2.0
+[0.1.5]: https://git.sr.ht/~ppentchev/roundlet/refs/release/0.1.5
+[0.1.4]: https://git.sr.ht/~ppentchev/roundlet/refs/release/0.1.4
+[0.1.3]: https://git.sr.ht/~ppentchev/roundlet/refs/release/0.1.3
+[0.1.2]: https://git.sr.ht/~ppentchev/roundlet/refs/release/0.1.2
+[0.1.1]: https://git.sr.ht/~ppentchev/roundlet/refs/release/0.1.1
+[0.1.0]: https://git.sr.ht/~ppentchev/roundlet/refs/release/0.1.0

roundlet-0.2.4/docs/index.md

@@ -0,0 +1,24 @@
+<!--
+SPDX-FileCopyrightText: Peter Pentchev <roam@ringlet.net>
+SPDX-License-Identifier: BSD-2-Clause
+-->
+
+# roundlet - a random collection of helper libraries used by Ringlet software
+
+\[[Home][ringlet-home] | [sourcehut][sourcehut] | [crates.io][crates-io] | [ReadTheDocs][readthedocs]\]
+
+## Overview
+
+A couple of helper functions for Rust programs developed at Ringlet.
+
+## Contact
+
+The `roundlet` library was written by [Peter Pentchev][roam].
+It is developed in [a Sourcehut repository][sourcehut]. This documentation is
+hosted at [Ringlet][ringlet-home] with a copy at [ReadTheDocs][readthedocs].
+
+[roam]: mailto:roam@ringlet.net "Peter Pentchev"
+[sourcehut]: https://git.sr.ht/~ppentchev/roundlet "The roundlet Sourcehut repository"
+[crates-io]: https://crates.io/crates/roundlet "The roundlet crate on crates.io"
+[readthedocs]: https://roundlet.readthedocs.io/ "The roundlet ReadTheDocs page"
+[ringlet-home]: https://devel.ringlet.net/devel/roundlet/ "The Ringlet roundlet homepage"

roundlet-0.2.4/mkdocs.yml

@@ -0,0 +1,39 @@
+# SPDX-FileCopyrightText: Peter Pentchev <roam@ringlet.net>
+# SPDX-License-Identifier: BSD-2-Clause
+
+theme:
+  name: material
+  features:
+    - navigation.instant
+    - navigation.tracking
+    - toc.integrate
+    - toc.follow
+    - content.code.copy
+  palette:
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      toggle:
+        icon: material/weather-sunny
+        name: Switch to dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      toggle:
+        icon: material/weather-night
+        name: Switch to light mode
+site_name: roundlet
+repo_url: https://git.sr.ht/~ppentchev/roundlet
+repo_name: roundlet
+site_author: ppentchev
+site_url: https://devel.ringlet.net/devel/roundlet/
+site_dir: site/docs
+nav:
+  - 'index.md'
+  - 'Changelog': 'changes.md'
+markdown_extensions:
+  - toc:
+  - pymdownx.highlight:
+      anchor_linenums: true
+  - pymdownx.inlinehilite:
+  - pymdownx.superfences:
+plugins:
+  - search