poepod 0.1.2 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 74aa4bb662884ffcb18e91baf9e8b25d892fd863218556e80a78ed30e603835d
-  data.tar.gz: 0d8c004bac28b64d0b3cb47732a118b28bca2fdcabb2c7f31ed5d8a574d554b2
+  metadata.gz: db687d7a65f167645bedbabce5082c8d254a70f891b493a7f900a4666b07dfc3
+  data.tar.gz: 159ed36950788d819b870a2f8d5e8d1e7c26103cdadc11702073bca959885711
 SHA512:
-  metadata.gz: b21d65bed30d5eaf4ae15f29434d94cd25546ba69f72c00c01c89aacbe7e9c17b0cf38560a5e9620bfa6b3c1b59eb0ec0caa4e9b74f23290cb7fd6e050803957
-  data.tar.gz: 9b1313031ed40252c18d8db8f17b72bb67deefd114964eec56beb52cb7493e5a794746f54eeb086d9774ec1777d6fdb5cf5462badff62bc72bbe71a51c17358d
+  metadata.gz: 53e110b148f0e78e7f9c257f18619f4c5718d01d390c8a604fd9a928349a25ca8840a26ac6130dc793f7687783732d360100c96195b88f83a2af20b58bed7723
+  data.tar.gz: 007e29ab64c3c3984aaef34a700fe3384c97d3f784f93cda466d8335252b979829b0373d7802737990bf8e65c618fa2e00fd46970a2345e57c35a24a33ddc05d

data/.github/workflows/rake.yml

@@ -1,5 +1,3 @@
-# Auto-generated by Cimas: Do not edit it manually!
-# See https://github.com/metanorma/cimas
 name: rake
 
 on:
@@ -7,9 +5,8 @@ on:
     branches: [ master, main ]
     tags: [ v* ]
   pull_request:
+  workflow_dispatch:
 
 jobs:
   rake:
     uses: metanorma/ci/.github/workflows/generic-rake.yml@main
-    secrets:
-      pat_token: ${{ secrets.METANORMA_CI_PAT_TOKEN }}

data/.github/workflows/release.yml

@@ -1,5 +1,3 @@
-# Auto-generated by Cimas: Do not edit it manually!
-# See https://github.com/metanorma/cimas
 name: release
 
 on:
@@ -10,8 +8,8 @@ on:
           Next release version. Possible values: x.y.z, major, minor, patch or pre|rc|etc
         required: true
         default: 'skip'
-  repository_dispatch:
-    types: [ do-release ]
+  push:
+    tags: [ v* ]
 
 jobs:
   release:
@@ -19,5 +17,6 @@ jobs:
     with:
       next_version: ${{ github.event.inputs.next_version }}
     secrets:
-      rubygems-api-key: ${{ secrets.METANORMA_CI_RUBYGEMS_API_KEY }}
-      pat_token: ${{ secrets.METANORMA_CI_PAT_TOKEN }}
+      rubygems-api-key: ${{ secrets.RIBOSE_RUBYGEMS_API_KEY }}
+      pat_token: ${{ secrets.RIBOSE_CI_PAT_TOKEN }}
+

data/README.adoc

@@ -1,7 +1,10 @@
 = Poepod
 
-Poepod is a Ruby gem that provides functionality to concatenate code files from
-a directory into one text file for analysis by Poe.
+Poepod is a Ruby gem that streamlines the process of preparing code for analysis
+by Poe. It offers two main features: concatenating multiple files into a single
+text file, and wrapping gem contents including unstaged files. These features
+are particularly useful for developers who want to quickly gather code for
+review, analysis, or submission to AI-powered coding assistants.
 
 == Installation
 
@@ -28,49 +31,102 @@ $ gem install poepod
 
 == Usage
 
-After installation, you can use the `poepod` command line tool to concatenate
-code files:
+After installation, you can use the `poepod` command line tool:
 
 [source,shell]
 ----
 $ poepod help
 Commands:
