myfinance 0.4.0 → 0.5.0

data/lib/myfinance/resources/person.rb

@@ -0,0 +1,97 @@
+module Myfinance
+  module Resources
+    #
+    # A wrapper to Myfinance people API
+    #
+    # [API]
+    #   Documentation: https://app.myfinance.com.br/docs/api/people
+    #
+    class Person < Base
+      #
+      # List all people
+      #
+      # [API]
+      #   Method: <tt>GET /people</tt>
+      #
+      #   Documentation: https://app.myfinance.com.br/docs/api/people#get_index
+      #
+      def find_all
+        http.get("/people", body: {}) do |response|
+          respond_with_collection(response)
+        end
+      end
+
+      #
+      # Find people by attributtes
+      #
+      # [API]
+      #   Method: <tt>GET /people</tt>
+      #
+      #   Documentation: https://app.myfinance.com.br/docs/api/people#get_index
+      #
+      def find_by(params)
+        values = params.map { |k,v| "search[#{k}]=#{v}" }.join("&")
+
+        http.get("/people?#{values}", body: {}) do |response|
+          respond_with_collection(response)
+        end
+      end
+
+      #
+      # Show a person
+      #
+      # [API]
+      #   Method: <tt>GET /people/:id</tt>
+      #
+      #   Documentation: https://app.myfinance.com.br/docs/api/people#get_show
+      #
+      def find(id)
+        http.get("/people/#{id}", body: {}) do |response|
+          respond_with_object response, "person"
+        end
+      end
+
+      #
+      # Creates a person
+      #
+      # [API]
+      #   Method: <tt>POST /people</tt>
+      #
+      #   Documentation: https://app.myfinance.com.br/docs/api/people#post_create
+      #
+      def create(params)
+        http.post("/people", body: { person: params }) do |response|
+          respond_with_object response, "person"
+        end
+      end
+
+      #
+      # Updates a person
+      #
+      # [API]
+      #   Method: <tt>PUT /people/:id</tt>
+      #
+      #   Documentation: https://app.myfinance.com.br/docs/api/people#put_update
+      #
+      def update(id, params)
+        http.put("/people/#{id}", body: { person: params }) do |response|
+          respond_with_object response, "person"
+        end
+      end
+
+      #
+      # Destroy a person
+      #
+      # [API]
+      #   Method: <tt>DELETE /people/:id</tt>
+      #
+      #   Documentation: https://app.myfinance.com.br/docs/api/people#delete_destroy
+      #
+      def destroy(id)
+        http.delete("/people/#{id}", body: {}) do |response|
+          respond_with_object response, "person"
+        end
+      end
+    end
+  end
+end

data/lib/myfinance/version.rb

@@ -1,3 +1,3 @@
 module Myfinance
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

data/spec/lib/myfinance/client_spec.rb

@@ -60,4 +60,44 @@ describe Myfinance::Client do
       subject.attachments
     end
   end
+
+  describe "#classification_centers" do
+    it "instantiates a new Myfinance::Resources::ClassificationCenter" do
+      expect(
+        Myfinance::Resources::ClassificationCenter
+      ).to receive(:new).with(subject.http)
+      subject.classification_centers
+    end
+  end
+
+  describe "#categories" do
+    it "instantiates a new Myfinance::Resources::Category" do
+      expect(Myfinance::Resources::Category).to receive(:new).with(subject.http)
+      subject.categories
+    end
+  end
+
+  describe "#accounts" do
+    it "instantiates a new Myfinance::Resources::Account" do
+      expect(Myfinance::Resources::Account).to receive(:new).with(subject.http)
+      subject.accounts
+    end
+  end
+
+  describe "#deposit_accounts" do
+    it "instantiates a new Myfinance::Resources::DepositAccount" do
+      expect(
+        Myfinance::Resources::DepositAccount
+      ).to receive(:new).with(subject.http)
+
+      subject.deposit_accounts
+    end
+  end
+
+  describe "#people" do
+    it "instantiates a new Myfinance::Resources::Person" do
+      expect(Myfinance::Resources::Person).to receive(:new).with(subject.http)
+      subject.people
+    end
+  end
 end

