trailblazer 1.1.1 → 2.1.0

metadata

@@ -1,51 +1,57 @@
 --- !ruby/object:Gem::Specification
 name: trailblazer
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 2.1.0
 platform: ruby
 authors:
 - Nick Sutterer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-03-27 00:00:00.000000000 Z
+date: 2019-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: uber
+  name: trailblazer-macro
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.0.15
+        version: 2.1.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.0.15
+        version: 2.1.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.2.0
 - !ruby/object:Gem::Dependency
-  name: reform
+  name: trailblazer-macro-contract
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.0
+        version: 2.1.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: 3.0.0
+        version: 2.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.0
+        version: 2.1.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: 3.0.0
+        version: 2.2.0
 - !ruby/object:Gem::Dependency
-  name: declarative
+  name: trailblazer-operation
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -58,20 +64,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: activemodel
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -114,50 +106,8 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: sqlite3
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: database_cleaner
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: roar
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-description: A high-level, modular architecture for Ruby framworks with domain and
-  form objects, view models, twin decorators and representers.
+description: A high-level architecture introducing new abstractions such as operations
+  and control flow, form objects and policies.
 email:
 - apotonick@gmail.com
 executables: []
@@ -165,61 +115,25 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".rubocop-https---raw-githubusercontent-com-trailblazer-meta-master-rubocop-yml"
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
 - ".travis.yml"
 - CHANGES.md
+- COMM-LICENSE
+- CONTRIBUTING.md
 - Gemfile
-- LICENSE.txt
+- LICENSE
 - README.md
 - Rakefile
 - THOUGHTS
-- TODO.md
-- doc/Trb-The-Stack.png
-- doc/trb.jpg
-- gemfiles/Gemfile.rails.lock
-- gemfiles/Gemfile.reform-2.0
-- gemfiles/Gemfile.reform-2.1
 - lib/trailblazer.rb
-- lib/trailblazer/autoloading.rb
-- lib/trailblazer/endpoint.rb
-- lib/trailblazer/operation.rb
-- lib/trailblazer/operation/builder.rb
-- lib/trailblazer/operation/callback.rb
-- lib/trailblazer/operation/collection.rb
-- lib/trailblazer/operation/controller.rb
-- lib/trailblazer/operation/dispatch.rb
-- lib/trailblazer/operation/model.rb
-- lib/trailblazer/operation/model/dsl.rb
-- lib/trailblazer/operation/model/external.rb
-- lib/trailblazer/operation/module.rb
-- lib/trailblazer/operation/policy.rb
-- lib/trailblazer/operation/policy/guard.rb
-- lib/trailblazer/operation/representer.rb
-- lib/trailblazer/operation/resolver.rb
-- lib/trailblazer/operation/uploaded_file.rb
 - lib/trailblazer/version.rb
-- test/callback_test.rb
-- test/collection_test.rb
-- test/model_test.rb
-- test/module_test.rb
-- test/operation/builder_test.rb
-- test/operation/contract_test.rb
-- test/operation/controller_test.rb
-- test/operation/dsl/callback_test.rb
-- test/operation/dsl/contract_test.rb
-- test/operation/dsl/representer_test.rb
-- test/operation/external_model_test.rb
-- test/operation/guard_test.rb
-- test/operation/policy_test.rb
-- test/operation/reject_test.rb
-- test/operation/resolver_test.rb
-- test/operation_test.rb
-- test/representer_test.rb
-- test/rollback_test.rb
 - test/test_helper.rb
 - trailblazer.gemspec
 homepage: http://trailblazer.to
 licenses:
-- MIT
+- LGPL-3.0
 metadata: {}
 post_install_message: 
 rdoc_options: []
@@ -229,7 +143,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -237,27 +151,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.8
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: A high-level architecture for Ruby and Rails.
 test_files:
-- test/callback_test.rb
-- test/collection_test.rb
-- test/model_test.rb
-- test/module_test.rb
-- test/operation/builder_test.rb
-- test/operation/contract_test.rb
-- test/operation/controller_test.rb
-- test/operation/dsl/callback_test.rb
-- test/operation/dsl/contract_test.rb
-- test/operation/dsl/representer_test.rb
-- test/operation/external_model_test.rb
-- test/operation/guard_test.rb
-- test/operation/policy_test.rb
-- test/operation/reject_test.rb
-- test/operation/resolver_test.rb
-- test/operation_test.rb
-- test/representer_test.rb
-- test/rollback_test.rb
 - test/test_helper.rb

