ledger_sync 1.1.3 → 1.3.1

data/qa/stripe/customers_spec.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+RSpec.describe LedgerSync::Adaptors::Stripe::Customer, adaptor: :stripe do
+  let(:adaptor) { stripe_adaptor }
+  let(:attribute_updates) do
+    {
+      name: "QA UPDATE #{rand_id}"
+    }
+  end
+  let(:resource) do
+    FactoryBot.create(:customer)
+  end
+
+  it_behaves_like 'a full stripe resource'
+end

data/qa/support/adaptor_helpers.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+module AdaptorHelpers
+  def adaptor_class
+    raise NotImplementedError
+  end
+
+  def create_operation_for(resource_class:)
+    operation_for(
+      method: :create,
+      resource: resource_class
+    )
+  end
+
+  def create_resource_for(*args)
+    create_result_for(*args).raise_if_error.resource
+  end
+
+  def create_result_for(adaptor:, resource:)
+    result_for(
+      adaptor: adaptor,
+      method: :create,
+      resource: resource
+    )
+  end
+
+  def delete_operation_for(resource_class:)
+    operation_for(
+      method: :delete,
+      resource: resource_class
+    )
+  end
+
+  def delete_resource_for(*args)
+    delete_result_for(*args).raise_if_error.resource
+  end
+
+  def delete_result_for(adaptor:, resource:)
+    result_for(
+      adaptor: adaptor,
+      method: :delete,
+      resource: resource
+    )
+  end
+
+  def find_operation_for(resource_class:)
+    operation_for(
+      method: :find,
+      resource: resource_class
+    )
+  end
+
+  def find_resource_for(*args)
+    find_result_for(*args).raise_if_error.resource
+  end
+
+  def find_result_for(adaptor:, resource:)
+    result_for(
+      adaptor: adaptor,
+      method: :find,
+      resource: resource
+    )
+  end
+
+  def operation_for(method:, resource_class:)
+    adaptor_class
+      .base_operation_module_for(resource_class: resource_class)
+      .const_get(LedgerSync::Util::StringHelpers.camelcase(method.to_s))
+  end
+
+  def result_for(adaptor:, method:, resource:)
+    operation_for(
+      method: method,
+      resource_class: resource.class
+    ).new(
+      adaptor: adaptor,
+      resource: resource
+    ).perform
+  end
+
+  def update_operation_for(resource_class:)
+    operation_for(
+      method: :update,
+      resource: resource_class
+    )
+  end
+
+  def update_resource_for(*args)
+    update_result_for(*args).raise_if_error.resource
+  end
+
+  def update_result_for(adaptor:, resource:)
+    result_for(
+      adaptor: adaptor,
+      method: :update,
+      resource: resource
+    )
+  end
+end

data/qa/support/adaptor_support_setup.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+def setup_adaptor_support(*adaptors)
+  adaptors.each do |adaptor|
+    key = adaptor.config.root_key
+
+    support "#{key}_helpers"
+    helpers_module  = Object.const_get("#{adaptor.base_module.name.split('::').last}Helpers")
+    env_key         = "#{key}_qa".upcase
+
+    RSpec.configure do |config|
+      config.include helpers_module, adaptor: key
+
+      config.around(:each, adaptor: key) do |example|
+        if ENV.fetch(env_key, nil) == '1'
+          example.run
+        else
+          skip "Set #{env_key}=1 to run #{key} QA tests"
+        end
+      end
+    end
+  end
+end

data/qa/support/netsuite_helpers.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+support :adaptor_helpers,
+        :netsuite_shared_examples
+
+module NetSuiteHelpers
+  include AdaptorHelpers
+
+  def adaptor_class
+    LedgerSync::Adaptors::NetSuite::Adaptor
+  end
+
+  def existing_subsidiary_resource
+    LedgerSync::Subsidiary.new(
+      ledger_id: 2,
+      name: "QA Subsidary #{test_run_id}"
+    )
+  end
+
+  def netsuite_adaptor
+    @netsuite_adaptor ||= LedgerSync.adaptors.netsuite.new(
+      account_id: ENV.fetch('NETSUITE_ACCOUNT_ID'),
+      consumer_key: ENV.fetch('NETSUITE_CONSUMER_KEY'),
+      consumer_secret: ENV.fetch('NETSUITE_CONSUMER_SECRET'),
+      token_id: ENV.fetch('NETSUITE_TOKEN_ID'),
+      token_secret: ENV.fetch('NETSUITE_TOKEN_SECRET')
+    )
+  end
+end
+
+RSpec.configure do |config|
+  config.include NetSuiteHelpers, adaptor: :netsuite
+end

