rack-rest-rspec 0.0.5 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71ef01252294ee9e868956d7022e23990f81557cc4025940da96b2783b4c2d04
-  data.tar.gz: ab4553953c6cb4bc1f428741133889fa3defd63fa4309be087db6ba95b7f9cb8
+  metadata.gz: b5eeab5a42b95fad3925b35beb70d00b9b5ba87cb0813e42d45dd1f7f3f9f7da
+  data.tar.gz: bc8e33415d1fd2ebc6b9f9a4095a575c0f37c5d24792355c9c914082edeefcf6
 SHA512:
-  metadata.gz: 7e2fe753acd7375aa77f1672768b6c150e68df0a1f2ff5d58f68fba12c0290ea7906510b6ca29d2d877aaf4b185e80a0a50e78955c62b867b8e538445a434bfb
-  data.tar.gz: f6b5c79124bcf35173281e7b66ce0a22348d3892b7b8ff547d15c3ed1018541550712fdf97102e30e0f55fe013b10e5aca8204f67844c7ff6c282c2e083dc49e
+  metadata.gz: a0204cb39a36df05af11f9de67cfa808d5754861de3ca86931c848a974b2f6d6c625f44e90adfdb636f708291216dfea3b59e91f651d5b53fa5642b29754e58c
+  data.tar.gz: 955bb74528ca5ec0d4945fd53564990f1ee0d9c19be86f669137dbdabeef0bedff4f99b3e0c871ba36c2b15b23512d24e4800cc18ec439829f4c354d98181afb

data/.debride_whitelist

@@ -0,0 +1,6 @@
+path
+returned_data
+service
+get_file
+memorize
+retrieve

data/.github/workflows/main.yml