-  poepod concat DIRECTORY OUTPUT_FILE  # Concatenate code from a directory into one text file
-  poepod help [COMMAND]                # Describe available commands or one specific command
+  poepod concat FILES [OUTPUT_FILE]  # Concatenate specified files into one text file
+  poepod help [COMMAND]              # Describe available commands or one specific command
+  poepod wrap GEMSPEC_PATH           # Wrap a gem based on its gemspec file
+----
+
+=== Concatenating files
+
+The `concat` command allows you to combine multiple files into a single text
+file. This is particularly useful when you want to review or analyze code from
+multiple files in one place, or when preparing code submissions for AI-powered
+coding assistants.
+
+[source,shell]
+----
+$ poepod concat path/to/files/* output.txt
+----
+
+This will concatenate all files from the specified path into `output.txt`.
+
+==== Excluding patterns
+
+You can exclude certain patterns using the `--exclude` option:
+
+[source,shell]
+----
+$ poepod concat path/to/files/* output.txt --exclude node_modules .git build test
+----
+
+This is helpful when you want to focus on specific parts of your codebase,
+excluding irrelevant or large directories.
 
-$ poepod help concat
-Usage:
-  poepod concat DIRECTORY OUTPUT_FILE
+==== Including binary files
 
-Options:
-  [--exclude=one two three]  # List of patterns to exclude
-                             # Default: "node_modules/" ".git/" "build" "test" ".gitignore" ".DS_Store" "*.jpg" "*.jpeg" "*.png" "*.svg" "*.gif" "*.exe" "*.dll" "*.so" "*.bin" "*.o" "*.a"
-  [--config=CONFIG]          # Path to configuration file
+By default, binary files are excluded to keep the output focused on readable
+code. However, you can include binary files (encoded in MIME format) using the
+`--include-binary` option:
 
-Concatenate code from a directory into one text file
+[source,shell]
+----
+$ poepod concat path/to/files/* output.txt --include-binary
 ----
 
-For example:
+This can be useful when you need to include binary assets or compiled files in
+your analysis.
+
+=== Wrapping a gem
+
+The `wrap` command creates a comprehensive snapshot of your gem, including all
+files specified in the gemspec and README files. This is particularly useful for
+gem developers who want to review their entire gem contents or prepare it for
+submission to code review tools.
 
 [source,shell]
 ----
-$ poepod concat my_project
-# => concatenated into my_project.txt
+$ poepod wrap path/to/your_gem.gemspec
 ----
 
-This will concatenate all code files from the specified directory into `output.txt`.
+This will create a file named `your_gem_wrapped.txt` containing all the files
+specified in the gemspec, including README files.
+
+==== Handling unstaged files
 
-You can also exclude certain directories or files by using the `--exclude` option:
+By default, unstaged files in the `lib/`, `spec/`, and `test/` directories are
+not included in the wrap, but they will be listed as a warning. This default
+behavior ensures that the wrapped content matches what's currently tracked in
+your version control system.
+
+However, there are cases where including unstaged files can be beneficial:
+
+. When you're actively developing and want to include recent changes that
+haven't been committed yet.
+
+. When you're seeking feedback on work-in-progress code.
+
+. When you want to ensure you're not missing any important files in your commit.
+
+To include these unstaged files in the wrap:
 
 [source,shell]
 ----
-$ poepod concat my_project output.txt --exclude node_modules .git build test .gitignore .DS_Store .jpg .png .svg
+$ poepod wrap path/to/your_gem.gemspec --include-unstaged
 ----
 
+This option allows you to capture a true snapshot of your gem's current state,
+including any work in progress.
+
 == Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run
-`rake test` to run the tests. You can also run `bin/console` for an interactive
+`rake spec` to run the tests. You can also run `bin/console` for an interactive
 prompt that will allow you to experiment.
 
 To install this gem onto your local machine, run `bundle exec rake install`. To
@@ -81,4 +137,5 @@ https://rubygems.org.
 
 == Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/riboseinc/poepod.
+Bug reports and pull requests are welcome on GitHub at https://github.com/riboseinc/poepod.
+Please adhere to the link:CODE_OF_CONDUCT.md[code of conduct].

data/lib/poepod/cli.rb

@@ -1,30 +1,72 @@
 # frozen_string_literal: true
 
+# lib/poepod/cli.rb
 require "thor"
-require_relative "processor"
+require_relative "file_processor"
+require_relative "gem_processor"
 
 module Poepod
   class Cli < Thor
-    desc "concat DIRECTORY OUTPUT_FILE", "Concatenate code from a directory into one text file"
-    option :exclude, type: :array, default: Poepod::Processor::EXCLUDE_DEFAULT, desc: "List of patterns to exclude"
+    desc "concat FILES [OUTPUT_FILE]", "Concatenate specified files into one text file"
+    option :exclude, type: :array, default: Poepod::FileProcessor::EXCLUDE_DEFAULT, desc: "List of patterns to exclude"
     option :config, type: :string, desc: "Path to configuration file"
+    option :include_binary, type: :boolean, default: false, desc: "Include binary files (encoded in MIME format)"
 
-    def concat(directory, output_file = nil)
-      dir_path = Pathname.new(directory)
+    def concat(*files, output_file: nil)
+      if files.empty?
+        puts "Error: No files specified."
+        exit(1)
+      end
 
-      dir_path = dir_path.expand_path unless dir_path.absolute?
+      output_file ||= default_output_file(files.first)
+      output_path = Pathname.new(output_file).expand_path
 
-      output_file ||= "#{dir_path.basename}.txt"
-      output_path = dir_path.dirname.join(output_file)
-      processor = Poepod::Processor.new(options[:config])
-      total_files, copied_files = processor.write_directory_structure_to_file(directory, output_path, options[:exclude])
+      processor = Poepod::FileProcessor.new(files, output_path, options[:config], options[:include_binary])
+      total_files, copied_files = processor.process
 
-      puts "-> #{total_files} files detected in the #{dir_path.relative_path_from(Dir.pwd)} directory."
-      puts "=> #{copied_files} files have been concatenated into #{Pathname.new(output_path).relative_path_from(Dir.pwd)}."
+      puts "-> #{total_files} files detected."
+      puts "=> #{copied_files} files have been concatenated into #{output_path.relative_path_from(Dir.pwd)}."
+    end
+
+    desc "wrap GEMSPEC_PATH", "Wrap a gem based on its gemspec file"
+    option :include_unstaged, type: :boolean, default: false,
+                              desc: "Include unstaged files from lib, spec, and test directories"
+
+    def wrap(gemspec_path)
+      processor = Poepod::GemProcessor.new(gemspec_path, nil, options[:include_unstaged])
+      success, result, unstaged_files = processor.process
+
+      if success
+        puts "=> The gem has been wrapped into '#{result}'."
+        if unstaged_files.any?
+          puts "\nWarning: The following files are not staged in git:"
+          puts unstaged_files
+          puts "\nThese files are #{options[:include_unstaged] ? "included" : "not included"} in the wrap."
+          puts "Use --include-unstaged option to include these files." unless options[:include_unstaged]
+        end
+      else
+        puts result
+        exit(1)
+      end
     end
 
     def self.exit_on_failure?
       true
     end
+
+    private
+
+    def default_output_file(first_pattern)
+      first_item = Dir.glob(first_pattern).first
+      if first_item
+        if File.directory?(first_item)
+          "#{File.basename(first_item)}.txt"
+        else
+          "#{File.basename(first_item, ".*")}_concat.txt"
+        end
+      else
+        "concatenated_output.txt"
+      end
+    end
   end
 end

data/lib/poepod/file_processor.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require_relative "processor"
+require "yaml"
+require "tqdm"
+require "pathname"
+require "open3"
+require "base64"
+require "mime/types"
+
+module Poepod
+  class FileProcessor < Processor
+    EXCLUDE_DEFAULT = [
+      %r{node_modules/}, %r{.git/}, /.gitignore$/, /.DS_Store$/
+    ].freeze
+
+    def initialize(files, output_file, config_file = nil, include_binary = false)
+      super(config_file)
+      @files = files
+      @output_file = output_file
+      @failed_files = []
+      @include_binary = include_binary
+    end
+
+    def process
+      total_files = 0
+      copied_files = 0
+
+      File.open(@output_file, "w", encoding: "utf-8") do |output|
+        @files.each do |file|
+          Dir.glob(file).each do |matched_file|
+            next unless File.file?(matched_file)
+
+            total_files += 1
+            file_path, content, error = process_file(matched_file)
+            if content
+              output.puts "--- START FILE: #{file_path} ---"
+              output.puts content
+              output.puts "--- END FILE: #{file_path} ---"
+              copied_files += 1
+            elsif error
+              output.puts "#{file_path}\n#{error}"
+            end
+          end
+        end
+      end
+
+      [total_files, copied_files]
+    end
+
+    private
+
+    def process_file(file_path)
+      if text_file?(file_path)
+        content = File.read(file_path, encoding: "utf-8")
+        [file_path, content, nil]
+      elsif @include_binary
+        content = encode_binary_file(file_path)
+        [file_path, content, nil]
+      else
+        [file_path, nil, "Skipped binary file"]
+      end
+    rescue Encoding::InvalidByteSequenceError, Encoding::UndefinedConversionError
+      @failed_files << file_path
+      [file_path, nil, "Failed to decode the file, as it is not saved with UTF-8 encoding."]
+    end
+
+    def text_file?(file_path)
+      stdout, status = Open3.capture2("file", "-b", "--mime-type", file_path)
+      status.success? && stdout.strip.start_with?("text/")
+    end
+
+    def encode_binary_file(file_path)
+      mime_type = MIME::Types.type_for(file_path).first.content_type
+      encoded_content = Base64.strict_encode64(File.binread(file_path))
+      "Content-Type: #{mime_type}\nContent-Transfer-Encoding: base64\n\n#{encoded_content}"
+    end
+  end
+end

data/lib/poepod/gem_processor.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+# lib/poepod/gem_processor.rb
+require_relative "processor"
+require "rubygems/specification"
+require "git"
+
+module Poepod
+  class GemProcessor < Processor
+    def initialize(gemspec_path, config_file = nil, include_unstaged = false)
+      super(config_file)
+      @gemspec_path = gemspec_path
+      @include_unstaged = include_unstaged
+    end
+
+    def process
+      unless File.exist?(@gemspec_path)
+        return [false, "Error: The specified gemspec file '#{@gemspec_path}' does not exist."]
+      end
+
+      begin
+        spec = Gem::Specification.load(@gemspec_path)
+      rescue StandardError => e
+        return [false, "Error loading gemspec: #{e.message}"]
+      end
+
+      gem_name = spec.name
+      output_file = "#{gem_name}_wrapped.txt"
+      unstaged_files = check_unstaged_files
+
+      File.open(output_file, "w") do |file|
+        file.puts "# Wrapped Gem: #{gem_name}"
+        file.puts "## Gemspec: #{File.basename(@gemspec_path)}"
+
+        if unstaged_files.any?
+          file.puts "\n## Warning: Unstaged Files"
+          file.puts unstaged_files.join("\n")
+          file.puts "\nThese files are not included in the wrap unless --include-unstaged option is used."
+        end
+
+        file.puts "\n## Files:\n"
+
+        files_to_include = (spec.files + spec.test_files + find_readme_files).uniq
+        files_to_include += unstaged_files if @include_unstaged
+
+        files_to_include.uniq.each do |relative_path|
+          full_path = File.join(File.dirname(@gemspec_path), relative_path)
+          next unless File.file?(full_path)
+
+          file.puts "--- START FILE: #{relative_path} ---"
+          file.puts File.read(full_path)
+          file.puts "--- END FILE: #{relative_path} ---\n\n"
+        end
+      end
+
+      [true, output_file, unstaged_files]
+    end
+
+    private
+
+    def find_readme_files
+      Dir.glob(File.join(File.dirname(@gemspec_path), "README*"))
+         .map { |path| Pathname.new(path).relative_path_from(Pathname.new(File.dirname(@gemspec_path))).to_s }
+    end
+
+    def check_unstaged_files
+      gem_root = File.dirname(@gemspec_path)
+      git = Git.open(gem_root)
+
+      untracked_files = git.status.untracked.keys
+      modified_files = git.status.changed.keys
+
+      (untracked_files + modified_files).select do |file|
+        file.start_with?("lib/", "spec/", "test/")
+      end
+    rescue Git::GitExecuteError => e
+      warn "Git error: #{e.message}. Assuming no unstaged files."
+      []
+    end
+  end
+end

data/lib/poepod/processor.rb

@@ -1,20 +1,9 @@
 # frozen_string_literal: true
 
-require "yaml"
-require "tqdm"
-require "pathname"
-
+# lib/poepod/processor.rb
 module Poepod
   class Processor
-    EXCLUDE_DEFAULT = [
-      /node_modules\//, /.git\//, /.gitignore$/, /.DS_Store$/,
-      /.jpg$/, /.jpeg$/, /.png/, /.svg$/, /.gif$/,
-      /.exe$/, /.dll$/, /.so$/, /.bin$/, /.o$/, /.a$/, /.gem$/, /.cap$/,
-      /.zip$/,
-    ].freeze
-
     def initialize(config_file = nil)
-      @failed_files = []
       @config = load_config(config_file)
     end
 
@@ -26,61 +15,8 @@ module Poepod
       end
     end
 
-    def process_file(file_path)
-      content = File.read(file_path, encoding: "utf-8")
-      [file_path, content, nil]
-    rescue Encoding::InvalidByteSequenceError, Encoding::UndefinedConversionError
-      @failed_files << file_path
-      [file_path, nil, "Failed to decode the file, as it is not saved with UTF-8 encoding."]
-    end
-
-    def gather_files(directory_path, exclude)
-      exclude += @config["exclude"] if @config["exclude"]
-      exclude_pattern = Regexp.union(exclude.map { |ex| Regexp.new(ex) })
-
-      Dir.glob("#{directory_path}/**/*").reject do |file_path|
-        File.directory?(file_path) || file_path.match?(exclude_pattern)
-      end.map do |file_path|
-        Pathname.new(file_path).expand_path.to_s
-      end
-    end
-
-    def write_results_to_file(results, output_file)
-      results.each_with_index do |(file_path, content, error), index|
-        relative = relative_path(file_path)
-        if content
-          output_file.puts "--- START FILE: #{relative} ---"
-          output_file.puts content
-          output_file.puts "--- END FILE: #{relative} ---"
-        elsif error
-          output_file.puts "#{relative}\n#{error}"
-        end
-        output_file.puts if index < results.size - 1 # Add a newline between files
-      end
-    end
-
-    def relative_path(file_path)
-      Pathname.new(file_path).relative_path_from(Dir.pwd)
-    end
-
-    def write_directory_structure_to_file(directory_path, output_file_name, exclude = EXCLUDE_DEFAULT)
-      dir_path = Pathname.new(directory_path)
-
-      dir_path = dir_path.expand_path unless dir_path.absolute?
-
-      file_list = gather_files(dir_path, exclude)
-      total_files = file_list.size
-
-      File.open(output_file_name, "w", encoding: "utf-8") do |output_file|
-        results = file_list.tqdm(desc: "Progress", unit: " file").map do |file|
-          process_file(file)
-        end
-        write_results_to_file(results, output_file)
-      end
-
-      copied_files = total_files - @failed_files.size
-
-      [total_files, copied_files]
+    def process
+      raise NotImplementedError, "Subclasses must implement the 'process' method"
     end
   end
 end

