create-neon

.gitignore

@@ -7,6 +7,7 @@ Cargo.lock
 **/index.node
 **/artifacts.json
 cli/lib
+create-neon/dist
 test/cli/lib
 npm-debug.log
 rls*.log

create-neon/data/templates/.gitignore.hbs

@@ -0,0 +1,4 @@
+target
+index.node
+**/node_modules
+**/.DS_Store

create-neon/data/templates/Cargo.toml.hbs

@@ -0,0 +1,19 @@
+[package]
+name = "{{project.name}}"
+version = "{{project.version}}"
+{{#if project.author}}
+authors = ["{{project.author}}"]
+{{/if}}
+{{#if project.license}}
+license = "{{project.license}}"
+{{/if}}
+edition = "2018"
+exclude = ["index.node"]
+
+[lib]
+crate-type = ["cdylib"]
+
+[dependencies.neon]
+version = "{{versions.neon}}"
+default-features = false
+features = ["napi-{{versions.napi}}"]

create-neon/data/templates/README.md.hbs

@@ -0,0 +1,3 @@
+# {{project.name}}
+
+{{project.description}}

create-neon/data/templates/lib.rs.hbs

@@ -0,0 +1,11 @@
+use neon::prelude::*;
+
+fn hello(mut cx: FunctionContext) -> JsResult<JsString> {
+    Ok(cx.string("hello node"))
+}
+
+#[neon::main]
+fn main(mut cx: ModuleContext) -> NeonResult<()> {
+    cx.export_function("hello", hello)?;
+    Ok(())
+}

create-neon/data/versions.json

@@ -0,0 +1,4 @@
+{
+    "neon": "0.7.1",
+    "napi": "6"
+}

create-neon/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "create-neon",
+  "version": "0.1.0",
+  "description": "Create Neon projects with no build configuration.",
+  "author": "Dave Herman <david.herman@gmail.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/neon-bindings/neon/issues"
+  },
+  "homepage": "https://github.com/neon-bindings/neon#readme",
+  "bin": {
+    "create-neon": "dist/src/bin/create-neon.js"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "scripts": {
+    "build": "tsc && cp -r data/templates dist/data",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "manual-test": "npm run build && rm -rf throwaway-test && mkdir throwaway-test && cd throwaway-test && node ../dist/src/bin/create-neon.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/neon-bindings/neon.git"
+  },
+  "keywords": [
+    "neon"
+  ],
+  "devDependencies": {
+    "@types/node": "^14.14.31",
+    "typescript": "^4.2.2"
+  },
+  "dependencies": {
+    "handlebars": "^4.7.7"
+  }
+}

create-neon/src/bin/create-neon.ts

@@ -0,0 +1,52 @@
+import { readFile, mkdir, writeFile } from 'fs/promises';
+import npmInit from '../npm-init';
+import versions from '../../data/versions.json';
+import template from '../template';
+import * as path from 'path';
+
+function escapeQuotes(str: string): string {
+  return str.replace(/"/g, '\\"');
+}
+
+async function main() {
+  await npmInit();
+
+  let name: string;
+  let version: string;
+  let author: string;
+  let license: string;
+  let description: string;
+
+  try {
+    let json = JSON.parse(await readFile('package.json', 'utf8'));
+    name = json.name || "";
+    version = json.version || "";
+    author = escapeQuotes(json.author || "");
+    license = json.license || "";
+    description = escapeQuotes(json.description || "");
+  } catch (err) {
+    console.error("Could not read `package.json`: " + err.message);
+    process.exit(1);
+  }
+
+  let ctx = {
+    project: { name, version, author, license, description },
+    versions
+  };
+
+  let gitignore = (await template('.gitignore.hbs'))(ctx);
+  let manifest = (await template('Cargo.toml.hbs'))(ctx);
+  let readme = (await template('README.md.hbs'))(ctx);
+  let librs = (await template('lib.rs.hbs'))(ctx);
+
+  await mkdir('src');
+
+  await writeFile('.gitignore', gitignore, { flag: 'wx' });
+  await writeFile('Cargo.toml', manifest, { flag: 'wx' });
+  await writeFile('README.md', readme, { flag: 'wx' });
+  await writeFile(path.join('src', 'lib.rs'), librs, { flag: 'wx' });
+
+  console.log(`✨ Created Neon project \`${ctx.project.name}\`. Happy 🦀 hacking! ✨`);
+}
+
+main();

create-neon/src/npm-init.ts

@@ -0,0 +1,23 @@
+import shell from './shell';
+
+const NPM: string = process.env.npm_execpath || die('create-neon must be run from `npm init`');
+const NODE: string = process.env.npm_node_execpath || die('create-neon must be run from `npm init`');
+
+function die(msg: string): never {
+  console.error(msg);
+  process.exit(1);
+}
+
+export default async function npmInit(): Promise<number> {
+  let code = await shell(NODE, [NPM, 'init']);
+
+  if (code == null) {
+    process.exit(1);
+  }
+
+  if (code !== 0) {
+    process.exit(code);
+  }
+
+  return 0;
+}

create-neon/src/shell.ts

@@ -0,0 +1,27 @@
+import { spawn } from 'child_process';
+
+/**
+ * Transparently shell out to an executable with a list of arguments.
+ * All stdio is inherited directly from the current process.
+ */
+export default function shell(cmd: string, args: string[]): Promise<number | null> {
+  let child = spawn(cmd, args, { stdio: 'inherit' });
+
+  let resolve: (result: number | null) => void;
+  let reject: (error: Error) => void;
+
+  let result: Promise<number | null> = new Promise((res, rej) => {
+    resolve = res;
+    reject = rej;
+  });
+
+  child.on('exit', (code) => {
+    resolve(code);
+  });
+
+  child.on('error', (error) => {
+    reject(error);
+  });
+
+  return result;
+}

create-neon/src/template.ts

@@ -0,0 +1,12 @@
+import { readFile } from 'fs/promises';
+import handlebars from 'handlebars';
+import * as path from 'path';
+
+const TEMPLATES_DIR = path.join(__dirname, '..', 'data', 'templates');
+
+export default async function template(filename: string) {
+  let source = await readFile(path.join(TEMPLATES_DIR, filename), {
+    encoding: 'utf8'
+  });
+  return handlebars.compile(source, { noEscape: true });
+}

create-neon/tsconfig.json

@@ -0,0 +1,28 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "target": "es6",
+        "lib": [
+            "es6",
+            "es7"
+        ],
+        "allowJs": false,
+
+        "sourceMap": false,
+        "outDir": "dist",
+
+        "esModuleInterop": true,
+        "strict": true,
+        "noImplicitReturns": true,
+        "allowUnreachableCode": false,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "resolveJsonModule": true
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": [
+        "node_modules"
+    ]
+}