devkits-chmod 1.0.0

package/README.md

@@ -0,0 +1,151 @@
+# devkits-chmod
+
+> Calculate Unix file permissions (chmod) values
+
+## Installation
+
+```bash
+npm install -g devkits-chmod
+```
+
+Or use without installation:
+
+```bash
+npx devkits-chmod [args]
+```
+
+## Usage
+
+```bash
+# Show what an octal value means
+dk-chmod 755
+dk-chmod 644
+dk-chmod 600
+
+# Calculate from symbolic permissions
+dk-chmod --owner rwx --group r-x --other r-x   # 755
+dk-chmod --owner rw --group r --other r        # 644
+
+# Using symbolic notation
+dk-chmod -s u+rwx,g+rx,o+rx                     # 755
+```
+
+## Output Example
+
+```
+Chmod Calculator Results
+========================
+
+Octal: 755
+
+Permissions:
+  Owner: rwx (7)
+  Group: r-x (5)
+  Other: r-x (5)
+
+Binary: 111 101 101
+
+Command: chmod 755 <file>
+
+Common patterns:
+  777 - rwxrwxrwx (everyone has full access) ⚠️
+  755 - rwxr-xr-x (common for directories)
+  644 - rw-r--r-- (common for files)
+  600 - rw------- (private file)
+  400 - r-------- (read-only, owner only)
+```
+
+## Permission Values
+
+| Value | Binary | Symbolic | Meaning |
+|-------|--------|----------|---------|
+| 7 | 111 | rwx | Read + Write + Execute |
+| 6 | 110 | rw- | Read + Write |
+| 5 | 101 | r-x | Read + Execute |
+| 4 | 100 | r-- | Read only |
+| 3 | 011 | -wx | Write + Execute |
+| 2 | 010 | -w- | Write only |
+| 1 | 001 | --x | Execute only |
+| 0 | 000 | --- | No permissions |
+
+## Why @devkits/chmod?
+
+- ✅ Fast - Instant calculation
+- ✅ Zero dependencies - Pure Node.js
+- ✅ Offline - Works without internet
+- ✅ Free - Open source (MIT)
+- ✅ CLI - Use in your terminal
+- ✅ Shows binary and symbolic representations
+
+## Web Version
+
+Prefer a GUI? Check out the web version: **https://devkits-tools.surge.sh/tools/chmod-calculator**
+
+- 84 developer tools in one PWA
+- Works offline
+- No signup required
+
+## Pro Features
+
+Upgrade to Pro for advanced features:
+
+- 📦 Batch Processing
+- 🔗 API Access (1000 req/day free)
+- ☁️ Cloud Sync
+- 🎨 Custom Themes
+- 📊 Advanced Analytics
+- 💬 Priority Support
+
+**Price:** $9 one-time payment
+**Upgrade:** https://devkits-tools.surge.sh/pro
+**Discount:** Use code `EARLYBIRD-2026` for 20% off
+
+## See Also
+
+Part of the **[DevKits Tools](https://devkits-tools.surge.sh)** collection — 80+ free developer tools:
+
+### Popular Tools
+
+| Tool | npm Package | Description |
+|------|-------------|-------------|
+| **[Base64](https://devkits-tools.surge.sh/tools/base64)** | `@devkits/base64` | Encode/decode Base64 |
+| **[JSON Formatter](https://devkits-tools.surge.sh/tools/json-formatter)** | `@devkits/json-formatter` | Format and validate JSON |
+| **[Color Converter](https://devkits-tools.surge.sh/tools/color-converter)** | `@devkits/color-converter` | HEX/RGB/HSL conversion |
+| **[UUID Generator](https://devkits-tools.surge.sh/tools/uuid-generator)** | `@devkits/uuid-generator` | Generate unique UUIDs |
+| **[Hash Generator](https://devkits-tools.surge.sh/tools/hash-generator)** | `@devkits/hash-generator` | MD5, SHA1, SHA256, SHA512 |
+| **[Regex Tester](https://devkits-tools.surge.sh/tools/regex-tester)** | `@devkits/regex-tester` | Test regex patterns |
+
+### Other DevKits Tools
+
+- **[HTML Tools](https://devkits-tools.surge.sh/tools/html-entities)** — HTML entity encode/decode
+- **[CSS Tools](https://devkits-tools.surge.sh/tools/css-minifier)** — CSS minify/format
+- **[Cron Parser](https://devkits-tools.surge.sh/tools/cron-parser)** — Parse cron expressions
+- **[Case Convert](https://devkits-tools.surge.sh/tools/text-case)** — camelCase, snake_case, etc.
+- **[Slugify](https://devkits-tools.surge.sh/tools/slug-generator)** — Create URL-friendly slugs
+- **[Lorem Ipsum](https://devkits-tools.surge.sh/tools/lorem-ipsum)** — Generate placeholder text
+- **[Password Generator](https://devkits-tools.surge.sh/tools/password-generator)** — Secure passwords
+- **[Text Counter](https://devkits-tools.surge.sh/tools/text-counter)** — Word/char counter
+
+---
+
+### More from DevKits
+
+- **[Invoicely](https://invoicely-app.surge.sh)** — Free invoice generator for freelancers
+- **[SnapOG](https://snapog.surge.sh)** — Free OG image generator with 20+ templates
+- **[API Monitor](https://api-monitor-saas.surge.sh)** — Real-time API monitoring
+
+---
+
+👉 **Explore all 80+ developer tools at [DevKits Tools](https://devkits-tools.surge.sh)**
+
+## License
+
+MIT © [DevKits Team](https://devkits-tools.surge.sh)
+
+---
+
+## 🚀 API Monitoring for Developers
+
+Build better APIs with **API Monitor SaaS** — real-time monitoring, alerting, and analytics.
+
+👉 **Early Access: $1 pre-order (50% off for life)** → https://api-monitor-saas.surge.sh?utm_source=npm&utm_medium=readme&utm_campaign=phase0

package/index.js

@@ -0,0 +1,180 @@
+#!/usr/bin/env node
+
+/**
+ * @devkits/chmod - Calculate Unix file permissions
+ *
+ * Usage:
+ *   dk-chmod 755                    # Show what 755 means
+ *   dk-chmod -r wx -w r             # Calculate from symbols
+ *   dk-chmod --symbolic u+rwx,g+rx  # Symbolic notation
+ *
+ * Web version: https://devkits-tools.surge.sh/tools/chmod-calculator
+ * Pro features: https://devkits-tools.surge.sh/pro
+ */
+
+const PERMISSIONS = {
+  7: { binary: '111', symbolic: 'rwx', value: 7 },
+  6: { binary: '110', symbolic: 'rw-', value: 6 },
+  5: { binary: '101', symbolic: 'r-x', value: 5 },
+  4: { binary: '100', symbolic: 'r--', value: 4 },
+  3: { binary: '011', symbolic: '-wx', value: 3 },
+  2: { binary: '010', symbolic: '-w-', value: 2 },
+  1: { binary: '001', symbolic: '--x', value: 1 },
+  0: { binary: '000', symbolic: '---', value: 0 },
+};
+
+function parseOctal(octal) {
+  const octalStr = octal.toString();
+  const digits = octalStr.split('').map(d => parseInt(d, 10));
+
+  // Pad to 3 or 4 digits
+  while (digits.length < 3) {
+    digits.unshift(0);
+  }
+
+  const result = {
+    octal: digits.join(''),
+    owner: PERMISSIONS[digits[digits.length - 3]] || PERMISSIONS[0],
+    group: PERMISSIONS[digits[digits.length - 2]] || PERMISSIONS[0],
+    other: PERMISSIONS[digits[digits.length - 1]] || PERMISSIONS[0],
+  };
+
+  if (digits.length >= 4) {
+    result.special = {
+      4: 'setuid',
+      2: 'setgid',
+      1: 'sticky',
+    }[digits[0]] || null;
+  }
+
+  return result;
+}
+
+function symbolicToOctal(symbolic) {
+  let result = 0;
+
+  if (symbolic.includes('r')) result += 4;
+  if (symbolic.includes('w')) result += 2;
+  if (symbolic.includes('x')) result += 1;
+
+  return result;
+}
+
+function showHelp() {
+  console.log(`
+@devkits/chmod - Unix file permissions calculator
+
+Usage:
+  dk-chmod 755                      # Show what 755 means
+  dk-chmod 644                      # Show what 644 means
+  dk-chmod -o rwx r-x r--           # Calculate from symbols
+  dk-chmod --owner rwx --group r-x  # Verbose symbolic
+
+Options:
+  -o, --octal <n>       Show octal permissions
+  -s, --symbolic <sym>  Symbolic notation (e.g., u+rwx,g+rx)
+  --owner <sym>         Owner permissions (rwx, rw, etc.)
+  --group <sym>         Group permissions
+  --other <sym>         Other permissions
+  -h, --help            Show this help message
+
+Examples:
+  dk-chmod 755                        # rwxr-xr-x
+  dk-chmod 644                        # rw-r--r--
+  dk-chmod -o rwx r-x r--             # 755
+  dk-chmod --owner rw --group r --other r  # 644
+
+Web version: https://devkits-tools.surge.sh/tools/chmod-calculator
+Pro features: https://devkits-tools.surge.sh/pro
+`);
+}
+
+// Main entry point
+const args = process.argv.slice(2);
+
+if (!args.length || args.includes('-h') || args.includes('--help')) {
+  showHelp();
+  process.exit(0);
+}
+
+// Parse options
+let ownerSym = null;
+let groupSym = null;
+let otherSym = null;
+let octalValue = null;
+
+for (let i = 0; i < args.length; i++) {
+  switch (args[i]) {
+    case '-o':
+    case '--octal':
+      octalValue = args[++i];
+      break;
+    case '--owner':
+      ownerSym = args[++i];
+      break;
+    case '--group':
+      groupSym = args[++i];
+      break;
+    case '--other':
+      otherSym = args[++i];
+      break;
+    case '-s':
+    case '--symbolic':
+      // Parse symbolic notation like u+rwx,g+rx
+      const parts = args[++i].split(',');
+      for (const part of parts) {
+        const match = part.match(/([ugo])([+\-=])([rwx]+)/);
+        if (match) {
+          const [, who, op, perms] = match;
+          if (who === 'u') ownerSym = perms;
+          else if (who === 'g') groupSym = perms;
+          else if (who === 'o') otherSym = perms;
+        }
+      }
+      break;
+    default:
+      // Assume it's an octal value
+      if (!octalValue && /^\d+$/.test(args[i])) {
+        octalValue = args[i];
+      }
+  }
+}
+
+// Calculate from symbolic
+if (ownerSym || groupSym || otherSym) {
+  const owner = ownerSym ? symbolicToOctal(ownerSym) : 0;
+  const group = groupSym ? symbolicToOctal(groupSym) : 0;
+  const other = otherSym ? symbolicToOctal(otherSym) : 0;
+  octalValue = `${owner}${group}${other}`;
+}
+
+if (octalValue) {
+  const result = parseOctal(octalValue);
+
+  console.log(`\nChmod Calculator Results`);
+  console.log(`========================\n`);
+  console.log(`Octal: ${result.octal}`);
+  console.log(`\nPermissions:`);
+  console.log(`  Owner: ${result.owner.symbolic} (${result.owner.value})`);
+  console.log(`  Group: ${result.group.symbolic} (${result.group.value})`);
+  console.log(`  Other: ${result.other.symbolic} (${result.other.value})`);
+
+  if (result.special) {
+    console.log(`\nSpecial: ${result.special}`);
+  }
+
+  console.log(`\nBinary: ${result.owner.binary} ${result.group.binary} ${result.other.binary}`);
+  console.log(`\nCommand: chmod ${result.octal} <file>`);
+
+  // Common use cases
+  console.log(`\nCommon patterns:`);
+  console.log(`  777 - rwxrwxrwx (everyone has full access) ⚠️`);
+  console.log(`  755 - rwxr-xr-x (common for directories)`);
+  console.log(`  644 - rw-r--r-- (common for files)`);
+  console.log(`  600 - rw------- (private file)`);
+  console.log(`  400 - r-------- (read-only, owner only)`);
+} else {
+  console.error('Error: Please provide an octal value or symbolic permissions');
+  showHelp();
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "devkits-chmod",
+  "version": "1.0.0",
+  "description": "Calculate Unix file permissions (chmod) values",
+  "main": "index.js",
+  "bin": {
+    "dk-chmod": "./index.js",
+    "chmod-calc": "./index.js"
+  },
+  "scripts": {
+    "test": "node test.js"
+  },
+  "keywords": [
+    "chmod",
+    "permissions",
+    "unix",
+    "linux",
+    "file",
+    "devkits",
+    "developer-tools",
+    "cli",
+    "command-line",
+    "nodejs",
+    "utility",
+    "productivity",
+    "dev-tools",
+    "free-tools"
+  ],
+  "author": "DevKits Team <devkits-auto@protonmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/devkits/tools"
+  },
+  "homepage": "https://devkits-tools.surge.sh/tools/chmod-calculator",
+  "bugs": {
+    "url": "https://github.com/devkits/tools/issues"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "files": [
+    "index.js",
+    "README.md",
+    "test.js"
+  ],
+  "dependencies": {}
+}

package/test.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+
+/**
+ * Tests for @devkits/chmod
+ */
+
+const { execSync } = require('child_process');
+
+const tests = [
+  {
+    name: '755 shows rwxr-xr-x',
+    cmd: 'node index.js 755',
+    check: (result) => result.includes('rwx') && result.includes('r-x') && result.includes('755')
+  },
+  {
+    name: '644 shows rw-r--r--',
+    cmd: 'node index.js 644',
+    check: (result) => result.includes('rw-') && result.includes('r--') && result.includes('644')
+  },
+  {
+    name: '600 shows rw-------',
+    cmd: 'node index.js 600',
+    check: (result) => result.includes('rw-') && result.includes('---')
+  },
+  {
+    name: 'Symbolic to octal (rwx r-x r-x)',
+    cmd: 'node index.js --owner rwx --group r-x --other r-x',
+    check: (result) => result.includes('755')
+  },
+  {
+    name: 'Symbolic to octal (rw r r)',
+    cmd: 'node index.js --owner rw --group r --other r',
+    check: (result) => result.includes('644')
+  },
+  {
+    name: 'Output includes binary representation',
+    cmd: 'node index.js 755',
+    check: (result) => result.includes('Binary:') && result.includes('111')
+  },
+];
+
+let passed = 0;
+let failed = 0;
+
+console.log('Running @devkits/chmod tests...\n');
+
+for (const test of tests) {
+  try {
+    const result = execSync(test.cmd, { encoding: 'utf8' }).trim();
+    if (test.check(result)) {
+      console.log(`✅ ${test.name}`);
+      passed++;
+    } else {
+      console.log(`❌ ${test.name}`);
+      console.log(`   Got: ${result.substring(0, 100)}...`);
+      failed++;
+    }
+  } catch (err) {
+    console.log(`❌ ${test.name} - Error: ${err.message}`);
+    failed++;
+  }
+}
+
+console.log(`\n${passed}/${tests.length} tests passed`);
+process.exit(failed > 0 ? 1 : 0);