imapcli 3.0.1 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf3da9229783f1c5eff9461b6062e36ae8d51eac5ce818a980425c25d9c5e431
-  data.tar.gz: b2a6c6476a95644f7a4a97e2f7da6120858d2057afca64372a69424a1e6f036e
+  metadata.gz: b57f2a82c06e43ef1d25ef4876ca78a746e01e2c985977ddb8f4789728992f5c
+  data.tar.gz: 7623524c875de285af386fcf521ec59893e1022ee5e09284d4aa30950eba2786
 SHA512:
-  metadata.gz: 7df011d6f9e64d4cfc387227e2eba187f921f4a80618fb12055ed616e357a9c8b80d3c129072768a453f3d63d4f221bd7b87c691cb1b73b7133dc6962f6fad03
-  data.tar.gz: 66fe3edbe82ce039b7d38e9f6f1836220adef5e71f6d8b268409daa838a6b1976252bac8d01514ef400ae645f2bf8b6c3e0f00bbd71f4f8b945d05d6715034a0
+  metadata.gz: 76857de95667a5d6ea600244cd48c54cc91257da559ed1968273822e1cc1fc08bb7e5e94955fd0b7a9f1b21b7514d970e1aa342941e640c78f279a702b706fcd
+  data.tar.gz: eabd2e90a25f8f8a2939208505d87dfd40828bee5db598810df9d1c6d186cd984f5b093f90ca89254276fbbeb20289fc6c94922345bdbb6006ea099f47bf02c9

data/CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Version 3.1.0 (2026-02-11)][v3.0.1]
+
+### CHanged
+
+- Increase resilience against IMAP errors. Added an option `--[no-]skip-errors`, which
+  is enabled by default, but can be disabled to error out on IMAP folder errors.
+
 ## [Version 3.0.1 (2025-06-29)][v3.0.1]
 
 ### Changed

data/Dockerfile

@@ -1,4 +1,4 @@
-FROM ruby:3.5-rc AS builder
+FROM ruby:4 AS builder
 WORKDIR /imapcli
 COPY Gemfile Gemfile.lock imapcli.gemspec .
 COPY lib/imapcli/version.rb lib/imapcli/version.rb
@@ -9,7 +9,7 @@ RUN apt-get update -qq && \
   bundle config set --local deployment true && \
   bundle install
 
-FROM ruby:3.5-rc-slim
+FROM ruby:4-slim
 LABEL maintainer="bovender@bovender.de"
 LABEL description="Command-line tool to query IMAP servers, collect stats etc."
 WORKDIR /imapcli

data/Gemfile.lock

@@ -17,14 +17,14 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (8.0.2)
+    activesupport (8.1.2)
       base64
-      benchmark (>= 0.3)
       bigdecimal
       concurrent-ruby (~> 1.0, >= 1.3.1)
       connection_pool (>= 2.2.5)
       drb
       i18n (>= 1.6, < 2)
+      json
       logger (>= 1.4.2)
       minitest (>= 5.1)
       securerandom (>= 0.3)
@@ -32,44 +32,43 @@ GEM
       uri (>= 0.13.1)
     ast (2.4.3)
     base64 (0.3.0)
-    benchmark (0.4.1)
-    bigdecimal (3.2.2)
+    bigdecimal (4.0.1)
     coderay (1.1.3)
-    concurrent-ruby (1.3.5)
-    connection_pool (2.5.3)
+    concurrent-ruby (1.3.6)
+    connection_pool (3.0.2)
     csv (3.3.5)
-    date (3.4.1)
-    debug (1.11.0)
+    date (3.5.1)
+    debug (1.11.1)
       irb (~> 1.10)
       reline (>= 0.3.8)
     descriptive_statistics (2.5.1)
     diff-lcs (1.6.2)
     docile (1.4.1)
-    dotenv (3.1.8)
+    dotenv (3.2.0)
     drb (2.2.3)