data/lib/poepod/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Poepod
-  VERSION = "0.1.2"
+  VERSION = "0.1.5"
 end

data/poepod.gemspec

@@ -16,10 +16,6 @@ Gem::Specification.new do |spec|
   spec.homepage = "https://github.com/riboseinc/poepod"
   spec.license = "BSD-2-Clause"
 
-  spec.bindir = "bin"
-  spec.require_paths = ["lib"]
-  spec.files = `git ls-files`.split("\n")
-  spec.test_files = `git ls-files -- {spec}/*`.split("\n")
   spec.required_ruby_version = Gem::Requirement.new(">= 3.0.0")
 
   # Specify which files should be added to the gem when it is released.
@@ -32,10 +28,14 @@ Gem::Specification.new do |spec|
   spec.bindir = "exe"
   spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
+  spec.test_files = `git ls-files -- spec/*`.split("\n")
 
+  spec.add_runtime_dependency "git", "~> 1.11"
+  spec.add_runtime_dependency "mime-types", "~> 3.3"
   spec.add_runtime_dependency "parallel", "~> 1.20"
   spec.add_runtime_dependency "thor", "~> 1.0"
   spec.add_runtime_dependency "tqdm"
+
   spec.add_development_dependency "rake"
   spec.add_development_dependency "rspec"
   spec.add_development_dependency "rubocop"

