ledger_sync 1.1.3 → 1.3.1

data/_config.yml

@@ -0,0 +1 @@
+theme: jekyll-theme-cayman

data/bin/qa

@@ -0,0 +1,3 @@
+#!/bin/bash
+
+bundle exec rspec qa -I ./qa --require qa_helper.rb $@

data/ledger_sync.gemspec

@@ -31,6 +31,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency('bump')
   spec.add_development_dependency('bundler', '~> 1.16')
   spec.add_development_dependency('byebug', '>= 0')
+  spec.add_development_dependency('factory_bot')
   spec.add_development_dependency('rake', '~> 10.0')
   spec.add_development_dependency('rspec', '~> 3.2')
   spec.add_development_dependency('rubocop', '>= 0')
@@ -39,14 +40,17 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency('activemodel', '>= 0')
   spec.add_runtime_dependency('colorize', '>= 0')
   spec.add_runtime_dependency('coveralls')
+  spec.add_runtime_dependency('dotenv')
   spec.add_runtime_dependency('dry-schema')
   spec.add_runtime_dependency('dry-validation')
   spec.add_runtime_dependency('faraday', '>= 0')
   spec.add_runtime_dependency('faraday-detailed_logger', '>= 0')
   spec.add_runtime_dependency('faraday_middleware', '>= 0')
   spec.add_runtime_dependency('fingerprintable', '>= 1.2.1')
+  spec.add_runtime_dependency('netsuite')
   spec.add_runtime_dependency('nokogiri', '>= 0')
   spec.add_runtime_dependency('oauth2', '>= 0')
   spec.add_runtime_dependency('resonad', '>= 0')
   spec.add_runtime_dependency('simply_serializable', '>= 1.3.0')
+  spec.add_runtime_dependency('stripe')
 end

data/lib/ledger_sync.rb

@@ -10,6 +10,14 @@ require 'colorize'
 require 'fingerprintable'
 require 'simply_serializable'
 require 'active_model'
+require 'stripe'
+require 'netsuite'
+require 'oauth2'
+require 'tempfile'
+
+# Dotenv
+require 'dotenv'
+Dotenv.load
 
 # Version
 require 'ledger_sync/version'
@@ -25,7 +33,9 @@ require 'ledger_sync/error'
 Gem.find_files('ledger_sync/error/**/*.rb').each { |path| require path }
 
 # Support Classes
+require 'ledger_sync/util/resonad'
 require 'ledger_sync/util/debug'
+require 'ledger_sync/util/signer'
 require 'ledger_sync/util/hash_helpers'
 require 'ledger_sync/util/resources_builder'
 require 'ledger_sync/adaptor_configuration'
@@ -34,24 +44,20 @@ require 'ledger_sync/util/performer'
 require 'ledger_sync/util/validator'
 require 'ledger_sync/util/string_helpers'
 require 'ledger_sync/result'
+
+# Adaptors
+Gem.find_files('ledger_sync/adaptors/mixins/**/*.rb').each { |path| require path }
+require 'ledger_sync/adaptors/adaptor'
+require 'ledger_sync/adaptors/searcher'
+require 'ledger_sync/adaptors/ledger_serializer'
 require 'ledger_sync/adaptors/operation'
 require 'ledger_sync/adaptors/contract'
+require 'ledger_sync/adaptors/response'
+require 'ledger_sync/adaptors/request'
 
 # Resources (resources are registerd below)
 require 'ledger_sync/resource' # Template class
-require 'ledger_sync/resources/account'
-require 'ledger_sync/resources/customer'
-require 'ledger_sync/resources/vendor'
-require 'ledger_sync/resources/payment'
-require 'ledger_sync/resources/expense_line_item'
-require 'ledger_sync/resources/expense'
-require 'ledger_sync/resources/deposit_line_item'
-require 'ledger_sync/resources/deposit'
-require 'ledger_sync/resources/transfer'
-require 'ledger_sync/resources/bill_line_item'
-require 'ledger_sync/resources/bill'
-require 'ledger_sync/resources/journal_entry_line_item'
-require 'ledger_sync/resources/journal_entry'
+Gem.find_files('ledger_sync/resources/**/*.rb').each { |path| require path }
 
 module LedgerSync
   @log_level = nil
