env-creator 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kyrylo Voronoi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,161 @@
+# env-creator
+
+A fast, lightweight CLI tool for managing and generating environment (`.env`) files.
+
+## Installation
+
+You can install `env-creator` globally using npm:
+
+```bash
+npm install -g env-creator
+```
+
+Alternatively, you can run it directly using `npx` without installing globally:
+
+```bash
+npx create-env <command> [options]
+# or
+npx env-creator <command> [options]
+```
+
+`env-creator` (also available as `create-env`) provides several commands to help you quickly set up or split your environment files.
+
+### 1. Create an empty or pre-filled `.env` file
+
+Generates a `.env` file in the current working directory. You can optionally pass `KEY=VALUE` pairs to pre-fill it. If a file already exists, it will not overwrite it.
+
+```bash
+npx create-env create
+```
+
+**With initial fields:**
+```bash
+npx create-env create PORT=3000 NODE_ENV=development
+```
+
+**Resulting `.env`:**
+```env
+PORT=3000
+NODE_ENV=development
+```
+
+### 2. Create from JSON
+
+Generates a `.env` target file from a provided JSON file. The keys and values in the JSON file will be converted into `KEY=VALUE` format.
+You can optionally provide an `--env <name>` flag to create a specific `.env.<name>` file (e.g., `.env.production`).
+
+```bash
+npx create-env create-from-json <path-to-file.json> [--env <name>]
+```
+
+**Example `config.json`:**
+```json
+{
+  "PORT": 3000,
+  "DB_HOST": "localhost",
+  "NODE_ENV": "development"
+}
+```
+
+**Command:**
+```bash
+npx create-env create-from-json config.json --env production
+```
+
+**Resulting `.env.production`:**
+```env
+PORT=3000
+DB_HOST=localhost
+NODE_ENV=development
+```
+
+### 3. Split `.env` for specific environments
+
+Reads your existing `.env` file, removes all comments and values, and creates a new target file containing **only the keys** (e.g., for creating a `.env.example` or `.env.production` template).
+
+```bash
+npx create-env split --env <env-name>
+```
+
+**Example:**
+If you have a `.env` file like this:
+```env
+# Database Config
+DB_USER=admin
+DB_PASS=secret
+```
+
+Running the split command for production:
+```bash
+npx create-env split --env production
+```
+
+Will generate a new file named `.env.production` with empty values:
+```env
+DB_USER=
+DB_PASS=
+```
+
+### 4. Delete an `.env` file
+
+Deletes a specific environment file. If no filename is provided, it defaults to deleting `.env`.
+
+```bash
+npx create-env delete [file]
+```
+
+**Examples:**
+```bash
+npx create-env delete            	# Deletes .env
+npx create-env delete .env.production  # Deletes .env.production
+```
+
+### 5. Sort `.env` keys alphabetically
+
+Reads an environment file and reorders all `KEY=VALUE` lines alphabetically. Comments and empty lines are preserved at the top of the file. Defaults to `.env` if no file is specified.
+
+```bash
+npx create-env sort [file]
+```
+
+**Examples:**
+```bash
+npx create-env sort               	# Sorts .env
+npx create-env sort .env.production	# Sorts .env.production
+```
+
+**Before:**
+```env
+# App config
+PORT=3000
+APP_NAME=my-app
+DB_HOST=localhost
+```
+
+**After:**
+```env
+# App config
+APP_NAME=my-app
+DB_HOST=localhost
+PORT=3000
+```
+
+## Development
+
+If you want to contribute or modify the tool, you can clone the repository and use the built-in npm scripts:
+
+### Linting
+To check the code for syntax and style errors using ESLint:
+```bash
+npm run lint
+```
+
+### Building
+The project uses `esbuild` to bundle and minify the code into a single executable file in the `dist/` directory:
+```bash
+npm run build
+```
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package/dist/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import("./index.js");

package/dist/index.js