data/spec/poepod/cli_spec.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+require "poepod/cli"
+
+RSpec.describe Poepod::Cli do
+  let(:cli) { described_class.new }
+
+  describe "#concat" do
+    let(:temp_dir) { Dir.mktmpdir }
+    let(:text_file) { File.join(temp_dir, "text_file.txt") }
+    let(:binary_file) { File.join(temp_dir, "binary_file.bin") }
+
+    before do
+      File.write(text_file, "Hello, World!")
+      File.write(binary_file, [0xFF, 0xD8, 0xFF, 0xE0].pack("C*"))
+    end
+
+    after do
+      FileUtils.remove_entry(temp_dir)
+    end
+
+    it "concatenates text files" do
+      output_file = File.join(temp_dir, "output.txt")
+      expect { cli.concat(text_file, output_file: output_file) }.to output(/1 files detected/).to_stdout
+      expect(File.exist?(output_file)).to be true
+      expect(File.read(output_file)).to include("Hello, World!")
+    end
+
+    it "excludes binary files by default" do
+      output_file = File.join(temp_dir, "output.txt")
+      expect do
+        cli.concat(text_file, binary_file,
+                   output_file: output_file)
+      end.to output(/-> 2 files detected\.\n=> 1 files have been concatenated into.*\.txt/).to_stdout
+    end
+
+    it "includes binary files when specified" do
+      output_file = File.join(temp_dir, "output.txt")
+      expect do
+        cli.invoke(:concat, [text_file, binary_file], output_file: output_file,
+                                                      include_binary: true)
+      end.to output(/-> 2 files detected\.\n=> 2 files have been concatenated into.*\.txt/).to_stdout
+    end
+  end
+
+  describe "#wrap" do
+    let(:temp_dir) { Dir.mktmpdir }
+    let(:gemspec_file) { File.join(temp_dir, "test_gem.gemspec") }
+
+    before do
+      File.write(gemspec_file, <<~GEMSPEC)
+        Gem::Specification.new do |spec|
+          spec.name = "test_gem"
+          spec.version = "0.1.0"
+          spec.authors = ["Test Author"]
+          spec.files = ["lib/test_gem.rb"]
+        end
+      GEMSPEC
+
+      FileUtils.mkdir_p(File.join(temp_dir, "lib"))
+      File.write(File.join(temp_dir, "lib/test_gem.rb"), "puts 'Hello from test_gem'")
+
+      # Mock Git operations
+      allow(Git).to receive(:open).and_return(double(status: double(untracked: {}, changed: {})))
+    end
+
+    after do
+      FileUtils.remove_entry(temp_dir)
+    end
+
+    it "wraps a gem" do
+      expect { cli.wrap(gemspec_file) }.to output(/The gem has been wrapped into/).to_stdout
+      output_file = File.join(Dir.pwd, "test_gem_wrapped.txt")
+      expect(File.exist?(output_file)).to be true
+      content = File.read(output_file)
+      expect(content).to include("# Wrapped Gem: test_gem")
+      expect(content).to include("## Gemspec: test_gem.gemspec")
+      expect(content).to include("--- START FILE: lib/test_gem.rb ---")
+      expect(content).to include("puts 'Hello from test_gem'")
+      expect(content).to include("--- END FILE: lib/test_gem.rb ---")
+    end
+
+    it "handles non-existent gemspec" do
+      expect do
+        cli.wrap("non_existent.gemspec")
+      end.to output(/Error: The specified gemspec file/).to_stdout.and raise_error(SystemExit)
+    end
+  end
+end

