node_module-nuke 0.2.0

Efficiently delete node_modules directories with nuclear precision
node_module-nuke-0.2.0 is not a library.

🚀 node_module-nuke

The nuclear option for those pesky node_modules directories

💥 What is this?

Are you tired of node_modules directories multiplying like rabbits and eating your disk space? Do you have more node_modules folders than actual projects? Has your SSD started crying every time you run npm install?

Fear no more! node_module-nuke is here to save the day (and your storage).

This blazingly fast Rust-powered tool will hunt down every single node_modules directory on your system and give you the power to DELETE THEM ALL with the satisfaction of watching your free disk space counter go brrrrr.

🎯 Why node_modules directories are the worst

  • 📦 They're basically black holes that suck up disk space
  • 🐌 They make your backups slower than dial-up internet
  • 🔍 They hide in every corner of your filesystem like digital dust bunnies
  • 💸 They cost you money in cloud storage fees
  • 🤡 They contain 47,000 packages just to center a div
  • 🏠 Each one could house a small family of dependencies
  • 📚 They have more files than the Library of Congress
  • 🌕 They're probably visible from space at this point

✨ Features

  • ⚡ Blazingly fast - Written in Rust because life's too short for slow tools
  • 🎯 Surgical precision - Only targets node_modules directories (your code is safe!)
  • 📊 Progress bars - Watch your disk space come back to life in real-time
  • 🏃‍♂️ Parallel processing - Uses all your CPU cores to maximize the carnage
  • 🧪 Dry run mode - Preview the destruction before committing to it
  • 🎨 Pretty output - Because even nuclear warfare should look good
  • 🛡️ Exclude paths - Protect your production builds (if you must)

🚀 Installation

From crates.io (once published):

cargo install node_module-nuke

From source (local development):

# Clone the repository
git clone <repository-url>
cd node_module-nuke

# Install locally
cargo install --path .

Just run it without installing:

cargo run

📦 Publishing to crates.io

For maintainers who want to publish this tool:

  1. Prepare your package:

    # Make sure everything builds
cargo build --release
cargo test

  2. Update Cargo.toml metadata:

    [package]
name = "node_module-nuke"
version = "0.1.0"
edition = "2021"
description = "Efficiently delete node_modules directories with nuclear precision"
license = "MIT"
repository = "https://github.com/yourusername/node_module-nuke"
homepage = "https://github.com/yourusername/node_module-nuke"
documentation = "https://docs.rs/node_module-nuke"
keywords = ["cli", "node_modules", "cleanup", "disk-space", "nodejs"]
categories = ["command-line-utilities", "filesystem"]

  3. Login to crates.io:

    cargo login
# Enter your API token from https://crates.io/me

  4. Publish:

    # Dry run first to check everything
cargo publish --dry-run

# Actually publish
cargo publish

  5. After publishing, users can install with:

    cargo install node_module-nuke

🎮 Usage

Basic nuclear strike (current directory):

node_module-nuke

Target a specific directory:

node_module-nuke ~/Projects

See what would be destroyed (dry run):

node_module-nuke --dry-run

Maximum verbosity (watch the world burn):

node_module-nuke --verbose

Limit the depth of destruction:

node_module-nuke --depth 3

Spare some directories from the apocalypse:

node_module-nuke --exclude ./important-project/node_modules,./another-project/node_modules

Get help (you'll need it):

node_module-nuke --help

🎪 Example Output

Scan complete in 0.42s:
- Folders found: 47
- Total size: 12.34 GB
- Estimated savings: 12.34 GB

Proceed with deletion? (yes/no): yes

Deleting... ████████████████████ 47/47 [00:03] Freed: 12.34 GB

Deletion complete in 3.14s:
- Folders deleted: 47
- Space freed: 12.34 GB

Your SSD just sighed with relief.

⚠️ Warning

This tool is nuclear. It will delete node_modules directories. Forever. Gone. Poof. 💨

Make sure you can recreate them with npm install or yarn install before proceeding.

(But let's be honest, you probably should have done this ages ago.)

🤝 Contributing

Found a bug? Want to make it even more destructive? PRs welcome!

Just remember: with great power comes great responsibility. Use this tool wisely.

📜 License

MIT - Because even nuclear weapons should be free and open source.

"I used to have 50GB of node_modules. Now I have 50GB of free space and inner peace." - Happy User

"This tool gave me back my weekend. And my sanity." - Another Happy User

"node_modules directories hate this one simple trick!" - Definitely Not Clickbait