pdfh 4.0.0 → 4.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3bfbea6779583e5ac915303ce31e9e7460003ba7703a7e90977abf12feb98fa5
-  data.tar.gz: a74428a0ba54acb17ee6195c2d6e84fd728a1e509009ed940099c34d56bbdabb
+  metadata.gz: caac169994dac2298602338729f41f79b0b047d8e5c78a8ffff3e7afe861547a
+  data.tar.gz: c1c31260ea0460b96b5cf77c103215323feaee2e7c4dfa6199962ecf1f851e16
 SHA512:
-  metadata.gz: aa97de92e612928c87c6d23df517be4168b8805adea2cd9006953ec00dc738cd6f62d83919e845868244322bd2c0e187df8b0a6402ac078a5d037e8f4851b664
-  data.tar.gz: de145b9b13f5f78d3203519e811ad43d124a50a23408583215656a65f06679db2a700ddf2948e0521198c5a387ad464d8cce9caf01a771e5d90d169ab0162826
+  metadata.gz: 0c817645e707161a62c42ef478e0471668547cc78f03a6e9831e060ceceb8638bd85404c7a6a929a016fc6b953d7a97c2f244350551cbec8ca6e7063054f742e
+  data.tar.gz: 444b02a1ba3324ac7ea98983d8c9500a3dafea33307f22cad5042817929db28f8be885d6fd355574014b514d1f07ae8554990d944967e51de6c69daec29a959c

data/.pre-commit-config.yaml

@@ -26,7 +26,7 @@ repos:
       - id: gitleaks
 
   - repo: https://github.com/rubocop/rubocop
-    rev: v1.85.1
+    rev: v1.86.0
     hooks:
       - id: rubocop
         args: [--parallel]

data/AGENTS.md

@@ -59,7 +59,11 @@ Useful `mise` tasks (`mise.toml`):
 ## Processing Flow (High Level)
 
 ```text
-exe/pdfh → Main.start → OptParser → SettingsBuilder → SettingsValidator
+exe/pdfh → DependencyValidator (qpdf, pdftotext) → Main.start
+                                              ↓
+                                   OptParser (ARGV)
+                                              ↓
+                               SettingsBuilder → SettingsValidator
                                                             ↓
                                          DirectoryScanner.scan (finds *.pdf)
                                                             ↓
@@ -76,9 +80,9 @@ Key service objects in `lib/pdfh/services/`:
 - `PdfTextExtractor` — shells out `pdftotext -enc UTF-8 -layout`
 - `DocumentMatcher` — iterates `DocumentType`s; matches `re_id` then `re_date`
 - `DocumentManager` — creates dest dir, copies/renames PDF, copies companion files
-- `SettingsBuilder` — locates and parses `pdfh.yml`
+- `SettingsBuilder` — resolves config from env/known locations (`.yml`/`.yaml`), validates, and builds `Settings`
 - `SettingsValidator` — validates settings; raises `ArgumentError` on fatal errors, warns and skips on soft errors (e.g. missing lookup dirs)
-- `OptParser` — parses `ARGV` into `RunOptions`
+- `OptParser` — parses `ARGV` into `RunOptions`; supports `--list-types` to print configured document type IDs
 
 ## Code Style and Conventions
 
@@ -127,6 +131,7 @@ Side effects and IO:
 - File system changes are centralized in `DocumentManager`.
 - Respect `dry_run` / `--dry` to avoid writing files.
 - When copying/moving files, preserve metadata if possible (`FileUtils` with `preserve: true`).
+- After successful processing, source PDFs are moved to `*.bkp` in place (`DocumentManager#backup_original`).
 
 Testing:
 
@@ -136,7 +141,9 @@ Testing:
 
 ## Configuration and Templates
 