data/spec/poepod/file_processor_spec.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+# spec/poepod/file_processor_spec.rb
+require "spec_helper"
+require "poepod/file_processor"
+require "tempfile"
+
+RSpec.describe Poepod::FileProcessor do
+  let(:temp_dir) { Dir.mktmpdir }
+  let(:output_file) { Tempfile.new("output.txt") }
+  let(:text_file1) { File.join(temp_dir, "file1.txt") }
+  let(:text_file2) { File.join(temp_dir, "file2.txt") }
+  let(:binary_file) { File.join(temp_dir, "binary_file.bin") }
+
+  before do
+    File.write(text_file1, "Content of file1.\n")
+    File.write(text_file2, "Content of file2.\n")
+    File.write(binary_file, [0xFF, 0xD8, 0xFF, 0xE0].pack("C*"))
+  end
+
+  after do
+    FileUtils.remove_entry(temp_dir)
+    output_file.unlink
+  end
+
+  let(:processor) { described_class.new([text_file1, text_file2], output_file.path) }
+
+  describe "#process" do
+    it "processes text files and writes them to the output file" do
+      total_files, copied_files = processor.process
+      expect(total_files).to eq(2)
+      expect(copied_files).to eq(2)
+
+      output_content = File.read(output_file.path, encoding: "utf-8")
+      expected_content = <<~TEXT
+        --- START FILE: #{text_file1} ---
+        Content of file1.
+        --- END FILE: #{text_file1} ---
+        --- START FILE: #{text_file2} ---
+        Content of file2.
+        --- END FILE: #{text_file2} ---
+      TEXT
+      expect(output_content).to eq(expected_content)
+    end
+  end
+
+  describe "#process_file" do
+    it "reads the content of a file" do
+      file_path, content, error = processor.send(:process_file, text_file1)
+      expect(file_path).to eq(text_file1)
+      expect(content).to eq("Content of file1.\n")
+      expect(error).to be_nil
+    end
+
+    it "handles encoding errors gracefully" do
+      allow(File).to receive(:read).and_raise(Encoding::InvalidByteSequenceError)
+      file_path, content, error = processor.send(:process_file, text_file1)
+      expect(file_path).to eq(text_file1)
+      expect(content).to be_nil
+      expect(error).to eq("Failed to decode the file, as it is not saved with UTF-8 encoding.")
+    end
+  end
+end

