|
1 | | -[](https://github.com/sponsors/hyperpolymath) |
| 1 | +<!-- |
| 2 | +SPDX-License-Identifier: CC-BY-SA-4.0 |
| 3 | +SPDX-FileCopyrightText: 2025-2026 Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk> |
| 4 | +--> |
2 | 5 |
|
3 | | -= asdf Tool Plugins |
4 | | -// SPDX-License-Identifier: CC-BY-SA-4.0 |
5 | | -:author: Jonathan D.A. Jewell <6759885+hyperpolymath@users.noreply.github.com> |
6 | | -:revdate: 2026-05-26 |
| 6 | +Hyperpolymath’s collection of [asdf](https://asdf-vm.com/) plugins for |
| 7 | +installing and managing development tools and runtimes across the |
| 8 | +estate. |
7 | 9 |
|
8 | | -Hyperpolymath's collection of https://asdf-vm.com/[asdf] plugins for installing |
9 | | -and managing development tools and runtimes across the estate. |
| 10 | +Each top-level subdirectory is a standalone asdf plugin. The full set |
| 11 | +covers the languages, runtimes, and tools the hyperpolymath |
| 12 | +language-policy (<a |
| 13 | +href="https://github.com/hyperpolymath/standards/blob/main/.claude/CLAUDE.md" |
| 14 | +class="md |
| 15 | +in `hyperpolymath/standards`">CLAUDE</a>) currently endorses, plus some |
| 16 | +neighbouring tools used in supporting infrastructure. |
10 | 17 |
|
11 | | -Each top-level subdirectory is a standalone asdf plugin. The full set covers |
12 | | -the languages, runtimes, and tools the hyperpolymath language-policy |
13 | | -(link:https://github.com/hyperpolymath/standards/blob/main/.claude/CLAUDE.md[CLAUDE.md |
14 | | -in `hyperpolymath/standards`]) currently endorses, plus some neighbouring |
15 | | -tools used in supporting infrastructure. |
| 18 | +# Installing a plugin |
16 | 19 |
|
17 | | -== Installing a plugin |
| 20 | +Each plugin is installable directly from this monorepo using the |
| 21 | +standard asdf plugin-add URL form: |
18 | 22 |
|
19 | | -Each plugin is installable directly from this monorepo using the standard |
20 | | -asdf plugin-add URL form: |
21 | | - |
22 | | -[source,bash] |
23 | | ----- |
| 23 | +```bash |
24 | 24 | asdf plugin add <name> https://github.com/hyperpolymath/asdf-tool-plugins.git |
25 | | ----- |
| 25 | +``` |
26 | 26 |
|
27 | | -(Some plugins may require additional setup — see the plugin's own README |
| 27 | +(Some plugins may require additional setup — see the plugin’s own README |
28 | 28 | inside its subdirectory.) |
29 | 29 |
|
30 | | -== Layout |
| 30 | +# Layout |
31 | 31 |
|
32 | | -This is a *consolidated monorepo* — every plugin lives in a sibling |
33 | | -directory at the top level. Each is autonomous (its own |
34 | | -`bin/list-all`, `bin/install`, plugin-specific helpers). |
| 32 | +This is a **consolidated monorepo** — every plugin lives in a sibling |
| 33 | +directory at the top level. Each is autonomous (its own `bin/list-all`, |
| 34 | +`bin/install`, plugin-specific helpers). |
35 | 35 |
|
36 | 36 | Browse the plugin list directly by running: |
37 | 37 |
|
38 | | -[source,bash] |
39 | | ----- |
| 38 | +```bash |
40 | 39 | ls -d */ |
41 | | ----- |
| 40 | +``` |
| 41 | + |
| 42 | +# Status |
42 | 43 |
|
43 | | -== Status |
| 44 | +- **Licence**: MPL-2.0. |
44 | 45 |
|
45 | | -* **Licence**: MPL-2.0. |
46 | | -* **Estate role**: development-tooling support; downstream of the |
| 46 | +- **Estate role**: development-tooling support; downstream of the |
47 | 47 | `hyperpolymath/standards` language-policy. |
48 | | -* **Audit findings**: see `docs/tech-debt-2026-05-26.md` if present |
| 48 | + |
| 49 | +- **Audit findings**: see `docs/tech-debt-2026-05-26.md` if present |
49 | 50 | (added by the 2026-05-26 estate tech-debt scan). |
50 | 51 |
|
51 | | -== Contributing |
| 52 | +# Contributing |
| 53 | + |
| 54 | +PRs welcome — see <a href="CONTRIBUTING.md" class="md">CONTRIBUTING</a>. |
| 55 | +All commits must be GPG-signed and follow conventional commits (per |
| 56 | +estate-wide policy in `hyperpolymath/standards`). |
52 | 57 |
|
53 | | -PRs welcome — see link:CONTRIBUTING.md[CONTRIBUTING.md]. |
54 | | -All commits must be GPG-signed and follow conventional commits |
55 | | -(per estate-wide policy in `hyperpolymath/standards`). |
| 58 | +# Companion repositories |
56 | 59 |
|
57 | | -== Companion repositories |
| 60 | +- [`hyperpolymath/standards`](https://github.com/hyperpolymath/standards) |
| 61 | + — canonical estate-wide standards including the language policy. |
58 | 62 |
|
59 | | -* link:https://github.com/hyperpolymath/standards[`hyperpolymath/standards`] — canonical estate-wide standards including the language policy. |
60 | | -* link:https://github.com/hyperpolymath/rsr-template-repo[`hyperpolymath/rsr-template-repo`] — the canonical project scaffold (this repo follows the RSR pattern). |
| 63 | +- [`hyperpolymath/rsr-template-repo`](https://github.com/hyperpolymath/rsr-template-repo) |
| 64 | + — the canonical project scaffold (this repo follows the RSR pattern). |
0 commit comments