concat.rb 1.0.2 → 1.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3750abff2498ac5e9f3ecb6e2218cdc461a8fdf289f9e4829e6bdfd4ad4fd97b
-  data.tar.gz: dee8579f28fe3e4f3b0fcf14b9b21e86e1fa01b0c353931d7a4c5a420492da21
+  metadata.gz: f0c056ff4a28f726096fcfe5fcbb3beb399b59fc02d695cde8f8359e8ab448b8
+  data.tar.gz: f2ca13f24a9289018d8c012c834d5c939410f0310a4eb04d5818371c08294443
 SHA512:
-  metadata.gz: 11dfb98869135d7c1ea9c0276f16ba668c4769f95784d90baecf3211b58ad675c14a2a2ac36fe118bb2cfe85d6eafb244c795249c1a237e323cd1b3176f4132a
-  data.tar.gz: ca88c21d02813873052d67d17f36706044d452a47dfe5652897c075fba76d6934211b2b123de905d5afcd0d2162c7bb20a83cebef734b8c4ce87a10cea63b246
+  metadata.gz: 7a663594927daece9d5067107e7fa626bd67256e0149a120c67f1e81ccee7135e4e14ccb554f8bc09791849873222bdf7d7cd20d06d53c57264d06617008f60c
+  data.tar.gz: 26807147e7dfa8b78331c30dc2ccee7b67c2d4ce665f478ee0871e767de6f112101ffb5faa15c2d26e6d950c3f2a6ac55adf646ac0c173a9941799b163819164

data/.rubocop.yml

@@ -0,0 +1,37 @@
+AllCops:
+  DisabledByDefault: true
+
+  RubyInterpreters:
+    - ruby
+
+  Include:
+    - '**/*.rb'
+    - '.pryrc'
+
+  Exclude:
+    <% Dir.glob("#{__dir__}/*").grep_v(%r{#{__dir__}\/(app|lib)}).each do |dir| %>
+    - <%= dir %>/**/*
+    <% end %>
+    - 'lib/templates/**/*'
+
+Layout/IndentationConsistency:
+  Enabled: true
+  EnforcedStyle: indented_internal_methods
+
+Layout/BlockEndNewline:
+  Enabled: true
+
+Layout/BeginEndAlignment:
+  Enabled: true
+  EnforcedStyleAlignWith: start_of_line
+
+Layout/ElseAlignment:
+  Enabled: true
+
+Layout/DefEndAlignment:
+  Enabled: true
+  EnforcedStyleAlignWith: def
+
+Layout/EmptyLinesAroundAccessModifier:
+  Enabled: true
+  EnforcedStyle: around

data/AGENTS.md

@@ -0,0 +1,55 @@
+# AGENTS.md
+
+## Specifications
+
+**IMPORTANT:** Before implementing any feature, consult the specifications in `specs/README.md`.
+
+- **Assume NOT implemented.** Many specs describe planned features that may not yet exist in the codebase.
+- **Check the codebase first.** Before concluding something is or isn't implemented, search the actual code. Specs describe intent; code describes reality.
+- **Use specs as guidance.** When implementing a feature, follow the design patterns, types, and architecture defined in the relevant spec.
+- **Spec index:** `specs/README.md` lists all specifications organized by category (core, LLM, security, etc.).
+
+## Development Commands
+
+```bash
+# Setup
+bin/setup
+
+# Run all tests
+bin/test
+
+# Run a single test file
+bin/test test/cli_test.rb
+
+# Lint
+bin/rubocop
+
+# Interactive console
+bin/console
+```
+
+## Architecture
+
+concat.rb is a Ruby gem providing two CLI tools for file concatenation and restoration.
+
+### Core Components
+
+- **`Concat::CLI`** (`lib/concat/cli.rb`) - Recursively reads files from directories, outputs contents prefixed with `# File path: <path>` markers. Supports `--extensions` flag for filtering.
+
+- **`Concat::DeconcatCLI`** (`lib/concat/deconcat_cli.rb`) - Parses concatenated output from STDIN, extracts file boundaries via `# File path:` markers, recreates directory structure and writes files.
+
+### Entry Points
+
+Executables in `exe/` instantiate the CLI classes and call `#call(ARGV)`, returning exit codes.
+
+### File Format
+
+The concatenation format uses `# File path: <relative_path>` as a delimiter:
+
+```
+# File path: ./lib/foo.rb
+<file contents>
+
+# File path: ./lib/bar.rb
+<file contents>
+```

data/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

data/Gemfile

@@ -2,7 +2,8 @@
 
 source "https://rubygems.org"
 
-gemspec
+gemspec name: "concat.rb"
+
 
 group :development do
   #gem "minitest", "~> 5.0"

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    mirrorfile (0.1.0)
+    concat.rb (1.1.1)
 
 GEM
   remote: https://rubygems.org/
@@ -45,8 +45,8 @@ PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
+  concat.rb!
   minitest (~> 5.0)
-  mirrorfile!
   rake (~> 13.0)
   rubocop (~> 1.21)
   yard (~> 0.9)

data/bin/rubocop

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+cd "$(dirname "$0")/.."
+
+bundle exec rubocop "$@"

data/bin/test

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+cd "$(dirname "$0")/.."
+
+if [ $# -eq 0 ]; then
+  bundle exec ruby -Itest -e 'Dir.glob("test/**/*_test.rb").each { |f| require "./#{f}" }'
+else
+  bundle exec ruby -Itest "$@"
+fi

data/concat2.gemspec

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require_relative "lib/concat/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "concat"
+  spec.version = Concat::VERSION
+  spec.authors = ["Nathan Kidd"]
+  spec.email = ["nathankidd@hey.com"]
+
+  spec.summary = "Concatenate files from directories with optional extension filtering"
+
+  spec.description = <<~DESC
+    A simple CLI tool that recursively reads files from directories and outputs
+    their contents with file path comments. Supports filtering by file extensions.
+  DESC
+
+  spec.homepage = "https://github.com/n-at-han-k/concat.rb"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.2.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["documentation_uri"] = spec.homepage
+  spec.metadata["rubygems_mfa_required"] = "true"
+
+  spec.files = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features|data)/}) }
+  spec.bindir = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rubocop", "~> 1.21"
+  spec.add_development_dependency "yard", "~> 0.9"
+end