data/spec/poepod/gem_processor_spec.rb

@@ -0,0 +1,158 @@
+# frozen_string_literal: true
+
+# spec/poepod/gem_processor_spec.rb
+require "spec_helper"
+require "poepod/gem_processor"
+require "tempfile"
+
+RSpec.describe Poepod::GemProcessor do
+  let(:temp_dir) { Dir.mktmpdir }
+  let(:gemspec_file) { File.join(temp_dir, "test_gem.gemspec") }
+
+  before do
+    File.write(gemspec_file, <<~GEMSPEC)
+      Gem::Specification.new do |spec|
+        spec.name = "test_gem"
+        spec.version = "0.1.0"
+        spec.authors = ["Test Author"]
+        spec.files = ["lib/test_gem.rb"]
+        spec.test_files = ["spec/test_gem_spec.rb"]
+      end
+    GEMSPEC
+
+    FileUtils.mkdir_p(File.join(temp_dir, "lib"))
+    FileUtils.mkdir_p(File.join(temp_dir, "spec"))
+    File.write(File.join(temp_dir, "lib/test_gem.rb"), "puts 'Hello from test_gem'")
+    File.write(File.join(temp_dir, "spec/test_gem_spec.rb"), "RSpec.describe TestGem do\nend")
+    File.write(File.join(temp_dir, "README.md"), "# Test Gem\n\nThis is a test gem.")
+    File.write(File.join(temp_dir, "README.txt"), "Test Gem\n\nThis is a test gem in plain text.")
+  end
+
+  after do
+    FileUtils.remove_entry(temp_dir)
+  end
+
+  describe "#process" do
+    let(:processor) { described_class.new(gemspec_file) }
+
+    before do
+      # Mock Git operations
+      allow(Git).to receive(:open).and_return(double(status: double(untracked: {}, changed: {})))
+    end
+
+    it "processes the gem files, includes README files, and spec files" do
+      success, output_file = processor.process
+      expect(success).to be true
+      expect(File.exist?(output_file)).to be true
+
+      content = File.read(output_file)
+      expect(content).to include("# Wrapped Gem: test_gem")
+      expect(content).to include("## Gemspec: test_gem.gemspec")
+      expect(content).to include("--- START FILE: lib/test_gem.rb ---")
+      expect(content).to include("puts 'Hello from test_gem'")
+      expect(content).to include("--- END FILE: lib/test_gem.rb ---")
+      expect(content).to include("--- START FILE: spec/test_gem_spec.rb ---")
+      expect(content).to include("RSpec.describe TestGem do")
+      expect(content).to include("--- END FILE: spec/test_gem_spec.rb ---")
+      expect(content).to include("--- START FILE: README.md ---")
+      expect(content).to include("# Test Gem\n\nThis is a test gem.")
+      expect(content).to include("--- END FILE: README.md ---")
+      expect(content).to include("--- START FILE: README.txt ---")
+      expect(content).to include("Test Gem\n\nThis is a test gem in plain text.")
+      expect(content).to include("--- END FILE: README.txt ---")
+    end
+
+    context "with non-existent gemspec" do
+      let(:processor) { described_class.new("non_existent.gemspec") }
+
+      it "returns an error" do
+        success, error_message = processor.process
+        expect(success).to be false
+        expect(error_message).to include("Error: The specified gemspec file")
+      end
+    end
+
+    context "with unstaged files" do
+      let(:mock_git) { instance_double(Git::Base) }
+      let(:mock_status) { instance_double(Git::Status) }
+
+      before do
+        allow(Git).to receive(:open).and_return(mock_git)
+        allow(mock_git).to receive(:status).and_return(mock_status)
+        allow(mock_status).to receive(:untracked).and_return({ "lib/unstaged_file.rb" => "??" })
+        allow(mock_status).to receive(:changed).and_return({})
+      end
+
+      it "warns about unstaged files" do
+        success, output_file, unstaged_files = processor.process
+        expect(success).to be true
+        expect(unstaged_files).to eq(["lib/unstaged_file.rb"])
+
+        content = File.read(output_file)
+        expect(content).to include("## Warning: Unstaged Files")
+        expect(content).to include("lib/unstaged_file.rb")
+      end
+
+      context "with include_unstaged option" do
+        let(:processor) { described_class.new(gemspec_file, nil, true) }
+
+        it "includes unstaged files" do
+          allow(File).to receive(:file?).and_return(true)
+
+          # Create a hash to store file contents
+          file_contents = {
+            "lib/test_gem.rb" => "puts 'Hello from test_gem'",
+            "spec/test_gem_spec.rb" => "RSpec.describe TestGem do\nend",
+            "README.md" => "# Test Gem\n\nThis is a test gem.",
+            "README.txt" => "Test Gem\n\nThis is a test gem in plain text.",
+            "lib/unstaged_file.rb" => "Unstaged content"
+          }
+
+          # Mock File.read
+          allow(File).to receive(:read) do |path|
+            file_name = File.basename(path)
+            if file_contents.key?(file_name)
+              file_contents[file_name]
+            elsif path.end_with?("_wrapped.txt")
+              # This is the output file, so we'll construct its content here
+              wrapped_content = "# Wrapped Gem: test_gem\n"
+              wrapped_content += "## Gemspec: test_gem.gemspec\n\n"
+              wrapped_content += "## Warning: Unstaged Files\n"
+              wrapped_content += "lib/unstaged_file.rb\n\n"
+              wrapped_content += "## Files:\n\n"
+              file_contents.each do |file, content|
+                wrapped_content += "--- START FILE: #{file} ---\n"
+                wrapped_content += "#{content}\n"
+                wrapped_content += "--- END FILE: #{file} ---\n\n"
+              end
+              wrapped_content
+            else
+              "Default content for #{path}"
+            end
+          end
+
+          success, output_file, unstaged_files = processor.process
+          expect(success).to be true
+          expect(unstaged_files).to eq(["lib/unstaged_file.rb"])
+
+          content = File.read(output_file)
+          expect(content).to include("--- START FILE: lib/test_gem.rb ---")
+          expect(content).to include("puts 'Hello from test_gem'")
+          expect(content).to include("--- END FILE: lib/test_gem.rb ---")
+          expect(content).to include("--- START FILE: spec/test_gem_spec.rb ---")
+          expect(content).to include("RSpec.describe TestGem do")
+          expect(content).to include("--- END FILE: spec/test_gem_spec.rb ---")
+          expect(content).to include("--- START FILE: README.md ---")
+          expect(content).to include("# Test Gem\n\nThis is a test gem.")
+          expect(content).to include("--- END FILE: README.md ---")
+          expect(content).to include("--- START FILE: README.txt ---")
+          expect(content).to include("Test Gem\n\nThis is a test gem in plain text.")
+          expect(content).to include("--- END FILE: README.txt ---")
+          expect(content).to include("--- START FILE: lib/unstaged_file.rb ---")
+          expect(content).to include("Unstaged content")
+          expect(content).to include("--- END FILE: lib/unstaged_file.rb ---")
+        end
+      end
+    end
+  end
+end

