dirfy 0.1.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 79899b98c10fa13d4c3d6c48a83efd80f3a7d9d7e3c62f58faaa0b8c39a6561f
+  data.tar.gz: d32b90c0829e778539896e4a4386d6a38db3dee915e42e12481b7cc72fa915c9
+SHA512:
+  metadata.gz: c956b986856643b569417ff8a355973fc9878757545feef593dd6daab1557c6a60d331bd321685be77e032b97d3ea58b3c8ab56c6eaaa718b5e74b3ce17ecb90
+  data.tar.gz: 79f20f7434fff68854d8ba31774d5976a2e7546866dbdc2240db5ff16df2e6f95c5b9f06b6cb6ab191749e96796f6109fa249f40c59ea7aac70fe84505886544

data/README.md

@@ -0,0 +1,131 @@
+# Dirfy
+
+[![Build Status](https://github.com/ahmedmelhady7/dirfy/actions/workflows/ruby.yml/badge.svg)](https://github.com/ahmedmelhady7/dirfy/actions)  
+[![Gem Version](https://badge.fury.io/rb/dirfy.svg)](https://badge.fury.io/rb/dirfy)  
+[![License](https://img.shields.io/github/license/ahmedmelhady7/dirfy.svg)](https://github.com/ahmedmelhady7/dirfy/blob/main/LICENSE)  
+[![Ruby ≥2.6](https://img.shields.io/badge/ruby-%3E%3D2.6-blue.svg)](https://www.ruby-lang.org/)  
+[![Issues](https://img.shields.io/github/issues/ahmedmelhady7/dirfy.svg)](https://github.com/ahmedmelhady7/dirfy/issues)  
+
+> **Instantly scaffold directory & file structures from any ASCII/Unicode “tree” diagram** 🚀
+
+---
+
+## 📋 Problem Statement
+
+Modern AI code generators (ChatGPT, Copilot, etc.) excel at producing code snippets—but often describe project layouts as ASCII or Unicode “tree” diagrams. Manually translating those diagrams into a real folder/file structure is:
+
+- **Time-consuming & error-prone** when projects are large or deeply nested  
+- **Tedious** to type out dozens or hundreds of `mkdir -p` / `touch` commands  
+- **Prone to typos** and forgotten directories
+
+**Dirfy** solves this by automating the entire process: feed it any `tree` diagram (text or file), and it will parse and create the exact structure—no matter how big—within seconds.
+
+---
+
+## ✨ Features
+
+- **Parse ASCII & Unicode** tree diagrams  
+- **Dry-run mode** (`-d`) to preview changes without writing  
+- **Verbose logging** (`-v`) for full action reports  
+- **Custom indent** support (`-i N`) for non-standard tree outputs  
+- **Path prefixing** (`-p DIR/`) to scaffold under any base folder  
+- **Live progress bar** and clear success/failure summary  
+- **Zero external dependencies** (pure Ruby ≥2.6)  
+
+---
+
+## 🚀 Installation
+
+```bash
+# via RubyGems
+gem install dirfy
+
+# or from source
+git clone https://github.com/ahmedmelhady7/dirfy.git
+cd dirfy
+bundle install
+rake install
+````
+
+---
+
+## 💡 Usage
+
+### From a file
+
+```bash
+dirfy path/to/tree.txt
+```
+
+### Via pipe
+
+```bash
+cat tree.txt | dirfy
+```
+
+### Common Options
+
+| Flag                       | Description                                        |
+| -------------------------- | -------------------------------------------------- |
+| `-d`, `--dry-run`          | Preview actions without creating files/directories |
+| `-v`, `--verbose`          | Show each create/skip/fail action                  |
+| `-i N`, `--indent=N`       | Set spaces per tree level (default: `4`)           |
+| `-p DIR/`, `--prefix=DIR/` | Prepend `DIR/` to every generated path             |
+| `-h`, `--help`             | Display help and exit                              |
+
+---
+
+## 🛠️ Examples
+
+Given a file `myapp_tree.txt`:
+
+```text
+my_app/
+├── lib/
+│   └── my_app.rb
+├── spec/
+│   └── my_app_spec.rb
+└── README.md
+```
+
+Run:
+
+```bash
+dirfy -d -v myapp_tree.txt
+```
+
+Output (dry-run):
+
+```
+🔍 Detected 4 items to create.
+DRY-RUN Dir:   my_app/
+DRY-RUN Dir:   my_app/lib/
+DRY-RUN File:  my_app/lib/my_app.rb
+DRY-RUN Dir:   my_app/spec/
+DRY-RUN File:  my_app/spec/my_app_spec.rb
+DRY-RUN File:  my_app/README.md
+```
+
+Remove `-d` to actually scaffold.
+
+---
+
+## 📖 Contributing
+
+1. Fork this repo
+2. Create a feature branch (`git checkout -b feature/your-feature`)
+3. Commit your changes (`git commit -m "Add feature"`)
+4. Run tests (`bundle exec rake spec`)
+5. Submit a pull request
+
+Please check [CONTRIBUTING.md](CONTRIBUTING.md) for full guidelines.
+
+---
+
+## 📝 License
+
+This project is released under the **MIT License**. See [LICENSE](LICENSE) for details.
+
+---
+
+> Built with ❤️ to make AI-generated project scaffolding a breeze.

data/Rakefile

@@ -0,0 +1,6 @@
+# Rakefile
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+task default: :spec

data/bin/dirfy

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+require "dirfy/cli"
+Dirfy::CLI.start(ARGV)

data/lib/dirfy/cli.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+require "optparse"
+require_relative "parser"
+require_relative "io"
+
+module Dirfy
+  # Command-line interface
+  class CLI
+    def self.start(argv = ARGV)
+      options = {
+        dry_run: false,
+        verbose: false,
+        indent: 4,
+        prefix: ""
+      }
+
+      parser = OptionParser.new do |opts|
+        opts.banner = "Usage: dirfy [options] [treefile]"
+
+        opts.on("-d", "--dry-run", "Preview only; no files/dirs created") do
+          options[:dry_run] = true
+        end
+
+        opts.on("-v", "--verbose", "Log each action") do
+          options[:verbose] = true
+        end
+
+        opts.on("-iN", "--indent=N", Integer, "Spaces per level (default 4)") do |n|
+          options[:indent] = n
+        end
+
+        opts.on("-pDIR", "--prefix=DIR", "Prepend DIR/ to every path") do |dir|
+          options[:prefix] = dir.chomp("/") + "/"
+        end
+
+        opts.on("-h", "--help", "Show this help") do
+          puts opts
+          exit
+        end
+      end
+
+      parser.parse!(argv)
+
+      lines =
+        if argv[0] && File.file?(argv[0])
+          File.readlines(argv[0]).map(&:chomp)
+        else
+          STDIN.read.lines.map(&:chomp)
+        end
+
+      items = Parser.new(indent: options[:indent]).parse(lines)
+      items.map! { |p| options[:prefix] + p }
+
+      puts "🔍 Detected #{items.size} items to create."
+      unless options[:dry_run]
+        print "Proceed? (y/N) "
+        answer = STDIN.gets.to_s.strip.downcase
+        exit(1) unless %w[y yes].include?(answer)
+      end
+
+      IO.new(dry_run: options[:dry_run], verbose: options[:verbose]).create(items)
+    end
+  end
+end

data/lib/dirfy/io.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+require "fileutils"
+
+module Dirfy
+  # Creates directories/files with progress bar, dry-run, verbose modes.
+  class IO
+    def initialize(dry_run: false, verbose: false)
+      @dry_run    = dry_run
+      @verbose    = verbose
+      @dirs       = @files = @skipped = @failed = 0
+      @bar_length = 30
+    end
+
+    # items - Array<String>
+    def create(items)
+      total = items.size
+      items.each_with_index do |item, idx|
+        print_progress(idx + 1, total)
+        if item.end_with?("/")
+          create_dir(item)
+        else
+          create_file(item)
+        end
+      end
+      puts
+      print_summary
+    end
+
+    private
+
+    def create_dir(path)
+      if @dry_run
+        log "DRY-RUN Dir:   #{path}"
+      else
+        if Dir.exist?(path)
+          log "Skipped dir:  #{path}"
+          @skipped += 1
+        else
+          FileUtils.mkdir_p(path)
+          log "Created dir:  #{path}"
+          @dirs += 1
+        end
+      end
+    rescue StandardError => e
+      warn "Failed dir:   #{path} (#{e.message})"
+      @failed += 1
+    end
+
+    def create_file(path)
+      dir = File.dirname(path)
+      unless Dir.exist?(dir)
+        if @dry_run
+          log "DRY-RUN Mkdir: #{dir}"
+        else
+          FileUtils.mkdir_p(dir)
+        end
+      end
+
+      if @dry_run
+        log "DRY-RUN File:  #{path}"
+      else
+        if File.exist?(path)
+          log "Skipped file: #{path}"
+          @skipped += 1
+        else
+          FileUtils.touch(path)
+          log "Created file: #{path}"
+          @files += 1
+        end
+      end
+    rescue StandardError => e
+      warn "Failed file:  #{path} (#{e.message})"
+      @failed += 1
+    end
+
+    def print_progress(current, total)
+      pct    = (current * 100.0 / total).floor
+      filled = (pct * @bar_length / 100.0).floor
+      empty  = @bar_length - filled
+      bar    = "█" * filled + " " * empty
+      print "\r🤖 [#{bar}] #{pct}%"
+    end
+
+    def log(msg)
+      puts msg if @verbose || @dry_run
+    end
+
+    def warn(msg)
+      STDERR.puts "⚠️  #{msg}"
+    end
+
+    def print_summary
+      puts "Summary → dirs=#{@dirs}, files=#{@files}, skipped=#{@skipped}, failed=#{@failed}"
+    end
+  end
+end

data/lib/dirfy/parser.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+require "strscan"
+
+module Dirfy
+  # Parses ASCII/Unicode tree diagrams into flat path lists.
+  class Parser
+    def initialize(indent: 4)
+      @indent = indent
+    end
+
+    # lines - Array<String>
+    # returns Array<String> of relative paths, dirs ending with '/'
+    def parse(lines)
+      stack = []
+      items = []
+
+      lines.each do |raw|
+        line = raw.rstrip
+        next if line.strip.empty? || line.strip.start_with?("#")
+
+        if line.match?(/[└├]/)
+          # replace tree chars with spaces to count indent
+          indent_str = line.gsub(/[│├└─]/, " ")
+          lead_spaces = indent_str[/\A */].size
+          depth = lead_spaces / @indent
+          name  = line.split("── ", 2).last
+        else
+          depth = 0
+          name  = line.strip
+        end
+
+        stack[depth] = name
+        stack = stack[0..depth]
+
+        # build full path
+        path = stack.map { |c| c.chomp("/") }.join("/")
+        path << "/" if name.end_with?("/")
+        items << path
+      end
+
+      items
+    end
+  end
+end

data/lib/dirfy/version.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+module Dirfy
+  VERSION = "0.1.4"
+end

data/lib/dirfy.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+require "dirfy/version"
+require "dirfy/parser"
+require "dirfy/io"
+require "dirfy/cli"

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: dirfy
+version: !ruby/object:Gem::Version
+  version: 0.1.4
+platform: ruby
+authors:
+- Your Name
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+email:
+- you@example.com
+executables:
+- dirfy
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- Rakefile
+- bin/dirfy
+- lib/dirfy.rb
+- lib/dirfy/cli.rb
+- lib/dirfy/io.rb
+- lib/dirfy/parser.rb
+- lib/dirfy/version.rb
+homepage: https://github.com/ahmedmelhady7/dirfy
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Create directory/file structures from ASCII/Unicode tree diagrams
+test_files: []