trace_location 0.9.3 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1a561560a5db37e6870b1d73fa5882361a0536d66ac38e9a673483787cdde524
-  data.tar.gz: 17b1ef97dec8fa0701e9892e3fd5b961ddfdc64e6cd825d7352e211cc41c80d5
+  metadata.gz: b1e2f74ef8aefad64a0a962c2a77dbd4a47d8992ca5ef027d0acf47da19e7c2a
+  data.tar.gz: ad9b606d32f96289cb629f0c58f7324e9d9704e084f61fc9bbf2d689836eabee
 SHA512:
-  metadata.gz: 34b5ee16699470a95f50ffa50604a65db6f776f2229853049ee63ba1d6c7125b917af0a2196939d0f44925e644b99bbec76fad53fef2f98095c9a31da1e4ca60
-  data.tar.gz: cf0f02f48e6625fdb2a9a00e4e63ba2e89b7dcd5d85c8561e06b0bc8fcf2b459242c5fa5d19cc8448d0f7907f4b8212c3e09cafbf921f03ae2a6d751997ff1e0
+  metadata.gz: 9835516aba4ce712bd1ef3311947e315e052de1c6cd102967d06d740db127c459754339b92221b7a2904046a8fdfe8391e105ff8001af915b9cd67eef79da1b2
+  data.tar.gz: 24d753f05e76317957adf43a6ab02024558af46f623a4ac548f22130b6bc7d450d238fca16d303986d3d70791b3f112919808f5de750a520c01978880826fe08

data/.rubocop.yml

@@ -1,5 +1,5 @@
 AllCops:
-  TargetRubyVersion: 2.5
+  TargetRubyVersion: 2.6
 
 Metrics:
   Enabled: false

data/.travis.yml

@@ -3,5 +3,11 @@ sudo: false
 language: ruby
 cache: bundler
 rvm:
-  - 2.6.3
-before_install: gem install bundler -v 2.0.1
+  - 2.6.6
+  - 2.7.1
+  - ruby-head
+before_install: gem install bundler -v 2.1.4
+
+matrix:
+  allow_failures:
+    - rvm: ruby-head

data/Gemfile.lock

@@ -1,25 +1,21 @@
 PATH
   remote: .
   specs:
-    trace_location (0.9.3)
-      binding_of_caller
+    trace_location (0.10.0)
       method_source
 
 GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.0)
-    binding_of_caller (0.8.0)
-      debug_inspector (>= 0.0.1)
-    debug_inspector (0.0.3)
     diff-lcs (1.3)
     jaro_winkler (1.5.2)
-    method_source (0.9.2)
+    method_source (1.0.0)
     parallel (1.17.0)
     parser (2.6.3.0)
       ast (~> 2.4.0)
     rainbow (3.0.0)
-    rake (12.3.2)
+    rake (13.0.1)
     rspec (3.8.0)
       rspec-core (~> 3.8.0)
       rspec-expectations (~> 3.8.0)
@@ -54,4 +50,4 @@ DEPENDENCIES
   trace_location!
 
 BUNDLED WITH
-   2.0.1
+   2.1.4

data/README.md

@@ -1,5 +1,7 @@
 # TraceLocation
 