data/qa/support/netsuite_shared_examples.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+support :shared_examples
+
+RSpec.shared_examples 'a record with metadata' do
+  describe LedgerSync::Adaptors::NetSuite::Record::Metadata do
+    subject do
+      described_class.new(
+        adaptor: adaptor,
+        record: record
+      )
+    end
+
+    context '.http_methods' do
+      it { expect(subject.http_methods.count).not_to be_zero }
+    end
+
+    context '.properties' do
+      it { expect(subject.properties.count).not_to be_zero }
+    end
+  end
+end
+
+RSpec.shared_examples 'a full netsuite resource' do
+  it_behaves_like 'a create'
+  it_behaves_like 'a delete'
+  it_behaves_like 'a find'
+  it_behaves_like 'an update'
+  it_behaves_like 'a record with metadata'
+end

data/qa/support/netsuite_soap_helpers.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+support :adaptor_helpers,
+        :netsuite_soap_shared_examples
+
+module NetSuiteSOAPHelpers
+  include AdaptorHelpers
+
+  def adaptor_class
+    LedgerSync::Adaptors::NetSuiteSOAP::Adaptor
+  end
+
+  def existing_subsidiary_resource
+    LedgerSync::Subsidiary.new(
+      ledger_id: 2,
+      name: "QA Subsidary #{test_run_id}"
+    )
+  end
+
+  def netsuite_soap_adaptor
+    @netsuite_soap_adaptor ||= LedgerSync.adaptors.netsuite_soap.new(
+      account_id: ENV.fetch('NETSUITE_SOAP_ACCOUNT_ID'),
+      consumer_key: ENV.fetch('NETSUITE_SOAP_CONSUMER_KEY'),
+      consumer_secret: ENV.fetch('NETSUITE_SOAP_CONSUMER_SECRET'),
+      token_id: ENV.fetch('NETSUITE_SOAP_TOKEN_ID'),
+      token_secret: ENV.fetch('NETSUITE_SOAP_TOKEN_SECRET')
+    )
+  end
+end
+
+RSpec.configure do |config|
+  config.include NetSuiteSOAPHelpers, adaptor: :netsuite_soap
+end

data/qa/support/netsuite_soap_shared_examples.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+support :shared_examples
+
+RSpec.shared_examples 'a full netsuite soap resource' do
+  it_behaves_like 'a create', delete: false
+  # it_behaves_like 'a delete', delete: false
+  it_behaves_like 'a find', delete: false
+  # it_behaves_like 'an update', delete: false
+end

data/qa/support/quickbooks_online_helpers.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+support :adaptor_helpers,
+        :quickbooks_online_shared_examples
+
+module QuickBooksOnlineHelpers
+  include AdaptorHelpers
+
+  def adaptor_class
+    LedgerSync::Adaptors::QuickBooksOnline::Adaptor
+  end
+
+  def find_or_create_in_ledger(factory, adaptor:)
+    resource_class = FactoryBot.factories[factory].build_class
+    searcher = adaptor.searcher_klass_for(resource_type: resource_class.resource_type)
+    resource = searcher.new(
+      adaptor: adaptor,
+      query: ''
+    ).search.raise_if_error.resources.first
+
+    return resource if resource.present?
+
+    create_resource_for(
+      adaptor: adaptor,
+      resource: resource
+    )
+  end
+
+  def quickbooks_online_adaptor
+    @quickbooks_online_adaptor ||= LedgerSync.adaptors.quickbooks_online.new_from_env(test: true)
+  end
+end
+
+RSpec.configure do |config|
+  config.include QuickBooksOnlineHelpers, adaptor: :quickbooks_online
+  # config.before { quickbooks_online_adaptor.refresh! }
+  config.around(:each, adaptor: :quickbooks_online) do |example|
+    example.run
+  ensure
+    quickbooks_online_adaptor.update_secrets_in_dotenv
+  end
+end

