pretty-git 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84571ab2bdd16f92dc31c1883a70433a140253ee0d0c66f1079453fc30f34419
-  data.tar.gz: 532ee3a2e436163f12821073297dc013e874746c5ac269f89c455826566c9f27
+  metadata.gz: 7e190585a91de27221e54bc2cbc58b5f6d26a1428c2e5cd5189ff0c18d362e6c
+  data.tar.gz: f8d2bc8f5d6c6a4887a745abd611a038166bcb54e95267a15d4868ee9d530003
 SHA512:
-  metadata.gz: a0ba7918e1179ebfe3c4771c995b8b0eda978263be1fc6484f0f913e7b2129472272660e3c6dfb24a11f9d64300c26748d0b01fc14f0594e04e9b88cf244b96c
-  data.tar.gz: afaa201615eff920f1af0b86384964437fe7a119fc0d43d2a5ae10ee36211215b84c9607b92354646a20d691f0382f0b5d214385a214e8107596cdcf06eefcb2
+  metadata.gz: e11fd51d24ed1e63fd5c773f76a46510bbcedad23c02ace63b25d7d80c366479fd02fe2bfabaa58693389c222bafe4fd9e6fc0b157b7d598e96294a3f888fbef
+  data.tar.gz: 38fc87c6467d72ae6a1cb63a13b06c417e81f714d5b074feae961f121e061cea0733494020e0b8f562f36ea00b2d537a0d6fd5ac36eea942465680376f8eb71e

data/CHANGELOG.md

@@ -7,6 +7,24 @@ The format is based on Keep a Changelog, and this project adheres to Semantic Ve
 ## [Unreleased]
  
 
+## [0.1.4] - 2025-08-17
+### Added
+- Integration tests for new reports exports: CSV/Markdown/YAML/XML for `hotspots`, `churn`, `ownership`.
+- Schema validations: `rake validate:json`, `rake validate:xml` to ensure format compatibility.
+- CI: expanded matrix to include macOS; smoke test for installed binary (`--help`, `--version`).
+
+### Changed
+- Renderers (`MarkdownRenderer`, `YamlRenderer`, `XmlRenderer`): deterministic sorting for all new reports according to `docs/determinism.md`.
+- XML: per-report root elements in XML exports to match XSDs (`hotspotsReport`, `churnReport`, `ownershipReport`, `languagesReport`, etc.).
+- Documentation: `README.md` and `README.ru.md` updated with sections and examples for new reports and all export formats.
+- CLI: keep `--time-bucket` permissive; default `time_bucket=nil`.
+
+### Fixed
+- Time parsing: interpret date-only inputs (`YYYY-MM-DD`) as UTC midnight and normalize to UTC ISO8601.
+- CLI UX: error when `--metric` is used outside `languages` report.
+- Tests/specs: updated XML specs to per-report roots; added timezone edge cases; fixed Open3 `popen3` stubs (`chdir:`) and integration requires.
+
+
 ## [0.1.3] - 2025-08-14
 ### Added
 - New analytics reports: `hotspots`, `churn`, `ownership` with sorting, scoring, and limits.
@@ -30,7 +48,7 @@ The format is based on Keep a Changelog, and this project adheres to Semantic Ve
 ### Changed
 - Languages: JSON language reinstated in the mapping and color scheme; sorting and percent calculations are based on the selected metric; percentages rounded to two decimals.
 - Renderers: updated `csv`, `markdown`, and console renderers to work with dynamic metrics.
-- Internal specs updated: `specs/output_formats.md`, `specs/cli_spec.md`, `specs/languages_map.md`.
+- Internal specs updated: `docs/output_formats.md`, `docs/cli_spec.md`, `docs/languages_map.md`.
 
 ### Fixed
 - Git provider: correct commit counting — emit a new commit when a header is read and remove the record separator from the subject (`lib/pretty_git/git/provider.rb`).

data/README.md

@@ -124,6 +124,10 @@ General form:
 pretty-git <report> <repo_path> [options]
 ```
 
+Notes:
+* `<repo_path>` defaults to `.` if omitted.
+* You can also pass the repository via `--repo PATH` as an alternative to the positional argument.
+
 Available reports: `summary`, `activity`, `authors`, `files`, `heatmap`, `languages`, `hotspots`, `churn`, `ownership`.
 
 Key options:
@@ -207,19 +211,31 @@ Markdown example:
 pretty-git files . --paths app,lib --format csv
 ```
 CSV columns: `path,commits,additions,deletions,changes`.
