attio-ruby 0.1.3 → 0.1.5

data/lib/attio/util/currency_formatter.rb

@@ -0,0 +1,143 @@
+# frozen_string_literal: true
+
+module Attio
+  module Util
+    # Utility class for formatting currency amounts
+    class CurrencyFormatter
+      # Map of currency codes to their symbols
+      CURRENCY_SYMBOLS = {
+        "USD" => "$",
+        "EUR" => "€",
+        "GBP" => "£",
+        "JPY" => "¥",
+        "CNY" => "¥",
+        "INR" => "₹",
+        "KRW" => "₩",
+        "CAD" => "$",
+        "AUD" => "$",
+        "CHF" => "CHF ",
+        "SEK" => "SEK ",
+        "NOK" => "NOK ",
+        "DKK" => "DKK ",
+        "PLN" => "zł",
+        "BRL" => "R$",
+        "MXN" => "$",
+        "NZD" => "$",
+        "SGD" => "$",
+        "HKD" => "$",
+        "ZAR" => "R",
+        "THB" => "฿",
+        "PHP" => "₱",
+        "IDR" => "Rp",
+        "MYR" => "RM",
+        "VND" => "₫",
+        "TRY" => "₺",
+        "RUB" => "₽",
+        "UAH" => "₴",
+        "ILS" => "₪",
+        "AED" => "د.إ",
+        "SAR" => "﷼",
+        "CLP" => "$",
+        "COP" => "$",
+        "PEN" => "S/",
+        "ARS" => "$"
+      }.freeze
+
+      # Currencies that typically don't use decimal places
+      NO_DECIMAL_CURRENCIES = %w[JPY KRW VND IDR CLP].freeze
+
+      class << self
+        # Format an amount with the appropriate currency symbol
+        # @param amount [Numeric] The amount to format
+        # @param currency_code [String] The ISO 4217 currency code
+        # @param options [Hash] Formatting options
+        # @option options [Integer] :decimal_places Number of decimal places (auto-determined by default)
+        # @option options [String] :thousands_separator Character for thousands separation (default: ",")
+        # @option options [String] :decimal_separator Character for decimal separation (default: ".")
+        # @return [String] The formatted currency string
+        def format(amount, currency_code = "USD", options = {})
+          currency_code = currency_code.to_s.upcase
+          symbol = symbol_for(currency_code)
+
+          # Determine decimal places
+          decimal_places = options[:decimal_places] || decimal_places_for(currency_code)
+          thousands_sep = options[:thousands_separator] || ","
+          decimal_sep = options[:decimal_separator] || "."
+
+          # Handle zero amounts
+          if amount == 0
+            if decimal_places > 0
+              return "#{symbol}0#{decimal_sep}#{"0" * decimal_places}"
+            else
+              return "#{symbol}0"
+            end
+          end
+
+          # Handle negative amounts
+          negative = amount < 0
+          abs_amount = amount.abs
+
+          # Format the amount
+          if decimal_places == 0
+            # No decimal places
+            formatted = format_with_separators(abs_amount.to_i, thousands_sep)
+            formatted = "-#{formatted}" if negative
+            "#{symbol}#{formatted}"
+          else
+            # With decimal places
+            whole = abs_amount.to_i
+            decimal = ((abs_amount - whole) * (10**decimal_places)).round
+            formatted_whole = format_with_separators(whole, thousands_sep)
+            formatted_whole = "-#{formatted_whole}" if negative
+            formatted_decimal = decimal.to_s.rjust(decimal_places, "0")
+            "#{symbol}#{formatted_whole}#{decimal_sep}#{formatted_decimal}"
+          end
+        end
+
+        # Get the currency symbol for a given code
+        # @param currency_code [String] The ISO 4217 currency code
+        # @return [String] The currency symbol or code with space
+        def symbol_for(currency_code)
+          currency_code = currency_code.to_s.upcase
+          CURRENCY_SYMBOLS[currency_code] || "#{currency_code} "
+        end
+
+        # Determine the number of decimal places for a currency
+        # @param currency_code [String] The ISO 4217 currency code
+        # @return [Integer] Number of decimal places
+        def decimal_places_for(currency_code)
+          currency_code = currency_code.to_s.upcase
+          NO_DECIMAL_CURRENCIES.include?(currency_code) ? 0 : 2
+        end
+
+        # Check if a currency typically uses decimal places
+        # @param currency_code [String] The ISO 4217 currency code
+        # @return [Boolean] True if the currency uses decimals
+        def uses_decimals?(currency_code)
+          decimal_places_for(currency_code) > 0
+        end
+
+        # Format just the numeric part without currency symbol
+        # @param amount [Numeric] The amount to format
+        # @param currency_code [String] The ISO 4217 currency code
+        # @param options [Hash] Formatting options (same as format method)
+        # @return [String] The formatted number without currency symbol
+        def format_number(amount, currency_code = "USD", options = {})
+          result = format(amount, currency_code, options)
+          symbol = symbol_for(currency_code)
+          result.sub(/^#{Regexp.escape(symbol)}/, "")
+        end
+
+        private
+
+        # Add thousands separators to a number
+        # @param number [Integer] The number to format
+        # @param separator [String] The separator character
+        # @return [String] The formatted number
+        def format_with_separators(number, separator)
+          number.to_s.reverse.gsub(/(\d{3})(?=\d)/, "\\1#{separator}").reverse
+        end
+      end
+    end
+  end
+end

data/lib/attio/util/time_period.rb

@@ -0,0 +1,219 @@
+# frozen_string_literal: true
+
+require "date"
+
+module Attio
+  module Util
+    # Utility class for time period calculations
+    class TimePeriod
+      attr_reader :start_date, :end_date
+
+      def initialize(start_date, end_date)
+        @start_date = parse_date(start_date)
+        @end_date = parse_date(end_date)
+      end
+
+      private
+
+      def parse_date(date)
+        case date
+        when Date
+          date
+        when String
+          Date.parse(date)
+        else
+          date.to_date
+        end
+      end
+
+      public
+
+      # Named constructors for common periods
+
+      # Current year to date
+      def self.year_to_date
+        today = Date.today
+        new(Date.new(today.year, 1, 1), today)
+      end
+
+      # Current month to date
+      def self.month_to_date
+        today = Date.today
+        new(Date.new(today.year, today.month, 1), today)
+      end
+
+      # Current quarter to date
+      def self.quarter_to_date
+        today = Date.today
+        quarter = (today.month - 1) / 3 + 1
+        quarter_start = Date.new(today.year, (quarter - 1) * 3 + 1, 1)
+        new(quarter_start, today)
+      end
+
+      # Specific quarter
+      def self.quarter(year, quarter_num)
+        raise ArgumentError, "Quarter must be between 1 and 4" unless (1..4).cover?(quarter_num)
+        quarter_start = Date.new(year, (quarter_num - 1) * 3 + 1, 1)
+        quarter_end = (quarter_start >> 3) - 1
+        new(quarter_start, quarter_end)
+      end
+
+      # Current quarter (full quarter, not QTD)
+      def self.current_quarter
+        today = Date.today
+        quarter(today.year, (today.month - 1) / 3 + 1)
+      end
+
+      # Previous quarter
+      def self.previous_quarter
+        today = Date.today
+        current_q = (today.month - 1) / 3 + 1
+        if current_q == 1
+          quarter(today.year - 1, 4)
+        else
+          quarter(today.year, current_q - 1)
+        end
+      end
+
+      # Specific month
+      def self.month(year, month_num)
+        raise ArgumentError, "Month must be between 1 and 12" unless (1..12).cover?(month_num)
+        month_start = Date.new(year, month_num, 1)
+        month_end = (month_start >> 1) - 1
+        new(month_start, month_end)
+      end
+
+      # Current month (full month, not MTD)
+      def self.current_month
+        today = Date.today
+        month(today.year, today.month)
+      end
+
+      # Previous month
+      def self.previous_month
+        today = Date.today
+        if today.month == 1
+          month(today.year - 1, 12)
+        else
+          month(today.year, today.month - 1)
+        end
+      end
+
+      # Specific year
+      def self.year(year_num)
+        new(Date.new(year_num, 1, 1), Date.new(year_num, 12, 31))
+      end
+
+      # Current year (full year, not YTD)
+      def self.current_year
+        year(Date.today.year)
+      end
+
+      # Previous year
+      def self.previous_year
+        year(Date.today.year - 1)
+      end
+
+      # Last N days (including today)
+      def self.last_days(num_days)
+        today = Date.today
+        new(today - num_days + 1, today)
+      end
+
+      # Last 7 days
+      def self.last_week
+        last_days(7)
+      end
+
+      # Last 30 days
+      def self.last_30_days
+        last_days(30)
+      end
+
+      # Last 90 days
+      def self.last_90_days
+        last_days(90)
+      end
+
+      # Last 365 days
+      def self.last_year_rolling
+        last_days(365)
+      end
+
+      # Custom range
+      def self.between(start_date, end_date)
+        new(start_date, end_date)
+      end
+
+      # Instance methods
+
+      # Check if a date falls within this period
+      def includes?(date)
+        date = date.to_date
+        date.between?(@start_date, @end_date)
+      end
+
+      # Get the date range
+      def to_range
+        @start_date..@end_date
+      end
+
+      # Number of days in the period
+      def days
+        (@end_date - @start_date).to_i + 1
+      end
+
+      # String representation
+      def to_s
+        if @start_date == @end_date
+          @start_date.to_s
+        else
+          "#{@start_date} to #{@end_date}"
+        end
+      end
+
+      # Human-readable label
+      def label
+        today = Date.today
+
+        # Check for common patterns
+        if @start_date == Date.new(today.year, 1, 1) && @end_date == today
+          "Year to Date"
+        elsif @start_date == Date.new(today.year, today.month, 1) && @end_date == today
+          "Month to Date"
+        elsif @start_date == Date.new(today.year, 1, 1) && @end_date == Date.new(today.year, 12, 31)
+          today.year.to_s
+        elsif @start_date.day == 1 && @end_date == (@start_date >> 1) - 1
+          @start_date.strftime("%B %Y")
+        elsif days == 7 && @end_date == today
+          "Last 7 Days"
+        elsif days == 30 && @end_date == today
+          "Last 30 Days"
+        elsif days == 90 && @end_date == today
+          "Last 90 Days"
+        else
+          # Check for quarters
+          quarter = detect_quarter
+          return quarter if quarter
+
+          to_s
+        end
+      end
+
+      private
+
+      def detect_quarter
+        # Check if this is a complete quarter
+        [1, 2, 3, 4].each do |q|
+          quarter_start = Date.new(@start_date.year, (q - 1) * 3 + 1, 1)
+          quarter_end = (quarter_start >> 3) - 1
+
+          if @start_date == quarter_start && @end_date == quarter_end
+            return "Q#{q} #{@start_date.year}"
+          end
+        end
+        nil
+      end
+    end
+  end
+end

data/lib/attio/version.rb

@@ -2,5 +2,5 @@
 
 module Attio
   # Current version of the Attio Ruby gem
-  VERSION = "0.1.3"
+  VERSION = "0.1.5"
 end

data/lib/attio-ruby.rb

@@ -2,4 +2,4 @@
 
 # This file exists to match the gem name for auto-requiring
 # It simply requires the main attio module
-require_relative "attio"
+require_relative "attio"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: attio-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.5
 platform: ruby
 authors:
 - Robert Beene
@@ -335,7 +335,6 @@ files:
 - LICENSE
 - README.md
 - Rakefile
-- attio-ruby.gemspec
 - docs/CODECOV_SETUP.md
 - examples/app_specific_typed_record.md
 - examples/basic_usage.rb
@@ -349,6 +348,7 @@ files:
 - lib/attio/api_resource.rb
 - lib/attio/builders/name_builder.rb
 - lib/attio/client.rb
+- lib/attio/concerns/time_filterable.rb
 - lib/attio/errors.rb
 - lib/attio/internal/record.rb
 - lib/attio/oauth/client.rb
@@ -370,7 +370,9 @@ files:
 - lib/attio/resources/webhook.rb
 - lib/attio/resources/workspace_member.rb
 - lib/attio/util/configuration.rb
+- lib/attio/util/currency_formatter.rb
 - lib/attio/util/id_extractor.rb
+- lib/attio/util/time_period.rb
 - lib/attio/util/webhook_signature.rb
 - lib/attio/version.rb
 - lib/attio/webhook/event.rb

data/attio-ruby.gemspec

@@ -1,61 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "lib/attio/version"
-
-Gem::Specification.new do |spec|
-  spec.name = "attio-ruby"
-  spec.version = Attio::VERSION
-  spec.authors = ["Robert Beene"]
-  spec.email = ["robert@ismly.com"]
-
-  spec.summary = "Ruby client library for the Attio API"
-  spec.description = "A comprehensive Ruby client library for the Attio CRM API with OAuth support, type safety, and extensive test coverage"
-  spec.homepage = "https://github.com/rbeene/attio_ruby"
-  spec.license = "MIT"
-  spec.required_ruby_version = ">= 3.4.0"
-
-  spec.metadata["allowed_push_host"] = "https://rubygems.org"
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/rbeene/attio_ruby"
-  spec.metadata["changelog_uri"] = "https://github.com/rbeene/attio_ruby/blob/main/CHANGELOG.md"
-  spec.metadata["documentation_uri"] = "https://rubydoc.info/gems/attio-ruby"
-  spec.metadata["bug_tracker_uri"] = "https://github.com/rbeene/attio_ruby/issues"
-
-  # Specify which files should be added to the gem when it is released.
-  spec.files = Dir.chdir(__dir__) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (File.expand_path(f) == __FILE__) ||
-        f.start_with?(*%w[bin/ test/ spec/ features/ .git .github appveyor Gemfile])
-    end
-  end
-  spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  # Runtime dependencies
-  spec.add_dependency "faraday", "~> 2.0"
-  spec.add_dependency "faraday-retry", "~> 2.0"
-  spec.add_dependency "ostruct", "~> 0.6"
-
-  # Development dependencies
-  spec.add_development_dependency "bundler", "~> 2.0"
-  spec.add_development_dependency "rake", "~> 13.0"
-  spec.add_development_dependency "rspec", "~> 3.12"
-  spec.add_development_dependency "webmock", "~> 3.18"
-  spec.add_development_dependency "simplecov", "~> 0.22"
-  spec.add_development_dependency "simplecov-cobertura", "~> 2.1"
-  spec.add_development_dependency "yard", "~> 0.9"
-  spec.add_development_dependency "redcarpet", "~> 3.6"
-  spec.add_development_dependency "rubocop", "~> 1.50"
-  spec.add_development_dependency "rubocop-rspec", "~> 2.20"
-  spec.add_development_dependency "rubocop-performance", "~> 1.17"
-  spec.add_development_dependency "standard", "~> 1.28"
-  spec.add_development_dependency "benchmark-ips", "~> 2.12"
-  spec.add_development_dependency "pry", "~> 0.14"
-  spec.add_development_dependency "pry-byebug", "~> 3.10"
-  spec.add_development_dependency "dotenv", "~> 2.8"
-  spec.add_development_dependency "timecop", "~> 0.9"
-  spec.add_development_dependency "bundle-audit", "~> 0.1"
-  spec.add_development_dependency "brakeman", "~> 6.0"
-  spec.metadata["rubygems_mfa_required"] = "true"
-end