data/lib/concat/cli.rb

@@ -10,7 +10,7 @@ module Concat
       extensions = ""
 
       parser = OptionParser.new do |parse|
-        parse.banner = "Usage: concat FOLDERS... --extensions=rb,py,md"
+        parse.banner = "Usage: concat PATHS... --extensions=rb,py,md"
         parse.on("--extensions=LIST", String, "File extensions to include") do |value|
           extensions = ".{#{value}}"
         end
@@ -24,18 +24,38 @@ module Concat
         return 1
       end
 
-      argv.each do |folder|
-        Dir.glob("#{folder}/**/*#{extensions}").each do |path|
-          if File.file?(path)
-            puts "#{COMMENT} File path: #{path}"
-            puts File.read(path)
-            puts
+      argv.each do |arg|
+        if File.file?(arg)
+          next if binary_file?(arg)
+          puts "#{COMMENT} File path: #{arg}"
+          puts File.read(arg)
+          puts
+        elsif File.directory?(arg)
+          Dir.glob("#{arg}/**/*#{extensions}").each do |path|
+            if File.file?(path) && !binary_file?(path)
+              puts "#{COMMENT} File path: #{path}"
+              puts File.read(path)
+              puts
+            end
           end
+        else
+          warn "concat: #{arg}: No such file or directory"
+          return 1
         end
       end
 
       0
     end
+
+    private
+
+    def binary_file?(path)
+      File.open(path, "rb") do |file|
+        chunk = file.read(8192)
+        return false if chunk.nil?
+        chunk.include?("\x00")
+      end
+    end
   end
 end
 

data/lib/concat/deconcat_cli.rb

@@ -10,7 +10,7 @@ module Concat
 
       ARGF.each_line do |line|
         if line.start_with?("# File path: ")
-          File.write(current_path, content.join) if current_path && !content.empty?
+          File.write(current_path, content.join.chomp) if current_path && !content.empty?
           current_path = line.sub("# File path: ", "").strip
           content = []
           FileUtils.mkdir_p(File.dirname(current_path))
@@ -19,7 +19,7 @@ module Concat
         end
       end
 
-      File.write(current_path, content.join) if current_path && !content.empty?
+      File.write(current_path, content.join.chomp) if current_path && !content.empty?
 
       0
     end

data/lib/concat/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Concat
-  VERSION = "1.0.2"
+  VERSION = "1.1.2"
 end
 

data/specs/README.md

@@ -0,0 +1,31 @@
+<!--
+ Copyright (c) 2025 Nathan Kidd <nathankidd@hey.com>. All rights reserved.
+ SPDX-License-Identifier: Proprietary
+-->
+
+<!--
+  HOW TO MAINTAIN THIS FILE
+
+  This is the index of all design specifications for concat.rb.
+  Each row links a spec document to its implementation code and a short purpose summary.
+
+  When adding a new spec:
+  1. Create the markdown file in this directory (specs/)
+  2. Add a row to the appropriate table section below
+  3. Link the spec file, the code path it describes, and a brief purpose
+
+  Table format:
+    | [spec-name.md](./spec-name.md) | [path/to/code](../path/to/code) | Short description |
+
+  Use "—" in the Code column if the spec has no implementation yet.
+  Group specs under heading sections by domain area.
+-->
+
+# Project Specifications
+
+concat.rb is a CLI tool for concatenating files from directories into a single output with file path markers, and reversing the process.
+
+## Core
+
+| Spec | Code | Purpose |
+|------|------|---------|

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: concat.rb
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.2
 platform: ruby
 authors:
 - Nathan Kidd
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-15 00:00:00.000000000 Z
+date: 2026-03-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -78,20 +78,27 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".github/workflows/gem-push.yml"
+- ".rubocop.yml"
+- AGENTS.md
+- CLAUDE.md
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
 - bin/console
+- bin/rubocop
 - bin/setup
+- bin/test
 - concat.gemspec
+- concat2.gemspec
 - exe/concat
 - exe/deconcat
 - lib/concat.rb
 - lib/concat/cli.rb
 - lib/concat/deconcat_cli.rb
 - lib/concat/version.rb
+- specs/README.md
 homepage: https://github.com/n-at-han-k/concat.rb
 licenses:
 - MIT