dev_metrics 0.1.2 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 61eeda6933db54b48b7f7ca3941b035da3d04f9f9a8e6d414b8ef9db87a265ea
-  data.tar.gz: c2477155037f8f078dc7ffcc044c7cba1767915a0334434af365ddf967fcca06
+  metadata.gz: 34f8fdcb4bcfa8353303ddc44a30dc227df6ecbf92d87b1f967c927d56ba2480
+  data.tar.gz: e77b9e47b4bd91487c0a4deea93df599cd1b31f778d4bcba32b8de8448d18b9b
 SHA512:
-  metadata.gz: 3ed77728ffae77e7e4ff2f84affc023902fabbd2c9cd2adce81cc3b40b88eb02d97f1c6ced8e7bf7323452234274b29229f3ea775618ab3324ecc3752f4130e3
-  data.tar.gz: b7d5c47d5d486014d03ab9829b4f325377aa0f5c07c7e64b5f1692d0d308333352f45ea9eaf3b89f6120a374be8ddfec7fb36d7054b037887ee1d8f9c74a5505
+  metadata.gz: 2b3cb0b8caec22116264a81ef34b3d62ca1c616852dc45eece9cfeead345f71901be7f91d3b87cc1d69cf66b30118fe37e90b4c82f9c6d95baf8128375fc1f9d
+  data.tar.gz: 0b0f53174f2f572538cac10c90c607c65fbdb421a1bac95ebf5839541ef31f218a0a955ccee0788a5e35cc7eb47755ff79ef4bbaa789b7b78f31d2649b591f63

data/bin/dev_metrics

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# filepath: bin/dev_metrics
+
+require_relative "../lib/dev_metrics"
+
+DevMetrics.run

data/lib/dev_metrics/client.rb