-- Configuration is loaded from `$PDFH_CONFIG_FILE`, then CWD, `~/.config/`, then `~/`.
+- Configuration is loaded from `$PDFH_CONFIG_FILE`, then CWD, then `$XDG_CONFIG_HOME` (default `~/.config`), then `~/`.
+- Supported config file extensions are `.yml` and `.yaml`.
+- If no config file is found, `SettingsBuilder` creates a default template at `~/pdfh.yml`.
 - Document templates use `{placeholder}` tokens defined in `Document#rename_data`.
 - Date regex supports named captures `(?<m>...)` / `(?<y>...)` / `(?<d>...)` or positional captures.
 
@@ -149,7 +156,8 @@ Testing:
 - **v4 breaking change**: Config format changed in v4.0.0 — old configs are incompatible. `re_id` matches PDF *text content* (not filename). New placeholders: `{day}`, `{quarter}`, `{bimester}`, `{name}`.
 - **Multi-match behavior**: PDFs matching more than one `DocumentType` are silently skipped (see `Main.start`).
 - **`_unlocked` suffix**: `DocumentManager` strips `_unlocked` when locating companion files — legacy pattern from `qpdf` unlocking.
-- **Config search path**: `$PDFH_CONFIG_FILE` → CWD → `~/.config/` → `~/`. Error message does not list paths checked.
+- **First run side effect**: Missing config does not fail fast; it auto-creates `~/pdfh.yml` and continues from that template.
+- **Dependency mismatch risk**: `qpdf` is still checked at startup (`exe/pdfh`) even though normal v4 processing does not call it directly.
 - **Colorize in tests**: Logging output is colored via `colorize`; specs mock `Console` with shared context `"with silent console"` to suppress output.
 
 ## Suggested Workflow for Agents

data/Gemfile.lock

@@ -1,13 +1,13 @@
 PATH
   remote: .
   specs:
-    pdfh (4.0.0)
+    pdfh (4.0.2)
       colorize (~> 1.1.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (8.1.2)
+    activesupport (8.1.3.1)
       base64
       bigdecimal
       concurrent-ruby (~> 1.0, >= 1.3.1)
@@ -20,66 +20,59 @@ GEM
       securerandom (>= 0.3)
       tzinfo (~> 2.0, >= 2.0.5)
       uri (>= 0.13.1)
-    addressable (2.8.9)
-      public_suffix (>= 2.0.2, < 8.0)
     ast (2.4.3)
     base64 (0.3.0)
-    bigdecimal (4.0.1)
+    bigdecimal (4.1.2)
     code-scanning-rubocop (0.6.1)
       rubocop (~> 1.0)
     colorize (1.1.0)
-    concurrent-ruby (1.3.6)
+    concurrent-ruby (1.3.8)
     connection_pool (3.0.2)
-    date (3.5.1)
     debug (1.11.1)
       irb (~> 1.10)
       reline (>= 0.3.8)
     diff-lcs (1.6.2)
     docile (1.4.1)
     drb (2.2.3)
-    erb (6.0.2)
-    factory_bot (6.5.6)
+    erb (6.0.6)
+    factory_bot (6.6.0)
       activesupport (>= 6.1.0)
-    i18n (1.14.8)
+    i18n (1.15.2)
       concurrent-ruby (~> 1.0)
     io-console (0.8.2)
-    irb (1.17.0)
+    irb (1.18.0)
       pp (>= 0.6.0)
       prism (>= 1.3.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
-    json (2.19.2)
-    json-schema (6.2.0)
-      addressable (~> 2.8)
-      bigdecimal (>= 3.1, < 5)
-    language_server-protocol (3.17.0.5)
+    json (2.21.2)
+    language_server-protocol (3.17.0.6)
     lint_roller (1.1.0)
     logger (1.7.0)
-    mcp (0.9.0)
-      json-schema (>= 4.1)
-    minitest (6.0.2)
+    minitest (6.0.6)
       drb (~> 2.0)
       prism (~> 1.5)
-    parallel (1.27.0)
-    parser (3.3.10.2)
+    parallel (2.1.0)
+    parser (3.3.12.0)
       ast (~> 2.4.1)
       racc
-    pp (0.6.3)
+    pp (0.6.4)
       prettyprint
     prettyprint (0.2.0)
     prism (1.9.0)
-    psych (5.3.1)
-      date
-      stringio
-    public_suffix (7.0.5)
     racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.3.1)
-    rdoc (7.2.0)
+    rake (13.4.2)
+    rbs (4.1.2)
+      logger
+      prism (>= 1.6.0)
+      tsort
+    rdoc (8.0.0)
       erb
-      psych (>= 4.0.0)
+      prism (>= 1.6.0)
+      rbs (>= 4.0.0)
       tsort
-    regexp_parser (2.11.3)
+    regexp_parser (2.12.0)
     reline (0.6.3)
       io-console (~> 0.5)
     rspec (3.13.2)
@@ -95,19 +88,18 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.7)
-    rubocop (1.85.1)
+    rubocop (1.88.2)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
-      mcp (~> 0.6)
-      parallel (~> 1.10)
+      parallel (>= 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
       rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.49.1)
