track source

.gitignore

@@ -103,4 +103,5 @@ distribution/*
 mirrorlist
 mirrors*.json
 mirrors.md
+head.md
 .env

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "artix-mlg",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "artix-mlg",
-      "version": "0.2.6",
+      "version": "0.2.7",
       "license": "MIT",
       "dependencies": {
         "country-code-lookup": "0.1.3",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "artix-mlg",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "mirrorlist generator for Artix Linux",
   "keywords": [
     "artix",

src/index.ts

@@ -10,6 +10,7 @@ const inputFile = process.env['INPUT'] || path.join(process.cwd(), 'mirrors.json
 const fixtureFile = process.env['FIXTURE'] || path.join(process.cwd(), 'mirrors.fixture.json');
 const mirrorList = process.env['MIRRORLIST'] || path.join(process.cwd(), 'mirrorlist');
 const mirrorMd = process.env['MIRRORMD'] || path.join(process.cwd(), 'mirrors.md');
+const mdHeadFile = process.env['MDHEADER'] || path.join(process.cwd(), 'head.md');
 const verbose = !!process.env['VERBOSE'];
 
 const protocolId: Record<Protocol, number> = {
@@ -69,7 +70,6 @@ interface UrlComponents {
 type MirrorMap = { [name: string]: Mirror };
 
 let mirrorCounter = 0;
-let mirrorUrlCounter = 0;
 
 function setMirrors(fixture: FixtureObject[]) {
     const mirrors: MirrorMap = {};
@@ -130,25 +130,25 @@ function updateMirror(m: Mirror, profile: MirrorProfile, url: UrlComponents) {
     }
 }
 
-function processMirrorProfile(m: MirrorProfile) {
+function processMirrorProfile(m: MirrorProfile, index: number) {
     const url: UrlComponents = processUrl(m.url);
     const mirror: Mirror = getMirror(m.force_mirror_name || url.name);
-        updateMirror(mirror, m, url);
-        const mirrorUrl: MirrorUrl = {
-            pk: ++mirrorUrlCounter,
-            model: 'mirrors.MirrorUrl',
-            fields: {
-                url: url.partial,
-                protocol: protocolId[url.protocol],
-                mirror: mirror.pk,
-                country: resolveCountry(m.country)?.iso2 || undefined,
-                // populate ip fields with `mirrorresolv`
-                has_ipv4: false,
-                has_ipv6: false,
-                active: m.active
-            }
-        };
-        mirrorUrls.push(mirrorUrl);
+    updateMirror(mirror, m, url);
+    const mirrorUrl: MirrorUrl = {
+        pk: index + 1,
+        model: 'mirrors.MirrorUrl',
+        fields: {
+            url: url.partial,
+            protocol: protocolId[url.protocol],
+            mirror: mirror.pk,
+            country: resolveCountry(m.country)?.iso2 || undefined,
+            // populate ip fields with `mirrorresolv`
+            has_ipv4: false,
+            has_ipv6: false,
+            active: m.active
+        }
+    };
+    mirrorUrls.push(mirrorUrl);
     pushMirrorProfile(m.force_mirror_name || url.name, m);
 }
 
@@ -183,7 +183,7 @@ function generateMirrorlist(mirrors: MirrorProfile[] = []): string {
     const lines: string[] = [
         '##',
         '## Artix Linux repository mirrorlist',
-        `## Generated on ${getDateTime()}`,
+        `## Generated on ${getDateTime()} by artix-mlg`,
         '##',
         '',
         '# Artix mirrors',
@@ -199,7 +199,18 @@ function generateMirrorlist(mirrors: MirrorProfile[] = []): string {
     return lines.join('\n');
 }
 
-function generateMirrorMd(): string {
+async function generateMirrorMd(): Promise<string> {
+    async function tryReadHeader(): Promise<string[]> {
+        try {
+            return [await fsp.readFile(mdHeadFile, 'utf-8')];
+        }
+        catch (err) {
+            if (verbose) {
+                console.error(err);
+            }
+            return [];
+        }
+    }
     function pushTableRowIfTruthy(lines: string[], label: string, value: string | undefined | null | false) {
         if (value) {
             lines.push(`| ${label} | ${value} |`);
@@ -208,15 +219,14 @@ function generateMirrorMd(): string {
     function findFirstWithChild<T, K extends keyof T>(profiles: T[], key: K): T[K] | undefined {
         return profiles.find(p => !!p[key])?.[key];
     }
-    const lines: string[] = [
-        '# Mirrors\n\nContact or other information for the mirrors of our repositories and ISOs.\n'
-    ]
+    const lines: string[] = await tryReadHeader();
+    lines.push('# Mirrors\n\nContact or other information for the mirrors of our repositories and ISOs.\n');
     for (let mirrorName in mirrorProfilesByMirrorName) {
         const profiles: MirrorProfile[] = mirrorProfilesByMirrorName[mirrorName];
         const activeProfiles: MirrorProfile[] = profiles.filter(p => p.active);
         const urls: string[] = profiles.map(p => {
             const url = p.url.split('$repo')[0];
-            return p.active ? url: `${url} (inactive)`;
+            return p.active ? url : `${url} (inactive)`;
         });
         const upstream = findFirstWithChild(activeProfiles, 'upstream');
         lines.push(`### ${mirrorName}`);
@@ -265,7 +275,7 @@ async function main() {
 
     await fsp.writeFile(fixtureFile, JSON.stringify(composeMirrorFixture(), null, 4));
     await fsp.writeFile(mirrorList, generateMirrorlist(input.mirrors?.filter(m => m.public && m.active && !m.suppress) || []));
-    await fsp.writeFile(mirrorMd, generateMirrorMd());
+    await fsp.writeFile(mirrorMd, await generateMirrorMd());
 }
 
 export default main;