@git.zone/tsrust 1.13.2 → 1.14.0

package/ts/mod_notices/helpers.staticglibc.ts

@@ -0,0 +1,79 @@
+import { friendlyTargetName } from '../mod_cli/helpers.targets.js';
+
+export interface IStaticGlibcCheckOptions {
+  targets: Array<{ triple: string; friendly: string }>;
+  /** `static` from the configuration or `--static`. */
+  staticLinking: boolean;
+  /** `rustflags` from the tsrust configuration. */
+  rustflags: string[];
+  environment: NodeJS.ProcessEnv;
+}
+
+const isGnuTarget = (tripleArg: string): boolean => tripleArg.endsWith('-linux-gnu');
+
+/**
+ * The error for a Linux GNU target that links glibc statically: static glibc
+ * carries LGPL-2.1 relinking obligations that native notices do not fulfil.
+ */
+export function staticGlibcError(
+  friendlyArg: string,
+  tripleArg: string,
+  reasonArg: string,
+  remedyArg: string,
+): Error {
+  const musl = friendlyTargetName(tripleArg.replace(/-gnu$/, '-musl'));
+  return new Error(
+    `${reasonArg}. Static glibc carries LGPL-2.1 relinking obligations that tsrust notices do not fulfil. ` +
+      `Choose (a) a static musl target such as ${musl} instead of ${friendlyArg}, or (b) dynamic glibc by ` +
+      `${remedyArg}.`,
+  );
+}
+
+/**
+ * Refuses a build with native notices that would link glibc statically, from
+ * any source tsrust can see before building: `static`, tsrust `rustflags`,
+ * and the rustflags environment variables Cargo reads. Static linking set up
+ * elsewhere (a Cargo configuration file) is caught by inspecting the built
+ * binary with `staticGlibcArtifactError`.
+ */
+export function assertNoStaticGlibc(optionsArg: IStaticGlibcCheckOptions): void {
+  for (const target of optionsArg.targets.filter((entry) => isGnuTarget(entry.triple))) {
+    if (optionsArg.staticLinking) {
+      throw staticGlibcError(
+        target.friendly,
+        target.triple,
+        `Target ${target.friendly} links glibc statically ("static" or --static)`,
+        'removing "static" from the @git.zone/tsrust configuration and not passing --static',
+      );
+    }
+    const sources: Array<[string, string | undefined]> = [
+      ['the @git.zone/tsrust rustflags', optionsArg.rustflags.join(' ')],
+      ['RUSTFLAGS', optionsArg.environment.RUSTFLAGS],
+      ['CARGO_ENCODED_RUSTFLAGS', optionsArg.environment.CARGO_ENCODED_RUSTFLAGS],
+      ['CARGO_BUILD_RUSTFLAGS', optionsArg.environment.CARGO_BUILD_RUSTFLAGS],
+    ];
+    const targetVariable = `CARGO_TARGET_${target.triple.toUpperCase().replace(/-/g, '_')}_RUSTFLAGS`;
+    sources.push([targetVariable, optionsArg.environment[targetVariable]]);
+    for (const [name, value] of sources) {
+      if (value?.includes('+crt-static')) {
+        throw staticGlibcError(
+          target.friendly,
+          target.triple,
+          `Target ${target.friendly} links glibc statically (+crt-static in ${name})`,
+          `removing +crt-static from ${name}`,
+        );
+      }
+    }
+  }
+}
+
+/** The error for a GNU binary that the build produced without an interpreter. */
+export function staticGlibcArtifactError(friendlyArg: string, tripleArg: string): Error {
+  return staticGlibcError(
+    friendlyArg,
+    tripleArg,
+    `${friendlyArg} was linked statically: the binary has no ELF interpreter although no tsrust setting or ` +
+      'rustflags environment variable requested static linking',
+    'removing crt-static and static link arguments from the Cargo configuration (.cargo/config.toml)',
+  );
+}

package/ts/mod_notices/index.ts

@@ -0,0 +1,8 @@
+export * from './helpers.spdx.js';
+export * from './helpers.licensetext.js';
+export * from './helpers.muslversion.js';
+export * from './helpers.noticesconfig.js';
+export * from './helpers.runtimetexts.js';
+export * from './helpers.staticglibc.js';
+export * from './classes.noticetoolchain.js';
+export * from './classes.nativenoticesgenerator.js';