Build the Apple Container extension
Turns the empty scaffold into a working Nova extension for Apple Container and container-compose, in the shape of the Docker Suite extension. Sidebar (Scripts/Sidebar): - System, Containers, Images, Volumes and Networks sections - Containers grouped into compose projects via the com.docker.compose.project label container-compose stamps; project rows drive compose up/down/build against the matching workspace file - Lifecycle, shell, logs, inspect, browse and copy commands per resource - Apple Container publishes no event stream, so the sidebar polls while visible and only reloads a section when a fingerprint of its data changes, which keeps selection and expansion intact Hostnames (Scripts/Hostnames.js): - A container's hostname is <name>.<domain> and the domain lives in Apple Container's config.toml, which has no CLI setter, so the Hostname Domain preference reads and writes that file directly - Changing it offers to register the domain with macOS and restart the services; the write preserves the file's other tables and its mode Language support: - Dockerfile and Compose syntaxes backed by tree-sitter grammars built by Tools/build-syntaxes.sh, pinned to revisions that generate ABI 14 - The Compose syntax is named dockercompose because that is the languageId docker-language-server recognises compose files by - docker-language-server is downloaded on first use rather than bundled, at roughly 40 MB Icons are generated by Tools/make-icons.py so they can be regenerated rather than hand-maintained. Co-Authored-By: Claude Opus 5 <[email protected]> Claude-Session: https://claude.ai/code/session_01UnSBcR5Lywz5Fbj5FmVbfc
This commit is contained in:
Claude Opus 5
@@ -0,0 +1,221 @@
|
||||
//
|
||||
// System section: the container services, the builder, disk usage and any
|
||||
// local DNS domains.
|
||||
//
|
||||
|
||||
const { Controller } = require("./Controller");
|
||||
const { SystemTreeItem } = require("../TreeItems/SystemTreeItem");
|
||||
const { ContainerCLI } = require("../../Interfaces/ContainerCLI");
|
||||
const systemConfig = require("../../Utilities/SystemConfig");
|
||||
const format = require("../../Utilities/Format");
|
||||
const { Terminal } = require("../../Interfaces/Terminal");
|
||||
const notify = require("../../Utilities/Notify");
|
||||
const prompt = require("../../Utilities/Prompt");
|
||||
|
||||
class SystemController extends Controller {
|
||||
constructor(sidebar) {
|
||||
super("apple_container.system");
|
||||
this.sidebar = sidebar;
|
||||
this.running = false;
|
||||
this.registerCommands();
|
||||
}
|
||||
|
||||
async fetch() {
|
||||
let status = await ContainerCLI.systemStatus();
|
||||
let running = status.status === "running";
|
||||
let rows = [];
|
||||
|
||||
this.running = running;
|
||||
|
||||
rows.push({
|
||||
identifier: "system.services",
|
||||
label: "Services",
|
||||
running: running,
|
||||
contextValue: running ? "system.services.running" : "system.services.stopped",
|
||||
description: running ? version(status.apiServerVersion) : "stopped",
|
||||
tooltip: statusTooltip(status),
|
||||
copy: status.apiServerVersion || "",
|
||||
children: []
|
||||
});
|
||||
|
||||
if (!running) {
|
||||
return rows;
|
||||
}
|
||||
|
||||
let [builder, usage, domains] = await Promise.all([
|
||||
ContainerCLI.builderRunning(),
|
||||
ContainerCLI.systemDiskUsage(),
|
||||
ContainerCLI.dnsDomains()
|
||||
]);
|
||||
|
||||
rows.push({
|
||||
identifier: "system.builder",
|
||||
label: "Builder",
|
||||
running: builder,
|
||||
contextValue: builder ? "system.builder.running" : "system.builder.stopped",
|
||||
description: builder ? "running" : "stopped",
|
||||
tooltip: "The builder container backing `container build`.",
|
||||
copy: "builder",
|
||||
children: []
|
||||
});
|
||||
|
||||
if (usage) {
|
||||
rows.push({
|
||||
identifier: "system.disk",
|
||||
label: "Disk Usage",
|
||||
contextValue: "system.disk",
|
||||
image: "icons/system.png",
|
||||
description: usageSummary(usage),
|
||||
tooltip: usageTooltip(usage),
|
||||
copy: usageSummary(usage),
|
||||
children: []
|
||||
});
|
||||
}
|
||||
|
||||
// The domain containers are named under, which is separate from the
|
||||
// domains macOS has been told to resolve.
|
||||
let hostnameDomain = systemConfig.defaultDomain();
|
||||
let resolved = hostnameDomain !== null && domains.includes(hostnameDomain);
|
||||
|
||||
rows.push({
|
||||
identifier: "system.dns.default",
|
||||
label: "Hostname Domain",
|
||||
contextValue: "system.dns.default",
|
||||
image: hostnameDomain && !resolved ? "icons/status/warning.png" : "icons/network.png",
|
||||
description: hostnameDomain ? `.${hostnameDomain}` : "not set",
|
||||
tooltip: hostnameTooltip(hostnameDomain, resolved),
|
||||
copy: hostnameDomain || "",
|
||||
children: []
|
||||
});
|
||||
|
||||
for (let domain of domains) {
|
||||
rows.push({
|
||||
identifier: `system.dns.${domain}`,
|
||||
label: domain,
|
||||
contextValue: "system.dns",
|
||||
image: "icons/network.png",
|
||||
description: "resolved by macOS",
|
||||
tooltip: `macOS resolves *.${domain} through Apple Container's DNS service.`,
|
||||
copy: domain,
|
||||
children: []
|
||||
});
|
||||
}
|
||||
|
||||
return rows;
|
||||
}
|
||||
|
||||
signature(rows) {
|
||||
return JSON.stringify(rows.map((row) => [row.identifier, row.description, row.running]));
|
||||
}
|
||||
|
||||
getTreeItem(element) {
|
||||
return new SystemTreeItem(element);
|
||||
}
|
||||
|
||||
registerCommands() {
|
||||
this.register("apple_container.system.df", async () => {
|
||||
try {
|
||||
let result = await ContainerCLI.run(["system", "df", "--format", "json"]);
|
||||
nova.workspace.openNewTextDocument({ content: result.stdout, syntax: "json" });
|
||||
} catch (error) {
|
||||
notify.failure("Unable to read disk usage", error, "apple-container-df");
|
||||
}
|
||||
});
|
||||
|
||||
this.register("apple_container.dns.unregister", async () => {
|
||||
let row = this.selection[0];
|
||||
|
||||
if (!row || !row.copy) {
|
||||
return;
|
||||
}
|
||||
|
||||
if (
|
||||
!(await prompt.confirm(
|
||||
`Stop macOS resolving *.${row.copy}? This runs sudo in your terminal.`,
|
||||
"Unregister"
|
||||
))
|
||||
) {
|
||||
return;
|
||||
}
|
||||
|
||||
await Terminal.run(
|
||||
`sudo ${Terminal.command([ContainerCLI.path(), "system", "dns", "delete", row.copy])}`
|
||||
);
|
||||
});
|
||||
|
||||
this.register("apple_container.system.copy", () => {
|
||||
let row = this.selection[0];
|
||||
|
||||
if (row && row.copy) {
|
||||
nova.clipboard.writeText(row.copy);
|
||||
}
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
function hostnameTooltip(domain, resolved) {
|
||||
if (!domain) {
|
||||
return [
|
||||
"Containers have unqualified hostnames.",
|
||||
"Set a domain to reach them as <name>.<domain>."
|
||||
].join("\n");
|
||||
}
|
||||
|
||||
if (resolved) {
|
||||
return `Containers are reachable as <name>.${domain} from this Mac.`;
|
||||
}
|
||||
|
||||
return [
|
||||
`Containers are named <name>.${domain}, but macOS does not resolve that domain yet.`,
|
||||
"Use Set Up Container Hostnames to register it."
|
||||
].join("\n");
|
||||
}
|
||||
|
||||
function version(text) {
|
||||
if (!text) {
|
||||
return "running";
|
||||
}
|
||||
|
||||
let match = String(text).match(/version\s+(\S+)/);
|
||||
return match ? `running ${match[1]}` : "running";
|
||||
}
|
||||
|
||||
function statusTooltip(status) {
|
||||
if (status.status !== "running") {
|
||||
return "Container services are not running.\nUse Start Services to launch them.";
|
||||
}
|
||||
|
||||
return [
|
||||
`Status:\t${status.status}`,
|
||||
status.apiServerVersion ? `Version:\t${status.apiServerVersion}` : "",
|
||||
status.appRoot ? `App root:\t${status.appRoot}` : "",
|
||||
status.installRoot ? `Install:\t${status.installRoot}` : ""
|
||||
]
|
||||
.filter((line) => line.length > 0)
|
||||
.join("\n");
|
||||
}
|
||||
|
||||
function usageSummary(usage) {
|
||||
let total = ["images", "containers", "volumes"].reduce(
|
||||
(sum, key) => sum + ((usage[key] && usage[key].sizeInBytes) || 0),
|
||||
0
|
||||
);
|
||||
let reclaimable = ["images", "containers", "volumes"].reduce(
|
||||
(sum, key) => sum + ((usage[key] && usage[key].reclaimable) || 0),
|
||||
0
|
||||
);
|
||||
|
||||
return `${format.bytes(total)} ${format.bytes(reclaimable)} reclaimable`;
|
||||
}
|
||||
|
||||
function usageTooltip(usage) {
|
||||
return ["images", "containers", "volumes"]
|
||||
.map((key) => {
|
||||
let entry = usage[key] || {};
|
||||
let name = key.charAt(0).toUpperCase() + key.slice(1);
|
||||
return `${name}:\t${entry.total || 0}\t${format.bytes(entry.sizeInBytes || 0)}`;
|
||||
})
|
||||
.join("\n");
|
||||
}
|
||||
|
||||
module.exports = { SystemController };
|
||||
Reference in New Issue
Block a user