data/LICENSE.txt

@@ -1,22 +0,0 @@
-Copyright (c) 2013 Nick Sutterer
-
-MIT License
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/TODO.md

@@ -1,11 +0,0 @@
-# Operation: External API
-
-* allow `Op[{body: "Great!"}, {additional: true}]` to save merge.
-* make `Op[]` not require wrap like `comment: {}`
-* in tests, make Op[].model return the reloaded model!
-
-# Operation: Internal API
-
-* don't populate the form in #present context, we don't need it (only the representer goes nuts)
-* don't pass contract in validate, we have #contract.
-* abstract validate/success/fail into methods to make it easily overrideable.

data/gemfiles/Gemfile.rails.lock

@@ -1,130 +0,0 @@
-PATH
-  remote: ../
-  specs:
-    trailblazer (0.2.2)
-      actionpack (>= 3.0.0)
-      reform (>= 1.2.0)
-      uber (>= 0.0.10)
-
-GEM
-  remote: http://rubygems.org/
-  specs:
-    actionmailer (4.1.1)
-      actionpack (= 4.1.1)
-      actionview (= 4.1.1)
-      mail (~> 2.5.4)
-    actionpack (4.1.1)
-      actionview (= 4.1.1)
-      activesupport (= 4.1.1)
-      rack (~> 1.5.2)
-      rack-test (~> 0.6.2)
-    actionview (4.1.1)
-      activesupport (= 4.1.1)
-      builder (~> 3.1)
-      erubis (~> 2.7.0)
-    activemodel (4.1.1)
-      activesupport (= 4.1.1)
-      builder (~> 3.1)
-    activerecord (4.1.1)
-      activemodel (= 4.1.1)
-      activesupport (= 4.1.1)
-      arel (~> 5.0.0)
-    activesupport (4.1.1)
-      i18n (~> 0.6, >= 0.6.9)
-      json (~> 1.7, >= 1.7.7)
-      minitest (~> 5.1)
-      thread_safe (~> 0.1)
-      tzinfo (~> 1.1)
-    arel (5.0.1.20140414130214)
-    builder (3.2.2)
-    celluloid (0.16.0)
-      timers (~> 4.0.0)
-    connection_pool (2.0.0)
-    disposable (0.0.9)
-      representable (~> 2.0)
-      uber
-    erubis (2.7.0)
-    hitimes (1.2.2)
-    i18n (0.6.11)
-    json (1.8.1)
-    mail (2.5.4)
-      mime-types (~> 1.16)
-      treetop (~> 1.4.8)
-    mime-types (1.25.1)
-    mini_portile (0.6.2)
-    minitest (5.4.2)
-    multi_json (1.11.0)
-    nokogiri (1.6.6.2)
-      mini_portile (~> 0.6.0)
-    polyglot (0.3.5)
-    rack (1.5.2)
-    rack-test (0.6.2)
-      rack (>= 1.0)
-    rails (4.1.1)
-      actionmailer (= 4.1.1)
-      actionpack (= 4.1.1)
-      actionview (= 4.1.1)
-      activemodel (= 4.1.1)
-      activerecord (= 4.1.1)
-      activesupport (= 4.1.1)
-      bundler (>= 1.3.0, < 2.0)
-      railties (= 4.1.1)
-      sprockets-rails (~> 2.0)
-    railties (4.1.1)
-      actionpack (= 4.1.1)
-      activesupport (= 4.1.1)
-      rake (>= 0.8.7)
-      thor (>= 0.18.1, < 2.0)
-    rake (10.3.2)
-    redis (3.1.0)
-    redis-namespace (1.5.1)
-      redis (~> 3.0, >= 3.0.4)
-    reform (1.2.6)
-      activemodel
-      disposable (~> 0.0.5)
-      representable (~> 2.1.0)
-      uber (~> 0.0.11)
-    representable (2.1.8)
-      multi_json
-      nokogiri
-      uber (~> 0.0.7)
-    responders (1.1.2)
-      railties (>= 3.2, < 4.2)
-    sidekiq (3.1.4)
-      celluloid (>= 0.15.2)
-      connection_pool (>= 2.0.0)
-      json
-      redis (>= 3.0.6)
-      redis-namespace (>= 1.3.1)
-    sprockets (3.1.0)
-      rack (~> 1.0)
-    sprockets-rails (2.3.1)
-      actionpack (>= 3.0)
-      activesupport (>= 3.0)
-      sprockets (>= 2.8, < 4.0)
-    sqlite3 (1.3.9)
-    thor (0.19.1)
-    thread_safe (0.3.4)
-    timers (4.0.1)
-      hitimes
-    treetop (1.4.15)
-      polyglot
-      polyglot (>= 0.3.1)
-    tzinfo (1.2.2)
-      thread_safe (~> 0.1)
-    uber (0.0.13)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  activerecord
-  bundler
-  minitest
-  rails
-  railties
-  rake
-  responders
-  sidekiq (~> 3.1.0)
-  sqlite3
-  trailblazer!