-    erb (5.0.1)
-    ffi (1.17.2)
-    ffi (1.17.2-aarch64-linux-gnu)
-    ffi (1.17.2-aarch64-linux-musl)
-    ffi (1.17.2-arm-linux-gnu)
-    ffi (1.17.2-arm-linux-musl)
-    ffi (1.17.2-arm64-darwin)
-    ffi (1.17.2-x86-linux-gnu)
-    ffi (1.17.2-x86-linux-musl)
-    ffi (1.17.2-x86_64-darwin)
-    ffi (1.17.2-x86_64-linux-gnu)
-    ffi (1.17.2-x86_64-linux-musl)
-    formatador (1.1.0)
+    erb (6.0.1)
+    ffi (1.17.3)
+    ffi (1.17.3-aarch64-linux-gnu)
+    ffi (1.17.3-aarch64-linux-musl)
+    ffi (1.17.3-arm-linux-gnu)
+    ffi (1.17.3-arm-linux-musl)
+    ffi (1.17.3-arm64-darwin)
+    ffi (1.17.3-x86-linux-gnu)
+    ffi (1.17.3-x86-linux-musl)
+    ffi (1.17.3-x86_64-darwin)
+    ffi (1.17.3-x86_64-linux-gnu)
+    ffi (1.17.3-x86_64-linux-musl)
+    formatador (1.2.3)
+      reline
     gli (2.22.2)
       ostruct
-    guard (2.19.1)
+    guard (2.20.1)
       formatador (>= 0.2.4)
       listen (>= 2.7, < 4.0)
       logger (~> 1.6)
       lumberjack (>= 1.0.12, < 2.0)
       nenv (~> 0.1)
       notiffany (~> 0.0)
-      ostruct (~> 0.6)
       pry (>= 0.13.0)
       shellany (~> 0.0)
       thor (>= 0.18.1)
@@ -78,25 +77,28 @@ GEM
       guard (~> 2.1)
       guard-compat (~> 1.1)
       rspec (>= 2.99.0, < 4.0)
-    i18n (1.14.7)
+    i18n (1.14.8)
       concurrent-ruby (~> 1.0)
-    io-console (0.8.0)
-    irb (1.15.2)
+    io-console (0.8.2)
+    irb (1.17.0)
       pp (>= 0.6.0)
+      prism (>= 1.3.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
-    json (2.12.2)
+    json (2.18.1)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
-    listen (3.9.0)
+    listen (3.10.0)
+      logger
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     logger (1.7.0)
-    lumberjack (1.2.10)
+    lumberjack (1.4.2)
     method_source (1.1.0)
-    minitest (5.25.5)
+    minitest (6.0.1)
+      prism (~> 1.5)
     nenv (0.3.0)
-    net-imap (0.5.9)
+    net-imap (0.6.2)
       date
       net-protocol
     net-protocol (0.2.2)
@@ -104,52 +106,54 @@ GEM
     notiffany (0.1.3)
       nenv (~> 0.1)
       shellany (~> 0.0)
-    oj (3.16.11)
+    oj (3.16.15)
       bigdecimal (>= 3.0)
       ostruct (>= 0.2)
-    ostruct (0.6.2)
+    ostruct (0.6.3)
     parallel (1.27.0)
-    parser (3.3.8.0)
+    parser (3.3.10.1)
       ast (~> 2.4.1)
       racc
     pastel (0.8.0)
       tty-color (~> 0.5)
-    pp (0.6.2)
+    pp (0.6.3)
       prettyprint
     prettyprint (0.2.0)
-    prism (1.4.0)
-    pry (0.15.2)
+    prism (1.9.0)
+    pry (0.16.0)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    psych (5.2.6)
+      reline (>= 0.6.0)
+    psych (5.3.1)
       date
       stringio
     racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.3.0)
+    rake (13.3.1)
     rb-fsevent (0.11.2)
     rb-inotify (0.11.1)
       ffi (~> 1.0)
-    rdoc (6.14.1)
+    rdoc (7.2.0)
       erb
       psych (>= 4.0.0)
-    regexp_parser (2.10.0)
-    reline (0.6.1)
+      tsort
+    regexp_parser (2.11.3)
+    reline (0.6.3)
       io-console (~> 0.5)
-    rspec (3.13.1)
+    rspec (3.13.2)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
       rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.5)
+    rspec-core (3.13.6)
       rspec-support (~> 3.13.0)
     rspec-expectations (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.5)
+    rspec-mocks (3.13.7)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-support (3.13.4)
-    rubocop (1.77.0)
+    rspec-support (3.13.7)
+    rubocop (1.84.1)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -157,22 +161,22 @@ GEM
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.45.1, < 2.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.45.1)
+    rubocop-ast (1.49.0)
       parser (>= 3.3.7.2)
-      prism (~> 1.4)
-    rubocop-performance (1.25.0)
+      prism (~> 1.7)
+    rubocop-performance (1.26.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.75.0, < 2.0)
-      rubocop-ast (>= 1.38.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
     rubocop-rake (0.7.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.72.1)
-    rubocop-rspec (3.6.0)
+    rubocop-rspec (3.9.0)
       lint_roller (~> 1.1)
-      rubocop (~> 1.72, >= 1.72.1)
+      rubocop (~> 1.81)
     ruby-progressbar (1.13.0)
     securerandom (0.4.1)
     shellany (0.0.1)
@@ -180,16 +184,17 @@ GEM
       docile (~> 1.1)
       simplecov-html (~> 0.11)
       simplecov_json_formatter (~> 0.1)
-    simplecov-html (0.13.1)
+    simplecov-html (0.13.2)
     simplecov_json_formatter (0.1.4)
-    stringio (3.1.7)
+    stringio (3.2.0)
     strings (0.2.1)
       strings-ansi (~> 0.2)
       unicode-display_width (>= 1.5, < 3.0)
       unicode_utils (~> 1.4)
     strings-ansi (0.2.0)
-    thor (1.3.2)
-    timeout (0.4.3)
+    thor (1.5.0)
+    timeout (0.6.0)
+    tsort (0.2.0)
     tty-color (0.6.0)
     tty-cursor (0.7.1)
     tty-progressbar (0.18.3)
@@ -213,9 +218,9 @@ GEM
       concurrent-ruby (~> 1.0)
     unicode-display_width (2.6.0)
     unicode_utils (1.4.0)
-    uri (1.0.3)
+    uri (1.1.1)
     wisper (2.0.1)
-    zeitwerk (2.7.3)
+    zeitwerk (2.7.4)
 
 PLATFORMS
   aarch64-linux-gnu
@@ -245,4 +250,4 @@ DEPENDENCIES
   simplecov
 
 BUNDLED WITH
-   2.6.9
+   4.0.6

data/README.md

@@ -332,10 +332,11 @@ the `Gemfile` for other work that this tool depends on.
 
 - [@bovender](https://github.com/bovender)
 - [@n-rodriguez](https://github.com/n-rodriguez)
+- [@d4nyl0](https://github.com/d4nyl0)
 
 ## License
 
-© 2017-2025 Daniel Kraus (@bovender)
+© 2017-2026 Daniel Kraus (@bovender)
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

data/lib/imapcli/cli.rb

@@ -69,6 +69,12 @@ module Imapcli
       c.switch %i[H human],
         desc: 'Convert byte counts to human-friendly formats',
         negatable: false
+      
+      c.switch %i[skip-errors],
+        desc: 'Skip folders (IMAP mailboxes) that cannot be accessed',
+        negatable: true,
+        default_value: true
+      
       c.flag %i[o sort],
         desc: 'Ordered (sorted) results',
         arg_name: 'sort_property',
@@ -85,9 +91,11 @@ module Imapcli
         raise unless @validator.stats_options_valid?(options, args)
 
         progress_bar = nil
+        skipped_mailboxes = []
 
         head = ['Mailbox', 'Count', 'Total size', 'Min', 'Q1', 'Median', 'Q3', 'Max']
-        body = @command.stats(args, options) do |n|
+        
+        body = @command.stats(args, options, skipped_mailboxes) do |n|
           if progress_bar
             progress_bar.advance
           else
@@ -98,6 +106,7 @@ module Imapcli
             )
           end
         end
+        
         formatted_body = body.map do |row|
           row[0..1] + row[2..].map { |cell| format_bytes(cell, options[:human]) }
         end
@@ -130,6 +139,14 @@ module Imapcli
             @prompt.warn "#{Imapcli::Command.unknown_mailbox_prefix}unknown mailbox"
           end
         end
+        
+        unless skipped_mailboxes.empty?
+          @prompt.say ""
+          @prompt.warn "Skipped #{skipped_mailboxes.length} folder(s) (IMAP mailbox(es)) due to errors:"
+          skipped_mailboxes.each do |info|
+            @prompt.warn "  - #{info[:name]}: #{info[:error]}"
+          end
+        end
       end
     end
 

data/lib/imapcli/command.rb

@@ -46,7 +46,7 @@ module Imapcli
     #
     # If a block is given, it is called with the current mailbox count and the
     # total mailbox count so that current progress can be computed.
-    def stats(mailbox_names = [], options = {}) # rubocop:disable Metrics/MethodLength,Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity
+    def stats(mailbox_names = [], options = {}, skipped_mailboxes = []) # rubocop:disable Metrics/MethodLength,Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity
       mailbox_names = [mailbox_names] unless mailbox_names.is_a? Array
       perform do
         # Map the command line arguments to Imapcli::Mailbox objects
@@ -59,11 +59,14 @@ module Imapcli
         current_count = 0
         yield list.length if block_given?
         total_stats = Stats.new
+        
+        skip_errors = options.fetch(:'skip-errors', true)
+        
         list.each do |mailbox|
           # Since we are working on a flat list of mailboxes, set the maximum
           # level to 0 when collecting stats.
-          mailbox.collect_stats(@client, 0) do |stats|
-            total_stats.add(stats)
+          mailbox.collect_stats(@client, 0, skip_errors: skip_errors, skipped_mailboxes: skipped_mailboxes) do |stats|
+            total_stats.add(stats) if stats
             current_count += 1
             yield current_count if block_given?
           end
@@ -74,8 +77,8 @@ module Imapcli
         else
           sorted_list(list, options)
         end.map do |mailbox|
-          stats_to_table(mailbox.full_name, mailbox.stats)
-        end
+          mailbox.stats ? stats_to_table(mailbox.full_name, mailbox.stats) : nil
+        end.compact
         output << stats_to_table('Total', total_stats) if list.length > 1
         output
       end

data/lib/imapcli/mailbox.rb

@@ -106,15 +106,30 @@ module Imapcli
     #
     # If a block is given, it is called with the Imapcli::Stats object for this
     # mailbox.
-    def collect_stats(client, max_level = nil, &block)
+    def collect_stats(client, max_level = nil, skip_errors: true, skipped_mailboxes: nil, &block)
       return if @stats
 
-      @stats = Stats.new(client.message_sizes(full_name)) if full_name # proceed only if this is a mailbox of its own
-      yield @stats if block_given?
+      # proceed only if this is a mailbox of its own
+      if full_name
+        begin
+          @stats = Stats.new(client.message_sizes(full_name))
+          yield @stats if block_given?
+        rescue Net::IMAP::NoResponseError => e
+          # Errore IMAP: mailbox non esiste o non è accessibile
+          handle_mailbox_error(e, skip_errors, skipped_mailboxes)
+        rescue Net::IMAP::ByeResponseError => e
+          # Server ha chiuso la connessione
+          handle_mailbox_error(e, skip_errors, skipped_mailboxes)
+        rescue StandardError => e
+          # Altro tipo di errore
+          handle_mailbox_error(e, skip_errors, skipped_mailboxes)
+        end
+      end
+      
       return unless max_level.nil? || level < max_level
 
       @children.each_value do |child|
-        child.collect_stats(client, max_level, &block)
+        child.collect_stats(client, max_level, skip_errors: skip_errors, skipped_mailboxes: skipped_mailboxes, &block)
       end
     end
 
@@ -175,5 +190,31 @@ module Imapcli
       end
     end
 
+    private
+
+    # Handle errors during stats collection
+    def handle_mailbox_error(error, skip_errors, skipped_mailboxes)
+      error_message = case error
+                      when Net::IMAP::NoResponseError
+                        error.message
+                      when Net::IMAP::ByeResponseError
+                        "Server closed connection: #{error.message}"
+                      else
+                        "#{error.class}: #{error.message}"
+                      end
+
+      if skip_errors
+        if skipped_mailboxes.is_a?(Array)
+          skipped_mailboxes << {
+            name: full_name,
+            error: error_message
+          }
+        end
+        nil
+      else
+        raise error
+      end
+    end
+
   end
 end

data/lib/imapcli/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Imapcli
-  VERSION = '3.0.1'
+  VERSION = '3.1.0'
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: imapcli
 version: !ruby/object:Gem::Version
-  version: 3.0.1
+  version: 3.1.0
 platform: ruby
 authors:
 - Daniel Kraus (bovender)
 bindir: exe
 cert_chain: []
-date: 2025-06-29 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -226,7 +226,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Command-line tool to query IMAP servers
 test_files: []