web_tsunami 0.0.1 → 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2a151d3928ef65c636d341b5c00c4aab1f51314f7bb809e845f1281782b172db
+  data.tar.gz: '08597d6fcdb0157c1636033ebc92c2a0a0accd66d023ae6d609817f60d371756'
+SHA512:
+  metadata.gz: 4f987ec8a711515c8bf5c8045b8fb074b8e4617af5c802e66cf0900b2e5df89eaeb286b78a529ef9508d7629ed365bbe73384bb722308a77dd26084d2ddce361
+  data.tar.gz: e9e2e9d3c9c975b3f6f2b6ce3ea2657da4bd806819944b34ea7824621e85700637b340a2dab3388af74723d1391080e45da8b766488fbc9d1a41d0369bfcb521

data/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog of Web Tsunami
+
+## Unreleased
+
+* Fix non compatible changes of Typhoeus
+
+## 0.0.1 (2012-07-13)
+
+* Initial version

data/Gemfile.lock

@@ -1,12 +1,17 @@
 GEM
   remote: http://rubygems.org/
   specs:
-    mime-types (1.18)
-    typhoeus (0.3.3)
-      mime-types
+    ethon (0.16.0)
+      ffi (>= 1.15.0)
+    ffi (1.16.3)
+    typhoeus (1.4.1)
+      ethon (>= 0.9.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
   typhoeus
+
+BUNDLED WITH
+   2.2.22

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2024 Alexis Bernard
+
+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/README.md

@@ -0,0 +1,54 @@
+# Web Tsunami
+
+Write tailor-made scenarios for load testing web apps
+
+## Why
+
+Many good tools already exist for a very long time such as ApacheBench and Siege.
+But, sometimes load testing a web app requires to write a custom scenario.
+The goal is to focus only on the scenario without thinking about forking, threads and non blocking IOs.
+Fortunately there is [Typhoeus](https://github.com/typhoeus/typhoeus) to send parallel HTTP requests.
+
+Web Tsunami is a tiny class that forks every seconds and sends as many requests as expected.
+
+## Example
+
+```ruby
+class Example < WebTsunami::Scenario
+  def run
+    get("http://site.example") do
+      # Block is executed once the response has been received
+      sleep(5) # Simulates the time required for a human to visit the next page
+      get("http://site.example/search?query=stress+test") do |response|
+        # Do whatever you need with the response object or ignore it
+        sleep(10)
+        get("http://site.example/search?query=stress+test&page=2") do
+          sleep(5)
+          get("http://site.example/stress/test")
+        end
+      end
+    end
+  end
+end
+
+# Simulates 100 concurrent visitors every second for 10 minutes
+# It's a total of 60K unique visitors for an average of 23'220 rpm.
+Example.start(concurrency: 100, duration: 60 * 10)
+```
+
+In this example, the same requests are always sent.
+But you can provide dynamic query strings, use variables and some randomness.
+
+## Output and result
+
+Web Tsunami does not measure response time or print any result.
+If you are running a load test, that means you should use an APM (application performance monitoring).
+It already collects and displays all data you need such as throughput, response time and bottlenecks.
+
+So, the only output are errors.
+
+## License
+
+The gem is available as open-source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+Rails developer? Check out [RoRvsWild](https://rorvswild.com), our Ruby on Rails application monitoring tool.

data/example.rb

@@ -13,7 +13,7 @@ class GoogleTsunami < WebTsunami::Scenario
       puts 'http://www.google.com'
       get('http://www.google.com/search?q=ruby') do
         puts 'http://www.google.com/search?q=ruby'
-        get("http://www.google.com/search?q=ruby&start=#{rand(100)*10}") do
+        get('http://www.google.com/search?q=ruby&start=10') do
           puts 'http://www.google.com/search?q=ruby&start=10'
         end
       end

data/lib/web_tsunami/version.rb

@@ -0,0 +1,3 @@
+module WebTsunami
+  VERSION = "0.1.0"
+end

data/{web_tsunami.rb → lib/web_tsunami.rb}

@@ -18,8 +18,7 @@ module WebTsunami
     end
 
     def requests
-      (@requests = Typhoeus::Hydra.new).disable_memoization unless @requests
-      @requests
+      @requests ||= Typhoeus::Hydra.new
     end
 
     def get(url, &block)
@@ -28,7 +27,7 @@ module WebTsunami
         if response.timed_out?
           puts "Timeout #{url}"
         elsif response.code == 0
-          puts "#{response.curl_error_message} #{url}"
+          puts "#{response.return_message} #{url}"
         elsif !response.success? && response.code != 302
           puts "#{response.code} #{url}"
         end
@@ -37,7 +36,7 @@ module WebTsunami
     end
 
     def start
-      concurrency.times { |i| run }
+      concurrency.times { run }
       requests.run
     end
 

data/web_tsunami.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+
+require_relative "lib/web_tsunami/version"
+
+Gem::Specification.new do |s|
+  s.name          = "web_tsunami"
+  s.version       = WebTsunami::VERSION
+  s.authors       = ["Alexis Bernard"]
+  s.email         = ["alexis@basesecrete.com"]
+  s.homepage      = "https://github.com/BaseSecrete/web_tsunami"
+  s.summary       = "Tailor-made load testing for web apps"
+  s.description   = "Write realistic scenarios to test the load of a web application."
+  s.license       = "MIT"
+
+  s.files         = `git ls-files`.split("\n")
+  s.require_paths = ["lib"]
+
+  s.metadata["source_code_uri"] = "https://github.com/BaseSecrete/web_tsunami"
+  s.metadata["changelog_uri"] = "https://github.com/BaseSecrete/web_tsunami/blob/master/CHANGELOG.md"
+
+  s.add_runtime_dependency "typhoeus"
+end

metadata

@@ -1,50 +1,68 @@
 --- !ruby/object:Gem::Specification
 name: web_tsunami
 version: !ruby/object:Gem::Version
-  version: 0.0.1
-  prerelease: 
+  version: 0.1.0
 platform: ruby
 authors:
 - Alexis Bernard
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-07-13 00:00:00.000000000Z
-dependencies: []
-description: Benchmark your web application
+date: 2024-01-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: typhoeus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Write realistic scenarios to test the load of a web application.
 email:
-- alexis@official.fm
+- alexis@basesecrete.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - Gemfile
 - Gemfile.lock
-- README
+- LICENSE.txt
+- README.md
 - example.rb
-- web_tsunami.rb
-homepage: https://github.com/officialfm/web_tsunami
-licenses: []
+- lib/web_tsunami.rb
+- lib/web_tsunami/version.rb
+- web_tsunami.gemspec
+homepage: https://github.com/BaseSecrete/web_tsunami
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/BaseSecrete/web_tsunami
+  changelog_uri: https://github.com/BaseSecrete/web_tsunami/blob/master/CHANGELOG.md
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 1.8.10
+rubygems_version: 3.2.22
 signing_key: 
-specification_version: 3
-summary: Benchmark your web application
+specification_version: 4
+summary: Tailor-made load testing for web apps
 test_files: []

data/README

@@ -1,9 +0,0 @@
-Benchmark your web application.
-
-Why not using Apache Benchmark or any similar tool?
-
-Because some times we need to send unique requests and AB doesn't fit for that need.
-
-Check example.rb to see how it's working.
-
-More documentation and gem is coming soon.