@@ -0,0 +1,8 @@
+import n from"fs";import f from"path";var t=process.argv.slice(2);t.length===0&&(p(),process.exit(0));function p(){console.log("Usage: env-creator <command> [options]"),console.log("Commands:"),console.log("  create [KEY=value...]   Create a .env file (optionally with values)"),console.log("  create-from-json <json> [--env <name>] Create .env or .env.<name> from JSON"),console.log("  split --env <dev|prod>  Create environment-specific file from .env"),console.log("  delete [file]           Delete an environment file (default: .env)"),console.log("  sort [file]             Sort keys alphabetically in an env file (default: .env)"),console.log("Options:"),console.log("  -h, --help              Show this help message")}var d=t[0];(d==="--help"||d==="-h"||d==="help")&&(p(),process.exit(0));switch(d){case"create":{let e=f.join(process.cwd(),".env");if(n.existsSync(e))console.log(".env already exists");else{let o=t.slice(1),s="";if(o.length>0){let i=o.filter(c=>c.includes("="));s=i.join(`
+`)+(i.length>0?`
+`:"")}n.writeFileSync(e,s),console.log(s?"Created .env with specified fields":"Created empty .env")}break}case"create-from-json":{let e=t[1];e||(console.error("Please provide a JSON file"),process.exit(1)),n.existsSync(e)||(console.error("JSON file not found"),process.exit(1));let o=t.indexOf("--env"),i=`.env${o!==-1&&t[o+1]?`.${t[o+1]}`:""}`;if(n.existsSync(i)){console.log(`${i} already exists`);break}let c=JSON.parse(n.readFileSync(e,"utf-8")),a="";for(let r in c)a+=`${r}=${c[r]}
+`;n.writeFileSync(i,a),console.log(`Created ${i} from JSON`);break}case"split":{let e=t.indexOf("--env");(e===-1||!t[e+1])&&(console.error("Please specify environment with --env <dev|prod>"),process.exit(1));let o=t[e+1],s=f.join(process.cwd(),".env");n.existsSync(s)||(console.error(".env file not found"),process.exit(1));let c=n.readFileSync(s,"utf-8").split(/\r?\n/).filter(r=>r.trim()!==""&&!r.startsWith("#")).map(r=>r.split("=")[0]+"=").join(`
+`),a=f.join(process.cwd(),`.env.${o}`);if(n.existsSync(a)){console.log(`.env.${o} already exists`);break}n.writeFileSync(a,c),console.log(`Created .env.${o} with keys only`);break}case"delete":{let e=t[1]||".env",o=f.join(process.cwd(),e);n.existsSync(o)?(n.unlinkSync(o),console.log(`Deleted ${e}`)):console.log(`File ${e} does not exist`);break}case"sort":{let e=t[1]||".env",o=f.join(process.cwd(),e);n.existsSync(o)||(console.error(`File ${e} does not exist`),process.exit(1));let s=n.readFileSync(o,"utf-8").split(/\r?\n/),i=s[s.length-1]===""?s.slice(0,-1):s,c=i.filter(l=>!l.startsWith("#")&&l.trim()!==""&&l.includes("=")).sort((l,v)=>l.localeCompare(v)),a=0,r=i.map(l=>!l.startsWith("#")&&l.trim()!==""&&l.includes("=")?c[a++]:l);n.writeFileSync(o,r.join(`
+`)+`
+`),console.log(`Sorted keys in ${e}`);break}default:console.error(`Unknown command: "${d}"
+`),p(),process.exit(1)}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "env-creator",
+  "version": "1.0.0",
+  "description": "Environment variable generator CLI",
+  "type": "module",
+  "bin": {
+    "env-creator": "./dist/cli.js",
+    "create-env": "./dist/cli.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "lint": "eslint .",
+    "build": "esbuild src/index.js --bundle --platform=node --format=esm --target=node20 --minify --outfile=dist/index.js && printf '#!/usr/bin/env node\nimport(\"./index.js\");\n' > dist/cli.js && chmod +x dist/cli.js",
+    "prepublishOnly": "npm run lint && npm run build",
+    "release": "npm version patch && npm publish"
+  },
+  "keywords": [
+    "env",
+    "dotenv",
+    "cli",
+    "environment",
+    "generator"
+  ],
+  "author": "Kyrylo Voronoi",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kyrylovoronoi/env-creator.git"
+  },
+  "homepage": "https://github.com/kyrylovoronoi/env-creator",
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "esbuild": "^0.27.3",
+    "eslint": "^10.0.3",
+    "globals": "^17.4.0"
+  }
+}