data/spec/poepod_spec.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+RSpec.describe Poepod do
+  it "has a version number" do
+    expect(Poepod::VERSION).not_to be nil
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require "poepod"
+require "fileutils"
+
+RSpec.configure do |config|
+  # Enable flags like --only-failures and --next-failure
+  config.example_status_persistence_file_path = ".rspec_status"
+
+  # Disable RSpec exposing methods globally on `Module` and `main`
+  config.disable_monkey_patching!
+
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+end

data/spec/support/test_files/file1.txt

@@ -0,0 +1 @@
+Content of file1.

data/spec/support/test_files/file2.txt

@@ -0,0 +1 @@
+Content of file2.

metadata

@@ -1,15 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: poepod
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.5
 platform: ruby
 authors:
 - Ribose Inc.
-autorequire:
+autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-06-12 00:00:00.000000000 Z
+date: 2024-07-22 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: git
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+- !ruby/object:Gem::Dependency
+  name: mime-types
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
 - !ruby/object:Gem::Dependency
   name: parallel
   requirement: !ruby/object:Gem::Requirement
@@ -139,7 +167,6 @@ files:
 - ".rubocop.yml"
 - CODE_OF_CONDUCT.md
 - Gemfile
-- Gemfile.lock
 - README.adoc
 - Rakefile
 - bin/console