@@ -84,13 +90,13 @@ module LedgerSync
     @logger = val
   end
 
-  def self.register_adaptor(adaptor_key)
+  def self.register_adaptor(adaptor_key, module_string: nil)
     adaptor_root_path = "ledger_sync/adaptors/#{adaptor_key}"
     require "#{adaptor_root_path}/adaptor"
     self.adaptors ||= LedgerSync::AdaptorConfigurationStore.new
-    self.adaptors.register_adaptor(adaptor_key)
-
-    yield(adaptors.send(adaptor_key))
+    adaptor_config = LedgerSync::AdaptorConfiguration.new(adaptor_key, module_string: module_string)
+    yield(adaptor_config)
+    self.adaptors.register_adaptor(adaptor_config: adaptor_config)
 
     adaptor_files = Gem.find_files("#{adaptor_root_path}/**/*.rb")
     # Sort the files to include BFS-style as most dependencies are in parent folders
@@ -113,23 +119,27 @@ module LedgerSync
   end
 end
 
-# Adaptors
-require 'ledger_sync/adaptors/adaptor'
-require 'ledger_sync/adaptors/searcher'
-require 'ledger_sync/adaptors/ledger_serializer'
+# Load Adaptors
 Gem.find_files('ledger_sync/adaptors/**/config.rb').each { |path| require path }
 
 # Register Resources
 LedgerSync.register_resource(resource: LedgerSync::Account)
+LedgerSync.register_resource(resource: LedgerSync::Bill)
+LedgerSync.register_resource(resource: LedgerSync::BillLineItem)
+LedgerSync.register_resource(resource: LedgerSync::Currency)
 LedgerSync.register_resource(resource: LedgerSync::Customer)
-LedgerSync.register_resource(resource: LedgerSync::Vendor)
-LedgerSync.register_resource(resource: LedgerSync::Payment)
-LedgerSync.register_resource(resource: LedgerSync::ExpenseLineItem)
-LedgerSync.register_resource(resource: LedgerSync::Expense)
-LedgerSync.register_resource(resource: LedgerSync::DepositLineItem)
+LedgerSync.register_resource(resource: LedgerSync::Department)
 LedgerSync.register_resource(resource: LedgerSync::Deposit)
-LedgerSync.register_resource(resource: LedgerSync::Transfer)
-LedgerSync.register_resource(resource: LedgerSync::BillLineItem)
-LedgerSync.register_resource(resource: LedgerSync::Bill)
-LedgerSync.register_resource(resource: LedgerSync::JournalEntryLineItem)
+LedgerSync.register_resource(resource: LedgerSync::DepositLineItem)
+LedgerSync.register_resource(resource: LedgerSync::Expense)
+LedgerSync.register_resource(resource: LedgerSync::ExpenseLineItem)
+LedgerSync.register_resource(resource: LedgerSync::Invoice)
+LedgerSync.register_resource(resource: LedgerSync::InvoiceSalesLineItem)
+LedgerSync.register_resource(resource: LedgerSync::Item)
 LedgerSync.register_resource(resource: LedgerSync::JournalEntry)
+LedgerSync.register_resource(resource: LedgerSync::JournalEntryLineItem)
+LedgerSync.register_resource(resource: LedgerSync::LedgerClass)
+LedgerSync.register_resource(resource: LedgerSync::Payment)
+LedgerSync.register_resource(resource: LedgerSync::PaymentLineItem)
+LedgerSync.register_resource(resource: LedgerSync::Transfer)
+LedgerSync.register_resource(resource: LedgerSync::Vendor)

data/lib/ledger_sync/adaptor_configuration.rb

@@ -5,7 +5,7 @@ module LedgerSync
     include Fingerprintable::Mixin
     include SimplySerializable::Mixin
 
-    attr_accessor :module,
+    attr_accessor :module_string,
                   :name,
                   :rate_limiting_wait_in_seconds,
                   :test
@@ -15,39 +15,45 @@ module LedgerSync
 
     serialize only: %i[
       aliases
-      module
+      module_string
       root_key
       rate_limiting_wait_in_seconds
       test
     ]
 
-    def initialize(root_key)
+    def initialize(root_key, module_string: nil)
       @root_key = root_key
       @aliases = []
-      @module = LedgerSync::Util::StringHelpers.camelcase(root_key)
+      @module_string = module_string || LedgerSync::Util::StringHelpers.camelcase(root_key)
     end
 
     def adaptor_klass
       @adaptor_klass ||= base_module::Adaptor
     end
 
-    def base_module
-      @base_module ||= begin
-        LedgerSync::Adaptors.const_get(@module)
-      end
-    end
-
     def add_alias(new_alias)
       @aliases << new_alias
       LedgerSync.adaptors.add_alias(new_alias, self)
     end
 
-    # Delegate new to the adaptor class enabling faster adaptor initialization
+    def base_module
+      @base_module ||= begin
+        LedgerSync::Adaptors.const_get(@module_string)
+      end
+    end
+
+    # Delegate #new to the adaptor class enabling faster adaptor initialization
     # e.g. LedgerSync.adaptors.test.new(...)
     def new(*args)
       adaptor_klass.new(*args)
     end
 
+    # Delegate #new_from_env to the adaptor class enabling faster adaptor initialization
+    # e.g. LedgerSync.adaptors.test.new_from_env(...)
+    def new_from_env(*args)
+      adaptor_klass.new_from_env(*args)
+    end
+
     def test?
       test == true
     end

data/lib/ledger_sync/adaptor_configuration_store.rb

@@ -2,11 +2,12 @@ module LedgerSync
   class AdaptorConfigurationStore
     include Enumerable
 
-    attr_reader :configs
+    attr_reader :configs, :inflections
 
     def initialize
       @keys = []
       @configs = {}
+      @inflections = []
       @klass_configs = {}
     end
 
@@ -17,7 +18,7 @@ module LedgerSync
         return
       end
 
-      instance_methods_for(adaptor_key, existing_config)
+      _instance_methods_for(adaptor_key: adaptor_key, adaptor_config: existing_config)
     end
 
     def config_from_klass(klass:)
@@ -28,24 +29,27 @@ module LedgerSync
       configs.each { |k, v| yield(k, v) }
     end
 
-    def register_adaptor(adaptor_key)
-      instance_methods_for(adaptor_key)
+    def register_adaptor(adaptor_config:)
+      _instance_methods_for(
+        adaptor_key: adaptor_config.root_key,
+        adaptor_config: adaptor_config
+      )
     end
 
     private
 
-    def instance_methods_for(adaptor_key, existing_config = nil)
+    def _instance_methods_for(adaptor_key:, adaptor_config:)
       @keys << adaptor_key.to_sym
 
-      config = existing_config || LedgerSync::AdaptorConfiguration.new(adaptor_key)
-      @configs[adaptor_key] = config
-      @klass_configs[config.adaptor_klass] = config
+      @configs[adaptor_key] = adaptor_config
+      @klass_configs[adaptor_config.adaptor_klass] = adaptor_config
 
       instance_variable_set(
         "@#{adaptor_key}",
-        config
+        adaptor_config
       )
 
+      @inflections |= [adaptor_config.module_string]
       self.class.class_eval { attr_reader adaptor_key }
     end
   end

data/lib/ledger_sync/adaptors/adaptor.rb

@@ -20,7 +20,7 @@ module LedgerSync
       end
 
       def base_module
-        adaptor_configuration.base_module
+        self.class.base_module
       end
 
       def ledger_attributes_to_save
@@ -49,6 +49,14 @@ module LedgerSync
         nil
       end
 
+      def self.base_module
+        config.base_module
+      end
+
+      def self.base_operation_module_for(resource_class:)
+        base_module.const_get("#{resource_class.resource_module_str}::Operations")
+      end
+
       def self.config
         @config ||= LedgerSync.adaptors.config_from_klass(klass: self)
       end

data/lib/ledger_sync/adaptors/ledger_serializer.rb

@@ -8,6 +8,8 @@ Gem.find_files('ledger_sync/adaptors/ledger_serializer_type/**/*.rb').each { |pa
 module LedgerSync
   module Adaptors
     class LedgerSerializer
+      include Mixins::InferResourceClassMixin
+
       attr_reader :resource
 
       def initialize(resource:)
@@ -90,11 +92,6 @@ module LedgerSync
         )
       end
 
-      def self._inferred_resource_class
-        parts = name.split('::')
-        LedgerSync.const_get(parts[parts.index('Adaptors') + 2])
-      end
-
       private_class_method def self._attribute(**keywords)
         attributes.add(
           _build_attribute(**keywords)
@@ -116,7 +113,7 @@ module LedgerSync
       private
 
       def ensure_inferred_resource_class!
-        inferred_resource_class = self.class._inferred_resource_class
+        inferred_resource_class = self.class.inferred_resource_class
         raise "Resource must be a #{inferred_resource_class.name}.  Given #{resource.class}" unless resource.is_a?(inferred_resource_class)
       end
     end

data/lib/ledger_sync/adaptors/ledger_serializer_attribute_set.rb

@@ -32,7 +32,7 @@ module LedgerSync
         end
 
         if attribute.resource_attribute.present?
-          raise "resource_attribute already defined for #{serializer_class.name}: #{attribute.resource_attribute}" if resource_attribute_keyed_hash.key?(attribute.resource_attribute.to_s)
+          # raise "resource_attribute already defined for #{serializer_class.name}: #{attribute.resource_attribute}" if resource_attribute_keyed_hash.key?(attribute.resource_attribute.to_s)
 
           resource_attribute_keyed_hash[attribute.resource_attribute.to_s] = attribute
         end

data/lib/ledger_sync/adaptors/ledger_serializer_type/references_many_type.rb

@@ -5,7 +5,7 @@ module LedgerSync
     module LedgerSerializerType
       class ReferencesManyType < ValueType
         def convert_from_ledger(resource_class: nil, serializer:, value:)
-          resource_class ||= serializer._inferred_resource_class
+          resource_class ||= serializer.inferred_resource_class
           return [] if value.nil?
 
           value.map do |one_value|

data/lib/ledger_sync/adaptors/mixins/infer_adaptor_class_mixin.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module Adaptors
+    module Mixins
+      module InferAdaptorClassMixin
+        module ClassMethods
+          def inferred_adaptor_class
+            @inferred_adaptor_class ||= begin
+              parts = name.split('::')
+              LedgerSync::Adaptors.const_get(
+                parts[parts.index('Adaptors') + 1]
+              )::Adaptor
+            end
+          end
+        end
+
+        def self.included(base)
+          base.extend ClassMethods
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/adaptors/mixins/infer_ledger_serializer_mixin.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module Adaptors
+    module Mixins
+      module InferLedgerSerializerMixin
+        module ClassMethods
+          def inferred_ledger_serializer(resource:)
+            @inferred_ledger_serializer ||= inferred_ledger_serializer_class.new(
+              resource: resource
+            )
+          end
+
+          def inferred_ledger_serializer_class
+            @inferred_ledger_serializer_class ||= begin
+              inferred_adaptor_class.base_module.const_get(
+                "#{inferred_resource_class.resource_module_str}::LedgerSerializer"
+              )
+            end
+          end
+        end
+
+        def self.included(base)
+          base.include InferAdaptorClassMixin
+          base.include InferResourceClassMixin
+          base.extend ClassMethods
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/adaptors/mixins/infer_resource_class_mixin.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module Adaptors
+    module Mixins
+      module InferResourceClassMixin
+        module ClassMethods
+          def inferred_resource_class
+            @inferred_resource_class ||= begin
+              parts = name.split('::')
+              LedgerSync.const_get(parts[parts.index('Adaptors') + 2])
+            end
+          end
+        end
+
+        def self.included(base)
+          base.extend ClassMethods
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/adaptors/mixins/offset_and_limit_pagination_searcher_mixin.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module Adaptors
+    module Mixins
+      module OffsetAndLimitPaginationSearcherMixin
+        def next_searcher
+          paginate(limit: limit, offset: offset + limit)
+        end
+
+        def previous_searcher
+          return nil if offset <= 1
+
+          paginate(limit: limit, offset: offset - limit)
+        end
+
+        private
+
+        def default_offset
+          raise NotImplementedError
+        end
+
+        def default_limit
+          10
+        end
+
+        def limit
+          pagination.fetch(:limit, default_limit).to_i
+        end
+
+        def offset
+          pagination.fetch(:offset, default_offset).to_i
+        end
+      end
+    end
+  end
+end