data/spec/lib/myfinance/entities/account_collection_spec.rb

@@ -0,0 +1,19 @@
+require "spec_helper"
+
+describe Myfinance::Entities::AccountCollection do
+  let(:response) { double(headers: {}, parsed_body: [{}]) }
+
+  subject { described_class.new(response) }
+
+  describe "#build" do
+    it "returns orders collection" do
+      expect(subject.build).to be_a(Myfinance::Entities::AccountCollection)
+    end
+
+    it "returns orders" do
+      subject.build
+      expect(subject.collection.count).to eq(1)
+      expect(subject.collection.first.class).to eq(Myfinance::Entities::Account)
+    end
+  end
+end

data/spec/lib/myfinance/entities/account_spec.rb

@@ -0,0 +1,13 @@
+require "spec_helper"
+
+describe Myfinance::Entities::Account do
+  subject { described_class.new({}) }
+
+  it_behaves_like "entity_attributes", [
+                    :beta, :canceled_at, :cancellation_reason, :charging_uuid,
+                    :created_at, :default_currency_id, :ecommerce_response,
+                    :expires_on, :id, :invite, :is_trial, :name, :owner_id,
+                    :payment_method, :plan_slug, :referral_code, :referrer_id,
+                    :updated_at, :uuid, :waiting_payment
+                  ]
+end

data/spec/lib/myfinance/entities/category_collection_spec.rb

@@ -0,0 +1,47 @@
+require "spec_helper"
+
+describe Myfinance::Entities::CategoryCollection do
+  let(:entity_klass) { Myfinance::Entities::Category }
+
+  let(:response) do
+    double(
+      headers: {},
+      parsed_body: [
+        {
+          "category" => {
+            "account_id" => 3613,
+            "cost" => true,
+            "created_at" => "2015-07-29T11:04:50-03:00",
+            "excel_import_id" => nil,
+            "force_destroy" => false,
+            "full_name" => "Alimentação",
+            "guid" => nil,
+            "id" => 532314,
+            "imported_from_sync" => false,
+            "interested_users_ids" => [],
+            "modified_by_sync" => false,
+            "name" => "Alimentação",
+            "parent_id" => nil,
+            "revenue" => true,
+            "updated_at" => "2015-07-29T11:04:50-03:00",
+            "use_count" => 0
+          }
+        }
+      ]
+    )
+  end
+
+  subject { Myfinance::Entities::CategoryCollection.new(response) }
+
+  describe "#build" do
+    it "returns order collection" do
+      expect(subject.build.class).to eq(Myfinance::Entities::CategoryCollection)
+    end
+
+    it "returns order" do
+      subject.build
+      expect(subject.collection.count).to eq(1)
+      expect(subject.collection.first.class).to eq(entity_klass)
+    end
+  end
+end

data/spec/lib/myfinance/entities/category_spec.rb

@@ -0,0 +1,12 @@
+require 'spec_helper'
+
+describe Myfinance::Entities::Category do
+  subject { described_class.new({}) }
+
+  it_behaves_like 'entity_attributes', [
+                    :account_id, :cost, :created_at, :excel_import_id,
+                    :force_destroy, :full_name, :guid, :id, :imported_from_sync,
+                    :interested_users_ids, :modified_by_sync, :name, :parent_id,
+                    :revenue, :updated_at, :use_count
+                  ]
+end

data/spec/lib/myfinance/entities/classification_center_collection_spec.rb

