nmew 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 waxodium
+
+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,35 @@
+# Usage
+    nmew [FILE]
+It's that simple. `nmew` concatenate files to standard output as **UTF-8**. The __[FILE]__ argument accepts both absolute and relative file paths, and supports file path formats for both Unix-like (example: `/home/Alice/File.txt`) and Windows operating (e.g., `C:\Users\Bobby\File.txt`) systems.
+
+# Installation
+    npm install -g nmew
+
+# About
+Why nmew should be recognized among Node.js beginners?
+
+Because it demonstrates core CLI and Node.js concepts by presenting them in a clear, block-by-block format that makes each part easy to read and understand. Featuring: 
+* Shebang for Node.js scripts
+* Node.js core modules `node:fs, node:os`
+* Basic terminal styling with Node.js
+* Arguement handling
+* String replacement with Regex
+* Modular error handling
+* Conditional CLI behavior
+* Async Function Usage
+* Command-Line Arguments `process.argv[2]`
+
+# Features
+Display the description and the lore of nmew.
+    
+    nmew --info
+
+Prints out an adorable little ASCII cat
+
+    nmew --cat
+
+# Credits
+As this is an experimental project, I would like to respectfully acknowledge that the modular part of the code, `const untildify`, is adapted from the [30secondsofcode.org](https://www.30secondsofcode.org/js/s/convert-to-absolute-path/) article and modified for use in the current binary.
+
+Link to credited NPM registry
+[30-seconds-of-code#untildify](https://www.npmjs.com/package/30-seconds-of-code#untildify)

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "nmew",
+  "version": "1.0.0",
+  "description": "nmew. Concatenate files to standard output built with NodeJS experimentally. Developed through personal exercise and studies",
+  "main": "s.js",
+  "bin": {
+    "nmew": "./src/nmew.js"
+  },
+  "author": "waxory",
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/src/nmew.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+const fs = require("node:fs")
+const os = require("node:os")
+const reset = "\x1b[0m"
+const red = "\x1b[31m"
+const bold = "\x1b[1m"
+
+
+const untildify = str => { 
+    if (typeof str !== 'string') {  
+        console.error(`[${red}${bold}nmew${reset}] Invalid Arguement! Try 'nmew --info'`)
+        process.exit(1)
+    } else if (typeof str === 'string') {
+        return str.replace(/^~($|\/|\\)/, `${os.homedir()}$1`) 
+    };
+};
+
+const info = `Usage 'nmew [FILE]'
+
+Concatenate files to standard output as UTF-8. 
+[FILE] argument accepts both absolute and relative 
+file paths, and supports file path formats for 
+both Unix-like (example: home/Alice/File.txt) 
+and Windows operating (e.g., C:\\Users\\Bobby\\File.txt) systems.
+
+# OPTIONS
+    ,--info         Display this info looking thing
+    ,--cat          Prints out an adorable little ASCII cat (^o~o^)
+
+
+Why the heck is it named nmew?
+> nmew ~ (n) Node.js (mew) A shorthand word of Meow.
+Inspired by command: cat
+cat goes Meow. So that gives off a similar relation
+between nmew and cat :)
+`
+const cuteCat = [
+    '',
+    ' /\\_/\\',
+    '( o.o )',
+    ' > ^ <',
+    '/     \\',
+    '(#   #)',
+    ' 2___2',
+    '',
+    ' Meowy!',
+    '',
+    ' His name is Owen',
+    ''
+].map(function (l) {
+  return l;
+});
+
+async function paw(path) {
+    const data = path;
+    const parsed = untildify(data)
+
+    try {
+        if (parsed === "--info") {
+            console.log(info)
+        } else if (parsed === "--cat") {
+            console.log(cuteCat.join('\n'));
+        } else {
+            const fileData = fs.readFileSync(parsed, 'utf8');
+            console.log(fileData);
+        }
+
+    } catch (err) {
+        if (err.code === "ENOENT") { console.error(`[${red}${bold}nmew${reset}] Path not found!`)}
+    }
+
+} 
+
+const ManHowDoINameThis = process.argv[2]
+paw(ManHowDoINameThis)