callcounter 0.0.0 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c1296edd2bdff7494496219c2806b20a63ca53e4edd01c5162e7d1cbae08421e
-  data.tar.gz: 6bd1af03dd43ae43fddd6c86168bce112ba5ceb1d3d546cb0c030787257f178b
+  metadata.gz: c162b867a3b3a0050d698462603b089142c29460c49254bae7e78705eef1b0ff
+  data.tar.gz: 8613f4d81bf8e88f3bf083dd7360ab8e7255ecacc1fac0e4d74ff555fadfb579
 SHA512:
-  metadata.gz: ea1a95f4179f2818cf9f68802ea54954010db5def0b3f0f7385a263222dd2239d63bcc63241a4d97dbc62e663c1c0e547014b4ff96b33b6f72eb3fab8bbb1819
-  data.tar.gz: 20aeb37e0ee4b67d11e29d1e66f059eee6a016ed630d7159556715ee98541c9f73149b83a0953b9aa8a07d47b50427d235837642cd47ed270e47e180434640e7
+  metadata.gz: a0513ed8e497d09a4c5c14735415b5b054546cf0bccbfa86e6e006420852f1c1107a9cc50b7bdc6781dfcd4e9f892c66f36ec2f801fc36e9ead53b8ed4416b3c
+  data.tar.gz: 7f0d38080e754246ca32f73f2cd2ff7a37e1bd9ca5737fdb8a21143d8effd8dca48a79c0a396a00b53b8c229e076f51c1eea125ea7f6bce0f6f0f5fdb640f97d

data/LICENSE

