Ken Van Hoeylandt 79d3dd4fdb
Improvements for apps, filesystems, terminal and shell (#659)
app-module

- Apps now have support for:
  - environment variables (inherit from parent app)
  - current workdir
  - window size (when running in terminal)
- Add type aliases like `AppId` and `PackageId`
- Remove data duplication between ledger and app instance records: create `AppManifestSet`
- `AppManifest` usage safety improved: pass by value where needed, or use `AppId` instead of a manifest.

Terminal and shell

- Moved shell commands into coreutils-module as proper apps.
- Refine stack size for terminal and shell because apps now run with their own task and stack (including in-memory apps)

Platform

- Fix for listing root dir on ESP32: wrap posix directory functions and wire in file systems.
- Moved all platform-specific file system init code to platform subprojects

Other

- Fix for screenshot capture (issue with paths)
- Fixes for coreutils app correctness
- Memory optimizations (use more PSRAM where possible) in various locations such as app-module, shell and terminal.
- `ls` and `help` commands now use terminal width and show columns of data by default
- Created fs helpers at `TactilityKernel/include/tactility/filesystem/fs.h` (partially ported from `ShellFs`)
2026-09-25 08:29:27 +02:00

83 lines
2.9 KiB
C++

#include <app/io.h>
#include <app/manager.h>
#include <app/manifest.h>
#include <TactilityCpp/Allocator.h>
#include <algorithm>
#include <cstdio>
#include <string>
#include <vector>
namespace coreutils::help {
namespace {
// Prefers PSRAM over internal RAM, like the rest of app-module's own unbounded collections
// (AppLedger::instances/packages, AppEnv) - this isn't on any hot path, so there's no reason to
// spend scarce internal RAM on it.
using IdList = std::vector<std::string, tt::OptExternalAllocator<std::string>>;
// app_manager_for_each_manifest() holds app_ledger()'s mutex for the whole call and its own
// contract forbids calling back into anything that touches the ledger from inside the visitor -
// printf() is wrapped on some platforms to route through the app I/O layer, which needs the
// ledger too, so this only copies the id out; printing happens after the call returns below.
void collectHeadlessId(const AppManifest* manifest, void* context) {
if ((manifest->flags & APP_MANIFEST_FLAG_HEADLESS) == 0) {
return;
}
static_cast<IdList*>(context)->emplace_back(manifest->id);
}
} // namespace
static int32_t main(int, char*[]) {
IdList ids;
app_manager_for_each_manifest(collectHeadlessId, &ids);
std::sort(ids.begin(), ids.end());
int commandWidth = 0;
for (const auto& id : ids) {
const int length = static_cast<int>(id.size());
if (length > commandWidth) {
commandWidth = length;
}
}
AppWindowSize windowSize {};
int columns = 0;
if (app_io_ioctl(STDIN_FILENO, APP_IOCTL_GET_WINDOW_SIZE, &windowSize) == ERROR_NONE ||
app_io_ioctl(STDOUT_FILENO, APP_IOCTL_GET_WINDOW_SIZE, &windowSize) == ERROR_NONE ||
app_io_ioctl(STDERR_FILENO, APP_IOCTL_GET_WINDOW_SIZE, &windowSize) == ERROR_NONE) {
columns = windowSize.columns;
}
// Sized off the widest registered id, not the worst-case APP_MANIFEST_ID_LENGTH, so short ids
// pack tighter; capped at the window width so one long id can't force perLine below 1.
const int entryWidth = (columns < commandWidth ? columns : commandWidth) + 1;
const int perLine = (columns >= entryWidth) ? columns / entryWidth : 1;
puts("Commands:");
for (size_t i = 0; i < ids.size(); i++) {
const bool lastInLine = (i + 1) % perLine == 0 || i + 1 == ids.size();
if (lastInLine) {
printf("%s\n", ids[i].c_str());
} else {
printf("%-*s", entryWidth, ids[i].c_str());
}
}
return 0;
}
extern const ::AppManifest manifest = {
.id = "help",
.name = "help",
.category = APP_CATEGORY_SYSTEM,
.location = { .type = APP_LOCATION_MEMORY, .location = reinterpret_cast<void*>(main) },
.flags = APP_MANIFEST_FLAG_HIDDEN | APP_MANIFEST_FLAG_HEADLESS,
.stack = { .depth = 4096, .desired_memory_capability = 0 },
};
} // namespace coreutils::help