data/gemfiles/Gemfile.reform-2.0

@@ -1,6 +0,0 @@
-source "http://rubygems.org"
-
-gemspec path: '../'
-
-gem "reform", "~> 2.0.5"
-gem "multi_json"

data/gemfiles/Gemfile.reform-2.1

@@ -1,7 +0,0 @@
-source "http://rubygems.org"
-
-gemspec path: '../'
-
-gem "reform",  github: "apotonick/reform" #"~> 2.1.0.rc1"
-gem "roar", github: "apotonick/roar" # "1.1.0"
-gem "multi_json"

data/lib/trailblazer/autoloading.rb

@@ -1,15 +0,0 @@
-Trailblazer.class_eval do
-  autoload :NotAuthorizedError, "trailblazer/operation/policy"
-end
-
-Trailblazer::Operation.class_eval do
-  autoload :Controller, "trailblazer/operation/controller"
-  autoload :Model,      "trailblazer/operation/model"
-  autoload :Collection, "trailblazer/operation/collection"
-  autoload :Dispatch,   "trailblazer/operation/dispatch" # TODO: remove in 1.2.
-  autoload :Callback,   "trailblazer/operation/callback"
-  autoload :Module,     "trailblazer/operation/module"
-  autoload :Representer,"trailblazer/operation/representer"
-  autoload :Policy,     "trailblazer/operation/policy"
-  autoload :Resolver,   "trailblazer/operation/resolver"
-end

data/lib/trailblazer/endpoint.rb

@@ -1,31 +0,0 @@
-module Trailblazer
-  # Encapsulates HTTP-specific logic needed before running an operation.
-  # Right now, all this does is #document_body! which figures out whether or not to pass the request body
-  # into params, so the operation can use a representer to deserialize the original document.
-  # To be used in Hanami, Roda, Rails, etc.
-  class Endpoint
-    def initialize(operation_class, params, request, options)
-      @operation_class = operation_class
-      @params          = params
-      @request         = request
-      @is_document     = options[:is_document]
-    end
-
-    def call
-      document_body! if @is_document
-      yield @params# Create.run(params)
-    end
-
-  private
-    attr_reader :params, :operation_class, :request
-
-    def document_body!
-      # this is what happens:
-      # respond_with Comment::Update::JSON.run(params.merge(comment: request.body.string))
-      concept_name = operation_class.model_class.to_s.underscore # this could be renamed to ::concept_class soon.
-      request_body = request.body.respond_to?(:string) ? request.body.string : request.body.read
-
-      params.merge!(concept_name => request_body)
-    end
-  end
-end

data/lib/trailblazer/operation/builder.rb

@@ -1,26 +0,0 @@
-require "uber/builder"
-
-# Allows to add builders via ::builds.
-module Trailblazer::Operation::Builder
-  def self.extended(extender)
-    extender.send(:include, Uber::Builder)
-  end
-
-  def builder_class
-    @builders
-  end
-
-  def builder_class=(constant)
-    @builders = constant
-  end
-
-private
-  # Runs the builders for this operation class to figure out the actual class.
-  def build_operation_class(*args)
-    class_builder(self).(*args) # Uber::Builder::class_builder(context)
-  end
-
-  def build_operation(params, options={})
-    build_operation_class(params).new(params, options)
-  end
-end

data/lib/trailblazer/operation/callback.rb

