![\"https://raw.githubusercontent.com/nickanderson/cfengine-delete-files/main/delete-files-example-input-mp.png\"](\"https://raw.githubusercontent.com/nickanderson/cfengine-delete-files/main/delete-files-example-input-mp.png\" "\\"https://raw.githubusercontent.com/nickanderson/cfengine-delete-files/main/delete-files-example-input-mp.png\\"")
![\"CI\"](\"https://github.com/aleksandrychev/cfengine-clamav/actions/workflows/ci.yml/badge.svg\"){kind=icon}
![\"Mission](\"https://raw.githubusercontent.com/aleksandrychev/cfengine-clamav/main/inventory.png\")
{{#classes.common:webserver_role}}Web server role{{/classes.common:webserver_role}}
CFEngine Policy Builder demo project
This page, the nginx it runs on and everything around them were set up by policy built visually in CFEngine Policy Builder.
@@ -171,6 +173,36 @@ function buildLandingPageBlock(): DemoBlock { }; } +// The logo the landing page shows, fetched from cfengine.com once a day: an HTTP Request block, +// whose promise type comes from the promise-type-http module (adding the block adds it). +function buildLogoBlock(): DemoBlock { + return { + blockId: 'http-request', + label: 'Download the CFEngine logo', + note: 'The landing page shows it; fetched at most once a day.', + runInterval: '1440', + params: { + url: 'https://cfengine.com/images/cfengine-logo.svg', + method: 'GET', + file: '/var/www/html/cfengine-logo.svg', + headers: '', + payload: '', + insecure: 'false' + } + }; +} + +// The http promise type runs with python3 on the host. +function buildPythonBlock(): DemoBlock { + return { + blockId: 'install-package', + label: 'Install python3', + note: 'The logo download is an http promise, which runs with python3.', + params: { package_name: 'python3', version: '' }, + condition: { mode: 'if', kind: 'class', className: 'common:webserver_role' } + }; +} + // The landing page's folder, made explicitly: a file's missing parents would be created 700. function buildWebRootBlock(): DemoBlock { return { blockId: 'create-directory', label: 'Create web root', params: { path: '/var/www/html', mode: '755', owner: 'root', group: 'root' } }; @@ -279,6 +311,8 @@ const POSITIONS: RecordUse
Lists files.
| Name | \n\tType |
|---|---|
| string | text |
Use
', 'https://github.com/o/r/blob/abc/')).toEqual([
+ { tag: 'img', src: 'https://raw.githubusercontent.com/o/r/abc/shot.png', alt: 'Shot', children: [] },
+ { tag: 'a', href: 'https://example.com/a.png', children: ['🖼 A'] }
+ ]);
+ });
+
+ it('reads the website data: "None" links are none, versions newest first', () => {
+ const details = parseDetails({
+ author: { name: 'Nick', url: 'https://github.com/nick', image: 'https://avatars.githubusercontent.com/u/2' },
+ downloads: 89,
+ documentation: 'None',
+ versions: { '1.0.0': { date: 'Dec 21, 2022', latest: false }, '2.0.0': { date: 'Jun 30, 2023', latest: true } },
+ readme: 'Hi
' + }); + expect(details).toMatchObject({ downloads: '89', documentation: undefined, readme: [{ tag: 'p', children: ['Hi'] }] }); + expect(details.author).toEqual({ name: 'Nick', url: 'https://github.com/nick', image: 'https://avatars.githubusercontent.com/u/2' }); + expect(details.versions.map(version => version.version)).toEqual(['2.0.0', '1.0.0']); + }); +}); diff --git a/src/renderer/src/modules/moduleDetails.ts b/src/renderer/src/modules/moduleDetails.ts new file mode 100644 index 0000000..221e285 --- /dev/null +++ b/src/renderer/src/modules/moduleDetails.ts @@ -0,0 +1,138 @@ +// A module's details as build.cfengine.com has them (its js/modules.json, what Mission Portal shows). + +export interface ModuleVersion { + date?: string; + latest: boolean; + version: string; +} + +export interface ModuleWebDetails { + author?: { image?: string; name: string; url?: string }; + discussion?: string; + discussionSearch?: string; + documentation?: string; + downloads?: string; + // The README, as a tree of allowlisted tags and text: rendered as React elements, never as HTML. + readme: ReadmeNode[]; + updated?: string; + versions: ModuleVersion[]; + website?: string; +} + +const isRecord = (value: unknown): value is Record