+[![Build Status](https://travis-ci.org/yhirano55/trace_location.svg?branch=master)](https://travis-ci.org/yhirano55/trace_location)
+
 TraceLocation helps you get tracing the source location of codes, and helps you can get reading the huge open souce libraries in Ruby.
 
 ## Installation
@@ -20,355 +22,80 @@ Or install it yourself as:
 
 ## Usage
 
-You just surround the code which you want to track the process.
-
-### Example 01. Track the validation process of Active Record
-
-```
-% bin/rails c
-
-irb(main):001:0> book = Book.new(title: "My Book Title")
-irb(main):002:0> TraceLocation.trace(ignore: /active_support/) { book.validate }
-Created at /path/to/sampleapp/log/trace_location-2019060401061559579741.md
-=> true
-```
-
-Then you can get a markdown file like this:
+### Example: Track establish connection in Active Record
 
---
-
-Generated by [trace_location](https://github.com/yhirano55/trace_location) at 2019-06-04 01:35:41 +0900
-
-<details open>
-<summary>activerecord-5.2.3/lib/active_record/validations.rb:65</summary>
-
-##### ActiveRecord::Validations#valid?
 ```ruby
-def valid?(context = nil)
-  context ||= default_validation_context
-  output = super(context)
-  errors.empty? && output
-end
-# called from (irb):2
-```
-
-</details>
-<details open>
-<summary>activerecord-5.2.3/lib/active_record/validations.rb:75</summary>
+config = Rails.application.config.database_configuration[Rails.env]
 
-##### ActiveRecord::Validations#default_validation_context
-```ruby
-def default_validation_context
-  new_record? ? :create : :update
+TraceLocation.trace do
+  # You just surround you want to track the process.
+  ActiveRecord::Base.establish_connection(config)
 end
-# called from activerecord-5.2.3/lib/active_record/validations.rb:66
 ```
 
-</details>
-<details open>
-<summary>activerecord-5.2.3/lib/active_record/persistence.rb:231</summary>
+Then you can get logs like this: [.md](https://github.com/yhirano55/trace_location/blob/master/examples/active_record_establish_connection/result.md), [.log](https://github.com/yhirano55/trace_location/blob/master/examples/active_record_establish_connection/result.log), [.csv](https://github.com/yhirano55/trace_location/blob/master/examples/active_record_establish_connection/result.csv)
 
-##### ActiveRecord::Persistence#new_record?
-```ruby
-def new_record?
-  sync_with_transaction_state
-  @new_record
-end
-# called from activerecord-5.2.3/lib/active_record/validations.rb:76
-```
+### Trace method options
 
-</details>
-<details open>
-<summary>activerecord-5.2.3/lib/active_record/transactions.rb:490</summary>
+| name | content | example |
+|:-----|:--------|:--------|
+| format | `:md`, `:log`, `:csv` (default: `:md`) | `:md` |
+| match | Regexp, Symbol, String or Array for allow list | `[:activerecord, :activesupport]` |
+| ignore | Regexp, Symbol, String or Array for deny list | `/bootsnap\|activesupport/` |
 
-##### ActiveRecord::Transactions#sync_with_transaction_state
-```ruby
-def sync_with_transaction_state
-  update_attributes_from_transaction_state(@transaction_state)
-end
-# called from activerecord-5.2.3/lib/active_record/persistence.rb:232
-```
+## More examples
 
-</details>
-<details open>
-<summary>activerecord-5.2.3/lib/active_record/transactions.rb:494</summary>
+### Example: Track the validation process of Active Record
 
-##### ActiveRecord::Transactions#update_attributes_from_transaction_state
 ```ruby
-def update_attributes_from_transaction_state(transaction_state)
-  if transaction_state && transaction_state.finalized?
-    restore_transaction_record_state(transaction_state.fully_rolledback?) if transaction_state.rolledback?
-    force_clear_transaction_record_state if transaction_state.fully_committed?
-    clear_transaction_record_state if transaction_state.fully_completed?
-  end
-end
-# called from activerecord-5.2.3/lib/active_record/transactions.rb:491
+book = Book.new(title: "My Book Title")
+TraceLocation.trace(match: /activerecord/) { book.validate }
 ```
 
-</details>
-<details open>
-<summary>activemodel-5.2.3/lib/active_model/validations.rb:336</summary>
+Results: [.md](https://github.com/yhirano55/trace_location/blob/master/examples/active_record_validation_process/result.md), [.log](https://github.com/yhirano55/trace_location/blob/master/examples/active_record_validation_process/result.log), [.csv](https://github.com/yhirano55/trace_location/blob/master/examples/active_record_validation_process/result.csv)
 
-##### ActiveModel::Validations#valid?
-```ruby
-def valid?(context = nil)
-  current_context, self.validation_context = validation_context, context
-  errors.clear
-  run_validations!
-ensure
-  self.validation_context = current_context
-end
-# called from activerecord-5.2.3/lib/active_record/validations.rb:67
-```
+### Example: Track the lifecycle of Rails application
 
-</details>
-<details open>
-<summary>activemodel-5.2.3/lib/active_model/validations.rb:303</summary>
-
-##### ActiveModel::Validations#errors
-```ruby
-def errors
-  @errors ||= Errors.new(self)
-end
-# called from activemodel-5.2.3/lib/active_model/validations.rb:338
-```
-
-</details>
-<details open>
-<summary>activemodel-5.2.3/lib/active_model/errors.rb:74</summary>
-
-##### ActiveModel::Errors#initialize
-```ruby
-def initialize(base)
-  @base     = base
-  @messages = apply_default_array({})
-  @details = apply_default_array({})
-end
-# called from activemodel-5.2.3/lib/active_model/validations.rb:304
-```
-
-</details>
-<details open>
-<summary>activemodel-5.2.3/lib/active_model/errors.rb:470</summary>
-
-##### ActiveModel::Errors#apply_default_array
-```ruby
-def apply_default_array(hash)
-  hash.default_proc = proc { |h, key| h[key] = [] }
-  hash
-end
-# called from activemodel-5.2.3/lib/active_model/errors.rb:76
-```
-
-</details>
-<details open>
-<summary>activemodel-5.2.3/lib/active_model/errors.rb:470</summary>
-
-##### ActiveModel::Errors#apply_default_array
 ```ruby
-def apply_default_array(hash)
-  hash.default_proc = proc { |h, key| h[key] = [] }
-  hash
-end
-# called from activemodel-5.2.3/lib/active_model/errors.rb:77
-```
+env = Rack::MockRequest.env_for('http://localhost:3000/books')
 
-</details>
-<details open>
-<summary>activemodel-5.2.3/lib/active_model/errors.rb:115</summary>
-
-##### ActiveModel::Errors#clear
-```ruby
-def clear
-  messages.clear
-  details.clear
+TraceLocation.trace do
+  status, headers, body = Rails.application.call(env)
 end
-# called from activemodel-5.2.3/lib/active_model/validations.rb:338
 ```
 
-</details>
-<details open>
-<summary>activemodel-5.2.3/lib/active_model/validations/callbacks.rb:117</summary>
-
-##### ActiveModel::Validations::Callbacks#run_validations!
-```ruby
-def run_validations!
-  _run_validation_callbacks { super }
-end
-# called from activemodel-5.2.3/lib/active_model/validations.rb:339
-```
+Results: [.md](https://github.com/yhirano55/trace_location/blob/master/examples/lifecycle_of_rails_application/result.md), [.log](https://github.com/yhirano55/trace_location/blob/master/examples/lifecycle_of_rails_application/result.log), [.csv](https://github.com/yhirano55/trace_location/blob/master/examples/lifecycle_of_rails_application/result.csv)
 
-</details>
-<details open>
-<summary>activemodel-5.2.3/lib/active_model/validations.rb:408</summary>
+### Example: Track the `has_secure_password` in User model
 
-##### ActiveModel::Validations#run_validations!
 ```ruby
-def run_validations!
-  _run_validate_callbacks
-  errors.empty?
-end
-# called from activemodel-5.2.3/lib/active_model/validations/callbacks.rb:118
-```
-
-</details>
-<details open>
-<summary>activemodel-5.2.3/lib/active_model/validations.rb:303</summary>
-
-##### ActiveModel::Validations#errors
-```ruby
-def errors
-  @errors ||= Errors.new(self)
-end
-# called from activemodel-5.2.3/lib/active_model/validations.rb:410
-```
-
-</details>
-<details open>
-<summary>activemodel-5.2.3/lib/active_model/errors.rb:209</summary>
-
-##### ActiveModel::Errors#empty?
-```ruby
-def empty?
-  size.zero?
-end
-# called from activemodel-5.2.3/lib/active_model/validations.rb:410
-```
-
-</details>
-<details open>
-<summary>activemodel-5.2.3/lib/active_model/errors.rb:179</summary>
-
-##### ActiveModel::Errors#size
-```ruby
-def size
-  values.flatten.size
-end
-# called from activemodel-5.2.3/lib/active_model/errors.rb:210
-```
-
-</details>
-<details open>
-<summary>activemodel-5.2.3/lib/active_model/errors.rb:188</summary>
-
-##### ActiveModel::Errors#values
-```ruby
-def values
-  messages.select do |key, value|
-    !value.empty?
-  end.values
-end
-# called from activemodel-5.2.3/lib/active_model/errors.rb:180
-```
-
-</details>
-<details open>
-<summary>activemodel-5.2.3/lib/active_model/validations.rb:303</summary>
-
-##### ActiveModel::Validations#errors
-```ruby
-def errors
-  @errors ||= Errors.new(self)
-end
-# called from activerecord-5.2.3/lib/active_record/validations.rb:68
-```
-
-</details>
-<details open>
-<summary>activemodel-5.2.3/lib/active_model/errors.rb:209</summary>
-
-##### ActiveModel::Errors#empty?
-```ruby
-def empty?
-  size.zero?
-end
-# called from activerecord-5.2.3/lib/active_record/validations.rb:68
+class User < ApplicationRecord
+  # temporary surrounding with TraceLocation#trace
+  TraceLocation.trace(format: :md, ignore: /activesupport/) do
+    has_secure_password
+  end
 ```
 
-</details>
-<details open>
-<summary>activemodel-5.2.3/lib/active_model/errors.rb:179</summary>
-
-##### ActiveModel::Errors#size
-```ruby
-def size
-  values.flatten.size
-end
-# called from activemodel-5.2.3/lib/active_model/errors.rb:210
-```
+Results: [.md](https://github.com/yhirano55/trace_location/blob/master/examples/has_secure_password/result.md), [.log](https://github.com/yhirano55/trace_location/blob/master/examples/has_secure_password/result.log), [.csv](https://github.com/yhirano55/trace_location/blob/master/examples/has_secure_password/result.csv)
 
-</details>
-<details open>
-<summary>activemodel-5.2.3/lib/active_model/errors.rb:188</summary>
+### Example: Track the rendering process of action in controller class
 
-##### ActiveModel::Errors#values
 ```ruby
-def values
-  messages.select do |key, value|
-    !value.empty?
-  end.values
-end
-# called from activemodel-5.2.3/lib/active_model/errors.rb:180
-```
-
-</details>
-
-
-
-### Example 02. Track the lifecycle of Rails application
+class BooksController < ApplicationController
+  before_action :set_book, only: [:show, :update, :destroy]
 
+  # GET /books
+  def index
+    @books = Book.all
 
-```
-% bin/rails c
-
-irb(main):001:0> env = Rack::MockRequest.env_for('http://localhost:3000/books')
-irb(main):002:0> TraceLocation.trace(format: :log) { status, headers, body = Rails.application.call(env) }
-Created at /path/to/sampleapp/log/trace_location-2019050602051557077971.log
-=> true
+    # temporary surrounding with TraceLocation#trace
+    TraceLocation.trace(format: :md, ignore: /activesupport|rbenv|concurrent-ruby/) do
+      render json: @books
+    end
+  end
 ```
 
-Then you can get a log like this:
-
-```
-Logged by TraceLocation gem at 2019-05-06 02:39:31 +0900
-https://github.com/yhirano55/trace_location
-
-[Tracing events] C: Call, R: Return
-
-C railties-5.2.3/lib/rails.rb:39 [Rails.application]
-R railties-5.2.3/lib/rails.rb:41 [Rails.application]
-C railties-5.2.3/lib/rails/engine.rb:522 [Rails::Engine#call]
-  C railties-5.2.3/lib/rails/application.rb:607 [Rails::Application#build_request]
-    C railties-5.2.3/lib/rails/engine.rb:705 [Rails::Engine#build_request]
-      C railties-5.2.3/lib/rails/application.rb:247 [Rails::Application#env_config]
-        C railties-5.2.3/lib/rails/engine.rb:528 [Rails::Engine#env_config]
-        R railties-5.2.3/lib/rails/engine.rb:530 [Rails::Engine#env_config]
-        C railties-5.2.3/lib/rails/application.rb:372 [Rails::Application#config]
-        R railties-5.2.3/lib/rails/application.rb:374 [Rails::Application#config]
-        C railties-5.2.3/lib/rails/application.rb:372 [Rails::Application#config]
-        R railties-5.2.3/lib/rails/application.rb:374 [Rails::Application#config]
-        C railties-5.2.3/lib/rails/application.rb:394 [Rails::Application#secrets]
-        R railties-5.2.3/lib/rails/application.rb:414 [Rails::Application#secrets]
-        C activesupport-5.2.3/lib/active_support/ordered_options.rb:41 [ActiveSupport::OrderedOptions#method_missing]
-          C activesupport-5.2.3/lib/active_support/ordered_options.rb:37 [ActiveSupport::OrderedOptions#[]]
-          R activesupport-5.2.3/lib/active_support/ordered_options.rb:39 [ActiveSupport::OrderedOptions#[]]
-        R activesupport-5.2.3/lib/active_support/ordered_options.rb:54 [ActiveSupport::OrderedOptions#method_missing]
-        C railties-5.2.3/lib/rails/application.rb:428 [Rails::Application#secret_key_base]
-          C railties-5.2.3/lib/rails.rb:72 [Rails.env]
-          R railties-5.2.3/lib/rails.rb:74 [Rails.env]
-          C activesupport-5.2.3/lib/active_support/string_inquirer.rb:26 [ActiveSupport::StringInquirer#method_missing]
-          R activesupport-5.2.3/lib/active_support/string_inquirer.rb:32 [ActiveSupport::StringInquirer#method_missing]
-          C railties-5.2.3/lib/rails/application.rb:394 [Rails::Application#secrets]
-          R railties-5.2.3/lib/rails/application.rb:414 [Rails::Application#secrets]
-          C activesupport-5.2.3/lib/active_support/ordered_options.rb:41 [ActiveSupport::OrderedOptions#method_missing]
-            C activesupport-5.2.3/lib/active_support/ordered_options.rb:37 [ActiveSupport::OrderedOptions#[]]
-            R activesupport-5.2.3/lib/active_support/ordered_options.rb:39 [ActiveSupport::OrderedOptions#[]]
-          R activesupport-5.2.3/lib/active_support/ordered_options.rb:54 [ActiveSupport::OrderedOptions#method_missing]
-        R railties-5.2.3/lib/rails/application.rb:436 [Rails::Application#secret_key_base]
-..................
-(an omission)
-..................
-```
+Results: [.md](https://github.com/yhirano55/trace_location/blob/master/examples/rendering_process/result.md), [.log](https://github.com/yhirano55/trace_location/blob/master/examples/rendering_process/result.log), [.csv](https://github.com/yhirano55/trace_location/blob/master/examples/rendering_process/result.csv)
 
 ## License