+    rubocop-ast (1.50.0)
       parser (>= 3.3.7.2)
       prism (~> 1.7)
     rubocop-factory_bot (2.28.0)
@@ -120,9 +112,10 @@ GEM
     rubocop-rake (0.7.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.72.1)
-    rubocop-rspec (3.9.0)
+    rubocop-rspec (3.10.2)
       lint_roller (~> 1.1)
-      rubocop (~> 1.81)
+      regexp_parser (>= 2.0)
+      rubocop (~> 1.86, >= 1.86.2)
     ruby-progressbar (1.13.0)
     securerandom (0.4.1)
     simplecov (0.22.0)
@@ -131,7 +124,6 @@ GEM
       simplecov_json_formatter (~> 0.1)
     simplecov-html (0.13.2)
     simplecov_json_formatter (0.1.4)
-    stringio (3.2.0)
     tsort (0.2.0)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
@@ -159,4 +151,4 @@ DEPENDENCIES
   simplecov (~> 0.22)
 
 BUNDLED WITH
-  4.0.8
+  4.0.17

data/lib/pdfh/services/document_manager.rb

@@ -89,16 +89,18 @@ module Pdfh
       # Finds companion files by removing the _unlocked suffix from the PDF name if present.
       # This allows PDFs unlock by qpdf to locate their original companion files (e.g., .xml, .txt)
       # that were never renamed with the _unlocked suffix.
+      # Excludes PDF files and `.bkp` backup files (already-processed PDFs renamed by +backup_original+).
       #
-      # @return [Array<String>] array of non-PDF files with the same base name
+      # @return [Array<String>] array of non-PDF, non-backup files with the same base name
       # @example
       #   # If document is "cuenta_unlocked.pdf", searches for "cuenta.*"
-      #   # Returns ["cuenta.xml", "cuenta.txt"] (excluding "cuenta.pdf")
+      #   # Returns ["cuenta.xml", "cuenta.txt"] (excluding "cuenta.pdf" and "cuenta.pdf.bkp")
       def companion_files
         @companion_files ||= begin
           base_name = document.file_info.stem.delete_suffix(PDF_UNLOCKED_MAGIC_SUFFIX)
           Dir.glob(File.join(document.file_info.dir, "#{base_name}.*")).reject do |file|
-            File.extname(file) == ".pdf"
+            ext = File.extname(file)
+            ext == ".pdf" || file.end_with?(".bkp")
           end
         end
       end

data/lib/pdfh/services/pdf_text_extractor.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 require "shellwords"
-require "english"
+require "English"
 
 module Pdfh
   module Services

data/lib/pdfh/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pdfh
-  VERSION = "4.0.0"
+  VERSION = "4.0.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pdfh
 version: !ruby/object:Gem::Version
-  version: 4.0.0
+  version: 4.0.2
 platform: ruby
 authors:
 - Isaias Piña
@@ -98,7 +98,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.8
+rubygems_version: 4.0.17
 specification_version: 4
 summary: Organize PDF files
 test_files: []