@@ -0,0 +1,23 @@
+name: Ruby
+
+on: [push,pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 3.2.3
+    - name: Getting dependencies (Bundle)
+      run: |
+        gem install bundler -v 2.2.3
+        bundle install
+    - name: Running test Rspec
+      run: |
+        bundle exec rake
+    - name: Running CVE security audit 
+      run: |
+        bundle exec rake audit

data/.rspec

@@ -0,0 +1,2 @@
+--require spec_helper 
+--format documentation

data/.rubocop.yml

@@ -0,0 +1,44 @@
+AllCops:
+    NewCops: enable
+
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2024-05-03 14:08:48 UTC using RuboCop version 1.63.4.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 2
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+# AllowedMethods: refine
+Metrics/BlockLength:
+  Max: 32
+
+Gemspec/DevelopmentDependencies:
+  Enabled: false
+
+# Offense count: 3
+# Configuration parameters: AllowedConstants.
+Style/Documentation:
+  Exclude:
+    - 'spec/**/*'
+    - 'test/**/*'
+    - 'lib/rack-rest-rspec/lib/rest_service.rb'
+    - 'lib/rack-rest-rspec/version.rb'
+    - 'samples/app.rb'
+
+# Offense count: 23
+# Configuration parameters: AllowedVariables.
+Style/GlobalVars:
+  Exclude:
+    - 'lib/rack-rest-rspec/helpers/memorizer.rb'
+    - 'samples/spec/api_spec.rb'
+    - 'spec/api_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 122

data/Gemfile

@@ -1,20 +1,5 @@
 # frozen_string_literal: true
 
-source "https://rubygems.org"
+source 'https://rubygems.org'
 
-git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
-
-group :test, :development do
-  gem "roodi", "~> 5.0"
-  gem "rake", "~> 13.0"
-  gem "code_statistics", "~> 0.2.13"
-  gem "rspec", "~> 3.11"
-  gem "yard", "~> 0.9.28"
-  gem "yard-rspec", "~> 0.1"
-end
-
-gem "rack-test", "~> 2.0"
-
-
-
-gem "version", "~> 1.1"
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Romain GEORGES
+
+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/README.md

@@ -130,16 +130,110 @@ Finished in 0.01585 seconds (files took 0.25845 seconds to load)
 
 ## Available matchers :
 
-* be_correctly_send : check if return is HTTP valid
-* respond_with_a_collection_of_record OPTIONAL[root: <:symbol>] : check if the return is a JSON Array, could be chroot with root:
-* respond_a_record OPTIONAL[root: <:symbol>] : check if the return is a JSON Hash, could be chroot with root:
-* respond_with_collection size: <Integer> OPTIONAL[root: <:symbol>] : check if the collection have the good size, could be chroot with root:
-* respond_with  data: <Object> OPTIONAL[root: <:symbol>] : check if the return match the given object, could be chroot with root:
-* respond_with_status <Integer> : check if the HTTP response code is the good.
 
+### be_correctly_send 
 
+* check if return is HTTP valid
 
+### respond_with_a_collection_of_record
 
+* params :  
+  - OPTIONAL[root: <:symbol>] 
+* goal : check if the return is a JSON Array, could be chroot with *root:*
 
+
+### respond_a_record 
+
+* params : 
+  - OPTIONAL[root: <:symbol>] : 
+* goal : check if the return is a JSON Hash, could be chroot with *root:*
+
+### respond_with_collection
+* params :
+  -  size: Integer
+  -  OPTIONAL[root: <:symbol>] 
+* goal : check if the collection have the good size, could be chroot with *root:*
+  
+### respond_with  
+* params : 
+  - data: Object
+  - OPTIONAL[root: <:symbol>] 
+* goal : check if the return match the given object, could be chroot with root:
+
+### respond_with_status 
+* params : 
+  - code: Integer
+* goal : check if the HTTP response code is the good.
+
+
+## More 
+
+### Data dumper RestService#returned_data
+
+You could, for debug your tests and during dev, dump your data with 
+
+```ruby
+describe 'Test REST API' do
+    before :all do
+      $service = RestService::new :service => Application
+    end
+  
+    subject { $service }
+    context "GET /data" do
+      it { expect(subject.get('/data')).to be_correctly_sent }
+      it { subject.returned_data }
+    end
+end
+``` 
     
+It display the returned data of API. 
+
+###  Fixtures getter
+
+If you want to compare or inject data you could create fixture YAML files with :
+
+
+```ruby
+
+  describe 'Test REST API' do
+    before :all do
+      $service = RestService::new :service => Application
+      $mydata = get_file 'spec/fixtures/mydata.yml'
+    end
+  
+    subject { $service }
+    context "POST /data : test" do
+      it {  expect(subject.post('/data',$mydata.to_json)).to be_correctly_sent }
+    end
+
+
+end
+```
+
+### Statefullies helpers
+
+To be able to record ids of record, rack-rest-spec offer two helpers, to transit data from tests to tests.
+
+```ruby
+
+  describe 'Test REST API' do
+    before :all do
+      $service = RestService::new :service => Application
+      $mydata = get_file 'spec/fixtures/mydata.yml'
+    end
+  
+    subject { $service }
+    context "POST /data : test" do
+      it {  expect(subject.post('/data',$mydata.to_json)).to be_correctly_sent }
+      it { memorize id: subject.returned_data[:id] }
+    end
+
+    context "GET /data/<id> : test" do
+      it { expect(subject.get("/data#{retrieve(:id)}")).to be_correctly_sent }
+      end
+    end
+
+end
+```
+
 

data/Rakefile

@@ -1,54 +1,61 @@
-require "bundler/gem_tasks"
-require 'rubygems'
-require 'version'
-require 'rake/version_task'
-require 'rspec'
-require 'rake'
-require "rake/clean"
-require "rubygems/package_task"
-require "rdoc/task"
-require 'code_statistics'
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
+require 'rubocop//rake_task'
+
 require 'yard'
-require 'yard/rake/yardoc_task.rb'
-require "rake/tasklib"
-require "roodi"
-require "roodi_task"
+require 'yard/rake/yardoc_task'
 
+require 'code_statistics'
+
+RuboCop::RakeTask.new
+RSpec::Core::RakeTask.new(:spec)
 
 task default: :spec
 
+require 'version'
+require 'rake/version_task'
 Rake::VersionTask.new
 
-RoodiTask.new() do | t |
-t.patterns = %w(lib/**/*.rb)
-t.config = "ultragreen_roodi_coding_convention.yml"
-end
-
-
-CLEAN.include('*.tmp','*.old')
-CLOBBER.include('*.tmp', 'build/*','#*#')
-
-
-content = File::readlines(File.join(File.dirname(__FILE__), 'rack-rest-rspec.gemspec')).join
-spec = eval(content)
-
-RSpec::Core::RakeTask.new('spec')
-
 YARD::Rake::YardocTask.new do |t|
-  t.files   = [ 'lib/**/*.rb', '-', 'doc/**/*','spec/**/*_spec.rb']
-  t.options += ['--title', "Gem Documentation"]
-  t.options += ['-o', "yardoc"]
+  t.files = ['lib/**/*.rb', '-', 'doc/**/*', 'spec/**/*_spec.rb']
+  t.options += ['-o', 'yardoc']
 end
 YARD::Config.load_plugin('yard-rspec')
 
 namespace :yardoc do
   task :clobber do
-    rm_r "yardoc" rescue nil
-    rm_r ".yardoc" rescue nil
+    begin
+      rm_r 'yardoc'
+    rescue StandardError
+      nil
+    end
+    begin
+      rm_r '.yardoc'
+    rescue StandardError
+      nil
+    end
+    begin
+      rm_r 'pkg'
+    rescue StandardError
+      nil
+    end
   end
 end
-task :clobber => "yardoc:clobber"
+task clobber: 'yardoc:clobber'
 
+desc 'Run CVE security audit over bundle'
+task :audit do
+  system('bundle audit')
+end
 
+desc 'Run dead line of code detection'
+task :debride do
+  system('debride -w .debride_whitelist .')
+end
 
+desc 'Run SBOM CycloneDX Xml format file'
+task :sbom do
+  system('cyclonedx-ruby -p .')
+end

data/VERSION

@@ -1 +1 @@
-0.0.5
+1.0.0