@@ -0,0 +1,23 @@
+require "spec_helper"
+
+describe Myfinance::Entities::ClassificationCenterCollection do
+  let(:entity_klass) { described_class }
+
+  let(:params) { double(headers: {}, parsed_body: [{}]) }
+
+  subject { described_class.new(params) }
+
+  context "#build" do
+    it "returns order collection" do
+      expect(subject.build).to be_a(entity_klass)
+    end
+
+    it "returns order" do
+      subject.build
+      expect(subject.collection.count).to eq(1)
+      expect(
+        subject.collection.first
+      ).to be_a(Myfinance::Entities::ClassificationCenter)
+    end
+  end
+end

data/spec/lib/myfinance/entities/classification_center_spec.rb

@@ -0,0 +1,8 @@
+require "spec_helper"
+
+describe Myfinance::Entities::ClassificationCenter do
+  it_behaves_like "entity_attributes", [
+                    :cost_center, :created_at, :entity_id, :excel_import_id,
+                    :id, :name, :revenue_center, :updated_at, :use_count
+                  ]
+end

data/spec/lib/myfinance/entities/deposit_account_collection_spec.rb

@@ -0,0 +1,23 @@
+require "spec_helper"
+
+describe Myfinance::Entities::DepositAccountCollection do
+  let(:entity_klass) { described_class }
+
+  let(:params) { double(headers: {}, parsed_body: [{}]) }
+
+  subject { entity_klass.new(params) }
+
+  describe "#build" do
+    it "returns order collection" do
+      expect(subject.build).to be_a(entity_klass)
+    end
+
+    it "returns order" do
+      subject.build
+      expect(subject.collection.count).to eq(1)
+      expect(subject.collection.first).to be_a(
+        Myfinance::Entities::DepositAccount
+      )
+    end
+  end
+end

data/spec/lib/myfinance/entities/deposit_account_spec.rb

@@ -0,0 +1,11 @@
+require "spec_helper"
+
+describe Myfinance::Entities::DepositAccount do
+  it_behaves_like "entity_attributes", [
+                    :archive, :bank_account_id, :created_at, :currency_id,
+                    :deposit_account_type_id, :description, :entity_id,
+                    :force_destroy, :id, :imported_from_sync, :initial_balance,
+                    :last_transaction_date, :name, :sync_response, :updated_at,
+                    :calculated_balance, :logo_image_url, :links
+                  ]
+end

data/spec/lib/myfinance/entities/person_collection_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe Myfinance::Entities::PersonCollection do
+  let(:response) do
+    double(
+      headers: {},
+      parsed_body: [
+        {}
+      ]
+    )
+  end
+
+  subject { described_class.new(response) }
+
+  describe "#build" do
+    it "returns order collection" do
+      expect(subject.build.class).to eql(Myfinance::Entities::PersonCollection)
+    end
+
+    it "returns order" do
+      subject.build
+      expect(subject.collection.count).to eq(1)
+      expect(subject.collection.first.class).to eq(Myfinance::Entities::Person)
+    end
+  end
+end

data/spec/lib/myfinance/entities/person_spec.rb

@@ -0,0 +1,18 @@
+require 'spec_helper'
+
+describe Myfinance::Entities::Person do
+  subject { described_class.new({}) }
+
+  it_behaves_like "entity_attributes", [
+                    :account_id, :address, :address_number, :city, :complement,
+                    :country, :created_at, :customer, :email, :excel_import_id,
+                    :febraban_favored_code, :febraban_name,
+                    :federation_subscription_number,
+                    :federation_subscription_number_only_numbers,
+                    :federation_subscription_type_id, :force_destroy, :guid,
+                    :id, :imported_from_sync, :interested_users_ids,
+                    :modified_by_sync, :name, :neighborhood, :note,
+                    :person_type, :phone, :site, :state, :supplier, :updated_at,
+                    :use_count, :zip_code
+                  ]
+end

data/spec/lib/myfinance/resources/account_spec.rb

@@ -0,0 +1,28 @@
+require "spec_helper"
+
+describe Myfinance::Resources::Account, vcr: true do
+  let(:entity_klass) { described_class }
+
+  describe "#find_all" do
+    context "with success" do
+      subject { client.accounts.find_all }
+
+      it "show all accounts successfully" do
+        expect(subject).to be_a(Myfinance::Entities::AccountCollection)
+        expect(subject.collection.first).to be_a(Myfinance::Entities::Account)
+      end
+    end
+
+    context "with error" do
+      let(:client) { Myfinance.client("") }
+
+      it "raises Myfinance::RequestError with 401 status code" do
+        expect {
+          client.accounts.find_all
+        }.to raise_error(Myfinance::RequestError) do |error|
+          expect(error.code).to eq(401)
+        end
+      end
+    end
+  end
+end

data/spec/lib/myfinance/resources/category_spec.rb

@@ -0,0 +1,118 @@
+require 'spec_helper'
+
+describe Myfinance::Resources::Category, vcr: true do
+  let(:entity_klass) { Myfinance::Entities::Category }
+
+  describe "#find_all" do
+    context "with success" do
+      subject { client.categories.find_all }
+
+      it "show all categories successfully" do
+        expect(subject.class).to eq(Myfinance::Entities::CategoryCollection)
+        expect(subject.collection.first.class).to eq(entity_klass)
+        expect(subject.collection.first.full_name).to eq("Alimentação")
+      end
+    end
+
+    context "when not found" do
+      let(:client) { Myfinance.client("") }
+
+      it "raises Myfinance::RequestError with 401 status code" do
+        expect {
+          client.categories.find_all
+        }.to raise_error(Myfinance::RequestError) do |error|
+          expect(error.code).to eql(401)
+        end
+      end
+    end
+  end
+
+  describe "#find" do
+    context "with success" do
+      subject { client.categories.find(532314) }
+
+      it "returns a category successfully" do
+        expect(subject.class).to eql(entity_klass)
+        expect(subject.id).to eql(532314)
+      end
+    end
+
+    context "with error" do
+      it "raises Myfinance::RequestError with 404 status code" do
+        expect {
+          client.categories.find(88888888)
+        }.to raise_error(Myfinance::RequestError) do |error|
+          expect(error.code).to eql(404)
+        end
+      end
+    end
+  end
+
+  describe "#create" do
+    let(:params) { { name: "Category 1" } }
+
+    context "with success" do
+      it "creates a category successfully" do
+        result = client.categories.create(params)
+        expect(result).to be_a(entity_klass)
+        expect(result.name).to eql("Category 1")
+      end
+    end
+
+    context "with error" do
+      it "raises Myfinance::RequestError with 422 status code" do
+        expect {
+          client.categories.create({})
+        }.to raise_error(Myfinance::RequestError) do |error|
+          expect(error.code).to eql(422)
+        end
+      end
+    end
+  end
+
+  describe "#update" do
+    context "with success" do
+      it "updates a category successfully" do
+        expect(
+          client.categories.update(548083, { name: "Category updated" })
+        ).to be_a(entity_klass)
+      end
+    end
+
+    context "with error" do
+      it "raises Myfinance::RequestError with 404 status code" do
+        expect {
+          client.categories.update(88888888, {})
+        }.to raise_error(Myfinance::RequestError) do |error|
+          expect(error.code).to eql(404)
+        end
+      end
+
+      it "raises Myfinance::RequestError with 422 status core" do
+        expect {
+          result = client.categories.update(548083, { name: "" })
+        }.to raise_error(Myfinance::RequestError) do |error|
+          expect(error.code).to eql(422)
+        end
+      end
+    end
+  end
+
+  describe "#destroy" do
+    context "with success" do
+      it "destroy a category successfully" do
+        expect(client.categories.destroy(532314)).to be_truthy
+      end
+    end
+
+    context "with error" do
+      it "raises Myfinance::RequestError with 404 status code" do
+        expect {
+          client.categories.destroy(88888888)
+        }.to raise_error(Myfinance::RequestError) do |error|
+          expect(error.code).to eql(404)
+        end
+      end
+    end
+  end
+end