nacha 0.1.18 → 0.2.00

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e12fa57ffdd8c85b2b84a29ef356879f3fe7d4c1e71096c9b6700e9b0487ce3
-  data.tar.gz: 3872080ab8827c6328f96d6795f71221c6d31d7620e18b2bb8fbda72c4afad62
+  metadata.gz: 9e7e5a0b7067a5bc2fda825f05bc61f86992b4653056b5800892248b57561952
+  data.tar.gz: 547452686b682558a049c5c1b1d7985f9b55bec7219b9fc285a3c225c3ee5396
 SHA512:
-  metadata.gz: 0cad7aa20bb7547161d2dcae751d155e537d465f4461f881a2653c9d9b0dc4f5adad08893454f9dc449e4fb913b7de7b229acb1bad12c6d92c491dd704883cae
-  data.tar.gz: 67e29604d03b3e2c580840846d3ccf70d86527d1b4de7fd4396196e0b2eaaa9bdc710cd9c6d5c2f257063dfa8de89f82870352d2cd47e19fa7a42833091b704d
+  metadata.gz: f9d3b8d3e944540b87e2aa62061682c94786590bc1c1fdda8657a3bdf5e1ed57425a6a9e10cf9a0dcd71716ca01987d609cc8bb821460ff762e822c314734338
+  data.tar.gz: 21ed379b621b006d716e882d23f0e768269d39938e951bc2add70c3043670bb929117f19fa698ad69b1e6e9b2614b9582af25a3492eecaacbf8597601076b5bb

data/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2025-08-03
+
+- Better interface to parsed records (Nacha::AchFile)
+
+- Now Nacha::parse returns an AchFile
+
+
+## [0.1.19] - 2025-07-27
+
+- Accept stdin for command line parsing.
+
 ## [0.1.18] - 2025-07-26
 
 - first build automatically pushed from Github Actions

data/README.md

@@ -64,6 +64,19 @@ API may change at any time.   Pull requests welcomed
 
 ```
 nacha parse ach_file.ach > ach_file.html`
+nacha parse -f html ach_file.ach -o ach_file.html`
+```
+
+## Parse an ach file into a JSON file
+
+```
+nacha parse -f json ach_file.ach > ach_file.json`
+```
+
+## Parse an ach file into Markdown
+
+```
+nacha parse -f md ach_file.ach > ach_file.md`
 ```
 
 ## Discussion

data/ROADMAP.md

@@ -48,6 +48,13 @@
   - [x] WebAddendaRecord
   - [x] WebEntryDetailRecord
   - [x] XckEntryDetailRecord
+- [ ] External API Updates
+  - [ ] The interface to the gem needs some updating
+    - [ ] Create a Nacha::AchFile object to wrap the parsed records
+      - Encapsulate output formatting (json, markdown)
+      - Encapsulate file totals?
+    - [ ] Nacha::AchBatch object to wrap the batches include in the Nacha::AchFile
+
 - [ ] Debug / Inspection
 - [ ] Field Validations
 - [ ] Record Validations

data/exe/nacha

@@ -19,24 +19,29 @@ module Nacha
     desc "parse FILE", "Parse an ACH file"
     option :output_file, aliases: "-o"
     option :format, aliases: "-f", default: "html",
-      desc: "Output format (html, json, md, or ach)", enum: %w[html json md ach]
+           desc: "Output format (html, json, md, markdown, or ach)",
+           enum: %w[html json md markdown ach]
     option :md_flavor, default: "common_mark", enum: %w[common_mark github]
-    def parse(file_path)
-      unless File.exist?(file_path)
+    def parse(file_path = nil)
+      if file_path.nil? || file_path.empty?
+        input_file = $stdin
+      elsif File.exist?(file_path)
+        input_file = File.open(file_path)
+      else
         puts "Error: File not found at #{file_path}"
         exit 1
       end
 
-      file = File.open(file_path)
-      ach_file = Nacha.parse(file)
+      raw_records = input_file.read
+      ach_file = Nacha.parse(raw_records)
 
       if ach_file && ach_file.is_a?(Array) && !ach_file.empty?
         if options[:output_file]
           File.open(options[:output_file], "w") do |f|
-            write_output(ach_file, f, file)
+            write_output(ach_file, f, input_file)
           end
         else
-          write_output(ach_file, $stdout, file)
+          write_output(ach_file, $stdout, input_file)
         end
       else
         puts "Could not parse the file or the file was empty."
@@ -52,11 +57,10 @@ module Nacha
     def write_output(ach_records, io, file)
       formatter_options = {
         file_name: File.basename(file.path),
-        file_size: file.size,
+        file_size: file.respond_to?(:size) ? file.size : nil,
         number_of_lines: ach_records.size,
-        created_at: file.ctime,
-        modified_at: file.mtime,
-        checksum: OpenSSL::Digest::SHA256.file(File.expand_path(file.path)).hexdigest,
+        created_at: file.respond_to?(:ctime) ? file.ctime : Time.now,
+        modified_at: file.respond_to?(:mtime) ? file.mtime : Time.now,
         preamble: HTML_PREAMBLE_FILE,
         postamble: HTML_POSTAMBLE_FILE
       }
@@ -64,7 +68,7 @@ module Nacha
       case options[:format]
       when 'ach'
         output_ach(ach_records, io)
-      when 'md'
+      when 'md', 'markdown'
         formatter_options[:flavor] = options[:md_flavor].to_sym
         formatter = Nacha::Formatter::FormatterFactory.get(:markdown, ach_records, formatter_options)
         io.puts formatter.format

data/lib/nacha/version.rb

@@ -2,7 +2,7 @@
 
 module Nacha
   module Version
-    STRING = '0.1.18'
+    STRING = '0.2.00'
   end
   VERSION = Version::STRING
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nacha
 version: !ruby/object:Gem::Version
-  version: 0.1.18
+  version: 0.2.00
 platform: ruby
 authors:
 - David H. Wilkins