auto-dev-setup 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 auto-dev-setup contributors
+
+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,191 @@
+# auto-dev-setup
+
+A cross-platform command-line tool that automates developer environment setup on Windows, macOS, and Linux.
+
+## Features
+
+- **Cross-Platform**: Works consistently on Windows, macOS, and Linux
+- **Interactive Setup**: Guided installation with clear prompts
+- **Idempotent**: Safe to run multiple times
+- **Transparent**: Shows all commands before execution
+- **Modular**: Install only what you need
+
+## What Gets Installed
+
+### Always Installed (Base + Web Stack)
+- **Base Tools**: Git, curl/wget
+- **Node.js** (LTS version)
+- **npm** (configured for global installs)
+- **Visual Studio Code** with essential extensions:
+  - ESLint
+  - Prettier
+  - GitLens
+
+### Optional (Interactive Prompts)
+- **Python Stack**: Python 3, pip, pipx, virtualenv, Jupyter, NumPy, Pandas
+- **Java Stack**: OpenJDK (LTS), JAVA_HOME configuration
+
+## Installation
+
+### npm (Recommended)
+
+```bash
+npm install -g auto-dev-setup
+```
+
+### pip
+
+```bash
+pip install auto-dev-setup
+```
+
+### Homebrew (macOS)
+
+```bash
+brew tap yourusername/auto-dev-setup
+brew install auto-dev-setup
+```
+
+### Development / Local Installation
+
+If you're installing from a cloned repository (for development or testing):
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/auto-dev-setup.git
+cd auto-dev-setup
+
+# Install dependencies first (required!)
+npm install
+
+# Then link globally
+npm link
+
+# Now you can use the command
+auto-setup --version
+```
+
+**Note:** When installing from npm registry (`npm install -g auto-dev-setup`), dependencies are installed automatically. The extra `npm install` step is only needed for local development.
+
+## Usage
+
+### Run the Setup Wizard
+
+```bash
+auto-setup
+```
+
+This will:
+1. Detect your platform (Windows/macOS/Linux)
+2. Install base system tools
+3. Install the web developer stack
+4. Prompt for Python stack installation
+5. Prompt for Java stack installation
+6. Display a summary of all changes
+
+### Command Options
+
+```bash
+# Run with all stacks (no prompts)
+auto-setup --yes
+
+# Skip specific stacks
+auto-setup --skip-python
+auto-setup --skip-java
+
+# Check installed tools
+auto-setup check
+
+# Display system info
+auto-setup info
+
+# Show version
+auto-setup --version
+
+# Show help
+auto-setup --help
+```
+
+## Platform-Specific Behavior
+
+### macOS
+- Installs Xcode Command Line Tools
+- Uses Homebrew for package management
+- Supports both Intel and Apple Silicon
+
+### Linux
+- Detects distribution (Debian/Ubuntu, Fedora/RHEL, Arch, etc.)
+- Uses native package manager (apt, dnf, pacman, etc.)
+- Sets up NodeSource repository for latest Node.js LTS
+
+### Windows
+- Requires PowerShell
+- Uses winget (preferred) or Chocolatey
+- May require Administrator privileges for some installations
+
+## Project Structure
+
+```
+auto-dev-setup/
+├── bin/
+│   └── auto-setup.js          # CLI entry point
+├── src/
+│   ├── cli.js                 # Main CLI logic
+│   ├── index.js               # Module exports
+│   ├── platform/
+│   │   ├── detector.js        # OS/arch/shell detection
+│   │   ├── macos.js           # macOS installers
+│   │   ├── linux.js           # Linux installers
+│   │   └── windows.js         # Windows installers
+│   ├── stacks/
+│   │   ├── base.js            # Base tools installer
+│   │   ├── web.js             # Web stack installer
+│   │   ├── python.js          # Python stack installer
+│   │   └── java.js            # Java stack installer
+│   ├── utils/
+│   │   ├── executor.js        # Command execution
+│   │   ├── logger.js          # Console output
+│   │   ├── prompts.js         # User prompts
+│   │   └── verifier.js        # Installation verification
+│   └── config/
+│       └── extensions.js      # VS Code extensions config
+├── python/                    # pip distribution
+├── homebrew/                  # Homebrew formula
+├── package.json
+├── pyproject.toml
+└── README.md
+```
+
+## Safety
+
+- Does **NOT** install paid software
+- Does **NOT** run background services
+- Does **NOT** overwrite config files blindly
+- Always checks before modifying PATH or shell configs
+- Prints all executed commands to terminal
+
+## Requirements
+
+- **Node.js** >= 16.0.0 (for npm installation)
+- **Python** >= 3.8 (for pip installation)
+- Internet connection for downloading packages
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Acknowledgments
+
+- Built with [Commander.js](https://github.com/tj/commander.js)
+- Uses [Inquirer.js](https://github.com/SBoudrias/Inquirer.js) for prompts
+- Styled with [Chalk](https://github.com/chalk/chalk)

package/bin/auto-setup.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+/**
+ * auto-dev-setup CLI Entry Point
+ * Cross-platform developer environment setup tool
+ */
+
+const { run } = require('../src/cli');
+
+run().catch((error) => {
+  console.error('Fatal error:', error.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "auto-dev-setup",
+  "version": "0.1.0",
+  "description": "Cross-platform CLI tool to automate developer environment setup on Windows, macOS, and Linux",
+  "main": "src/index.js",
+  "bin": {
+    "auto-setup": "bin/auto-setup.js"
+  },
+  "scripts": {
+    "start": "node bin/auto-setup.js",
+    "test": "node --test",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm test || true"
+  },
+  "keywords": [
+    "developer",
+    "setup",
+    "cli",
+    "automation",
+    "cross-platform",
+    "devtools",
+    "environment",
+    "nodejs",
+    "python",
+    "java"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "inquirer": "^8.2.6",
+    "ora": "^5.4.1",
+    "boxen": "^5.1.2",
+    "which": "^3.0.1"
+  },
+  "devDependencies": {
+    "eslint": "^8.56.0"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md",
+    "LICENSE"
+  ],
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ]
+}

package/src/cli.js

@@ -0,0 +1,295 @@
+/**
+ * auto-dev-setup CLI
+ * Main CLI entry point with interactive setup flow
+ */
+
+const { Command } = require('commander');
+const { getPlatformInfo } = require('./platform/detector');
+const { logger, prompts, postinstall } = require('./utils');
+const stacks = require('./stacks');
+
+const VERSION = '0.1.0';
+
+/**
+ * Main CLI execution flow
+ */
+async function run() {
+  const program = new Command();
+
+  program
+    .name('auto-setup')
+    .description(
+      'Cross-platform CLI tool to automate developer environment setup'
+    )
+    .version(VERSION)
+    .option('-y, --yes', 'Skip interactive prompts and install all stacks')
+    .option('--skip-python', 'Skip Python stack installation')
+    .option('--skip-java', 'Skip Java stack installation')
+    .option('--dry-run', 'Show what would be installed without making changes')
+    .action(async (options) => {
+      await runSetup(options);
+    });
+
+  program
+    .command('check')
+    .description('Check current system and installed tools')
+    .action(async () => {
+      await runCheck();
+    });
+
+  program
+    .command('info')
+    .description('Display system information')
+    .action(async () => {
+      await runInfo();
+    });
+
+  await program.parseAsync(process.argv);
+}
+
+/**
+ * Run the main setup flow
+ * @param {Object} options - CLI options
+ */
+async function runSetup(options) {
+  // Display welcome banner
+  logger.banner(
+    'auto-dev-setup',
+    'Cross-platform Developer Environment Setup Tool'
+  );
+
+  // Track all results
+  const allResults = {
+    installed: [],
+    skipped: [],
+    failed: []
+  };
+
+  let needsRestart = false;
+
+  try {
+    // ========================================
+    // STEP 1: Platform Detection
+    // ========================================
+    logger.section('Step 1: Platform Detection');
+
+    const platformInfo = getPlatformInfo();
+    logger.displayPlatformInfo(platformInfo);
+
+    // Check for unsupported platforms
+    if (!['darwin', 'linux', 'win32'].includes(platformInfo.platform)) {
+      logger.error(`Unsupported platform: ${platformInfo.platform}`);
+      logger.info('This tool supports Windows, macOS, and Linux only.');
+      process.exit(1);
+    }
+
+    // Windows admin warning
+    if (platformInfo.platform === 'win32' && !platformInfo.isElevated) {
+      logger.warn('Not running as Administrator');
+      logger.info(
+        'Some installations may require Administrator privileges.'
+      );
+      logger.info(
+        'Consider restarting this tool as Administrator for best results.'
+      );
+      logger.newline();
+
+      if (!options.yes) {
+        const shouldContinue = await prompts.confirm(
+          'Continue without Administrator privileges?',
+          true
+        );
+        if (!shouldContinue) {
+          logger.info('Please restart as Administrator and try again.');
+          process.exit(0);
+        }
+      }
+    }
+
+    // ========================================
+    // STEP 2: Base System Setup
+    // ========================================
+    const baseResults = await stacks.base.install();
+
+    if (baseResults.pending) {
+      logger.info('Please complete pending installations and run again.');
+      process.exit(0);
+    }
+
+    mergeResults(allResults, baseResults);
+    needsRestart = baseResults.installed.length > 0;
+
+    // ========================================
+    // STEP 3: Web Developer Stack (Mandatory)
+    // ========================================
+    const webResults = await stacks.web.install();
+    mergeResults(allResults, webResults);
+    needsRestart = needsRestart || webResults.installed.length > 0;
+
+    // ========================================
+    // STEP 4: Python Stack (Interactive)
+    // ========================================
+    let installPython = options.yes && !options.skipPython;
+
+    if (!options.yes && !options.skipPython) {
+      installPython = await prompts.promptPythonStack();
+    }
+
+    if (installPython) {
+      const pythonResults = await stacks.python.install();
+      mergeResults(allResults, pythonResults);
+      needsRestart = needsRestart || pythonResults.installed.length > 0;
+    } else {
+      logger.section('Step 4: Python Development Environment');
+      logger.info('Skipped by user choice');
+      allResults.skipped.push('Python Stack');
+    }
+
+    // ========================================
+    // STEP 5: Java Stack (Interactive)
+    // ========================================
+    let installJava = options.yes && !options.skipJava;
+
+    if (!options.yes && !options.skipJava) {
+      installJava = await prompts.promptJavaStack();
+    }
+
+    if (installJava) {
+      const javaResults = await stacks.java.install();
+      mergeResults(allResults, javaResults);
+      needsRestart = needsRestart || javaResults.installed.length > 0;
+    } else {
+      logger.section('Step 5: Java Development Environment');
+      logger.info('Skipped by user choice');
+      allResults.skipped.push('Java Stack');
+    }
+
+    // ========================================
+    // STEP 6: Post-Installation Configuration
+    // ========================================
+    logger.section('Step 6: Post-Installation Configuration');
+
+    // Ensure all paths are properly configured
+    const pathResult = await postinstall.ensurePathsConfigured();
+    if (pathResult.added.length > 0) {
+      logger.success('PATH updated for the following:');
+      for (const pathInfo of pathResult.added) {
+        logger.listItem(`${pathInfo.name}: ${pathInfo.path}`);
+      }
+      needsRestart = true;
+    } else {
+      logger.success('All required paths already configured');
+    }
+
+    // Verify tools are accessible
+    const toolVerification = postinstall.verifyToolsAccessible();
+    if (toolVerification.notAccessible.length > 0) {
+      logger.newline();
+      logger.warn('Some tools may not be accessible until terminal restart:');
+      for (const tool of toolVerification.notAccessible) {
+        logger.listItem(tool);
+      }
+    }
+
+    // ========================================
+    // STEP 7: Final Summary
+    // ========================================
+    logger.section('Step 7: Final Summary');
+    logger.displaySummary(
+      allResults.installed,
+      allResults.skipped,
+      allResults.failed
+    );
+
+    if (needsRestart) {
+      logger.warn('Terminal restart required');
+      logger.info(
+        'Please restart your terminal for all changes to take effect.'
+      );
+      logger.newline();
+
+      // Show platform-specific reload command
+      if (platformInfo.platform === 'win32') {
+        logger.info('Close and reopen PowerShell/Terminal to refresh your environment.');
+      } else {
+        const shellConfig = platformInfo.shell.configFile;
+        if (shellConfig && shellConfig !== 'N/A') {
+          logger.info(`Or run: source ${shellConfig}`);
+        }
+      }
+    }
+
+    if (allResults.failed.length === 0) {
+      logger.complete();
+    } else {
+      logger.warn(
+        `Setup completed with ${allResults.failed.length} failed installation(s).`
+      );
+      logger.info('Review the errors above and try installing failed components manually.');
+    }
+  } catch (error) {
+    logger.error(`Setup failed: ${error.message}`);
+    logger.newline();
+    logger.info('If this is a permissions issue, try running as Administrator/sudo.');
+    process.exit(1);
+  }
+}
+
+/**
+ * Run system check
+ */
+async function runCheck() {
+  logger.banner('System Check', 'Verifying installed development tools');
+
+  const platformInfo = getPlatformInfo();
+  logger.displayPlatformInfo(platformInfo);
+
+  const { verifier } = require('./utils');
+  const allVerifications = verifier.runAllVerifications();
+
+  logger.section('Base Tools');
+  verifier.displayVerification(allVerifications.base);
+
+  logger.section('Web Stack');
+  verifier.displayVerification(allVerifications.web);
+
+  logger.section('Python Stack');
+  verifier.displayVerification(allVerifications.python);
+
+  logger.section('Java Stack');
+  verifier.displayVerification(allVerifications.java);
+}
+
+/**
+ * Display system information
+ */
+async function runInfo() {
+  logger.banner('System Information', 'auto-dev-setup v' + VERSION);
+
+  const platformInfo = getPlatformInfo();
+  logger.displayPlatformInfo(platformInfo);
+}
+
+/**
+ * Merge results from a stack installation
+ * @param {Object} allResults - Accumulated results
+ * @param {Object} stackResults - Results from single stack
+ */
+function mergeResults(allResults, stackResults) {
+  if (stackResults.installed) {
+    allResults.installed.push(...stackResults.installed);
+  }
+  if (stackResults.skipped) {
+    allResults.skipped.push(...stackResults.skipped);
+  }
+  if (stackResults.failed) {
+    allResults.failed.push(...stackResults.failed);
+  }
+}
+
+module.exports = {
+  run,
+  runSetup,
+  runCheck,
+  runInfo
+};

package/src/config/extensions.js

@@ -0,0 +1,51 @@
+/**
+ * VS Code Extensions Configuration
+ */
+
+const VSCODE_EXTENSIONS = {
+  essential: [
+    {
+      id: 'dbaeumer.vscode-eslint',
+      name: 'ESLint',
+      description: 'Integrates ESLint JavaScript into VS Code'
+    },
+    {
+      id: 'esbenp.prettier-vscode',
+      name: 'Prettier',
+      description: 'Code formatter using prettier'
+    },
+    {
+      id: 'eamodio.gitlens',
+      name: 'GitLens',
+      description: 'Supercharge Git within VS Code'
+    }
+  ],
+  python: [
+    {
+      id: 'ms-python.python',
+      name: 'Python',
+      description: 'Python language support'
+    },
+    {
+      id: 'ms-python.vscode-pylance',
+      name: 'Pylance',
+      description: 'Python language server'
+    },
+    {
+      id: 'ms-toolsai.jupyter',
+      name: 'Jupyter',
+      description: 'Jupyter notebook support'
+    }
+  ],
+  java: [
+    {
+      id: 'vscjava.vscode-java-pack',
+      name: 'Java Extension Pack',
+      description: 'Popular extensions for Java development'
+    }
+  ]
+};
+
+module.exports = {
+  VSCODE_EXTENSIONS
+};

package/src/index.js

@@ -0,0 +1,16 @@
+/**
+ * auto-dev-setup
+ * Cross-platform developer environment setup tool
+ */
+
+const { run } = require('./cli');
+const platform = require('./platform');
+const stacks = require('./stacks');
+const utils = require('./utils');
+
+module.exports = {
+  run,
+  platform,
+  stacks,
+  utils
+};