Compare commits
4 Commits
v0.5.0
...
2882cc33aa
Author | SHA1 | Date | |
---|---|---|---|
2882cc33aa | |||
149a0c2b39
|
|||
5f55c735f9
|
|||
140b18b7cd
|
@@ -1,5 +0,0 @@
|
|||||||
chore(pr): ${PullRequestTitle} ${PullRequestReference}
|
|
||||||
|
|
||||||
${PullRequestDescription}
|
|
||||||
|
|
||||||
Merged from ${HeadBranch} into ${BaseBranch}
|
|
@@ -36,19 +36,11 @@ jobs:
|
|||||||
continue-on-error: true
|
continue-on-error: true
|
||||||
run: deno task test
|
run: deno task test
|
||||||
|
|
||||||
- name: Compile
|
|
||||||
id: compile
|
|
||||||
continue-on-error: true
|
|
||||||
run: |
|
|
||||||
deno task build:amd64
|
|
||||||
deno task build:arm64
|
|
||||||
|
|
||||||
- name: Fail if any step failed
|
- name: Fail if any step failed
|
||||||
if: |
|
if: |
|
||||||
steps.format.outcome != 'success' ||
|
steps.format.outcome != 'success' ||
|
||||||
steps.lint.outcome != 'success' ||
|
steps.lint.outcome != 'success' ||
|
||||||
steps.test.outcome != 'success' ||
|
steps.test.outcome != 'success'
|
||||||
steps.compile.outcome != 'success'
|
|
||||||
run: |
|
run: |
|
||||||
echo "::error::One or more steps failed"
|
echo "::error::One or more steps failed"
|
||||||
exit 1
|
exit 1
|
||||||
|
3
.vscode/settings.json
vendored
3
.vscode/settings.json
vendored
@@ -17,8 +17,5 @@
|
|||||||
"[json]": {
|
"[json]": {
|
||||||
"editor.defaultFormatter": "denoland.vscode-deno"
|
"editor.defaultFormatter": "denoland.vscode-deno"
|
||||||
},
|
},
|
||||||
"[jsonc]": {
|
|
||||||
"editor.defaultFormatter": "denoland.vscode-deno"
|
|
||||||
},
|
|
||||||
"editor.formatOnSave": true
|
"editor.formatOnSave": true
|
||||||
}
|
}
|
28
CHANGELOG.md
28
CHANGELOG.md
@@ -2,34 +2,12 @@
|
|||||||
|
|
||||||
All notable changes to this project will be documented in this file.
|
All notable changes to this project will be documented in this file.
|
||||||
|
|
||||||
## [0.5.0](https://git.0xmax42.io/maxp/systemd-timer/compare/v0.4.1..v0.5.0) - 2025-05-30
|
## [unreleased]
|
||||||
|
|
||||||
### 🚀 Features
|
|
||||||
|
|
||||||
- *(cli)* Add validation for command options - ([1c07af4](https://git.0xmax42.io/maxp/systemd-timer/commit/1c07af402b35ba4c2abf89ff5816e791994db536))
|
|
||||||
- *(validation)* Add CLI validation helpers for input checks - ([3d95706](https://git.0xmax42.io/maxp/systemd-timer/commit/3d95706d683cac8d279dfb718541a17c42fa5d71))
|
|
||||||
- *(build)* Add run permissions to compiled binaries - ([ccb04e4](https://git.0xmax42.io/maxp/systemd-timer/commit/ccb04e49820ff8238d7e7ad853aab5db06d5dc8a))
|
|
||||||
- *(ci)* Add compile steps to CI workflow - ([531a02a](https://git.0xmax42.io/maxp/systemd-timer/commit/531a02a6e11a769f2e05888d49ea2b4808d974e3))
|
|
||||||
- *(vscode)* Add JSONC formatter configuration - ([c7af1fb](https://git.0xmax42.io/maxp/systemd-timer/commit/c7af1fb6caa46c22b84229745067d05bf60b6f64))
|
|
||||||
- *(i18n)* Support loading JSONC translation files - ([4ac5dd4](https://git.0xmax42.io/maxp/systemd-timer/commit/4ac5dd4c88324f99cb6827283ad85bb9718abbeb))
|
|
||||||
- *(config)* Add @std/jsonc dependency - ([8f1cb3f](https://git.0xmax42.io/maxp/systemd-timer/commit/8f1cb3fad71ead365d93087963ddb6c7202a9b4f))
|
|
||||||
|
|
||||||
### 🐛 Bug Fixes
|
|
||||||
|
|
||||||
- *(build)* Update included files to use .jsonc format - ([f3f2c61](https://git.0xmax42.io/maxp/systemd-timer/commit/f3f2c61da0785dce4c6b8c7d8ef0ae9abf098172))
|
|
||||||
|
|
||||||
### 🎨 Styling
|
|
||||||
|
|
||||||
- *(i18n)* Add comments for clarity and rename files - ([5226269](https://git.0xmax42.io/maxp/systemd-timer/commit/5226269ec2a0b76dfa30ac8d614c3789ff3a837b))
|
|
||||||
|
|
||||||
### 🧪 Testing
|
### 🧪 Testing
|
||||||
|
|
||||||
- *(fs)* Update test descriptions and comments to English - ([c4f4614](https://git.0xmax42.io/maxp/systemd-timer/commit/c4f4614a2daee68f9b33b9676106214c65a1a427))
|
- *(fs)* Update test descriptions and comments to English - ([5f55c73](https://git.0xmax42.io/maxp/systemd-timer/commit/5f55c735f96c787bb90b88e1aebb05660e3a4a42))
|
||||||
- *(fs)* Add rollback tests for writeUnitFiles errors - ([6039d23](https://git.0xmax42.io/maxp/systemd-timer/commit/6039d236eb7de449ce22b1d9ea718389a3e2261d))
|
- *(fs)* Add rollback tests for writeUnitFiles errors - ([140b18b](https://git.0xmax42.io/maxp/systemd-timer/commit/140b18b7cdd51d0e263003c105c9c809e7a594f1))
|
||||||
|
|
||||||
### ⚙️ Miscellaneous Tasks
|
|
||||||
|
|
||||||
- *(lock)* Update dependencies to latest versions - ([28b23cf](https://git.0xmax42.io/maxp/systemd-timer/commit/28b23cf947ecc57eb7fde541b29c68b41e508e7d))
|
|
||||||
|
|
||||||
## [0.4.1](https://git.0xmax42.io/maxp/systemd-timer/compare/v0.4.0..v0.4.1) - 2025-05-28
|
## [0.4.1](https://git.0xmax42.io/maxp/systemd-timer/compare/v0.4.0..v0.4.1) - 2025-05-28
|
||||||
|
|
||||||
|
@@ -4,9 +4,9 @@
|
|||||||
"test": "deno test -A --coverage **/__tests__/*.test.ts",
|
"test": "deno test -A --coverage **/__tests__/*.test.ts",
|
||||||
"fmt": "deno fmt --check",
|
"fmt": "deno fmt --check",
|
||||||
"lint": "deno lint",
|
"lint": "deno lint",
|
||||||
"ci": "deno task fmt && deno task lint && deno task test && build:amd64", // For local CI checks
|
"ci": "deno task fmt && deno task lint && deno task test", // For local CI checks
|
||||||
"build:amd64": "deno compile --target x86_64-unknown-linux-gnu --include VERSION --include src/i18n/de.jsonc --include src/i18n/en.jsonc --allow-env --allow-write --allow-read --allow-run --output dist/systemd-timer-linux-amd64 src/mod.ts",
|
"build:amd64": "deno compile --target x86_64-unknown-linux-gnu --include VERSION --include src/i18n/de.json --include src/i18n/en.json --allow-env --allow-write --allow-read --output dist/systemd-timer-linux-amd64 src/mod.ts",
|
||||||
"build:arm64": "deno compile --target aarch64-unknown-linux-gnu --include VERSION --include src/i18n/de.jsonc --include src/i18n/en.jsonc --allow-env --allow-write --allow-read --allow-run --output dist/systemd-timer-linux-arm64 src/mod.ts"
|
"build:arm64": "deno compile --target aarch64-unknown-linux-gnu --include VERSION --include src/i18n/de.json --include src/i18n/en.json --allow-env --allow-write --allow-read --output dist/systemd-timer-linux-arm64 src/mod.ts"
|
||||||
},
|
},
|
||||||
"compilerOptions": {},
|
"compilerOptions": {},
|
||||||
"fmt": {
|
"fmt": {
|
||||||
@@ -23,7 +23,6 @@
|
|||||||
},
|
},
|
||||||
"exclude": [],
|
"exclude": [],
|
||||||
"imports": {
|
"imports": {
|
||||||
"@cliffy/command": "jsr:@cliffy/command@1.0.0-rc.7",
|
"@cliffy/command": "jsr:@cliffy/command@1.0.0-rc.7"
|
||||||
"@std/jsonc": "jsr:@std/jsonc@^1.0.2"
|
|
||||||
}
|
}
|
||||||
}
|
}
|
18
deno.lock
generated
18
deno.lock
generated
@@ -6,8 +6,6 @@
|
|||||||
"jsr:@cliffy/internal@1.0.0-rc.7": "1.0.0-rc.7",
|
"jsr:@cliffy/internal@1.0.0-rc.7": "1.0.0-rc.7",
|
||||||
"jsr:@cliffy/table@1.0.0-rc.7": "1.0.0-rc.7",
|
"jsr:@cliffy/table@1.0.0-rc.7": "1.0.0-rc.7",
|
||||||
"jsr:@std/fmt@~1.0.2": "1.0.7",
|
"jsr:@std/fmt@~1.0.2": "1.0.7",
|
||||||
"jsr:@std/json@^1.0.2": "1.0.2",
|
|
||||||
"jsr:@std/jsonc@^1.0.2": "1.0.2",
|
|
||||||
"jsr:@std/text@~1.0.7": "1.0.13"
|
"jsr:@std/text@~1.0.7": "1.0.13"
|
||||||
},
|
},
|
||||||
"jsr": {
|
"jsr": {
|
||||||
@@ -39,24 +37,11 @@
|
|||||||
"@std/fmt@1.0.7": {
|
"@std/fmt@1.0.7": {
|
||||||
"integrity": "2a727c043d8df62cd0b819b3fb709b64dd622e42c3b1bb817ea7e6cc606360fb"
|
"integrity": "2a727c043d8df62cd0b819b3fb709b64dd622e42c3b1bb817ea7e6cc606360fb"
|
||||||
},
|
},
|
||||||
"@std/json@1.0.2": {
|
|
||||||
"integrity": "d9e5497801c15fb679f55a2c01c7794ad7a5dfda4dd1bebab5e409cb5e0d34d4"
|
|
||||||
},
|
|
||||||
"@std/jsonc@1.0.2": {
|
|
||||||
"integrity": "909605dae3af22bd75b1cbda8d64a32cf1fd2cf6efa3f9e224aba6d22c0f44c7",
|
|
||||||
"dependencies": [
|
|
||||||
"jsr:@std/json"
|
|
||||||
]
|
|
||||||
},
|
|
||||||
"@std/text@1.0.13": {
|
"@std/text@1.0.13": {
|
||||||
"integrity": "2191c90e6e667b0c3b7dea1cd082137580a93b3c136bad597c0212d5fe006eb1"
|
"integrity": "2191c90e6e667b0c3b7dea1cd082137580a93b3c136bad597c0212d5fe006eb1"
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
"remote": {
|
"remote": {
|
||||||
"https://deno.land/std@0.192.0/fmt/colors.ts": "d67e3cd9f472535241a8e410d33423980bec45047e343577554d3356e1f0ef4e",
|
|
||||||
"https://deno.land/std@0.192.0/testing/_diff.ts": "1a3c044aedf77647d6cac86b798c6417603361b66b54c53331b312caeb447aea",
|
|
||||||
"https://deno.land/std@0.192.0/testing/_format.ts": "a69126e8a469009adf4cf2a50af889aca364c349797e63174884a52ff75cf4c7",
|
|
||||||
"https://deno.land/std@0.192.0/testing/asserts.ts": "e16d98b4d73ffc4ed498d717307a12500ae4f2cbe668f1a215632d19fcffc22f",
|
|
||||||
"https://deno.land/std@0.224.0/assert/_constants.ts": "a271e8ef5a573f1df8e822a6eb9d09df064ad66a4390f21b3e31f820a38e0975",
|
"https://deno.land/std@0.224.0/assert/_constants.ts": "a271e8ef5a573f1df8e822a6eb9d09df064ad66a4390f21b3e31f820a38e0975",
|
||||||
"https://deno.land/std@0.224.0/assert/assert.ts": "09d30564c09de846855b7b071e62b5974b001bb72a4b797958fe0660e7849834",
|
"https://deno.land/std@0.224.0/assert/assert.ts": "09d30564c09de846855b7b071e62b5974b001bb72a4b797958fe0660e7849834",
|
||||||
"https://deno.land/std@0.224.0/assert/assert_almost_equals.ts": "9e416114322012c9a21fa68e187637ce2d7df25bcbdbfd957cd639e65d3cf293",
|
"https://deno.land/std@0.224.0/assert/assert_almost_equals.ts": "9e416114322012c9a21fa68e187637ce2d7df25bcbdbfd957cd639e65d3cf293",
|
||||||
@@ -188,8 +173,7 @@
|
|||||||
},
|
},
|
||||||
"workspace": {
|
"workspace": {
|
||||||
"dependencies": [
|
"dependencies": [
|
||||||
"jsr:@cliffy/command@1.0.0-rc.7",
|
"jsr:@cliffy/command@1.0.0-rc.7"
|
||||||
"jsr:@std/jsonc@^1.0.2"
|
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
@@ -2,14 +2,6 @@ import { Command } from '@cliffy/command';
|
|||||||
import { generateUnitFiles } from '../templates/unit-generator.ts';
|
import { generateUnitFiles } from '../templates/unit-generator.ts';
|
||||||
import { TimerOptions } from '../types/options.ts';
|
import { TimerOptions } from '../types/options.ts';
|
||||||
import { t } from '../i18n/mod.ts';
|
import { t } from '../i18n/mod.ts';
|
||||||
import {
|
|
||||||
collectAndValidateAfter,
|
|
||||||
collectAndValidateEnv,
|
|
||||||
validateIdentifier,
|
|
||||||
validateNotEmpty,
|
|
||||||
validatePath,
|
|
||||||
validateSystemdCalendar,
|
|
||||||
} from '../utils/mod.ts';
|
|
||||||
|
|
||||||
export function createCommand() {
|
export function createCommand() {
|
||||||
return new Command()
|
return new Command()
|
||||||
@@ -17,54 +9,43 @@ export function createCommand() {
|
|||||||
.option(
|
.option(
|
||||||
'--name <name:string>',
|
'--name <name:string>',
|
||||||
t('option_name'),
|
t('option_name'),
|
||||||
{ value: (v) => validateIdentifier(v, '--name') },
|
|
||||||
)
|
)
|
||||||
.option(
|
.option(
|
||||||
'--exec <cmd:string>',
|
'--exec <cmd:string>',
|
||||||
t('option_exec'),
|
t('option_exec'),
|
||||||
{
|
{ required: true },
|
||||||
required: true,
|
|
||||||
value: (v) => validateNotEmpty(v, '--exec'),
|
|
||||||
},
|
|
||||||
)
|
)
|
||||||
.option('--calendar <time:string>', t('option_calendar'), {
|
.option('--calendar <time:string>', t('option_calendar'), {
|
||||||
required: true,
|
required: true,
|
||||||
value: validateSystemdCalendar,
|
|
||||||
})
|
})
|
||||||
.option('--description <desc:string>', t('option_description'))
|
.option('--description <desc:string>', t('option_description'))
|
||||||
.option('--user', t('option_user'))
|
.option('--user', t('option_user'))
|
||||||
.option(
|
.option(
|
||||||
'--run-as <user:string>',
|
'--run-as <user:string>',
|
||||||
t('option_run_as'),
|
t('option_run_as'),
|
||||||
{ value: (v) => validateNotEmpty(v, '--run-as') },
|
|
||||||
)
|
)
|
||||||
.option(
|
.option(
|
||||||
'--home <path:string>',
|
'--home <path:string>',
|
||||||
t('option_home'),
|
t('option_home'),
|
||||||
{ value: (v) => validatePath(v, true) },
|
|
||||||
)
|
)
|
||||||
.option(
|
.option(
|
||||||
'--cwd <path:string>',
|
'--cwd <path:string>',
|
||||||
t('option_cwd'),
|
t('option_cwd'),
|
||||||
{ value: (v) => validatePath(v, true) },
|
|
||||||
)
|
)
|
||||||
.option('--output <dir:string>', t('option_output'), {
|
.option('--output <dir:string>', t('option_output'))
|
||||||
value: (v) => validatePath(v, false),
|
|
||||||
})
|
|
||||||
.option(
|
.option(
|
||||||
'--after <target:string>',
|
'--after <target:string>',
|
||||||
t('option_after'),
|
t('option_after'),
|
||||||
{ collect: true, value: collectAndValidateAfter },
|
{ collect: true },
|
||||||
)
|
)
|
||||||
.option(
|
.option(
|
||||||
'--environment <env:string>',
|
'--environment <env:string>',
|
||||||
t('option_environment'),
|
t('option_environment'),
|
||||||
{ collect: true, value: collectAndValidateEnv },
|
{ collect: true },
|
||||||
)
|
)
|
||||||
.option(
|
.option(
|
||||||
'--logfile <file:string>',
|
'--logfile <file:string>',
|
||||||
t('option_logfile'),
|
t('option_logfile'),
|
||||||
{ value: (v) => validatePath(v, false) },
|
|
||||||
)
|
)
|
||||||
.option('--dry-run', t('option_dry_run'))
|
.option('--dry-run', t('option_dry_run'))
|
||||||
.action(async (options: TimerOptions) => {
|
.action(async (options: TimerOptions) => {
|
||||||
|
@@ -1,8 +1,6 @@
|
|||||||
{
|
{
|
||||||
// General
|
|
||||||
"cli_description": "CLI-Tool zum Erzeugen von systemd .timer und .service Units",
|
"cli_description": "CLI-Tool zum Erzeugen von systemd .timer und .service Units",
|
||||||
"cli_create_description": "Erzeugt eine systemd .service und .timer Unit",
|
"cli_create_description": "Erzeugt eine systemd .service und .timer Unit",
|
||||||
// Options
|
|
||||||
"option_name": "Name der Unit-Dateien (optional, wird sonst aus dem Exec generiert)",
|
"option_name": "Name der Unit-Dateien (optional, wird sonst aus dem Exec generiert)",
|
||||||
"option_exec": "Kommando, das durch systemd ausgeführt werden soll",
|
"option_exec": "Kommando, das durch systemd ausgeführt werden soll",
|
||||||
"option_calendar": "OnCalendar-Ausdruck für den Timer",
|
"option_calendar": "OnCalendar-Ausdruck für den Timer",
|
||||||
@@ -16,17 +14,9 @@
|
|||||||
"option_environment": "Environment-Variablen im Format KEY=VALUE",
|
"option_environment": "Environment-Variablen im Format KEY=VALUE",
|
||||||
"option_logfile": "Dateipfad für Log-Ausgabe (stdout/stderr)",
|
"option_logfile": "Dateipfad für Log-Ausgabe (stdout/stderr)",
|
||||||
"option_dry_run": "Gibt die Unit-Dateien nur aus, ohne sie zu schreiben",
|
"option_dry_run": "Gibt die Unit-Dateien nur aus, ohne sie zu schreiben",
|
||||||
// Messages
|
|
||||||
"unit_written_service": "Service Unit geschrieben in: {path}",
|
"unit_written_service": "Service Unit geschrieben in: {path}",
|
||||||
"unit_written_timer": "Timer Unit geschrieben in: {path}",
|
"unit_written_timer": "Timer Unit geschrieben in: {path}",
|
||||||
"hint_header": "\nℹ️ Hinweis:",
|
"hint_header": "\nℹ️ Hinweis:",
|
||||||
// Error messages
|
|
||||||
"error_write_units": "Fehler beim Schreiben der Units:",
|
"error_write_units": "Fehler beim Schreiben der Units:",
|
||||||
"rollback_failed": "Rollback fehlgeschlagen:",
|
"rollback_failed": "Rollback fehlgeschlagen:"
|
||||||
"error_invalid_env": "Ungültiges Environment-Format. Verwende KEY=VALUE.",
|
|
||||||
"error_path_schold_not_be_empty": "Pfad darf nicht leer sein.",
|
|
||||||
"error_path_not_found": "Pfad nicht gefunden: {path}",
|
|
||||||
"error_value_should_not_be_empty": "Wert ({label}) sollte nicht leer sein.",
|
|
||||||
"error_invalid_identifier": "Ungültiger Bezeichner: '{value}' für {identifier}. Erlaubt sind nur alphanumerische Zeichen, Unterstriche und Bindestriche.",
|
|
||||||
"error_invalid_calendar": "Ungültiger OnCalendar-Ausdruck: {value}. Bitte überprüfe die Syntax."
|
|
||||||
}
|
}
|
@@ -1,8 +1,6 @@
|
|||||||
{
|
{
|
||||||
// General
|
|
||||||
"cli_description": "CLI tool for generating systemd .timer and .service units",
|
"cli_description": "CLI tool for generating systemd .timer and .service units",
|
||||||
"cli_create_description": "Generates a systemd .service and .timer unit",
|
"cli_create_description": "Generates a systemd .service and .timer unit",
|
||||||
// Options
|
|
||||||
"option_name": "Name of the unit files (optional, otherwise derived from the exec command)",
|
"option_name": "Name of the unit files (optional, otherwise derived from the exec command)",
|
||||||
"option_exec": "Command to be executed by systemd",
|
"option_exec": "Command to be executed by systemd",
|
||||||
"option_calendar": "OnCalendar expression for the timer",
|
"option_calendar": "OnCalendar expression for the timer",
|
||||||
@@ -16,17 +14,9 @@
|
|||||||
"option_environment": "Environment variables in the format KEY=VALUE",
|
"option_environment": "Environment variables in the format KEY=VALUE",
|
||||||
"option_logfile": "File path for log output (stdout/stderr)",
|
"option_logfile": "File path for log output (stdout/stderr)",
|
||||||
"option_dry_run": "Only outputs the unit files without writing them",
|
"option_dry_run": "Only outputs the unit files without writing them",
|
||||||
// Messages
|
|
||||||
"unit_written_service": "Service unit written to: {path}",
|
"unit_written_service": "Service unit written to: {path}",
|
||||||
"unit_written_timer": "Timer unit written to: {path}",
|
"unit_written_timer": "Timer unit written to: {path}",
|
||||||
"hint_header": "\nℹ️ Note:",
|
"hint_header": "\nℹ️ Note:",
|
||||||
// Error messages
|
|
||||||
"error_write_units": "Error while writing unit files:",
|
"error_write_units": "Error while writing unit files:",
|
||||||
"rollback_failed": "Rollback failed:",
|
"rollback_failed": "Rollback failed:"
|
||||||
"error_invalid_env": "Invalid environment format. Use KEY=VALUE.",
|
|
||||||
"error_path_schold_not_be_empty": "Path should not be empty.",
|
|
||||||
"error_path_not_found": "Path not found: {path}",
|
|
||||||
"error_value_should_not_be_empty": "Value ({label}) should not be empty.",
|
|
||||||
"error_invalid_identifier": "Invalid identifier: '{value}' for {identifier}. Only alphanumeric characters, underscores, and hyphens are allowed.",
|
|
||||||
"error_invalid_calendar": "Invalid OnCalendar expression: {value}. Please check the syntax."
|
|
||||||
}
|
}
|
@@ -1,5 +1,3 @@
|
|||||||
import { parse as parseJsonc } from '@std/jsonc';
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Initializes the i18n module by loading
|
* Initializes the i18n module by loading
|
||||||
* the appropriate locale file based on the system language.
|
* the appropriate locale file based on the system language.
|
||||||
@@ -17,35 +15,29 @@ let translations: Record<string, string> = {};
|
|||||||
/**
|
/**
|
||||||
* Loads the translation file for the specified locale.
|
* Loads the translation file for the specified locale.
|
||||||
*
|
*
|
||||||
* Accepts both `.jsonc` (JSON with comments) and plain `.json`.
|
* Expects a JSON file in the same directory named like `de.json` or `en.json`.
|
||||||
* When both exist, `.jsonc` takes precedence.
|
|
||||||
* Falls back to English ('en') if the specified file does not exist.
|
* Falls back to English ('en') if the specified file does not exist.
|
||||||
*
|
*
|
||||||
* @param locale - The language code (e.g., 'de', 'en') to load
|
* @param locale - The language code (e.g., 'de', 'en') to load
|
||||||
* @returns Promise that resolves once the translations have been loaded
|
* @returns Promise that resolves once the translations have been loaded
|
||||||
*/
|
*/
|
||||||
export async function loadLocale(locale: string): Promise<void> {
|
export async function loadLocale(locale: string): Promise<void> {
|
||||||
const extensions = ['jsonc', 'json'];
|
try {
|
||||||
for (const ext of extensions) {
|
const localeUrl = new URL(`./${locale}.json`, import.meta.url);
|
||||||
try {
|
const file = await Deno.readTextFile(localeUrl);
|
||||||
const localeUrl = new URL(`./${locale}.${ext}`, import.meta.url);
|
translations = JSON.parse(file);
|
||||||
const raw = await Deno.readTextFile(localeUrl);
|
} catch (err) {
|
||||||
// parseJsonc tolerates both pure JSON and JSONC, so we can use it for either.
|
if (err instanceof Deno.errors.NotFound) {
|
||||||
translations = parseJsonc(raw) as Record<string, string>;
|
console.warn(
|
||||||
return;
|
`Locale '${locale}' not found – falling back to 'en'.`,
|
||||||
} catch (err) {
|
);
|
||||||
if (err instanceof Deno.errors.NotFound) {
|
if (locale !== 'en') {
|
||||||
// Continue with next extension.
|
await loadLocale('en');
|
||||||
continue;
|
|
||||||
}
|
}
|
||||||
console.error(`Error parsing locale '${locale}.${ext}':`, err);
|
} else {
|
||||||
break;
|
console.error('Error loading translation file:', err);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
if (locale !== 'en') {
|
|
||||||
console.warn(`Locale '${locale}' not found – falling back to 'en'.`);
|
|
||||||
await loadLocale('en');
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
@@ -1,145 +0,0 @@
|
|||||||
import { resolve } from 'https://deno.land/std@0.224.0/path/mod.ts';
|
|
||||||
import { ValidationError } from '@cliffy/command';
|
|
||||||
import {
|
|
||||||
collectAndValidateAfter,
|
|
||||||
collectAndValidateEnv,
|
|
||||||
validateIdentifier,
|
|
||||||
validateNotEmpty,
|
|
||||||
validatePath,
|
|
||||||
validateSystemdCalendar,
|
|
||||||
} from '../mod.ts';
|
|
||||||
import { t } from '../../i18n/mod.ts';
|
|
||||||
import {
|
|
||||||
assertEquals,
|
|
||||||
assertThrows,
|
|
||||||
} from 'https://deno.land/std@0.224.0/assert/mod.ts';
|
|
||||||
|
|
||||||
Deno.test(
|
|
||||||
'collectAndValidateEnv: throws ValidationError for invalid env format',
|
|
||||||
() => {
|
|
||||||
const invalidEnv = 'INVALID_ENV';
|
|
||||||
assertThrows(
|
|
||||||
() => collectAndValidateEnv(invalidEnv),
|
|
||||||
ValidationError,
|
|
||||||
t('error_invalid_env', { value: invalidEnv }),
|
|
||||||
);
|
|
||||||
},
|
|
||||||
);
|
|
||||||
|
|
||||||
Deno.test(
|
|
||||||
'collectAndValidateEnv: returns collected array for valid env format',
|
|
||||||
() => {
|
|
||||||
const validEnv = 'KEY=value';
|
|
||||||
const previous = ['EXISTING=env'];
|
|
||||||
const result = collectAndValidateEnv(validEnv, previous);
|
|
||||||
assertEquals(result, ['EXISTING=env', 'KEY=value']);
|
|
||||||
},
|
|
||||||
);
|
|
||||||
|
|
||||||
Deno.test('collectAndValidateEnv: aggregates multiple calls', () => {
|
|
||||||
const first = collectAndValidateEnv('FOO=bar');
|
|
||||||
const second = collectAndValidateEnv('BAZ=qux', first);
|
|
||||||
assertEquals(second, ['FOO=bar', 'BAZ=qux']);
|
|
||||||
});
|
|
||||||
|
|
||||||
Deno.test(
|
|
||||||
'validatePath: returns absolute path for valid path without existence check',
|
|
||||||
() => {
|
|
||||||
const tmpDir = Deno.makeTempDirSync();
|
|
||||||
const relativePath = `${tmpDir}/testfile.txt`;
|
|
||||||
const result = validatePath(relativePath, false);
|
|
||||||
assertEquals(result, resolve(relativePath));
|
|
||||||
},
|
|
||||||
);
|
|
||||||
|
|
||||||
Deno.test(
|
|
||||||
'validatePath: throws ValidationError for non‑existent path with existence check',
|
|
||||||
() => {
|
|
||||||
const tmpDir = Deno.makeTempDirSync();
|
|
||||||
const nonExistentPath = `${tmpDir}/nonexistent.txt`;
|
|
||||||
assertThrows(
|
|
||||||
() => validatePath(nonExistentPath, true),
|
|
||||||
ValidationError,
|
|
||||||
t('error_path_not_found', { path: resolve(nonExistentPath) }),
|
|
||||||
);
|
|
||||||
},
|
|
||||||
);
|
|
||||||
|
|
||||||
Deno.test(
|
|
||||||
'validatePath: returns absolute path for existing path with existence check',
|
|
||||||
() => {
|
|
||||||
const tmpDir = Deno.makeTempDirSync();
|
|
||||||
const existingPath = `${tmpDir}/existing.txt`;
|
|
||||||
Deno.writeTextFileSync(existingPath, 'test content');
|
|
||||||
const result = validatePath(existingPath, true);
|
|
||||||
assertEquals(result, resolve(existingPath));
|
|
||||||
},
|
|
||||||
);
|
|
||||||
|
|
||||||
Deno.test('validatePath: throws ValidationError for empty path', () => {
|
|
||||||
const invalidPath = '';
|
|
||||||
assertThrows(
|
|
||||||
() => validatePath(invalidPath, true),
|
|
||||||
ValidationError,
|
|
||||||
t('error_path_schold_not_be_empty'),
|
|
||||||
);
|
|
||||||
});
|
|
||||||
|
|
||||||
Deno.test('validateNotEmpty: returns value for non‑empty string', () => {
|
|
||||||
const input = 'some-value';
|
|
||||||
const result = validateNotEmpty(input, '--exec');
|
|
||||||
assertEquals(result, input);
|
|
||||||
});
|
|
||||||
|
|
||||||
Deno.test('validateNotEmpty: throws ValidationError for empty string', () => {
|
|
||||||
const input = '';
|
|
||||||
assertThrows(
|
|
||||||
() => validateNotEmpty(input, '--exec'),
|
|
||||||
ValidationError,
|
|
||||||
t('error_value_should_not_be_empty', { label: '--exec' }),
|
|
||||||
);
|
|
||||||
});
|
|
||||||
|
|
||||||
Deno.test('collectAndValidateAfter: returns aggregated array', () => {
|
|
||||||
const first = collectAndValidateAfter('network.target');
|
|
||||||
const second = collectAndValidateAfter('postgres.service', first);
|
|
||||||
assertEquals(second, ['network.target', 'postgres.service']);
|
|
||||||
});
|
|
||||||
|
|
||||||
Deno.test('collectAndValidateAfter: throws ValidationError for empty value', () => {
|
|
||||||
assertThrows(
|
|
||||||
() => collectAndValidateAfter(''),
|
|
||||||
ValidationError,
|
|
||||||
t('error_value_should_not_be_empty', { label: '--after' }),
|
|
||||||
);
|
|
||||||
});
|
|
||||||
|
|
||||||
Deno.test('validateIdentifier: returns value for valid identifier', () => {
|
|
||||||
const id = 'backup_job-1';
|
|
||||||
const result = validateIdentifier(id, '--name');
|
|
||||||
assertEquals(result, id);
|
|
||||||
});
|
|
||||||
|
|
||||||
Deno.test('validateIdentifier: throws ValidationError for invalid identifier', () => {
|
|
||||||
const id = 'invalid$';
|
|
||||||
assertThrows(
|
|
||||||
() => validateIdentifier(id, '--name'),
|
|
||||||
ValidationError,
|
|
||||||
t('error_invalid_identifier', { label: '--name', value: id }),
|
|
||||||
);
|
|
||||||
});
|
|
||||||
|
|
||||||
Deno.test('validateSystemdCalendar: accepts valid expression', async () => {
|
|
||||||
const valid = 'Mon..Fri 12:00';
|
|
||||||
const result = await validateSystemdCalendar(valid);
|
|
||||||
assertEquals(result, valid);
|
|
||||||
});
|
|
||||||
|
|
||||||
Deno.test('validateSystemdCalendar: rejects invalid expression', async () => {
|
|
||||||
const invalid = 'Mo..Fr 12:00';
|
|
||||||
await assertThrows(
|
|
||||||
() => validateSystemdCalendar(invalid),
|
|
||||||
ValidationError,
|
|
||||||
t('error_invalid_calendar', { value: invalid }),
|
|
||||||
);
|
|
||||||
});
|
|
@@ -1,176 +0,0 @@
|
|||||||
import { ValidationError } from '@cliffy/command';
|
|
||||||
import { t } from '../i18n/mod.ts';
|
|
||||||
import { existsSync } from 'https://deno.land/std@0.224.0/fs/mod.ts';
|
|
||||||
import { resolve } from 'https://deno.land/std@0.224.0/path/mod.ts';
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Collects repeated occurrences of the `--environment` CLI option and validates
|
|
||||||
* that every entry adheres to `KEY=value` syntax.
|
|
||||||
*
|
|
||||||
* Cliffy calls this handler for *each* `--environment` argument. The previously
|
|
||||||
* accumulated values are passed in via the `previous` parameter, allowing us to
|
|
||||||
* build up the final array manually.
|
|
||||||
*
|
|
||||||
* @example
|
|
||||||
* ```ts
|
|
||||||
* // CLI invocation:
|
|
||||||
* // mycli --environment FOO=bar --environment BAZ=qux
|
|
||||||
* const env = collectAndValidateEnv("FOO=bar");
|
|
||||||
* const env2 = collectAndValidateEnv("BAZ=qux", env);
|
|
||||||
* console.log(env2); // => ["FOO=bar", "BAZ=qux"]
|
|
||||||
* ```
|
|
||||||
*
|
|
||||||
* @param value - Current `KEY=value` string supplied by the user.
|
|
||||||
* @param previous - Array of values collected so far (defaults to an empty
|
|
||||||
* array on the first call).
|
|
||||||
* @returns The updated array containing all validated `KEY=value` pairs.
|
|
||||||
*
|
|
||||||
* @throws {ValidationError} If the input does not match the required syntax
|
|
||||||
* The resulting error is caught by Cliffy, which
|
|
||||||
* will print a help message and terminate with a non-zero exit code.
|
|
||||||
*/
|
|
||||||
export function collectAndValidateEnv(
|
|
||||||
value: string,
|
|
||||||
previous: string[] = [],
|
|
||||||
): string[] {
|
|
||||||
if (!/^\w+=.+/.test(value)) {
|
|
||||||
throw new ValidationError(t('error_invalid_env', { value }));
|
|
||||||
}
|
|
||||||
previous.push(value);
|
|
||||||
return previous;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Normalises a given path to its absolute representation and optionally checks
|
|
||||||
* whether it exists on the filesystem.
|
|
||||||
*
|
|
||||||
* @remarks
|
|
||||||
* Because `--home`, `--cwd`, `--output`, and similar options may refer to files
|
|
||||||
* or directories that *must* already exist, this helper performs the common
|
|
||||||
* validation in a single place.
|
|
||||||
*
|
|
||||||
* @param value - Path provided by the user (absolute or relative).
|
|
||||||
* @param mustExist - When `true`, the function asserts that the resolved path
|
|
||||||
* exists; otherwise, existence is not verified.
|
|
||||||
* @returns The absolute path derived via {@linkcode resolve}.
|
|
||||||
*
|
|
||||||
* @throws {ValidationError}
|
|
||||||
* - If `value` is empty or not a string.
|
|
||||||
* - If `mustExist` is `true` **and** the resolved path cannot be found.
|
|
||||||
*/
|
|
||||||
export function validatePath(value: string, mustExist: boolean): string {
|
|
||||||
if (!value || typeof value !== 'string') {
|
|
||||||
throw new ValidationError(t('error_path_schold_not_be_empty'));
|
|
||||||
}
|
|
||||||
const abs = resolve(value);
|
|
||||||
if (mustExist && !existsSync(abs)) {
|
|
||||||
throw new ValidationError(t('error_path_not_found', { path: abs }));
|
|
||||||
}
|
|
||||||
return abs;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Ensures that a mandatory CLI argument is not empty.
|
|
||||||
*
|
|
||||||
* @param value - Raw string supplied by the user.
|
|
||||||
* @param label - Human-readable label identifying the option (used in error
|
|
||||||
* messages). Example: `"--exec"`.
|
|
||||||
* @returns The original `value` if the validation passes.
|
|
||||||
*
|
|
||||||
* @throws {ValidationError} When `value` is `""`, `null`, `undefined`, or a
|
|
||||||
* non-string.
|
|
||||||
*/
|
|
||||||
export function validateNotEmpty(value: string, label: string): string {
|
|
||||||
if (!value || typeof value !== 'string') {
|
|
||||||
throw new ValidationError(
|
|
||||||
t('error_value_should_not_be_empty', { label }),
|
|
||||||
);
|
|
||||||
}
|
|
||||||
return value;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Collects repeated occurrences of the `--after` CLI option, validating each
|
|
||||||
* target unit name and returning the aggregated list.
|
|
||||||
*
|
|
||||||
* The validation performed here is intentionally minimal – it merely checks
|
|
||||||
* that the argument is a non-empty string. Detailed identifier rules (ASCII
|
|
||||||
* characters, digits, etc.) are enforced elsewhere by
|
|
||||||
* {@link validateIdentifier} when appropriate.
|
|
||||||
*
|
|
||||||
* @param value - Unit name provided with the current `--after` occurrence.
|
|
||||||
* @param previous - Accumulated array of unit names (defaults to an empty
|
|
||||||
* array).
|
|
||||||
* @returns An array containing all validated `--after` values.
|
|
||||||
*
|
|
||||||
* @throws {ValidationError} If `value` is empty.
|
|
||||||
*/
|
|
||||||
export function collectAndValidateAfter(
|
|
||||||
value: string,
|
|
||||||
previous: string[] = [],
|
|
||||||
): string[] {
|
|
||||||
if (!value || typeof value !== 'string') {
|
|
||||||
throw new ValidationError(
|
|
||||||
t('error_value_should_not_be_empty', { label: '--after' }),
|
|
||||||
);
|
|
||||||
}
|
|
||||||
previous.push(value);
|
|
||||||
return previous;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Validates identifiers used in generated systemd unit file names (e.g.
|
|
||||||
* service or timer names) and option flags like `--run-as`.
|
|
||||||
*
|
|
||||||
* @example
|
|
||||||
* ```ts
|
|
||||||
* validateIdentifier("backup_job", "--name"); // OK
|
|
||||||
* validateIdentifier("foo.bar-baz", "--after"); // OK
|
|
||||||
* validateIdentifier("oops$", "--name"); // throws ValidationError
|
|
||||||
* ```
|
|
||||||
*
|
|
||||||
* @param value - The identifier string to validate.
|
|
||||||
* @param label - The relevant option flag, forwarded to the error message so
|
|
||||||
* the user immediately sees which argument is wrong.
|
|
||||||
* @returns The unchanged `value` when it satisfies the pattern.
|
|
||||||
*
|
|
||||||
* @throws {ValidationError} If `value` contains characters outside the allowed
|
|
||||||
* set of ASCII letters, digits, `.`, `_`, and `-`.
|
|
||||||
*/
|
|
||||||
export function validateIdentifier(value: string, label: string): string {
|
|
||||||
if (!/^[A-Za-z0-9_.-]+$/.test(value)) {
|
|
||||||
throw new ValidationError(
|
|
||||||
t('error_invalid_identifier', { identifier: label, value }),
|
|
||||||
);
|
|
||||||
}
|
|
||||||
return value;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Validates a systemd OnCalendar expression by invoking `systemd-analyze calendar`
|
|
||||||
* as a subprocess using a synchronous call. This avoids async overhead.
|
|
||||||
*
|
|
||||||
* @remarks
|
|
||||||
* Requires a Linux environment with systemd available.
|
|
||||||
*
|
|
||||||
* @param value - Calendar expression to validate
|
|
||||||
* @returns The original `value` if valid
|
|
||||||
* @throws {ValidationError} If the expression is invalid or systemd rejects it
|
|
||||||
*/
|
|
||||||
export function validateSystemdCalendar(value: string): string {
|
|
||||||
const command = new Deno.Command('systemd-analyze', {
|
|
||||||
args: ['calendar', value],
|
|
||||||
stdout: 'null',
|
|
||||||
stderr: 'null',
|
|
||||||
});
|
|
||||||
|
|
||||||
const { success } = command.outputSync();
|
|
||||||
|
|
||||||
if (!success) {
|
|
||||||
throw new ValidationError(
|
|
||||||
t('error_invalid_calendar', { value }),
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
return value;
|
|
||||||
}
|
|
@@ -1,11 +1,3 @@
|
|||||||
export {
|
|
||||||
collectAndValidateAfter,
|
|
||||||
collectAndValidateEnv,
|
|
||||||
validateIdentifier,
|
|
||||||
validateNotEmpty,
|
|
||||||
validatePath,
|
|
||||||
validateSystemdCalendar,
|
|
||||||
} from './cliValidationHelper.ts';
|
|
||||||
export { resolveUnitTargetPath, writeUnitFiles } from './fs.ts';
|
export { resolveUnitTargetPath, writeUnitFiles } from './fs.ts';
|
||||||
export { deriveNameFromExec } from './misc.ts';
|
export { deriveNameFromExec } from './misc.ts';
|
||||||
export { getVersion } from './version.ts';
|
export { getVersion } from './version.ts';
|
||||||
|
Reference in New Issue
Block a user