+
 XML example:
 ```xml
-<files>
-  <item path="app/models/user.rb" commits="42" additions="2100" deletions="1400" changes="3500" />
-  <item path="app/services/auth.rb" commits="35" additions="1500" deletions="900" changes="2400" />
+<?xml version="1.0" encoding="UTF-8"?>
+<report>
+  <report>files</report>
   <generated_at>2025-01-31T00:00:00Z</generated_at>
   <repo_path>/abs/path/to/repo</repo_path>
-  <report>files</report>
-  <period>
-    <since/>
-    <until/>
-  </period>
-</files>
+  <items>
+    <item>
+      <path>app/models/user.rb</path>
+      <commits>42</commits>
+      <additions>2100</additions>
+      <deletions>1400</deletions>
+      <changes>3500</changes>
+    </item>
+    <item>
+      <path>app/services/auth.rb</path>
+      <commits>35</commits>
+      <additions>1500</additions>
+      <deletions>900</deletions>
+      <changes>2400</changes>
+    </item>
+  </items>
+</report>
 ```
 
 ### 🔥 heatmap — commit heatmap
@@ -337,15 +353,20 @@ Notes:
 
 XML example:
 ```xml
-<ownership>
+<?xml version="1.0" encoding="UTF-8"?>
+<report>
   <report>ownership</report>
   <generated_at>2025-01-31T00:00:00Z</generated_at>
   <repo_path>.</repo_path>
   <items>
-    <item path="lib/a.rb" owner="Alice <a@example.com>" owner_share="82.5" authors="2"/>
+    <item>
+      <path>lib/a.rb</path>
+      <owner>Alice &lt;a@example.com&gt;</owner>
+      <owner_share>82.5</owner_share>
+      <authors>2</authors>
+    </item>
   </items>
-  
-</ownership>
+</report>
 ```
 
 ## 📤 Exports

data/README.ru.md

@@ -124,6 +124,10 @@ bundle exec bin/pretty-git activity . --time-bucket week --since 2025-01-01 \
 pretty-git <report> <repo_path> [options]
 ```
 
+Примечания:
+* `<repo_path>` по умолчанию — `.` (если опущен).
+* Репозиторий можно указать и через флаг `--repo PATH` как альтернативу позиционному аргументу.
+
 Доступные отчёты: `summary`, `activity`, `authors`, `files`, `heatmap`, `languages`, `hotspots`, `churn`, `ownership`.
 
 Ключевые опции:
@@ -207,19 +211,31 @@ CSV-колонки: `author,author_email,commits,additions,deletions,avg_commit_
 pretty-git files . --paths app,lib --format csv
 ```
 CSV-колонки: `path,commits,additions,deletions,changes`.
+
 Пример XML:
 ```xml
-<files>
-  <item path="app/models/user.rb" commits="42" additions="2100" deletions="1400" changes="3500" />
-  <item path="app/services/auth.rb" commits="35" additions="1500" deletions="900" changes="2400" />
+<?xml version="1.0" encoding="UTF-8"?>
+<report>
+  <report>files</report>
   <generated_at>2025-01-31T00:00:00Z</generated_at>
   <repo_path>/abs/path/to/repo</repo_path>
-  <report>files</report>
-  <period>
-    <since/>
-    <until/>
-  </period>
-  </files>
+  <items>
+    <item>
+      <path>app/models/user.rb</path>
+      <commits>42</commits>
+      <additions>2100</additions>
+      <deletions>1400</deletions>
+      <changes>3500</changes>
+    </item>
+    <item>
+      <path>app/services/auth.rb</path>
+      <commits>35</commits>
+      <additions>1500</additions>
+      <deletions>900</deletions>
+      <changes>2400</changes>
+    </item>
+  </items>
+</report>
 ```
 
 ### 🔥 heatmap — тепловая карта
@@ -335,15 +351,20 @@ CSV‑колонки: `path,owner,owner_share,authors`.
 
 Пример XML:
 ```xml
-<ownership>
+<?xml version="1.0" encoding="UTF-8"?>
+<report>
   <report>ownership</report>
   <generated_at>2025-01-31T00:00:00Z</generated_at>
   <repo_path>.</repo_path>
   <items>