data/qa/support/quickbooks_online_shared_examples.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+# RSpec.shared_examples 'a quickbooks_online create' do
+#   it do
+#     result = create_result_for(
+#       adaptor: adaptor,
+#       resource: resource
+#     )
+
+#     expect(result).to be_success
+#   end
+# end
+
+# RSpec.shared_examples 'a quickbooks_online find' do
+#   it do
+#     result = create_result_for(
+#       adaptor: adaptor,
+#       resource: resource
+#     ).raise_if_error
+#     expect(result).to be_success
+#     resource = result.resource
+
+#     result = find_result_for(
+#       adaptor: adaptor,
+#       resource: resource
+#     )
+
+#     expect(result).to be_success
+#   end
+# end
+
+# RSpec.shared_examples 'a quickbooks_online update' do
+#   it do
+#     result = create_result_for(
+#       adaptor: adaptor,
+#       resource: resource
+#     ).raise_if_error
+
+#     expect(result).to be_success
+#     resource = result.resource
+
+#     # Ensure values are currently not the same as the updates
+#     attribute_updates.each do |k, v|
+#       expect(resource.send(k)).not_to eq(v)
+#     end
+
+#     resource.assign_attributes(attribute_updates)
+#     result = update_result_for(
+#       adaptor: adaptor,
+#       resource: resource
+#     )
+
+#     expect(result).to be_success
+#     resource = result.resource
+
+#     # Ensure values are updated
+#     attribute_updates.each do |k, v|
+#       expect(resource.send(k)).to eq(v)
+#     end
+
+#     result = find_result_for(
+#       adaptor: adaptor,
+#       resource: resource.class.new(
+#         ledger_id: resource.ledger_id
+#       )
+#     ).raise_if_error
+
+#     expect(result).to be_success
+#     resource = result.resource
+
+#     # Ensure values are updated after raw find
+#     attribute_updates.each do |k, v|
+#       expect(resource.send(k)).to eq(v)
+#     end
+#   end
+# end
+
+RSpec.shared_examples 'a standard quickbooks_online resource' do
+  it_behaves_like 'a create', delete: false
+  it_behaves_like 'a find', delete: false
+  it_behaves_like 'an update', delete: false
+end

data/qa/support/shared_examples.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+RSpec.shared_examples 'a create' do |delete: true|
+  it do
+    result = create_result_for(
+      adaptor: adaptor,
+      resource: resource
+    )
+
+    expect(result).to be_success
+
+    if delete
+      delete_result_for(
+        adaptor: adaptor,
+        resource: result.resource
+      ).raise_if_error
+    end
+  end
+end
+
+RSpec.shared_examples 'a delete' do
+  it do
+    result = create_result_for(
+      adaptor: adaptor,
+      resource: resource
+    ).raise_if_error
+
+    resource = result.resource
+
+    result = delete_result_for(
+      adaptor: adaptor,
+      resource: resource
+    )
+
+    expect(result).to be_success
+
+    result = delete_result_for(
+      adaptor: adaptor,
+      resource: resource
+    )
+
+    expect(result).to be_failure
+  end
+end
+
+RSpec.shared_examples 'a find' do |delete: true|
+  it do
+    result = create_result_for(
+      adaptor: adaptor,
+      resource: resource
+    ).raise_if_error
+    expect(result).to be_success
+    resource = result.resource
+
+    begin
+      result = find_result_for(
+        adaptor: adaptor,
+        resource: resource
+      )
+
+      expect(result).to be_success
+    ensure
+      if delete
+        # Be sure to delete resource or raise an exception if this fails
+        delete_result_for(
+          adaptor: adaptor,
+          resource: resource
+        ).raise_if_error
+      end
+    end
+  end
+end
+
+RSpec.shared_examples 'an update' do |delete: true|
+  it do
+    result = create_result_for(
+      adaptor: adaptor,
+      resource: resource
+    ).raise_if_error
+
+    expect(result).to be_success
+    resource = result.resource
+
+    begin
+      # Ensure values are currently not the same as the updates
+      attribute_updates.each do |k, v|
+        expect(resource.send(k)).not_to eq(v)
+      end
+
+      resource.assign_attributes(attribute_updates)
+      result = update_result_for(
+        adaptor: adaptor,
+        resource: resource
+      )
+
+      expect(result).to be_success
+      resource = result.resource
+
+      # Ensure values are updated
+      attribute_updates.each do |k, v|
+        expect(resource.send(k)).to eq(v)
+      end
+
+      result = find_result_for(
+        adaptor: adaptor,
+        resource: resource.class.new(
+          ledger_id: resource.ledger_id
+        )
+      ).raise_if_error
+
+      expect(result).to be_success
+      resource = result.resource
+
+      # Ensure values are updated after raw find
+      attribute_updates.each do |k, v|
+        expect(resource.send(k)).to eq(v)
+      end
+    ensure
+      if delete
+        delete_result_for(
+          adaptor: adaptor,
+          resource: resource
+        ).raise_if_error
+      end
+    end
+  end
+end