@@ -147,15 +174,24 @@ files:
 - exe/poepod
 - lib/poepod.rb
 - lib/poepod/cli.rb
+- lib/poepod/file_processor.rb
+- lib/poepod/gem_processor.rb
 - lib/poepod/processor.rb
 - lib/poepod/version.rb
 - poepod.gemspec
 - sig/poepod.rbs
+- spec/poepod/cli_spec.rb
+- spec/poepod/file_processor_spec.rb
+- spec/poepod/gem_processor_spec.rb
+- spec/poepod_spec.rb
+- spec/spec_helper.rb
+- spec/support/test_files/file1.txt
+- spec/support/test_files/file2.txt
 homepage: https://github.com/riboseinc/poepod
 licenses:
 - BSD-2-Clause
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -170,8 +206,15 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
-signing_key:
+rubygems_version: 3.3.27
+signing_key: 
 specification_version: 4
 summary: Utilities for uploading code to Poe
-test_files: []
+test_files:
+- spec/poepod/cli_spec.rb
+- spec/poepod/file_processor_spec.rb
+- spec/poepod/gem_processor_spec.rb
+- spec/poepod_spec.rb
+- spec/spec_helper.rb
+- spec/support/test_files/file1.txt
+- spec/support/test_files/file2.txt

data/Gemfile.lock

@@ -1,101 +0,0 @@
-PATH
-  remote: .
-  specs:
-    poepod (0.1.0)
-      parallel (~> 1.20)
-      thor (~> 1.0)
-      tqdm
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    activesupport (7.1.3.4)
-      base64
-      bigdecimal
-      concurrent-ruby (~> 1.0, >= 1.0.2)
-      connection_pool (>= 2.2.5)
-      drb
-      i18n (>= 1.6, < 2)
-      minitest (>= 5.1)
-      mutex_m
-      tzinfo (~> 2.0)
-    ast (2.4.2)
-    base64 (0.2.0)
-    bigdecimal (3.1.8)
-    concurrent-ruby (1.3.3)
-    connection_pool (2.4.1)
-    diff-lcs (1.5.1)
-    drb (2.2.1)
-    i18n (1.14.5)
-      concurrent-ruby (~> 1.0)
-    json (2.7.2)
-    language_server-protocol (3.17.0.3)
-    minitest (5.23.1)
-    mutex_m (0.2.0)
-    parallel (1.25.1)
-    parser (3.3.2.0)
-      ast (~> 2.4.1)
-      racc
-    racc (1.8.0)
-    rack (3.1.3)
-    rainbow (3.1.1)
-    rake (13.2.1)
-    regexp_parser (2.9.2)
-    rexml (3.3.0)
-      strscan
-    rspec (3.13.0)
-      rspec-core (~> 3.13.0)
-      rspec-expectations (~> 3.13.0)
-      rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.0)
-      rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.0)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.1)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-support (3.13.1)
-    rubocop (1.64.1)
-      json (~> 2.3)
-      language_server-protocol (>= 3.17.0)
-      parallel (~> 1.10)
-      parser (>= 3.3.0.2)
-      rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
-      rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.31.1, < 2.0)
-      ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.31.3)
-      parser (>= 3.3.1.0)
-    rubocop-performance (1.21.0)
-      rubocop (>= 1.48.1, < 2.0)
-      rubocop-ast (>= 1.31.1, < 2.0)
-    rubocop-rails (2.25.0)
-      activesupport (>= 4.2.0)
-      rack (>= 1.1)
-      rubocop (>= 1.33.0, < 2.0)
-      rubocop-ast (>= 1.31.1, < 2.0)
-    ruby-progressbar (1.13.0)
-    strscan (3.1.0)
-    thor (1.3.1)
-    tqdm (0.4.1)
-    tzinfo (2.0.6)
-      concurrent-ruby (~> 1.0)
-    unicode-display_width (2.5.0)
-
-PLATFORMS
-  arm64-darwin-23
-  ruby
-
-DEPENDENCIES
-  poepod!
-  rake
-  rspec
-  rubocop
-  rubocop-performance
-  rubocop-rails
-
-BUNDLED WITH
-   2.5.11