@oclif/plugin-test-esm-2 0.1.0

package/README.md

@@ -0,0 +1,306 @@
+oclif-hello-world
+=================
+
+oclif example Hello World CLI
+
+[![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
+[![CircleCI](https://circleci.com/gh/oclif/hello-world/tree/main.svg?style=shield)](https://circleci.com/gh/oclif/hello-world/tree/main)
+[![GitHub license](https://img.shields.io/github/license/oclif/hello-world)](https://github.com/oclif/hello-world/blob/main/LICENSE)
+
+<!-- toc -->
+* [Usage](#usage)
+* [Commands](#commands)
+<!-- tocstop -->
+# Usage
+<!-- usage -->
+```sh-session
+$ npm install -g @oclif/plugin-test-esm-2
+$ esm2 COMMAND
+running command...
+$ esm2 (--version)
+@oclif/plugin-test-esm-2/0.1.0 linux-x64 node-v18.17.0
+$ esm2 --help [COMMAND]
+USAGE
+  $ esm2 COMMAND
+...
+```
+<!-- usagestop -->
+# Commands
+<!-- commands -->
+* [`esm2 esm2`](#esm2-esm2)
+* [`esm2 help [COMMANDS]`](#esm2-help-commands)
+* [`esm2 plugins`](#esm2-plugins)
+* [`esm2 plugins:install PLUGIN...`](#esm2-pluginsinstall-plugin)
+* [`esm2 plugins:inspect PLUGIN...`](#esm2-pluginsinspect-plugin)
+* [`esm2 plugins:install PLUGIN...`](#esm2-pluginsinstall-plugin-1)
+* [`esm2 plugins:link PLUGIN`](#esm2-pluginslink-plugin)
+* [`esm2 plugins:uninstall PLUGIN...`](#esm2-pluginsuninstall-plugin)
+* [`esm2 plugins:uninstall PLUGIN...`](#esm2-pluginsuninstall-plugin-1)
+* [`esm2 plugins:uninstall PLUGIN...`](#esm2-pluginsuninstall-plugin-2)
+* [`esm2 plugins update`](#esm2-plugins-update)
+
+## `esm2 esm2`
+
+```
+USAGE
+  $ esm2 esm2
+```
+
+_See code: [dist/commands/esm2.ts](https://github.com/oclif/plugin-test-esm-2/blob/v0.1.0/dist/commands/esm2.ts)_
+
+## `esm2 help [COMMANDS]`
+
+Display help for esm2.
+
+```
+USAGE
+  $ esm2 help [COMMANDS] [-n]
+
+ARGUMENTS
+  COMMANDS  Command to show help for.
+
+FLAGS
+  -n, --nested-commands  Include all nested commands in the output.
+
+DESCRIPTION
+  Display help for esm2.
+```
+
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v5.2.14/src/commands/help.ts)_
+
+## `esm2 plugins`
+
+List installed plugins.
+
+```
+USAGE
+  $ esm2 plugins [--json] [--core]
+
+FLAGS
+  --core  Show core plugins.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  List installed plugins.
+
+EXAMPLES
+  $ esm2 plugins
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.1.8/src/commands/plugins/index.ts)_
+
+## `esm2 plugins:install PLUGIN...`
+
+Installs a plugin into the CLI.
+
+```
+USAGE
+  $ esm2 plugins:install PLUGIN...
+
+ARGUMENTS
+  PLUGIN  Plugin to install.
+
+FLAGS
+  -f, --force    Run yarn install with force flag.
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Installs a plugin into the CLI.
+  Can be installed from npm or a git url.
+
+  Installation of a user-installed plugin will override a core plugin.
+
+  e.g. If you have a core plugin that has a 'hello' command, installing a user-installed plugin with a 'hello' command
+  will override the core plugin implementation. This is useful if a user needs to update core plugin functionality in
+  the CLI without the need to patch and update the whole CLI.
+
+
+ALIASES
+  $ esm2 plugins add
+
+EXAMPLES
+  $ esm2 plugins:install myplugin 
+
+  $ esm2 plugins:install https://github.com/someuser/someplugin
+
+  $ esm2 plugins:install someuser/someplugin
+```
+
+## `esm2 plugins:inspect PLUGIN...`
+
+Displays installation properties of a plugin.
+
+```
+USAGE
+  $ esm2 plugins:inspect PLUGIN...
+
+ARGUMENTS
+  PLUGIN  [default: .] Plugin to inspect.
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Displays installation properties of a plugin.
+
+EXAMPLES
+  $ esm2 plugins:inspect myplugin
+```
+
+## `esm2 plugins:install PLUGIN...`
+
+Installs a plugin into the CLI.
+
+```
+USAGE
+  $ esm2 plugins:install PLUGIN...
+
+ARGUMENTS
+  PLUGIN  Plugin to install.
+
+FLAGS
+  -f, --force    Run yarn install with force flag.
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Installs a plugin into the CLI.
+  Can be installed from npm or a git url.
+
+  Installation of a user-installed plugin will override a core plugin.
+
+  e.g. If you have a core plugin that has a 'hello' command, installing a user-installed plugin with a 'hello' command
+  will override the core plugin implementation. This is useful if a user needs to update core plugin functionality in
+  the CLI without the need to patch and update the whole CLI.
+
+
+ALIASES
+  $ esm2 plugins add
+
+EXAMPLES
+  $ esm2 plugins:install myplugin 
+
+  $ esm2 plugins:install https://github.com/someuser/someplugin
+
+  $ esm2 plugins:install someuser/someplugin
+```
+
+## `esm2 plugins:link PLUGIN`
+
+Links a plugin into the CLI for development.
+
+```
+USAGE
+  $ esm2 plugins:link PLUGIN
+
+ARGUMENTS
+  PATH  [default: .] path to plugin
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Links a plugin into the CLI for development.
+  Installation of a linked plugin will override a user-installed or core plugin.
+
+  e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
+  command will override the user-installed or core plugin implementation. This is useful for development work.
+
+
+EXAMPLES
+  $ esm2 plugins:link myplugin
+```
+
+## `esm2 plugins:uninstall PLUGIN...`
+
+Removes a plugin from the CLI.
+
+```
+USAGE
+  $ esm2 plugins:uninstall PLUGIN...
+
+ARGUMENTS
+  PLUGIN  plugin to uninstall
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Removes a plugin from the CLI.
+
+ALIASES
+  $ esm2 plugins unlink
+  $ esm2 plugins remove
+```
+
+## `esm2 plugins:uninstall PLUGIN...`
+
+Removes a plugin from the CLI.
+
+```
+USAGE
+  $ esm2 plugins:uninstall PLUGIN...
+
+ARGUMENTS
+  PLUGIN  plugin to uninstall
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Removes a plugin from the CLI.
+
+ALIASES
+  $ esm2 plugins unlink
+  $ esm2 plugins remove
+```
+
+## `esm2 plugins:uninstall PLUGIN...`
+
+Removes a plugin from the CLI.
+
+```
+USAGE
+  $ esm2 plugins:uninstall PLUGIN...
+
+ARGUMENTS
+  PLUGIN  plugin to uninstall
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Removes a plugin from the CLI.
+
+ALIASES
+  $ esm2 plugins unlink
+  $ esm2 plugins remove
+```
+
+## `esm2 plugins update`
+
+Update installed plugins.
+
+```
+USAGE
+  $ esm2 plugins update [-h] [-v]
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Update installed plugins.
+```
+<!-- commandsstop -->

package/bin/dev.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\dev" %*

package/bin/dev.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env ts-node
+// eslint-disable-next-line node/shebang
+(async () => {
+  const oclif = await import('@oclif/core')
+  await oclif.execute({type: 'esm', development: true, dir: import.meta.url})
+})()

package/bin/run.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\run" %*

package/bin/run.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+// eslint-disable-next-line node/shebang
+(async () => {
+  const oclif = await import('@oclif/core')
+  await oclif.execute({type: 'esm', dir: import.meta.url})
+})()

package/dist/commands/esm2.d.ts

@@ -0,0 +1,4 @@
+import { Command } from '@oclif/core';
+export default class ESM2 extends Command {
+    run(): Promise<void>;
+}

package/dist/commands/esm2.js

@@ -0,0 +1,6 @@
+import { Command } from '@oclif/core';
+export default class ESM2 extends Command {
+    async run() {
+        this.log(`hello I am an ESM plugin from ${this.config.root}!`);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { run } from '@oclif/core';

package/dist/index.js

@@ -0,0 +1 @@
+export { run } from '@oclif/core';

package/oclif.manifest.json

@@ -0,0 +1,15 @@
+{
+  "version": "0.1.0",
+  "commands": {
+    "esm2": {
+      "id": "esm2",
+      "strict": true,
+      "pluginName": "@oclif/plugin-test-esm-2",
+      "pluginAlias": "@oclif/plugin-test-esm-2",
+      "pluginType": "core",
+      "aliases": [],
+      "flags": {},
+      "args": {}
+    }
+  }
+}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@oclif/plugin-test-esm-2",
+  "version": "0.1.0",
+  "description": "Test ESM plugin",
+  "author": "Salesforce",
+  "bin": {
+    "esm2": "./bin/run"
+  },
+  "homepage": "https://github.com/oclif/plugin-test-esm-2",
+  "license": "MIT",
+  "main": "",
+  "repository": "oclif/plugin-test-esm-2",
+  "files": [
+    "/bin",
+    "/dist",
+    "/npm-shrinkwrap.json",
+    "/oclif.manifest.json"
+  ],
+  "dependencies": {
+    "@oclif/core": "^2",
+    "@oclif/plugin-help": "^5",
+    "@oclif/plugin-plugins": "^3.1.8"
+  },
+  "devDependencies": {
+    "@oclif/test": "^2.4.0",
+    "@types/chai": "^4",
+    "@types/mocha": "^9.0.0",
+    "@types/node": "^16.18.39",
+    "chai": "^4",
+    "eslint": "^7.32.0",
+    "eslint-config-oclif": "^4",
+    "eslint-config-oclif-typescript": "^1.0.3",
+    "mocha": "^9",
+    "oclif": "^3.10.0",
+    "shx": "^0.3.4",
+    "ts-node": "^10.9.1",
+    "tslib": "^2.6.1",
+    "typescript": "^4.9.5"
+  },
+  "oclif": {
+    "bin": "esm2",
+    "dirname": "esm2",
+    "commands": "./dist/commands",
+    "plugins": [
+      "@oclif/plugin-help",
+      "@oclif/plugin-plugins"
+    ],
+    "topicSeparator": " ",
+    "topics": {
+      "hello": {
+        "description": "Say hello to the world and others"
+      }
+    }
+  },
+  "scripts": {
+    "build": "shx rm -rf dist && tsc -b",
+    "lint": "eslint . --ext .ts --config .eslintrc",
+    "postpack": "shx rm -f oclif.manifest.json",
+    "posttest": "yarn lint",
+    "prepack": "yarn build && oclif manifest && oclif readme",
+    "test": "mocha --forbid-only \"test/**/*.test.ts\"",
+    "version": "oclif readme && git add README.md"
+  },
+  "engines": {
+    "node": ">=12.0.0"
+  },
+  "bugs": "https://github.com/oclif/plugin-test-esm-2/issues",
+  "keywords": [
+    "oclif"
+  ],
+  "types": "dist/index.d.ts",
+  "exports": "./lib/index.js",
+  "type": "module"
+}