Repo cleanup and devcontainer cleanup (#58)

* Doing some repo cleanup and devcontainer cleanup.

* Updating README and adding some tweaks to justfile.

.devcontainer/Dockerfile

@@ -8,5 +8,10 @@ RUN curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo
 RUN echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_20.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list
 RUN apt-get update && apt-get install nodejs -y
 
+RUN rustup target install wasm32-unknown-unknown
+
 USER vscode
-RUN cargo install wasm-pack
+RUN cargo install wasm-bindgen-cli
+RUN cargo install wasm-opt
+RUN cargo install wasm-pack
+RUN cargo install just

.devcontainer/devcontainer.json

@@ -1,8 +1,5 @@
 {
- "name": "Rust",
+ "name": "postman2openapi",
  "dockerFile": "Dockerfile",
- "postCreateCommand": "rustc --version",
- "runArgs": [
- "--network=host"
- ]
+ "postCreateCommand": "rustc --version && echo \"node $(node --version)\" && just --version",
 }

.gitignore

@@ -1,4 +1,5 @@
-/pkg
+/nodejs
 /target
-/web/node_modules
 /web/dist
+/web/node_modules
+/web/wasm

README.md

@@ -14,6 +14,7 @@ Convert Postman collections to OpenAPI definitions.
  - [Installation](#installation-1)
  - [Usage](#usage-1)
  - [JavaScript API](#javascript-api)
+- [Build](#build)
 - [License](#license)
 
 ## CLI
@@ -95,6 +96,24 @@ console.log(JSON.stringify(openapi, null, 2));
 - collection - An object representing the Postman collection.
 - _returns_ - an OpenAPI definition as a JavaScript object.
 
+## Build
+
+Note: A [Dev Container](https://containers.dev/) is included for convenience.
+
+To take advantage of build recipes, install [just](https://github.com/casey/just#packages).
+
+### `just build`
+
+Builds all projects.
+
+### `just test`
+
+Runs all lint checks (`cargo fmt --check`, `cargo clippy`) and runs all tests, including tests for `wasm32-unknown-unknown` targets (Node.js, Chrome, Firefox).
+
+### `just start-web`
+
+Builds the WebAssembly project and starts a local version of the [postman2openapi site](https://kevinswiber.github.io/postman2openapi/).
+
 ## License
 
 Apache License 2.0 (Apache-2.0)

justfile

@@ -15,11 +15,15 @@ build-web:
  wasm-pack build --release --out-dir ./web/wasm --target bundler
  npm install --prefix ./web
  npm run build --prefix ./web
+build-nodejs:
+ wasm-pack build --release --out-dir ./nodejs --target nodejs
 
+fmt-check:
+ cargo fmt --check --all
 clippy:
  cargo clippy -- -D warnings
 
-test: build test-lib test-unit test-integration test-wasm-node test-wasm-chrome test-wasm-firefox
+test: build fmt-check clippy test-lib test-unit test-integration test-wasm-node test-wasm-chrome test-wasm-firefox
 
 test-lib:
  cargo test --lib

web/package.json

@@ -4,8 +4,8 @@
  "main": "index.js",
  "private": true,
  "scripts": {
- "build": "rimraf dist ../pkg && NODE_OPTIONS=--openssl-legacy-provider webpack --config webpack.config.js --mode production",
- "start": "rimraf dist ../pkg && NODE_OPTIONS=--openssl-legacy-provider webpack-dev-server --mode development",
+ "build": "rimraf dist wasm && NODE_OPTIONS=--openssl-legacy-provider webpack --config webpack.config.js --mode production",
+ "start": "rimraf dist wasm && NODE_OPTIONS=--openssl-legacy-provider webpack-dev-server --mode development",
  "test": "cargo test && wasm-pack test --headless"
  },
  "dependencies": {

web/webpack.config.js

@@ -21,7 +21,7 @@ module.exports = {
  new CopyWebpackPlugin([path.resolve(__dirname, 'static')]),
  new WasmPackPlugin({
  crateDirectory: path.resolve(__dirname, '..'),
- outDir: path.resolve(__dirname, '..', 'pkg'),
+ outDir: path.resolve(__dirname, 'wasm'),
  }),
  ],
  module: {