@@ -1,116 +1,78 @@
-require 'net/http'
-require 'uri'
-require 'date'
-require 'json'
-require 'time'
-require_relative 'query_builder'
-
-module DevMetrics
-  class Client
-    GITHUB_GRAPHQL_API = 'https://api.github.com/graphql'.freeze
-    ACCESS_TOKEN = ENV.fetch('GITHUB_ACCESS_TOKEN', nil)
-
-    def initialize(config)
-      @repo_name = config.repo_name
-      @bot_accounts = config.bot_accounts || []
-      @access_token = config.access_token || ENV.fetch('GITHUB_ACCESS_TOKEN', nil)
-      @fix_branch_names = config.fix_branch_names || %w(hotfix fix rollback)
-    end
-
-    def process(period: Date.today)
-      uri = URI.parse(GITHUB_GRAPHQL_API)
-      builder = DevMetrics::QueryBuilder.new(@repo_name)
-
-      auth_request = build_request(uri, builder.access_auth_check)
-      auth_response = execute_request(uri, auth_request)
-      check_auth_errors!(auth_response)
-
-      pr_request = build_request(uri, builder.pull_requests_for(period))
-      pr_response = execute_request(uri, pr_request)
-
-      pr_data = parse_response(pr_response)
-
-      filtered_prs = exclude_bots(pr_data)
-      correction_pr_count = count_correction_prs(filtered_prs)
-
-      output_metrics(period, filtered_prs, correction_pr_count)
-      puts "Done. Please check the file #{output_filename}"
-    end
-
-    private
-
-    def build_request(uri, body)
-      request = Net::HTTP::Post.new(uri)
-      request['Authorization'] = "Bearer #{@access_token}"
-      request.body = body
-      request
-    end
-
-    def execute_request(uri, request)
-      options = { use_ssl: uri.scheme == 'https' }
-      Net::HTTP.start(uri.hostname, uri.port, options) { |http| http.request(request) }
-    end
-
-    def check_auth_errors!(response)
-      if response.code.to_i == 403 || response.body.include?('FORBIDDEN')
-        raise "Access denied: ensure the access token has permission to access #{@repo_name}"
-      end
-    end
-
-    def parse_response(response)
-      unless response.is_a?(Net::HTTPSuccess)
-        raise "Failed to fetch data: #{response.message} (#{response.code})"
-      end
-
-      data = JSON.parse(response.body)
-      raise "GraphQL error: #{data['errors']}" if data['errors']
-
-      data.dig('data', 'search', 'edges') || []
-    end
-
-    def exclude_bots(prs)
-      return prs if @bot_accounts.empty?
-      prs.reject { |pr| @bot_accounts.include?(pr.dig('node', 'author', 'login')) }
-    end
-
-    def count_correction_prs(prs)
-      prs.count { |pr| pr.dig('node', 'headRefName')&.match?(/^#{@fix_branch_names.join('|')}/) }
-    end
-
-    def calculate_lead_time(prs)
-      return "0d 00:00:00" if prs.empty?
-
-      times = prs.map do |pr|
-        merged_at = Time.parse(pr.dig('node', 'mergedAt'))
-        created_at = Time.parse(pr.dig('node', 'publishedAt'))
-        merged_at - created_at
-      end
-
-      average_time = times.sum.fdiv(times.size)
-      format_time(average_time)
-    end
-
-    def format_time(seconds)
-      return "0d 00:00:00" if seconds.nan? || seconds.infinite?
-
-      days, remaining = seconds.divmod(86_400)
-      Time.at(remaining).utc.strftime("#{days}d %H:%M:%S")
-    end
-
-    def output_metrics(period, prs, correction_pr_count)
-      formatted_data = format_data(period, prs, correction_pr_count)
-
-      File.open(output_filename, 'a') do |file|
-        file.write(formatted_data)
-      end
-    end
-
-    def format_data(period, prs, correction_pr_count)
-      raise NotImplementedError, "This method must be implemented by subclasses."
-    end
-
-    def output_filename
-      raise NotImplementedError, "This method must be implemented by subclasses."
-    end
-  end
-end
+require 'net/http'
+require 'uri'
+require 'date'
+require 'json'
+require 'time'
+require_relative 'query_builder'
+require_relative 'metrics_calc'
+require_relative 'pull_request_wrapper'
+
+
+module DevMetrics
+  class Client
+    GITHUB_GRAPHQL_API = 'https://api.github.com/graphql'.freeze
+
+    def initialize(config)
+      @repo_name = config.repo_name
+      @access_token = config.access_token
+      @excluded_accounts = config.excluded_accounts || []
+      @rollback_branch_prefixes = config.rollback_branch_prefixes || %w(hotfix fix rollback)
+    end
+
+    def fetch(period: Date.today)
+      uri = URI.parse(GITHUB_GRAPHQL_API)
+      builder = DevMetrics::QueryBuilder.new(@repo_name)
+
+
+      token = @access_token
+
+      auth_request = build_request(uri, builder.access_auth_check, token)
+      auth_response = execute_request(uri, auth_request)
+      check_auth_errors!(auth_response)
+
+      pr_request = build_request(uri, builder.pull_requests_for(period), token)
+      pr_response = execute_request(uri, pr_request)
+
+      pr_data = parse_response(pr_response)
+      parsed_pr_data = pr_data.map { |row| DevMetrics::PullRequestWrapper.new(row) }
+
+      DevMetrics::MetricsCalc.new(
+        parsed_pr_data,
+        period,
+        excluded_accounts: @excluded_accounts,
+        rollback_branch_prefixes: @rollback_branch_prefixes
+      )
+    end
+
+    private
+
+    def build_request(uri, body, token)
+      request = Net::HTTP::Post.new(uri)
+      request['Authorization'] = "Bearer #{token}"
+      request.body = body
+      request
+    end
+
+    def execute_request(uri, request)
+      options = { use_ssl: uri.scheme == 'https' }
+      Net::HTTP.start(uri.hostname, uri.port, options) { |http| http.request(request) }
+    end
+
+    def check_auth_errors!(response)
+      if response.code.to_i == 403 || response.body.include?('FORBIDDEN')
+        raise "Access denied: ensure the access token has permission to access #{@repo_name}"
+      end
+    end
+
+    def parse_response(response)
+      unless response.is_a?(Net::HTTPSuccess)
+        raise "Failed to fetch data: #{response.message} (#{response.code})"
+      end
+
+      data = JSON.parse(response.body)
+      raise "GraphQL error: #{data['errors']}" if data['errors']
+
+      data.dig('data', 'search', 'edges') || []
+    end
+  end
+end

data/lib/dev_metrics/csv.rb

@@ -0,0 +1,27 @@
+require_relative 'format_base'
+
+module DevMetrics
+  class Csv < FormatBase
+
+    def call
+      write
+    end
+
+    def file_name
+      "dev_metrics.csv"
+    end
+
+    def format
+      columns.map { |col| col['label'] || col }.join(',') + "\n" +
+        build_row.join(',')
+    end
+
+    def write
+      File.open(file_name, 'a') do |f|  # ← append mode
+        f.puts columns.map { |col| col['label'] || col }.join(',') if File.size(file_name).zero?
+        f.puts build_row.join(',')
+      end
+      puts "CSV data written to #{file_name}"
+    end
+  end
+end

data/lib/dev_metrics/format_base.rb

@@ -0,0 +1,35 @@
+require 'yaml'
+
+module DevMetrics
+  class FormatBase
+
+    attr_reader :metrics_calc
+
+    def initialize(metrics_calc, config_path = "dev_metrics_config.yml")
+      @metrics_calc = metrics_calc
+      @format_config = YAML.load_file(config_path)
+    end
+
+    private
+
+    def write; end
+
+    def file_name; end
+
+    def columns
+      @format_config['columns'] || []
+    end
+
+    def build_row
+      columns.map do |column|
+        key = column['key'] || column
+        begin
+          value = @metrics_calc.send(key)
+        rescue NoMethodError
+          value = "No defined for #{key}"
+        end
+        value
+      end
+    end
+  end
+end

data/lib/dev_metrics/json.rb

@@ -0,0 +1,28 @@
+require 'json'
+require_relative 'format_base'
+
+module DevMetrics
+  class Json < FormatBase
+
+    def call
+      write
+    end
+
+    private
+
+    def write
+      data = {}
+      columns.each_with_index do |col, idx|
+        key = col['label'] || col['key'] || col
+        data[key] = build_row[idx]
+      end
+      File.open(file_name, "w") do |file|
+        file.puts JSON.pretty_generate(data)
+      end
+    end
+
+    def file_name
+      "output.json"
+    end
+  end
+end

data/lib/dev_metrics/markdown.rb

@@ -1,25 +1,27 @@
-require_relative 'client'
+require_relative 'format_base'
 
 module DevMetrics
-  class Markdown < Client
+  class Markdown < FormatBase
+
+    def call
+      write
+    end
 
     private
 
-    def format_data(period, prs, correction_pr_count)
-      output = ""
-      output << "| #{period} | #{prs.count} | #{correction_pr_count} | "
-      output << "#{correction_calc(correction_pr_count, prs)}% | "
-      output << "#{calculate_lead_time(prs)} | "
-      output << "[PRs for #{period}](https://github.com/#{@repo_name}/pulls?q=is%3Apr+merged%3A#{period}) |\n"
-      output
+    def write
+      is_new_file = !File.exist?(file_name) || File.size(file_name).zero?
+      File.open(file_name, "a") do |file|
+        if is_new_file
+          file.puts "| " + columns.map { |col| col['label'] || col }.join(' | ') + " |"
+          file.puts "| " + (["---"] * columns.size).join(' | ') + " |"
+        end
+        file.puts "| " + build_row.join(' | ') + " |"
+      end
     end
 
-    def correction_calc(correction_pr_count, prs)
-      return "-" if prs.empty?
-      ((correction_pr_count.to_f / prs.count) * 100).round(2)
-    end
-    def output_filename
-      "metrics_report.md"
+    def file_name
+      "dev_metrics.md"
     end
   end
-end
+end

data/lib/dev_metrics/metrics_calc.rb

@@ -0,0 +1,218 @@
+require 'pry'
+
+module DevMetrics
+  class MetricsCalc
+    attr_reader :period
+
+    def initialize(prs, period, excluded_accounts:, rollback_branch_prefixes:)
+      @prs = prs
+      @period = period
+      @excluded_accounts = excluded_accounts || []
+      @rollback_branch_prefixes = rollback_branch_prefixes
+    end
+
+    # Returns the number of PRs excluding those created by bot accounts.
+    #
+    # @return [Integer] Number of PRs excluding bots.
+    def prs_length
+      count_prs_with_excluded_account(@prs, @excluded_accounts).length
+    end
+
+    # Returns the number of rollback PRs (branch name matches fix patterns).
+    #
+    # @return [Integer] Number of rollback PRs.
+    def rollback_prs_length
+      return 0 if @rollback_branch_prefixes.nil? || @rollback_branch_prefixes.empty?
+      regex = /^#{@rollback_branch_prefixes.join('|')}/
+      @prs.count { |pr| pr.head_ref_name&.match?(regex) }
+    end
+
+    # Returns the average lead time for PRs (from creation to merge) as a formatted string.
+    #
+    # @return [String] Average lead time formatted as "Xd HH:MM:SS".
+    def lead_time
+      return "0d 00:00:00" if @prs.empty?
+
+      times = @prs.map do |pr|
+        merged_at = pr.merged_at
+        created_at = pr.created_at
+        merged_at && created_at ? merged_at - created_at : 0
+      end
+
+      average_time = times.sum.fdiv(times.size)
+      format_time(average_time)
+    end
+
+    # Returns the failure rate (percentage of rollback PRs).
+    #
+    # @return [String, Float] Percentage of rollback PRs or "-" if no PRs.
+    def failure_rate
+      return "-" if @prs.empty?
+      ((rollback_prs_length.to_f / @prs.count) * 100).round(2)
+    end
+
+    # Returns the average PR size (additions + deletions).
+    #
+    # @return [Float] Average PR size.
+    def average_changed_line_size
+      return 0 if @prs.empty?
+      sizes = @prs.map { |pr| pr.additions + pr.deletions }
+      (sizes.sum.to_f / sizes.size).round(2)
+    end
+
+    # Returns the average number of changed files per PR.
+    #
+    # @return [Float] Average number of changed files.
+    def average_changed_file
+      return 0 if @prs.empty?
+      files = @prs.map(&:changed_files)
+      (files.sum.to_f / files.size).round(2)
+    end
+
+    # Returns the maximum PR size (additions + deletions).
+    #
+    # @return [Integer] Maximum PR size.
+    def max_pr_size
+      return 0 if @prs.empty?
+      @prs.map { |pr| pr.additions + pr.deletions }.max
+    end
+
+    # Returns the minimum PR size (additions + deletions).
+    #
+    # @return [Integer] Minimum PR size.
+    def min_pr_size
+      return 0 if @prs.empty?
+      @prs.map { |pr| pr.additions + pr.deletions }.min
+    end
+
+    # Returns the average number of commits per PR.
+    #
+    # @return [Float] Average number of commits.
+    def average_commits_count
+      return 0 if @prs.empty?
+      counts = @prs.map(&:commits_count)
+      (counts.sum.to_f / counts.size).round(2)
+    end
+
+    # Returns the average number of reviews per PR.
+    #
+    # @return [Float] Average number of reviews.
+    def average_reviews_count
+      return 0 if @prs.empty?
+      counts = @prs.map(&:reviews_count)
+      (counts.sum.to_f / counts.size).round(2)
+    end
+
+    # Returns the average number of review requests per PR.
+    #
+    # @return [Float] Average number of review requests.
+    def average_review_requests_count
+      return 0 if @prs.empty?
+      counts = @prs.map(&:review_requests_count)
+      (counts.sum.to_f / counts.size).round(2)
+    end
+
+    # Returns the percentage of PRs that are drafts.
+    #
+    # @return [Float] Percentage of draft PRs.
+    def draft_pr_rate
+      return 0 if @prs.empty?
+      draft_count = @prs.count(&:draft?)
+      ((draft_count.to_f / @prs.size) * 100).round(2)
+    end
+
+    # Returns a hash with label names as keys and their counts as values.
+    #
+    # @return [Hash] Label counts.
+    def label_counts
+      @prs.flat_map(&:labels).compact.tally
+    end
+
+    # Returns a hash with assignee names as keys and their counts as values.
+    #
+    # @return [Hash] Assignee counts.
+    def assignee_counts
+      @prs.flat_map(&:assignees).compact.tally
+    end
+
+    # Returns a hash with milestone titles as keys and their counts as values.
+    #
+    # @return [Hash] Milestone counts.
+    def milestone_counts
+      @prs.map(&:milestone).compact.tally
+    end
+
+    # Returns the average PR age in days (from creation to close, or now if open).
+    #
+    # @return [Float] Average PR age in days.
+    def average_pr_age
+      return 0 if @prs.empty?
+      ages = @prs.map do |pr|
+        closed = pr.closed_at || Time.now
+        created = pr.created_at
+        created && closed ? (closed - created) / 86400.0 : 0
+      end
+      (ages.sum / ages.size).round(2)
+    end
+
+    # Returns the maximum PR age in days.
+    #
+    # @return [Float] Maximum PR age in days.
+    def max_pr_age
+      return 0 if @prs.empty?
+      ages = @prs.map do |pr|
+        closed = pr.closed_at || Time.now
+        created = pr.created_at
+        created && closed ? (closed - created) / 86400.0 : 0
+      end
+      ages.max.round(2)
+    end
+
+    # Returns the minimum PR age in days.
+    #
+    # @return [Float] Minimum PR age in days.
+    def min_pr_age
+      return 0 if @prs.empty?
+      ages = @prs.map do |pr|
+        closed = pr.closed_at || Time.now
+        created = pr.created_at
+        created && closed ? (closed - created) / 86400.0 : 0
+      end
+      ages.min.round(2)
+    end
+
+    # Returns the number of draft PRs.
+    #
+    # @return [Integer] Number of draft PRs.
+    def draft_pr_count
+      @prs.count(&:draft?)
+    end
+
+    # Returns the number of merged PRs.
+    #
+    # @return [Integer] Number of merged PRs.
+    def merged_pr_count
+      @prs.count { |pr| !pr.merged_at.nil? }
+    end
+
+    # Returns the number of closed but unmerged PRs.
+    #
+    # @return [Integer] Number of closed but unmerged PRs.
+    def closed_unmerged_pr_count
+      @prs.count { |pr| pr.closed_at && pr.merged_at.nil? }
+    end
+
+    private
+
+    def count_prs_with_excluded_account(prs, excluded_accounts)
+      return prs if excluded_accounts.empty?
+      prs.reject { |pr| excluded_accounts.include?(pr.author) }
+    end
+
+    def format_time(seconds)
+      return "0d 00:00:00" if seconds.nan? || seconds.infinite?
+      days, remaining = seconds.divmod(86_400)
+      Time.at(remaining).utc.strftime("#{days}d %H:%M:%S")
+    end
+  end
+end

data/lib/dev_metrics/pull_request_wrapper.rb

@@ -0,0 +1,112 @@
+module DevMetrics
+  class PullRequestWrapper
+
+    def initialize(row)
+      @raw = row['node']
+    end
+
+    def url
+      @raw['url']
+    end
+
+    def number
+      @raw['number']
+    end
+
+    def title
+      @raw['title']
+    end
+
+    def body
+      @raw['body']
+    end
+
+    def state
+      @raw['state']
+    end
+
+    def created_at
+      Time.parse(@raw['createdAt'] || @raw['publishedAt']) rescue nil
+    end
+
+    def updated_at
+      Time.parse(@raw['updatedAt']) rescue nil
+    end
+
+    def closed_at
+      Time.parse(@raw['closedAt']) rescue nil
+    end
+
+    def merged_at
+      Time.parse(@raw['mergedAt']) rescue nil
+    end
+
+    def published_at
+      Time.parse(@raw['publishedAt']) rescue nil
+    end
+
+    def author
+      @raw.dig('author', 'login')
+    end
+
+    def assignees
+      Array(@raw.dig('assignees', 'nodes')).map { |a| a['login'] }
+    end
+
+    def labels
+      Array(@raw.dig('labels', 'nodes')).map { |l| l['name'] }
+    end
+
+    def head_ref_name
+      @raw['headRefName']
+    end
+
+    def base_ref_name
+      @raw['baseRefName']
+    end
+
+    def additions
+      @raw['additions'].to_i
+    end
+
+    def deletions
+      @raw['deletions'].to_i
+    end
+
+    def changed_files
+      @raw['changedFiles'].to_i
+    end
+
+    def commits_count
+      @raw.dig('commits', 'totalCount').to_i
+    end
+
+    def reviews_count
+      @raw.dig('reviews', 'totalCount').to_i
+    end
+
+    def review_requests_count
+      @raw.dig('reviewRequests', 'totalCount').to_i
+    end
+
+    def merged_by
+      @raw.dig('mergedBy', 'login')
+    end
+
+    def milestone
+      @raw.dig('milestone', 'title')
+    end
+
+    def draft?
+      @raw['isDraft']
+    end
+
+    def mergeable
+      @raw['mergeable']
+    end
+
+    def merge_commit_oid
+      @raw.dig('mergeCommit', 'oid')
+    end
+  end
+end

data/lib/dev_metrics/query_builder.rb

@@ -1,44 +1,63 @@
-module DevMetrics
-  class QueryBuilder
-
-    def initialize(repo)
-      @repo = repo
-    end
-    def access_auth_check
-      to_body <<~GRAPHQL
-      {
-         repository(owner: "#{@repo.split('/')[0]}", name: "#{@repo.split('/')[1]}"){
-          id
-        }
-      }
-    GRAPHQL
-    end
-
-    def pull_requests_for(period)
-      to_body <<~GRAPHQL
-      {
-        search(query: "repo:#{@repo} is:pr merged:#{period}", type: ISSUE, first: 100) {
-          edges {
-            node {
-              ... on PullRequest {
-                url
-                title
-                author { login }
-                mergedAt
-                headRefName
-                publishedAt
-              }
-            }
-          }
-        }
-      }
-    GRAPHQL
-    end
-
-    private
-
-    def to_body(query_string)
-      { "query" => query_string.strip }.to_json
-    end
-  end
-end
+module DevMetrics
+  class QueryBuilder
+
+    def initialize(repo)
+      @repo = repo
+    end
+
+    def access_auth_check
+      to_body <<~GRAPHQL
+      {
+         repository(owner: "#{@repo.split('/')[0]}", name: "#{@repo.split('/')[1]}"){
+          id
+        }
+      }
+      GRAPHQL
+    end
+
+    def pull_requests_for(period)
+      to_body <<~GRAPHQL
+      {
+        search(query: "repo:#{@repo} is:pr merged:#{period}", type: ISSUE, first: 100) {
+          edges {
+            node {
+              ... on PullRequest {
+                url
+                number
+                title
+                body
+                state
+                createdAt
+                updatedAt
+                closedAt
+                mergedAt
+                author { login }
+                assignees(first: 10) { nodes { login } }
+                labels(first: 10) { nodes { name } }
+                headRefName
+                baseRefName
+                additions
+                deletions
+                changedFiles
+                commits { totalCount }
+                reviews { totalCount }
+                reviewRequests { totalCount }
+                mergedBy { login }
+                milestone { title }
+                isDraft
+                mergeable
+              }
+            }
+          }
+        }
+      }
+      GRAPHQL
+    end
+
+    private
+
+    def to_body(query_string)
+      { "query" => query_string.strip }.to_json
+    end
+  end
+end

data/lib/dev_metrics/version.rb

@@ -0,0 +1,3 @@
+module DevMetrics
+  VERSION = "0.2.5"
+end

data/lib/dev_metrics.rb

@@ -1,29 +1,100 @@
-require_relative 'dev_metrics/markdown'
-
-module DevMetrics
-  class Config
-    attr_accessor :access_token, :repo_name, :bot_accounts, :fix_branch_names
-
-    def initialize
-      @access_token = nil
-      @repo_name = nil
-      @bot_accounts = nil
-      @fix_branch_names = nil
-    end
-  end
-
-  @configuration = Config.new
-
-  def self.configuration
-    @configuration
-  end
-
-  def self.configure
-    yield(configuration)
-  end
-
-  def self.run(period:, format:)
-    client = format.new(@configuration)
-    client.process(period: period)
-  end
-end
+require 'optparse'
+require 'yaml'
+require_relative 'dev_metrics/markdown'
+require_relative 'dev_metrics/version'
+require_relative 'dev_metrics/client'
+require_relative 'dev_metrics/metrics_calc'
+require_relative 'dev_metrics/csv'
+require_relative 'dev_metrics/json'
+
+
+module DevMetrics
+  class Config
+    attr_accessor :access_token, :repo_name, :excluded_accounts, :rollback_branch_prefixes
+
+    def initialize
+      @access_token = nil
+      @repo_name = nil
+      @excluded_accounts = []
+      @rollback_branch_prefixes = []
+    end
+
+    def load_from_yaml(path = "dev_metrics_config.yml")
+      unless File.exist?(path)
+        warn "Config file '#{path}' not found. Please create it before running this tool."
+        exit 1
+      end
+
+      config = YAML.load_file(path)
+      if config["access_token"].nil? || config["repo_name"].nil?
+        warn "Config file must include 'access_token' and 'repo_name'."
+        exit 1
+      end
+
+      @access_token = config["access_token"]
+      @repo_name = config["repo_name"]
+      @excluded_accounts = config["excluded_accounts"] || []
+      @rollback_branch_prefixes = config["rollback_branch_prefixes"] || []
+    end
+  end
+
+  @configuration = Config.new
+
+  def self.configuration
+    @configuration
+  end
+
+  def self.option_parse(argv)
+    options = {
+      period: (Date.today << 1).strftime("%Y-%m"),
+      format: "csv",
+      config: "dev_metrics_config.yml"
+    }
+    OptionParser.new do |opts|
+      opts.banner = "Usage: dev_metrics [options]"
+
+      opts.on("-c", "--config FILE", "Specify config YAML file (default: dev_metrics_config.yml)") do |file|
+        options[:config] = file
+      end
+
+      opts.on("-p", "--period PERIOD", "Specify the period for metrics (e.g., '2025-05' or '2025-05-01..2025-05-31')") do |period|
+        options[:period] = period
+      end
+
+      opts.on("-f", "--format FORMAT", "Specify the output format (e.g., 'csv', 'json', 'markdown')") do |format|
+        options[:format] = format
+      end
+
+      opts.on("-h", "--help", "Display this help message") do
+        puts opts
+        exit
+      end
+    end.parse!(argv)
+    options
+  end
+
+  def self.run(argv: nil)
+    argv ||= ARGV
+    options = option_parse(argv)
+    config_file = options[:config] || "dev_metrics_config.yml"
+    @configuration.load_from_yaml(config_file)
+    period = options[:period]
+    format = options[:format]
+
+    client = DevMetrics::Client.new(@configuration)
+    prs = client.fetch(period: period)
+
+    case format
+    when "csv"
+      DevMetrics::Csv.new(prs).call
+    when "markdown"
+      DevMetrics::Markdown.new(prs).call
+    when "json"
+      DevMetrics::Json.new(prs).call
+    else
+      warn "Unknown format: #{format}"
+      warn "Available formats: csv, markdown, json"
+      exit 1
+    end
+  end
+end

metadata

@@ -1,25 +1,33 @@
 --- !ruby/object:Gem::Specification
 name: dev_metrics
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.5
 platform: ruby
 authors:
 - sean2121
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-04-17 00:00:00.000000000 Z
+date: 2025-06-19 00:00:00.000000000 Z
 dependencies: []
 description: 
 email: 
-executables: []
+executables:
+- dev_metrics
 extensions: []
 extra_rdoc_files: []
 files:
+- bin/dev_metrics
 - lib/dev_metrics.rb
 - lib/dev_metrics/client.rb
+- lib/dev_metrics/csv.rb
+- lib/dev_metrics/format_base.rb
+- lib/dev_metrics/json.rb
 - lib/dev_metrics/markdown.rb
+- lib/dev_metrics/metrics_calc.rb
+- lib/dev_metrics/pull_request_wrapper.rb
 - lib/dev_metrics/query_builder.rb
+- lib/dev_metrics/version.rb
 homepage: 
 licenses:
 - MIT