-    <item path="lib/a.rb" owner="Alice &lt;a@example.com&gt;" owner_share="82.5" authors="2"/>
+    <item>
+      <path>lib/a.rb</path>
+      <owner>Alice &lt;a@example.com&gt;</owner>
+      <owner_share>82.5</owner_share>
+      <authors>2</authors>
+    </item>
   </items>
-  
-</ownership>
+</report>
 ```
 
 ## 🚫 Игнорируемые директории и файлы

data/lib/pretty_git/cli.rb

@@ -12,7 +12,7 @@ module PrettyGit
     SUPPORTED_REPORTS = %w[summary activity authors files heatmap languages hotspots churn ownership].freeze
     SUPPORTED_FORMATS = %w[console json csv md yaml xml].freeze
 
-    # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+    # rubocop:disable Metrics/AbcSize, Metrics/MethodLength, Metrics/CyclomaticComplexity
     def self.run(argv = ARGV, out: $stdout, err: $stderr)
       options = {
         report: 'summary',
@@ -22,7 +22,7 @@ module PrettyGit
         exclude_authors: [],
         paths: [],
         exclude_paths: [],
-        time_bucket: 'week',
+        time_bucket: nil,
         limit: 10,
         format: 'console',
         out: nil,
@@ -46,6 +46,9 @@ module PrettyGit
         return 1
       end
 
+      # REPO positional arg (after REPORT), if still present and not an option
+      options[:repo] = argv.shift if argv[0] && argv[0] !~ /^-/
+
       exit_code = CLIHelpers.validate_and_maybe_exit(options, parser, out, err)
       return exit_code if exit_code
 
@@ -58,6 +61,6 @@ module PrettyGit
       err.puts e.message
       2
     end
-    # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
+    # rubocop:enable Metrics/AbcSize, Metrics/MethodLength, Metrics/CyclomaticComplexity
   end
 end

data/lib/pretty_git/cli_helpers.rb

@@ -16,7 +16,7 @@ module PrettyGit
     module_function
 
     def configure_parser(opts, options)
-      opts.banner = 'Usage: pretty-git [REPORT] [options]'
+      opts.banner = 'Usage: pretty-git [REPORT] [REPO] [options]'
       add_repo_options(opts, options)
       add_time_author_options(opts, options)
       add_path_limit_options(opts, options)
@@ -75,7 +75,9 @@ module PrettyGit
       code = handle_version_help(options, parser, out)
       return code unless code.nil?
 
-      return nil if valid_report?(options[:report]) && valid_theme?(options[:theme]) && valid_metric?(options[:metric])
+      base_ok = valid_report?(options[:report]) && valid_theme?(options[:theme]) && valid_metric?(options[:metric])
+      conflicts_ok = validate_conflicts(options, err)
+      return nil if base_ok && conflicts_ok
 
       print_validation_errors(options, err)
       1
@@ -112,6 +114,17 @@ module PrettyGit
       err.puts "Unknown metric: #{options[:metric]}. Supported: #{METRICS.join(', ')}"
     end
 
+    # Returns true when flags are consistent; otherwise prints errors and returns false
+    def validate_conflicts(options, err)
+      ok = true
+      if options[:metric] && options[:report] != 'languages'
+        err.puts "--metric is only supported for 'languages' report"
+        ok = false
+      end
+      # time_bucket is accepted by multiple reports historically; do not enforce here.
+      ok
+    end
+
     def build_filters(options)
       Filters.new(
         repo_path: options[:repo],

data/lib/pretty_git/filters.rb

@@ -31,14 +31,23 @@ module PrettyGit
 
     private
 
+    # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
     def time_to_iso8601(val)
       return nil if val.nil? || val.to_s.strip.empty?
 
-      t = val.is_a?(Time) ? val : Time.parse(val.to_s)
-      t = t.getlocal if t.utc_offset.nil?
+      # If value is a date without time, interpret as UTC midnight to avoid
+      # timezone-dependent shifts across environments.
+      if val.is_a?(String) && val.match?(/^\d{4}-\d{2}-\d{2}$/)
+        y, m, d = val.split('-').map(&:to_i)
+        t = Time.new(y, m, d, 0, 0, 0, '+00:00')
+      else
+        # Otherwise parse normally and normalize to UTC.
+        t = val.is_a?(Time) ? val : Time.parse(val.to_s)
+      end
       t.utc.iso8601
     rescue ArgumentError
       raise ArgumentError, "Invalid datetime: #{val} (expected ISO8601 or YYYY-MM-DD)"
     end
+    # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
   end
 end

data/lib/pretty_git/git/provider.rb

@@ -7,6 +7,7 @@ require_relative '../types'
 module PrettyGit
   module Git
     # Streams commits from git CLI using `git log --numstat` and parses them.
+    # rubocop:disable Metrics/ClassLength
     class Provider
       SEP_RECORD = "\x1E" # record separator
       SEP_FIELD  = "\x1F" # unit separator
@@ -57,7 +58,7 @@ module PrettyGit
 
         additions = current[:files].sum(&:additions)
         deletions = current[:files].sum(&:deletions)
-        yld << Types::Commit.new(
+        commit = Types::Commit.new(
           sha: current[:sha],
           author_name: current[:author_name],
           author_email: current[:author_email],
@@ -67,6 +68,9 @@ module PrettyGit
           deletions: deletions,
           files: current[:files]
         )
+        return if exclude_author?(commit.author_name, commit.author_email)
+
+        yld << commit
       end
 
       def record_separator?(line)
@@ -120,13 +124,41 @@ module PrettyGit
         @filters.branches&.each { |b| args << "--branches=#{b}" }
       end
 
+      # rubocop:disable Metrics/AbcSize
       def add_path_filters(args)
         path_args = Array(@filters.paths).compact
-        return if path_args.empty?
+        exclude_args = Array(@filters.exclude_paths).compact
+
+        # Nothing to filter by
+        return if path_args.empty? && exclude_args.empty?
 
         args << '--'
-        args.concat(path_args)
+
+        # If only excludes provided, include all paths first
+        args << '.' if path_args.empty? && !exclude_args.empty?
+
+        # Include patterns as-is
+        args.concat(path_args) unless path_args.empty?
+
+        # Exclude patterns via git pathspec magic with glob
+        exclude_args.each do |pat|
+          args << ":(exclude,glob)#{pat}"
+        end
+      end
+      # rubocop:enable Metrics/AbcSize
+
+      # rubocop:disable Metrics/CyclomaticComplexity
+      def exclude_author?(name, email)
+        patterns = Array(@filters.exclude_authors).compact
+        return false if patterns.empty?
+
+        patterns.any? do |pat|
+          pn = pat.to_s
+          name&.downcase&.include?(pn.downcase) || email&.downcase&.include?(pn.downcase)
+        end
       end
+      # rubocop:enable Metrics/CyclomaticComplexity
     end
   end
 end
+# rubocop:enable Metrics/ClassLength

data/lib/pretty_git/render/csv_renderer.rb

@@ -4,7 +4,7 @@ require 'csv'
 
 module PrettyGit
   module Render
-    # Renders CSV according to specs/output_formats.md and DR-001
+    # Renders CSV according to docs/output_formats.md and DR-001
     class CsvRenderer
       HEADERS = {
         'activity' => %w[bucket timestamp commits additions deletions],

data/lib/pretty_git/render/markdown_renderer.rb

@@ -2,7 +2,8 @@
 
 module PrettyGit
   module Render
-    # Renders Markdown tables and sections per specs/output_formats.md
+    # Renders Markdown tables and sections per docs/output_formats.md
+    # rubocop:disable Metrics/ClassLength
     class MarkdownRenderer
       TITLES = {
         'activity' => 'Activity',
@@ -33,7 +34,8 @@ module PrettyGit
 
         headers = headers_for(report, result)
         title = title_for(report)
-        render_table(title, headers, result[:items])
+        rows = sort_rows(report, result[:items], result)
+        render_table(title, headers, rows)
       end
 
       private
@@ -82,6 +84,53 @@ module PrettyGit
         end
         @io.puts 'No data' if rows.empty?
       end
+
+      # Deterministic ordering per docs/determinism.md
+      # NOTE: High branching is intentional to keep tie-breakers explicit and stable across formats.
+      # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+      def sort_rows(report, rows, ctx = nil)
+        return rows unless rows.is_a?(Array)
+
+        case report
+        when 'hotspots'
+          rows.sort_by { |r| [-to_f(r[:score]), -to_i(r[:commits]), -to_i(r[:changes]), to_s(r[:path])] }
+        when 'churn'
+          rows.sort_by { |r| [-to_i(r[:churn]), -to_i(r[:commits]), to_s(r[:path])] }
+        when 'ownership'
+          rows.sort_by { |r| [-to_f(r[:owner_share]), -to_i(r[:authors]), to_s(r[:path])] }
+        when 'files'
+          rows.sort_by { |r| [-to_i(r[:changes]), -to_i(r[:commits]), to_s(r[:path])] }
+        when 'authors'
+          rows.sort_by { |r| [-to_i(r[:commits]), -to_i(r[:additions]), -to_i(r[:deletions]), to_s(r[:author_email])] }
+        when 'languages'
+          metric = ctx && ctx[:metric] ? ctx[:metric].to_sym : :bytes
+          rows.sort_by { |r| [-to_i(r[metric]), to_s(r[:language])] }
+        when 'activity'
+          rows.sort_by { |r| [to_s(r[:timestamp])] }
+        when 'heatmap'
+          rows.sort_by { |r| [to_i(r[:dow] || r[:day] || r[:weekday]), to_i(r[:hour])] }
+        else
+          rows
+        end
+      end
+      # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+
+      def to_i(val)
+        Integer(val || 0)
+      rescue StandardError
+        0
+      end
+
+      def to_f(val)
+        Float(val || 0.0)
+      rescue StandardError
+        0.0
+      end
+
+      def to_s(val)
+        (val || '').to_s
+      end
     end
+    # rubocop:enable Metrics/ClassLength
   end
 end

data/lib/pretty_git/render/xml_renderer.rb

@@ -10,15 +10,29 @@ module PrettyGit
         @io = io
       end
 
-      def call(_report, result, _filters)
+      # rubocop:disable Metrics/CyclomaticComplexity
+      def call(report, result, _filters)
+        ordered = apply_order(report, result)
         doc = REXML::Document.new
         doc << REXML::XMLDecl.new('1.0', 'UTF-8')
-        root = doc.add_element('report')
-        hash_to_xml(root, result)
+        root_name = case report
+                    when 'hotspots' then 'hotspotsReport'
+                    when 'churn' then 'churnReport'
+                    when 'ownership' then 'ownershipReport'
+                    when 'languages' then 'languagesReport'
+                    when 'files' then 'filesReport'
+                    when 'authors' then 'authorsReport'
+                    when 'activity' then 'activityReport'
+                    when 'heatmap' then 'heatmapReport'
+                    else 'report'
+                    end
+        root = doc.add_element(root_name)
+        hash_to_xml(root, ordered)
         formatter = REXML::Formatters::Pretty.new(2)
         formatter.compact = true
         formatter.write(doc, @io)
       end
+      # rubocop:enable Metrics/CyclomaticComplexity
 
       private
 
@@ -38,6 +52,60 @@ module PrettyGit
           parent.text = obj.nil? ? '' : obj.to_s
         end
       end
+
+      # Deterministic ordering per docs/determinism.md
+      # NOTE: High branching is intentional to keep tie-breakers explicit and stable across formats.
+      # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+      def apply_order(report, result)
+        dup = Marshal.load(Marshal.dump(result))
+        items = dup[:items]
+        return dup unless items.is_a?(Array)
+
+        dup[:items] =
+          case report
+          when 'hotspots'
+            items.sort_by do |r|
+              [-to_f(r[:score]), -to_i(r[:commits]), -to_i(r[:changes]), to_s(r[:path])]
+            end
+          when 'churn'
+            items.sort_by { |r| [-to_i(r[:churn]), -to_i(r[:commits]), to_s(r[:path])] }
+          when 'ownership'
+            items.sort_by { |r| [-to_f(r[:owner_share]), -to_i(r[:authors]), to_s(r[:path])] }
+          when 'files'
+            items.sort_by { |r| [-to_i(r[:changes]), -to_i(r[:commits]), to_s(r[:path])] }
+          when 'authors'
+            items.sort_by do |r|
+              [-to_i(r[:commits]), -to_i(r[:additions]), -to_i(r[:deletions]), to_s(r[:author_email])]
+            end
+          when 'languages'
+            metric = (dup[:metric] || 'bytes').to_sym
+            items.sort_by { |r| [-to_i(r[metric]), to_s(r[:language])] }
+          when 'activity'
+            items.sort_by { |r| [to_s(r[:timestamp])] }
+          when 'heatmap'
+            items.sort_by { |r| [to_i(r[:dow] || r[:day] || r[:weekday]), to_i(r[:hour])] }
+          else
+            items
+          end
+        dup
+      end
+      # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+
+      def to_i(val)
+        Integer(val || 0)
+      rescue StandardError
+        0
+      end
+
+      def to_f(val)
+        Float(val || 0.0)
+      rescue StandardError
+        0.0
+      end
+
+      def to_s(val)
+        (val || '').to_s
+      end
     end
   end
 end

data/lib/pretty_git/render/yaml_renderer.rb

@@ -10,9 +10,11 @@ module PrettyGit
         @io = io
       end
 
-      def call(_report, result, _filters)
+      def call(report, result, _filters)
+        # Apply deterministic ordering for items where applicable
+        ordered = apply_order(report, result)
         # Dump the entire result structure to YAML with string keys for safe parsing
-        @io.write(stringify_keys(result).to_yaml)
+        @io.write(stringify_keys(ordered).to_yaml)
       end
 
       private
@@ -29,6 +31,60 @@ module PrettyGit
           obj
         end
       end
+
+      # Deterministic ordering per docs/determinism.md
+      # NOTE: High branching is intentional to keep tie-breakers explicit and stable across formats.
+      # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+      def apply_order(report, result)
+        dup = Marshal.load(Marshal.dump(result)) # deep dup
+        items = dup[:items]
+        return dup unless items.is_a?(Array)
+
+        dup[:items] =
+          case report
+          when 'hotspots'
+            items.sort_by do |r|
+              [-to_f(r[:score]), -to_i(r[:commits]), -to_i(r[:changes]), to_s(r[:path])]
+            end
+          when 'churn'
+            items.sort_by { |r| [-to_i(r[:churn]), -to_i(r[:commits]), to_s(r[:path])] }
+          when 'ownership'
+            items.sort_by { |r| [-to_f(r[:owner_share]), -to_i(r[:authors]), to_s(r[:path])] }
+          when 'files'
+            items.sort_by { |r| [-to_i(r[:changes]), -to_i(r[:commits]), to_s(r[:path])] }
+          when 'authors'
+            items.sort_by do |r|
+              [-to_i(r[:commits]), -to_i(r[:additions]), -to_i(r[:deletions]), to_s(r[:author_email])]
+            end
+          when 'languages'
+            metric = (dup[:metric] || 'bytes').to_sym
+            items.sort_by { |r| [-to_i(r[metric]), to_s(r[:language])] }
+          when 'activity'
+            items.sort_by { |r| [to_s(r[:timestamp])] }
+          when 'heatmap'
+            items.sort_by { |r| [to_i(r[:dow] || r[:day] || r[:weekday]), to_i(r[:hour])] }
+          else
+            items
+          end
+        dup
+      end
+      # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+
+      def to_i(val)
+        Integer(val || 0)
+      rescue StandardError
+        0
+      end
+
+      def to_f(val)
+        Float(val || 0.0)
+      rescue StandardError
+        0.0
+      end
+
+      def to_s(val)
+        (val || '').to_s
+      end
     end
   end
 end

data/lib/pretty_git/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PrettyGit
-  VERSION = '0.1.3'
+  VERSION = '0.1.4'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pretty-git
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Pretty Git Authors
@@ -51,8 +51,6 @@ dependencies:
         version: '4.0'
 description: Generates structured analytics from local Git repositories with multiple
   export formats.
-email:
-- ''
 executables:
 - pretty-git
 extensions: []
@@ -92,9 +90,11 @@ homepage: https://github.com/MikoMikocchi/pretty-git
 licenses:
 - MIT
 metadata:
+  homepage_uri: https://github.com/MikoMikocchi/pretty-git
   source_code_uri: https://github.com/MikoMikocchi/pretty-git
   changelog_uri: https://github.com/MikoMikocchi/pretty-git/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/MikoMikocchi/pretty-git/issues
+  documentation_uri: https://github.com/MikoMikocchi/pretty-git#readme
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: