bridge_bankin 0.1.0 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dfe54b48509650b463422657a08f719b65ddbdd67f02c51acfb02cde720cf795
-  data.tar.gz: 789e29bc5b5f95a3a9dac2954c17c95a5a5420cff9fffd45e46d4dde85bfa0ad
+  metadata.gz: 4a9b2d23a566212f859c98a3d51351c3b66ed9ce1cc726e6b6529cbbaa7d00cc
+  data.tar.gz: cabf9ebc60c09b0aad07bd3138581f8f0dfbeeeb82009486b9f47ff7f1cde324
 SHA512:
-  metadata.gz: 8808c5e9381f0b3c79cab3c93663561e1f4e8688c172b752a39e02885694b910f669a026822f134d2e9c741400e31438af592e2481b794fe044f9c312ca3d9b4
-  data.tar.gz: 129b232bd2b76a61616deec2f430d1d3b59c3523f4cf802d36bf0ac142548124f40a648fb53f7f2b69e549cd629f6bfec196a478e5a6aa362432fcf94e310c3f
+  metadata.gz: cc8f0d7735714f22fb50db94d29a6056659dc44bf3de4df4fc9dde283061f81be9c3bd23d8c2cc5ce4640beb13c69f172e0056d3ff16e8f3dd93ccffcbb45fd6
+  data.tar.gz: d688ca09401e5e1fdbb80245f2774b84568b198b5eeb0cff2dc011daa831077406fbe9578361f95bef6571c59f484dde1d2dc67f738cc75ad6b98a53412aaaa4

data/.github/workflows/{main.yml → ci-analysis.yml}

@@ -1,4 +1,4 @@
-name: Ruby
+name: CI
 
 on:
   push:
@@ -16,9 +16,9 @@ jobs:
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
-          ruby-version: 2.7.2
+          ruby-version: 3.0.0
       - name: Run the default task
         run: |
-          gem install bundler -v 2.2.1
+          gem install bundler
           bundle install
-          bundle exec rake
+          bundle exec rspec

data/.github/workflows/rubocop-analysis.yml

@@ -0,0 +1,44 @@
+# .github/workflows/rubocop-analysis.yml
+name: "RuboCop"
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - "*"
+
+jobs:
+  rubocop:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.0.0
+
+      # This step is not necessary if you add the gem to your Gemfile
+      - name: Install Code Scanning integration
+        run: bundle add code-scanning-rubocop --skip-install
+
+      - name: Install dependencies
+        run: bundle install
+
+      - name: RuboCop run
+        run: |
+          bash -c "
+            bundle exec rubocop --require code_scanning --format CodeScanning::SarifFormatter -o rubocop.sarif
+            [[ $? -ne 2 ]]
+          "
+
+      - name: Upload Sarif output
+        uses: github/codeql-action/upload-sarif@v1
+        with:
+          sarif_file: rubocop.sarif

data/.gitignore

@@ -1,13 +1,11 @@
+.env
+.rspec_status
+/_yardoc/
 /.bundle/
 /.yardoc
-/_yardoc/
 /coverage/
 /doc/
 /pkg/
 /spec/reports/
 /tmp/
-
-# rspec failure tracking
-.rspec_status
-
-.env
+/.idea

data/.rubocop.yml

@@ -3,7 +3,7 @@ require:
   - rubocop-rspec
 
 AllCops:
-  TargetRubyVersion: 2.7
+  TargetRubyVersion: 3.0.0
   NewCops: enable
 
 Style/StringLiterals:
@@ -17,9 +17,6 @@ Style/StringLiteralsInInterpolation:
 Layout/LineLength:
   Max: 120
 
-Style/Documentation:
-  Enabled: false
-
 Metrics/BlockLength:
   Enabled: false
 
@@ -43,3 +40,9 @@ RSpec/SubjectStub:
 
 RSpec/MultipleDescribes:
   Enabled: false
+
+RSpec/StubbedMock:
+  Enabled: false
+
+RSpec/MultipleExpectations:
+  Enabled: false

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    bridge_bankin (0.1.0)
+    bridge_bankin (0.1.4)
 
 GEM
   remote: https://rubygems.org/
@@ -12,7 +12,7 @@ GEM
       minitest (>= 5.1)
       tzinfo (~> 2.0)
       zeitwerk (~> 2.3)
-    addressable (2.7.0)
+    addressable (2.8.0)
       public_suffix (>= 2.0.2, < 5.0)
     ast (2.4.1)
     awesome_print (1.8.0)
@@ -36,7 +36,7 @@ GEM
     rainbow (3.0.0)
     rake (13.0.3)
     regexp_parser (2.0.3)
-    rexml (3.2.4)
+    rexml (3.2.5)
     rspec (3.10.0)
       rspec-core (~> 3.10.0)
       rspec-expectations (~> 3.10.0)
@@ -80,6 +80,7 @@ GEM
     zeitwerk (2.4.2)
 
 PLATFORMS
+  ruby
   x86_64-darwin-19
 
 DEPENDENCIES
@@ -96,4 +97,4 @@ DEPENDENCIES
   webmock
 
 BUNDLED WITH
-   2.2.1
+   2.2.3

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2020 Olivier Buffon
+Copyright (c) 2020 Neatops
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,12 +1,34 @@
-# BridgeBankin
-
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/bridge_bankin`. To experiment with that code, run `bin/console` for an interactive prompt.
-
-TODO: Delete this and the text above, and describe your gem
+<p align="center">
+  <img width="500" src="https://user-images.githubusercontent.com/112219/103307983-5fe04500-49df-11eb-9618-1f9704b2f460.png" alt="Bankin Bridge Logo">
+</p>
+
+<p align="center">
+  <a href="https://badge.fury.io/rb/bridge_bankin">
+    <img src="https://badge.fury.io/rb/bridge_bankin.svg" alt="Gem Version">
+  </a>
+  <a href="https://github.com/neatops/bridge_bankin/actions?query=workflow%3ACI">
+    <img src="https://github.com/neatops/bridge_bankin/workflows/CI/badge.svg" alt="CI Status">
+  </a>
+  <a href="https://github.com/neatops/bridge_bankin/actions?query=workflow%3ARuboCop">
+    <img src="https://github.com/neatops/bridge_bankin/workflows/RuboCop/badge.svg" alt="Rubocop Status">
+  </a>
+  <a href="https://rubydoc.info/github/neatops/bridge_bankin/main">
+    <img src="https://img.shields.io/badge/yard-docs-blue.svg" alt="RubyDoc Link">
+  </a>
+</p>
+
+<br />
+
+This gem is an **unofficial Ruby client** that consumes the [Bridge by Bankin’ API](https://bridgeapi.io/).
+
+Thanks to a safe and automated access to bank data, Bridge powered by Bankin’ provides
+competitive and smart solutions to build conversion-driver financial services.
+
+You'll find more information about Bridge API in the [official documentations](https://docs.bridgeapi.io/).
 
 ## Installation
 
-Add this line to your application's Gemfile:
+Add this line to your application’s Gemfile:
 
 ```ruby
 gem 'bridge_bankin'
@@ -22,22 +44,185 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+### Requirements
 
-## Development
+To begin using the API with this gem, you need to create an account to the dashboard on the [Bridge website](https://dashboard.bridgeapi.io/signup).
+Then you’ll have to create a new `application` and generate the required API credentials: a `client_id` and `client_secret`.
+You can find more information about this process by visiting the [Bridge API Dashboard documentation](https://docs.bridgeapi.io/docs/dashboard).
+
+### Getting started
+
+One you have your valid API credential you can now create an initializer in your app like this:
+
+```ruby
+BridgeBankin.configure do |config|
+  config.api_client_id = ENV["BRIDGE_API_CLIENT_ID"]
+  config.api_client_secret = ENV["BRIDGE_API_CLIENT_SECRET"]
+end
+```
+
+Feel free to replace those environment variables by whatever values that work for you.
+
+Some resources are public (banks and categories) meaning that only provided the `client_id` and `client_secret` are required.
+Here is an example on how you can use this gem to fetch the banks:
+
+```ruby
+BridgeBankin::Bank.list
+=> [#<BridgeBankin::BridgeObject:0x00007fbb0727c620
+  @country_code="DE",
+  @parent_banks=
+   [#<BridgeBankin::BridgeObject:0x00007fbb0727c148
+     @banks=
+      [#<BridgeBankin::Bank:0x00007fbad702f6b8
+        @authentication_type="INTERNAL_CREDS",
+        @automatic_refresh=true,
+        @capabilities=["ais"],
+        @country_code="DE",
+        @deeplink_android=nil,
+        @deeplink_ios=nil,
+        @form=[#<BridgeBankin::BridgeObject:0x00007fbad702cf30 @isNum="0", @label="Email", @maxLength=nil, @type="USER">, #<BridgeBankin::BridgeObject:0x00007fbad702c648 @isNum="0", @label="Password", @maxLength=nil, @type="PWD">],
+        @id=457,
+        @logo_url="https://web.bankin.com/img/banks-logo/neo/04N26@2x.png",
+        @name="N26 (Number 26) DE",
+        @payment_enabled=false,
+        @primary_color=nil,
+        @secondary_color=nil,
+        @transfer_enabled=false>],
+     @display_order=0,
+     @is_highlighted=false,
+     @logo_url="https://web.bankin.com/img/banks-logo/neo/04N26@2x.png",
+     @name="N26 (Number 26) DE">,
+     ...]
+   ...]
+ ...]
+```
+
+But the majority of the resources need a logged in user. Here is how to create one using the gem:
+
+```ruby
+BridgeBankin::User.create(email: "john.doe@email.com", password: "password123!")
+=> #<BridgeBankin::User:0x00007fbb07c5e990 @email="john.doe@email.com", @uuid="f974389d-1442-48bb-bb5e-ac62d1a96984">
+```
+
+Then you can generate an `access_token` for this user by using the `Authorization` class:
+
+```ruby
+BridgeBankin::Authorization.generate_token(email: "john.doe@email.com", password: "password123!")
+=> #<BridgeBankin::Authorization:0x00007fbb07967f48 @access_token="58b0195d943f9a3e8433cda7dea48a70339eafc6-5fe7c375-873b-4b0d-bcff-4541c1e19488", @expires_at=2020-12-29 21:35:28.97 UTC>
+```
+
+Since the majority of endpoints are private, you’ll need to pass a valid `access_token` each time you request them.
+Here is how it works with the user we previously created:
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+```ruby
+BridgeBankin::Transaction.list(access_token: auth.access_token)
+=> [#<BridgeBankin::Transaction:0x00007fbb0002d948
+  @account=#<BridgeBankin::Account:0x00007fbb0002c250 @id=22271302>,
+  @amount=-676.0,
+  @category=#<BridgeBankin::Category:0x00007fbb0002c520 @id=79>,
+  @currency_code="EUR",
+  @date=#<Date: 2021-01-02 ((2459217j,0s,0n),+0s,2299161j)>,
+  @description="Achat De Titres",
+  @id=38000214608599,
+  @is_deleted=false,
+  @is_future=true,
+  @raw_description="ACHAT DE TITRES - 020121",
+  @show_client_side=true,
+  @updated_at=2020-12-29 19:40:50.942 UTC>,
+ #<BridgeBankin::Transaction:0x00007fbb00023da8
+  @account=#<BridgeBankin::Account:0x00007fbb000229f8 @id=22271298>,
+  @amount=170.0,
+  @category=#<BridgeBankin::Category:0x00007fbb00022c50 @id=289>,
+  @currency_code="EUR",
+  @date=#<Date: 2021-01-02 ((2459217j,0s,0n),+0s,2299161j)>,
+  @description="Economies",
+  @id=38000214608462,
+  @is_deleted=false,
+  @is_future=true,
+  @raw_description="Economies - 020121",
+  @show_client_side=true,
+  @updated_at=2020-12-29 19:40:49.564 UTC>,
+  ...
+]
+```
+
+If you need more information on how the API works or which parameters you can use for a specific query, we really encourage you to consult the great [official guides](https://docs.bridgeapi.io/docs).
+
+### Parameters
+
+##### Mandatory parameters
+
+In some case you'll need to specify some parameters to complete your request.
+For instance, in order to retrieve a specific `user`, it requires you to pass the user's `UUID`:
+
+```ruby
+BridgeBankin::User.find(uuid: "f974389d-1442-48bb-bb5e-ac62d1a96984")
+=> #<BridgeBankin::User:0x00007fbb07febf90 @email="john.doe@email.com", @uuid="f974389d-1442-48bb-bb5e-ac62d1a96984">
+```
+
+Note that in some case, the API uses basic sequential `IDs` instead of `UUIDs`. In that case just replace `uuid` key by `id`:
+
+```ruby
+BridgeBankin::Bank.find(id: 457)
+=> #<BridgeBankin::Bank:0x00007fbb07ec64d0
+ @authentication_type="INTERNAL_CREDS",
+ @automatic_refresh=true,
+ @capabilities=["ais"],
+ @country_code="DE",
+ @deeplink_android=nil,
+ @deeplink_ios=nil,
+ @form=[#<BridgeBankin::BridgeObject:0x00007fbb07ec5968 @isNum="0", @label="Email", @maxLength=nil, @type="USER">, #<BridgeBankin::BridgeObject:0x00007fbb07ec54b8 @isNum="0", @label="Password", @maxLength=nil, @type="PWD">],
+ @id=457,
+ @logo_url="https://web.bankin.com/img/banks-logo/neo/04N26@2x.png",
+ @name="N26 (Number 26) DE",
+ @payment_enabled=false,
+ @primary_color=nil,
+ @secondary_color=nil,
+ @transfer_enabled=false>
+```
+
+##### Optional parameters
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+The gem resources also allows you to pass any optional parameters supported by the API (see [Official Documentation](https://docs.bridgeapi.io/docs/overview)).
+To do so, just pass them as `named parameters` in corresponding resource class method:
+
+```ruby
+BridgeBankin::Bank.list(limit: 1)
+=> [#<BridgeBankin::BridgeObject:0x00007fbb07b4c228
+  @country_code="FR",
+  @parent_banks=
+   [#<BridgeBankin::BridgeObject:0x00007fbb07b4c070
+     @banks=
+      [#<BridgeBankin::Bank:0x00007fbb07b27d38
+        @authentication_type="INTERNAL_CREDS",
+        @automatic_refresh=true,
+        @capabilities=["ais"],
+        @country_code="FR",
+        @deeplink_android=nil,
+        @deeplink_ios=nil,
+        @form=[#<BridgeBankin::BridgeObject:0x00007fbb07b271a8 @isNum="1", @label="Identifiant", @maxLength=nil, @type="USER">, #<BridgeBankin::BridgeObject:0x00007fbb07b26cd0 @isNum="0", @label="Mot de passe", @maxLength=nil, @type="PWD">],
+        @id=486,
+        @logo_url="https://web.bankin.com/img/banks-logo/france/themis.png",
+        @name="Themis Banque",
+        @payment_enabled=false,
+        @primary_color=nil,
+        @secondary_color=nil,
+        @transfer_enabled=false>],
+     @display_order=0,
+     @is_highlighted=false,
+     @logo_url="https://web.bankin.com/img/banks-logo/france/themis.png",
+     @name="Themis Banque">]>]
+```
+
+## Development
+
+If you need more detailed informations regarding the gem source code you can find more in the official [RubyDoc](https://rubydoc.info/github/neatops/bridge_bankin/main).
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/bridge_bankin. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/bridge_bankin/blob/master/CODE_OF_CONDUCT.md).
+We're convinced this gem could be improved a lot or simply not cover every needs you have. That's why contributions of any kind is very encouraged.
+Bug reports and pull requests are welcome on GitHub at https://github.com/neatops/bridge_bankin. This project is intended to be a safe, welcoming space for collaboration.
 
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
-
-## Code of Conduct
-
-Everyone interacting in the BridgeBankin project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/bridge_bankin/blob/master/CODE_OF_CONDUCT.md).

data/bridge_bankin.gemspec

@@ -8,14 +8,14 @@ Gem::Specification.new do |spec|
   spec.authors       = ["Olivier Buffon"]
   spec.email         = ["olivier@buffon.dev"]
 
-  spec.summary       = "Unofficial client to consume Bridge by Bankin’ API"
+  spec.summary       = "Unofficial Ruby client to consume Bridge by Bankin’ API"
 
   spec.description   = "Thanks to a safe and automated access to bank data, Bridge powered by Bankin’ provides " \
                        "competitive and smart solutions to build conversion-driver financial services."
 
   spec.homepage      = "https://github.com/neatops/bridge_bankin"
   spec.license       = "MIT"
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.7.0")
+  spec.required_ruby_version = Gem::Requirement.new(">= 3.0.0")
 
   spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = spec.homepage

data/lib/bridge_bankin.rb

@@ -15,5 +15,8 @@ require "bridge_bankin/object_types"
 # Resources
 require "bridge_bankin/resources"
 
+#
+# BridgeBankin main module
+#
 module BridgeBankin
 end

data/lib/bridge_bankin/account.rb

@@ -1,23 +1,44 @@
 # frozen_string_literal: true
 
 module BridgeBankin
+  #
+  # Account resource
+  #
   class Account < BridgeObject
     RESOURCE_TYPE = "account"
 
     class << self
       include API::Resource
 
+      #
+      # List all logged in user accounts
+      #
+      # @param [String] access_token the access token provided during the user authentication
+      # @param [Hash] params any params that might be required (or optional) to communicate with the API
+      #
+      # @return [Array<Account>] the user accounts
+      #
       def list(access_token:, **params)
         protected_resource(access_token) do
-          data = api_client.get("/v2/accounts", params)
-          convert_to_bridge_object(data)
+          data = api_client.get("/v2/accounts", **params)
+          # binding.pry
+          convert_to_bridge_object(**data)
         end
       end
 
+      #
+      # Retrieve a single account for logged in user
+      #
+      # @param [Integer] id the id of the requested resource
+      # @param [String] access_token the access token provided during the user authentication
+      # @param [Hash] params any params that might be required (or optional) to communicate with the API
+      #
+      # @return [Account] the user accounts
+      #
       def find(id:, access_token:, **params)
         protected_resource(access_token) do
-          data = api_client.get("/v2/accounts/#{id}", params)
-          convert_to_bridge_object(data)
+          data = api_client.get("/v2/accounts/#{id}", **params)
+          convert_to_bridge_object(**data)
         end
       end
     end