@@ -1,53 +0,0 @@
-require "declarative"
-require "disposable/callback"
-
-module Trailblazer::Operation::Callback
-  def self.included(base)
-    base.extend ClassMethods
-
-    base.extend Declarative::Heritage::Inherited
-    base.extend Declarative::Heritage::DSL
-  end
-
-  def callback!(name=:default, options={ operation: self, contract: contract, params: @params }) # FIXME: test options.
-    config  = self.class.callbacks.fetch(name) # TODO: test exception
-    group   = config[:group].new(contract)
-
-    options[:context] ||= (config[:context] == :operation ? self : group)
-    group.(options)
-
-    invocations[name] = group
-  end
-
-  def dispatch!(*args, &block)
-    callback!(*args, &block)
-  end
-
-  def invocations
-    @invocations ||= {}
-  end
-
-  module ClassMethods
-    def callbacks
-      @callbacks ||= {}
-    end
-
-    def callback(name=:default, constant=nil, &block)
-      return callbacks[name][:group] unless constant or block_given?
-
-      add_callback(name, constant, &block)
-    end
-
-  private
-    def add_callback(name, constant, &block)
-      heritage.record(:add_callback, name, constant, &block)
-
-      callbacks[name] ||= {
-        group:   Class.new(constant || Disposable::Callback::Group),
-        context: constant ? nil : :operation # `context: :operation` when the callback is inline. `context: group` otherwise.
-      }
-
-      callbacks[name][:group].class_eval(&block) if block_given?
-    end
-  end
-end

data/lib/trailblazer/operation/collection.rb

@@ -1,6 +0,0 @@
-module Trailblazer::Operation::Collection
-  # Collection does not produce a contract.
-  def present
-    self
-  end
-end

data/lib/trailblazer/operation/controller.rb

@@ -1,72 +0,0 @@
-require "trailblazer/endpoint"
-
-module Trailblazer::Operation::Controller
-private
-  def form(operation_class, options={})
-    res, op, options = operation!(operation_class, options)
-    op.contract.prepopulate!(options) # equals to @form.prepopulate!
-
-    op.contract
-  end
-
-  # Provides the operation instance, model and contract without running #process.
-  # Returns the operation.
-  def present(operation_class, options={})
-    res, op = operation!(operation_class, options.merge(skip_form: true))
-    op
-  end
-
-  def collection(*args)
-    res, op = operation!(*args)
-    @collection = op.model
-    op
-  end
-
-  def run(operation_class, options={}, &block)
-    res, op = operation_for!(operation_class, options) { |params| operation_class.run(params) }
-
-    yield op if res and block_given?
-
-    op
-  end
-
-  # The block passed to #respond is always run, regardless of the validity result.
-  def respond(operation_class, options={}, &block)
-    res, op = operation_for!(operation_class, options) { |params| operation_class.run(params) }
-    namespace = options.delete(:namespace) || []
-
-    return respond_with *namespace, op, options if not block_given?
-    respond_with *namespace, op, options, &Proc.new { |formats| block.call(op, formats) } if block_given?
-  end
-
-private
-  def operation!(operation_class, options={}) # or #model or #setup.
-    operation_for!(operation_class, options) { |params| [true, operation_class.present(params)] }
-  end
-
-  def process_params!(params)
-  end
-
-  # Override and return arbitrary params object.
-  def params!(params)
-    params
-  end
-
-  # Normalizes parameters and invokes the operation (including its builders).
-  def operation_for!(operation_class, options, &block)
-    params = options[:params] || self.params # TODO: test params: parameter properly in all 4 methods.
-    params = params!(params)
-    process_params!(params) # deprecate or rename to #setup_params!
-
-    res, op = Trailblazer::Endpoint.new(operation_class, params, request, options).(&block)
-    setup_operation_instance_variables!(op, options)
-
-    [res, op, options.merge(params: params)]
-  end
-
-  def setup_operation_instance_variables!(operation, options)
-    @operation = operation
-    @model     = operation.model
-    @form      = operation.contract unless options[:skip_form]
-  end
-end

data/lib/trailblazer/operation/dispatch.rb

@@ -1,3 +0,0 @@
-require "trailblazer/operation/callback"
-# TODO: deprecate this module.
-Trailblazer::Operation::Dispatch = Trailblazer::Operation::Callback

data/lib/trailblazer/operation/model/dsl.rb

@@ -1,29 +0,0 @@
-class Trailblazer::Operation
-  module Model
-    # Imports ::model and ::action into an operation.
-    module DSL
-      def self.extended(extender)
-        extender.extend Uber::InheritableAttr
-        extender.inheritable_attr :config
-        extender.config = {}
-      end
-
-      def model(name, action=nil)
-        self.config[:model] = name
-        action(action) if action # coolest line ever.
-      end
-
-      def action(name)
-        self.config[:action] = name
-      end
-
-      def action_name # considered private.
-        self.config[:action] or :create
-      end
-
-      def model_class # considered private.
-        self.config[:model] or raise "[Trailblazer] You didn't call Operation::model."
-      end
-    end
-  end
-end