@@ -0,0 +1,23 @@
+Copyright (c) 2021, Webindie
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,44 @@
+[![builds.sr.ht status](https://builds.sr.ht/~webindie/callcounter-gem.svg)](https://builds.sr.ht/~webindie/callcounter-gem?)
+
+# Callcounter Ruby integration gem
+
+This gem can be used to gather API request & response data from Rack based applications.
+
+## Install
+
+When using bundler, simply add the following line to your Gemfile:
+
+```ruby
+gem 'callcounter'
+```
+
+Run `bundle install` in your project directory and create an initializer
+`config/initializers/callcounter.rb` with the following content:
+
+```ruby
+Callcounter.configure do |config|
+  config.project_token = '' # TODO: fill with your unique project token
+end
+```
+
+After deploying you should start seeing data in Callcounter. Note that this might take some time
+because this gems only sends data every few requests or every few minutes.
+
+## Configure what to capture
+
+You can add a lambda that will be called for every request to determine whether it was a request to your API.
+For example, the default lambda is shown below:
+
+```ruby
+Callcounter.configure do |config|
+  config.project_token = '' # TODO: fill with your unique project token
+  config.track = lambda { |request|
+    return request.hostname.start_with?('api') || request.path.start_with?('/api')
+  }
+end
+```
+
+## About Callcounter
+
+[Callcounter](https://callcounter.eu) is a service built by [Webindie](https://webindie.nl) that
+helps API providers with debugging and optimising the usage of their APIs.

data/lib/callcounter.rb

@@ -1,2 +1,21 @@
-class Callcounter
+# frozen_string_literal: true
+
+require 'callcounter/capturer'
+require 'callcounter/configuration'
+require 'callcounter/railtie' if defined?(Rails::Railtie)
+require 'callcounter/version'
+
+# rack middleware that captures incoming api requests and sends them to callcounter.eu
+module Callcounter
+  class << self
+    attr_writer :configuration
+  end
+
+  def self.configuration
+    @configuration ||= Callcounter::Configuration.new
+  end
+
+  def self.configure
+    yield(configuration)
+  end
 end

data/lib/callcounter/capturer.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module Callcounter
+  # class that captures the rack requests and sends them to callcounter.eu
+  class Capturer
+    attr_accessor :buffer
+
+    def initialize(app)
+      @app = app
+      @buffer = []
+    end
+
+    def call(env)
+      start = Time.now
+      result = @app.call(env)
+      finish = Time.now
+
+      return result if project_token.nil?
+
+      threading do
+        background_work(start, finish, env, result)
+      end
+
+      result
+    end
+
+    def debug?
+      Callcounter.configuration.debug
+    end
+
+    def track?(request)
+      Callcounter.configuration.track.call(request)
+    end
+
+    def project_token
+      Callcounter.configuration.project_token
+    end
+
+    def async?
+      Callcounter.configuration.async
+    end
+
+    def threading(&block)
+      if async?
+        Thread.new(&block)
+      else
+        yield
+      end
+    end
+
+    def send_buffer
+      http = Net::HTTP.new('api.callcounter.eu', 443)
+      http.use_ssl = true
+      track = Net::HTTP::Post.new('/api/v1/events')
+      track['content-type'] = 'application/json'
+      track['user-agent'] = "callcounter-gem (#{Callcounter::VERSION})"
+      track.body = { project_token: project_token, events: @buffer }.to_json
+
+      http.request(track)
+
+      puts 'sent request' if debug?
+    rescue StandardError
+      puts 'failed to send request' if debug?
+    end
+
+    def should_send_buffer?
+      @buffer.first[:created_at] < Time.now - Random.rand(300..359) || @buffer.size > 25
+    end
+
+    def event_attributes(start, finish, request, result)
+      {
+        created_at: start,
+        elapsed_time: ((finish - start) * 1000).round,
+        method: request.request_method,
+        path: request.path,
+        user_agent: request.user_agent,
+        status: result.first
+      }
+    end
+
+    def background_work(start, finish, env, result)
+      request = Rack::Request.new(env)
+      return unless track?(request)
+
+      @buffer << event_attributes(start, finish, request, result)
+
+      return unless should_send_buffer?
+
+      send_buffer
+      @buffer = []
+    end
+  end
+end

data/lib/callcounter/configuration.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Callcounter
+  # configuration class for callcounter middleware
+  class Configuration
+    attr_accessor :debug, :project_token, :track, :async
+
+    def initialize
+      @debug = false
+      @project_token = nil
+      @track = lambda { |request|
+        return request.hostname.start_with?('api') || request.path.start_with?('/api')
+      }
+      @async = true
+    end
+  end
+end

data/lib/callcounter/railtie.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Callcounter
+  # enable the callcounter rack middleware automatically in rails
+  class Railtie < Rails::Railtie
+    initializer 'callcounter.middleware' do |app|
+      app.middleware.use(Callcounter::Capturer)
+    end
+  end
+end

data/lib/callcounter/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Callcounter
+  VERSION = '0.1.0'
+end

metadata

@@ -1,43 +1,51 @@
 --- !ruby/object:Gem::Specification
 name: callcounter
 version: !ruby/object:Gem::Version
-  version: 0.0.0
+  version: 0.1.0
 platform: ruby
 authors:
 - Webindie
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-02-26 00:00:00.000000000 Z
+date: 2021-04-23 00:00:00.000000000 Z
 dependencies: []
-description: callcounter
+description: Callcounter is a service that helps API providers with debugging and
+  optimising the usage of their APIs.
 email: frank@webindie.nl
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- LICENSE
+- README.md
 - lib/callcounter.rb
-homepage: https://rubygems.org/gems/callcounter
+- lib/callcounter/capturer.rb
+- lib/callcounter/configuration.rb
+- lib/callcounter/railtie.rb
+- lib/callcounter/version.rb
+homepage: https://callcounter.eu
 licenses:
 - BSD-2-Clause
-metadata: {}
+metadata:
+  source_code_uri: https://git.sr.ht/~webindie/callcounter-gem
 post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.2.15
 signing_key:
 specification_version: 4
-summary: callcounter
+summary: Callcounter integration gem to gather API request statistics
 test_files: []