aws · MrArnoldPalmer · Aug 21, 2020 · Apr 15, 2020 · May 14, 2020 · May 26, 2020
diff --git a/packages/@jsii/kernel/test/kernel.test.ts b/packages/@jsii/kernel/test/kernel.test.ts
@@ -371,6 +371,7 @@ defineTest(
         namespace: 'Amazon.JSII.Tests.CalculatorNamespace',
         packageId: 'Amazon.JSII.Tests.CalculatorPackageId',
       },
+      go: {},
       java: {
         package: 'software.amazon.jsii.tests.calculator',
         maven: {
@@ -388,6 +389,7 @@ defineTest(
           packageId: 'Amazon.JSII.Tests.CalculatorPackageId.LibPackageId',
           versionSuffix: '-devpreview',
         },
+        go: {},
         java: {
           package: 'software.amazon.jsii.tests.calculator.lib',
           maven: {

diff --git a/packages/@scope/jsii-calc-base-of-base/package.json b/packages/@scope/jsii-calc-base-of-base/package.json
@@ -25,6 +25,7 @@
   "types": "lib/index.d.ts",
   "scripts": {
     "build": "jsii --project-references && jsii-rosetta",
+    "pacmak": "jsii-pacmak",
     "test": "diff-test test/assembly.jsii .jsii",
     "test:update": "npm run build && UPDATE_DIFF=1 npm run test"
   },
@@ -40,6 +41,7 @@
   "jsii": {
     "outdir": "dist",
     "targets": {
+      "go": {},
       "java": {
         "package": "software.amazon.jsii.tests.calculator.baseofbase",
         "maven": {

diff --git a/packages/@scope/jsii-calc-base-of-base/test/assembly.jsii b/packages/@scope/jsii-calc-base-of-base/test/assembly.jsii
@@ -23,6 +23,7 @@
       "namespace": "Amazon.JSII.Tests.CalculatorNamespace.BaseOfBaseNamespace",
       "packageId": "Amazon.JSII.Tests.CalculatorPackageId.BaseOfBasePackageId"
     },
+    "go": {},
     "java": {
       "maven": {
         "artifactId": "calculator-base-of-base",
@@ -111,5 +112,5 @@
     }
   },
   "version": "0.0.0",
-  "fingerprint": "v3mwSbKGQ2aa8g0DEKIeaEXh3csX7PX2MJJxHVRufhI="
+  "fingerprint": "QA35s5WeGGn1u/fckcbOi4pFcmI9m9oTSYs2cq+ewpw="
 }
diff --git a/packages/@scope/jsii-calc-base/package.json b/packages/@scope/jsii-calc-base/package.json
@@ -46,6 +46,7 @@
   "jsii": {
     "outdir": "dist",
     "targets": {
+      "go": {},
       "java": {
         "package": "software.amazon.jsii.tests.calculator.base",
         "maven": {

diff --git a/packages/@scope/jsii-calc-base/test/assembly.jsii b/packages/@scope/jsii-calc-base/test/assembly.jsii
@@ -17,6 +17,7 @@
           "namespace": "Amazon.JSII.Tests.CalculatorNamespace.BaseOfBaseNamespace",
           "packageId": "Amazon.JSII.Tests.CalculatorPackageId.BaseOfBasePackageId"
         },
+        "go": {},
         "java": {
           "maven": {
             "artifactId": "calculator-base-of-base",
@@ -50,6 +51,7 @@
       "namespace": "Amazon.JSII.Tests.CalculatorNamespace.BaseNamespace",
       "packageId": "Amazon.JSII.Tests.CalculatorPackageId.BasePackageId"
     },
+    "go": {},
     "java": {
       "maven": {
         "artifactId": "calculator-base",
@@ -151,5 +153,5 @@
     }
   },
   "version": "0.0.0",
-  "fingerprint": "ttHhQ5EzgjW0lybCNSKOfqilJ04kp4VK3arcpRl3rBM="
+  "fingerprint": "JCkFuFqry/njMLNi/IpfTVdkVye/esUFOCoZoFbDD+4="
 }
diff --git a/packages/@scope/jsii-calc-lib/package.json b/packages/@scope/jsii-calc-lib/package.json
@@ -49,6 +49,7 @@
   "jsii": {
     "outdir": "dist",
     "targets": {
+      "go": {},
       "java": {
         "package": "software.amazon.jsii.tests.calculator.lib",
         "maven": {

diff --git a/packages/@scope/jsii-calc-lib/test/assembly.jsii b/packages/@scope/jsii-calc-lib/test/assembly.jsii
@@ -18,6 +18,7 @@
           "namespace": "Amazon.JSII.Tests.CalculatorNamespace.BaseNamespace",
           "packageId": "Amazon.JSII.Tests.CalculatorPackageId.BasePackageId"
         },
+        "go": {},
         "java": {
           "maven": {
             "artifactId": "calculator-base",
@@ -40,6 +41,7 @@
           "namespace": "Amazon.JSII.Tests.CalculatorNamespace.BaseOfBaseNamespace",
           "packageId": "Amazon.JSII.Tests.CalculatorPackageId.BaseOfBasePackageId"
         },
+        "go": {},
         "java": {
           "maven": {
             "artifactId": "calculator-base-of-base",
@@ -97,6 +99,7 @@
       "packageId": "Amazon.JSII.Tests.CalculatorPackageId.LibPackageId",
       "versionSuffix": "-devpreview"
     },
+    "go": {},
     "java": {
       "maven": {
         "artifactId": "calculator-lib",
@@ -668,5 +671,5 @@
     }
   },
   "version": "0.0.0",
-  "fingerprint": "w6/8Kda6/JitSbpMK3LGPK5JGRxJ50gflR5S4sUEHKk="
+  "fingerprint": "/uziR97y1c4zIKVBkWC6j4EbxYLKuCC4ePZXhOMMXBE="
 }
diff --git a/packages/jsii-calc/package.json b/packages/jsii-calc/package.json
@@ -58,6 +58,7 @@
   "jsii": {
     "outdir": "dist",
     "targets": {
+      "go": {},
       "java": {
         "package": "software.amazon.jsii.tests.calculator",
         "maven": {

diff --git a/packages/jsii-calc/test/assembly.jsii b/packages/jsii-calc/test/assembly.jsii
@@ -45,6 +45,7 @@
           "namespace": "Amazon.JSII.Tests.CalculatorNamespace.BaseNamespace",
           "packageId": "Amazon.JSII.Tests.CalculatorPackageId.BasePackageId"
         },
+        "go": {},
         "java": {
           "maven": {
             "artifactId": "calculator-base",
@@ -67,6 +68,7 @@
           "namespace": "Amazon.JSII.Tests.CalculatorNamespace.BaseOfBaseNamespace",
           "packageId": "Amazon.JSII.Tests.CalculatorPackageId.BaseOfBasePackageId"
         },
+        "go": {},
         "java": {
           "maven": {
             "artifactId": "calculator-base-of-base",
@@ -109,6 +111,7 @@
           "packageId": "Amazon.JSII.Tests.CalculatorPackageId.LibPackageId",
           "versionSuffix": "-devpreview"
         },
+        "go": {},
         "java": {
           "maven": {
             "artifactId": "calculator-lib",
@@ -230,6 +233,7 @@
       "namespace": "Amazon.JSII.Tests.CalculatorNamespace",
       "packageId": "Amazon.JSII.Tests.CalculatorPackageId"
     },
+    "go": {},
     "java": {
       "maven": {
         "artifactId": "calculator",
@@ -13162,5 +13166,5 @@
     }
   },
   "version": "0.0.0",
-  "fingerprint": "miVjqwWxNOLMY7fR23c/SVvfiGqkgqLgG+18qp4f8MM="
+  "fingerprint": "WdFD02mRrBZaKXT1erhd6fi+1V5/bpaeGuNZWxNuRdk="
 }
diff --git a/packages/jsii-pacmak/lib/generator.ts b/packages/jsii-pacmak/lib/generator.ts
@@ -31,6 +31,10 @@ export interface GeneratorOptions {
 }
 
 export interface IGenerator {
+  /**
+   *
+   * @param fingerprint
+   */
   generate(fingerprint: boolean): void;
 
   /**

diff --git a/packages/jsii-pacmak/lib/targets/golang.ts b/packages/jsii-pacmak/lib/targets/golang.ts
@@ -0,0 +1,96 @@
+import { CodeMaker } from 'codemaker';
+import * as fs from 'fs-extra';
+import { Assembly } from 'jsii-reflect';
+import { Rosetta } from 'jsii-rosetta';
+import * as path from 'path';
+import { Package } from './golang/package';
+import { IGenerator } from '../generator';
+import { Target, TargetOptions } from '../target';
+
+export class Golang extends Target {
+  public readonly generator: IGenerator;
+
+  public constructor(options: TargetOptions) {
+    super(options);
+
+    this.generator = new GolangGenerator(options.rosetta);
+  }
+
+  /**
+   * Generates a publishable artifact in `outDir`.
+   *
+   * @param sourceDir the directory where the generated source is located.
+   * @param outDir    the directory where the publishable artifact should be placed.
+   */
+  public async build(sourceDir: string, outDir: string): Promise<void> {
+    return this.copyFiles(sourceDir, outDir);
+  }
+}
+
+class GolangGenerator implements IGenerator {
+  private assembly!: Assembly;
+  private readonly code = new CodeMaker();
+
+  public constructor(private readonly rosetta: Rosetta) {}
+
+  public async load(_: string, assembly: Assembly): Promise<void> {
+    this.assembly = assembly;
+    return Promise.resolve();
+  }
+
+  public async upToDate(_outDir: string) {
+    return Promise.resolve(false);
+  }
+
+  public generate(): void {
+    new Package(this.assembly).emit({ code: this.code, rosetta: this.rosetta });
+  }
+
+  public async save(outDir: string, tarball: string): Promise<any> {
+    const bundledRuntimeDotGo = path.join('_jsii', 'bundled-runtime.go');
+    this.code.openFile(bundledRuntimeDotGo);
+
+    this.code.line(
+      `// Embedded data for the tarball containing the runtime of ${this.assembly.name}@${this.assembly.version}`,
+    );
+    this.code.openBlock('const tarball = []byte');
+    for await (const line of encodedSlices(tarball)) {
+      this.code.line(`${line},`);
+    }
+    this.code.closeBlock();
+
+    this.code.closeFile(bundledRuntimeDotGo);
+
+    await this.code.save(outDir);
+  }
+}
+
+async function* encodedSlices(path: string, sliceSize = 16) {
+  const slice = Buffer.alloc(sliceSize);
+
+  const fd = await fs.open(path, fs.constants.O_RDONLY);
+
+  while (true) {
+    // eslint-disable-next-line no-await-in-loop
+    const { bytesRead } = await fs.read(fd, slice, 0, slice.length, null);
+    if (bytesRead === 0) {
+      return fs.close(fd);
+    }
+    yield inGroupsOf(slice.toString('hex', 0, bytesRead - 1), 2)
+      .map((byte) => `0x${byte}`)
+      .join(', ');
+  }
+
+  function inGroupsOf(str: string, count: number) {
+    if (str.length % count !== 0) {
+      throw new Error(
+        `Expected a string with a multiple of ${count} characters, but it has ${str.length}`,
+      );
+    }
+    const result = new Array<string>();
+    for (let i = 0; i < str.length; i += count) {
+      result.push(str.slice(i, i + count));
+    }
+    return result;
+  }
+}
diff --git a/packages/jsii-pacmak/lib/targets/golang/documentation.ts b/packages/jsii-pacmak/lib/targets/golang/documentation.ts
@@ -0,0 +1,15 @@
+import { Docs } from 'jsii-reflect';
+import { EmitContext } from './emit-context';
+
+export class Documentation {
+  public constructor(private readonly docs: Docs) {}
+
+  public emit({ code }: EmitContext): void {
+    // TODO: Translate code examples to Golang with Rosetta (not implemented there yet)
+    code.line(`// ${this.docs.summary}`);
+    code.line('//');
+    for (const line of this.docs.remarks.split('\n')) {
+      code.line(`// ${line}`);
+    }
+  }
+}
diff --git a/packages/jsii-pacmak/lib/targets/golang/emit-context.ts b/packages/jsii-pacmak/lib/targets/golang/emit-context.ts
@@ -0,0 +1,12 @@
+import { CodeMaker } from 'codemaker';
+import { Rosetta } from 'jsii-rosetta';
+
+/**
+ * The context in which Golang code is emitted.
+ */
+export interface EmitContext {
+  /** A CodeMaker to write out source code. */
+  readonly code: CodeMaker;
+  /** A Rosetta stone to translate code examples. */
+  readonly rosetta: Rosetta;
+}