lizarb 1.0.0 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c859781b1927e69f516b2b6d057b19a4e8d6603945636ce0ec7306640fbd1956
-  data.tar.gz: d5849f4bcbf610ee5a94df16dbd92feab78a4f724e2ac77eeae05e93aebfbef5
+  metadata.gz: ebe2ac1c0a6d2e86f70577662d985ea755707a6855e67bcc0fc1e3d8f89ac563
+  data.tar.gz: 47544f75a230d272e38bd50adacd388d4cb8a8710da689ae24ca0fe187e7d3f6
 SHA512:
-  metadata.gz: 4e4ffd81acfddf2a8aadebc0fcc10911141b3a8fc55e164d050fc3c8156a7ee560a7a84133c12d19e1491ff9c720b8a6afd857b6c22bdf14844ac03550c2dc6e
-  data.tar.gz: bd421065bc059d7ebeac4d3d805e2133a18d0bb31745bc95a4b62d785f2b2368fbd80482cd2a7cac2cec03a239dc58b988844c1a234f4a0aa9a84ef99fc77256
+  metadata.gz: 8427b2e5710ccff4f9031adc64b9ad9e3fcdc4dea4565f933dc34b91f72378230b7946e020074832c8e7f44c7c5085bc0c3dc503b98d9852a2fb207b685f41b1
+  data.tar.gz: a8fa9c03c1cfa03947e3be6a35b610192cb2a50f5111f175b3211ee1ca35fcafbc371583c53e3b006735873fd5c07897c8dd3edcf6fb0235fac49353e19a460d

data/.ruby-version

@@ -1 +1 @@
-3.1.2
+3.2.0

data/.tool-versions

@@ -0,0 +1 @@
+ruby 3.2.0

data/Gemfile

@@ -7,6 +7,7 @@ gemspec
 
 group :dev do
   # gems you only want to load if DevSystem is loaded
+  gem "pry", "~> 0.14.1"
 end
 
 group :happy do
@@ -24,4 +25,5 @@ group :web do
   gem "rack", "~> 3.0"
   gem "rackup", "~> 0.2.2"
   gem "puma", "~> 5.6"
+  gem "htmlbeautifier", "~> 1.4"
 end

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    lizarb (1.0.0)
+    lizarb (1.0.2)
       colorize (~> 0.8)
       dotenv (~> 2.8)
       zeitwerk (~> 2.6)
@@ -9,10 +9,17 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
+    coderay (1.1.3)
     colorize (0.8.1)
     connection_pool (2.3.0)
     dotenv (2.8.1)
+    htmlbeautifier (1.4.2)
+    method_source (1.0.0)
+    mini_portile2 (2.8.1)
     nio4r (2.5.8)
+    pry (0.14.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
     puma (5.6.5)
       nio4r (~> 2.0)
     rack (3.0.0)
@@ -24,15 +31,19 @@ GEM
       redis-client (>= 0.9.0)
     redis-client (0.10.0)
       connection_pool
-    sqlite3 (1.5.2-x86_64-linux)
+    sqlite3 (1.5.4)
+      mini_portile2 (~> 2.8.0)
     webrick (1.7.0)
-    zeitwerk (2.6.1)
+    zeitwerk (2.6.7)
 
 PLATFORMS
+  arm64-darwin-21
   x86_64-linux
 
 DEPENDENCIES
+  htmlbeautifier (~> 1.4)
   lizarb!
+  pry (~> 0.14.1)
   puma (~> 5.6)
   rack (~> 3.0)
   rackup (~> 0.2.2)

data/README.md

@@ -6,97 +6,56 @@ Liza is a light, experimental framework primarily developed to help study the Ru
 
 Install the gem by executing:
 
-    $ gem install lizarb
+    gem install lizarb
 
 You will get the following three shims:
 
-    $ lizarb version
-    $ liza version
+    lizarb version
+    liza version
+    lrb version
 
-## Try
-
-Try Liza with an interactive prompt
-
-    $ liza dev
-
-## Running Tests
-
-Run your Liza tests
-
-    $ liza test
-
-## Happy
-
-Try Liza and build an ASCII game
+## Create a liza app
 
-    $ liza happy axo
+So you can run your experiments:
 
-## Networking
+    liza new
 
-Try Liza to connect with Sqlite and Redis
+Then enter your automagically generated liza app:
 
-    $ liza net
+    cd app_1
+    bundle install
 
-```ruby
+Now you're ready to go and try some stuff!
 
-NetBox.adapters.get :sqlite
-NetBox.adapters.get :redis_url
-
-NetBox.databases.sql
-NetBox.databases.sqlite
-NetBox.databases.redis
-
-RedisDb.current
-SqliteDb.current
-
-RedisDb.current.call "TIME"
-SqliteDb.current.call "SELECT name, sql FROM sqlite_master WHERE type = 'table';"
-
-```
-
-## Web Server
+## Try
 
-Try Liza with the Rack Web Server
+Try Liza with an interactive terminal
 
-    $ liza web
+    liza terminal
 
-http://localhost:3000/
-  
-http://localhost:3000/xxxxxxx
-  
-http://localhost:3000/api/xxxxxxx
-  
-http://localhost:3000/api/auth/sign_up
-  
-http://localhost:3000/api/auth/sign_in
-  
-http://localhost:3000/api/auth/account
-  
-http://localhost:3000/api/auth/sign_out
-  
-http://localhost:3000/assets/app.css
-  
-http://localhost:3000/assets/app.js
+## Running Tests
 
-## Usage
+Run your Liza tests
 
-TODO: Write usage instructions here
+    liza test
 
 ## Development
 
 To install dependencies, run this bash script:
 
-    $ bin/setup
+    bin/setup
 
 For development experiments, use the local executable script
 
-    $ exe/lizarb test
+    exe/lizarb test
 
 To build and install lizarb in your local machine
 
-    $ bundle exec rake install
+    bundle exec rake install
+
+For systems in development, see [README_SYSTEMS.md](https://github.com/rubyonrails-brasil/lizarb/blob/master/README_SYSTEMS.md).
 
-## Release    
+## Release
 
 To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 

data/README_SYSTEMS.md

@@ -0,0 +1,80 @@
+# Liza - Systems in Development
+
+These systems operate at a very small capacity, and will be fleshed out in the future.
+
+## Happy
+
+Try Liza and build an ASCII game
+
+    liza happy axo
+
+## Networking
+
+Try Liza to connect with Sqlite and Redis
+
+    liza net
+
+```ruby
+
+NetBox.clients.get :sqlite
+NetBox.clients.get :redis_url
+
+NetBox.databases.sql
+NetBox.databases.sqlite
+NetBox.databases.redis
+
+RedisDb.current
+SqliteDb.current
+
+RedisDb.current.call "TIME"
+SqliteDb.current.call "SELECT name, sql FROM sqlite_master WHERE type = 'table';"
+
+```
+
+## Rack Web Server
+
+Try Liza with the Rack Web Server
+
+    liza rack
+
+http://localhost:3000/
+
+http://localhost:3000/xxxxxxx
+
+http://localhost:3000/api/xxxxxxx
+
+http://localhost:3000/api/auth/sign_up
+
+http://localhost:3000/api/auth/sign_in
+
+http://localhost:3000/api/auth/account
+
+http://localhost:3000/api/auth/sign_out
+
+http://localhost:3000/assets/app.css
+
+http://localhost:3000/assets/app.js
+
+## Web Request
+
+Try Liza with the Rack Web Server
+
+    liza request get /
+
+    liza request post /
+
+    liza request get /xxxxxxx
+
+    liza request get /api/xxxxxxx
+
+    liza request get /api/auth/sign_up
+
+    liza request get /api/auth/sign_in
+
+    liza request get /api/auth/account
+
+    liza request get /api/auth/sign_out
+
+    liza request get /assets/app.css
+
+    liza request get /assets/app.js

data/Rakefile

@@ -1,4 +1,6 @@
 # frozen_string_literal: true
 
 require "bundler/gem_tasks"
-task default: %i[]
+task default: %i[] do
+  system "lizarb test"
+end

data/app/dev/benches/app_bench.rb

@@ -0,0 +1,5 @@
+class AppBench < Liza::Bench
+
+  # Set up your bench controllers per the DSL in http://guides.lizarb.org/controllers/bench.html
+
+end

data/app/dev/benches/app_bench_test.rb

@@ -0,0 +1,7 @@
+class AppBenchTest < Liza::BenchTest
+
+  test :subject_class do
+    assert subject_class == AppBench
+  end
+
+end

data/app/dev/benches/loops_bench.rb

@@ -0,0 +1,183 @@
+class LoopsBench < AppBench
+  main_dsl
+
+  setup do
+    N = 1_000_000
+    RANGE = 1..N
+    ARRAY = Array RANGE
+    HASH_INT = RANGE.map { |i| [i, i] }.to_h
+    HASH_STR = RANGE.map { |i| ["a#{i}", i] }.to_h
+    HASH_SYM = RANGE.map { |i| [:"a#{i}", i] }.to_h
+  end
+
+  mark "for i in RANGE" do
+    for i in RANGE
+      a = "1"
+    end
+  end
+
+  mark "for i in ARRAY" do
+    for i in ARRAY
+      a = "1"
+    end
+  end
+
+  mark "for i, iv in HASH_INT" do
+    for i, iv in HASH_INT
+      a = "1"
+    end
+  end
+
+  mark "for i, iv in HASH_STR" do
+    for i, iv in HASH_STR
+      a = "1"
+    end
+  end
+
+  mark "for i, iv in HASH_SYM" do
+    for i, iv in HASH_SYM
+      a = "1"
+    end
+  end
+
+  mark "RANGE.each do |i|" do
+    RANGE.each do |i|
+      a = "1"
+    end
+  end
+
+  mark "ARRAY.each do |i|" do
+    ARRAY.each do |i|
+      a = "1"
+    end
+  end
+
+  mark "HASH_INT.each do |i, iv|" do
+    HASH_INT.each do |i, iv|
+      a = "1"
+    end
+  end
+
+  mark "HASH_STR.each do |i, iv|" do
+    HASH_STR.each do |i, iv|
+      a = "1"
+    end
+  end
+
+  mark "HASH_SYM.each do |i, iv|" do
+    HASH_SYM.each do |i, iv|
+      a = "1"
+    end
+  end
+
+  mark "HASH_INT.each_pair do |i, iv|" do
+    HASH_INT.each_pair do |i, iv|
+      a = "1"
+    end
+  end
+
+  mark "HASH_STR.each_pair do |i, iv|" do
+    HASH_STR.each_pair do |i, iv|
+      a = "1"
+    end
+  end
+
+  mark "HASH_SYM.each_pair do |i, iv|" do
+    HASH_SYM.each_pair do |i, iv|
+      a = "1"
+    end
+  end
+
+  mark "RANGE.map do |i|" do
+    RANGE.map do |i|
+      a = "1"
+    end
+  end
+
+  mark "ARRAY.map do |i|" do
+    ARRAY.map do |i|
+      a = "1"
+    end
+  end
+
+  mark "HASH_INT.map do |i, iv|" do
+    HASH_INT.map do |i, iv|
+      a = "1"
+    end
+  end
+
+  mark "HASH_STR.map do |i, iv|" do
+    HASH_STR.map do |i, iv|
+      a = "1"
+    end
+  end
+
+  mark "HASH_SYM.map do |i, iv|" do
+    HASH_SYM.map do |i, iv|
+      a = "1"
+    end
+  end
+
+  mark "N.times do |i|" do
+    N.times do |i|
+      a = "1"
+    end
+  end
+
+  mark "1.upto N do |i|" do
+    1.upto N do |i|
+      a = "1"
+    end
+  end
+
+  mark "1.upto N next" do
+    it = 1.upto N
+    begin
+      it.next while true
+    rescue StopIteration
+    end
+    #  do |i|
+    #   a = "1"
+    # end
+  end
+
+  mark "loop break" do
+    i = 0
+
+    loop do
+      a = "1"
+      break unless (i += 1) <= N
+    end
+  end
+
+  mark "while" do
+    i = 0
+
+    while (i += 1) <= N
+      a = "1"
+    end
+  end
+
+  mark "while inline" do
+    i = 0
+
+    a = "1" while (i += 1) <= N
+  end
+
+  mark "begin end while" do
+    i = 0
+
+    begin
+      a = "1"
+    end while (i += 1) <= N
+  end
+
+  mark "begin end until" do
+    i = 0
+
+    begin
+      a = "1"
+    end until (i += 1) == N
+  end
+
+end

data/app/dev/benches/loops_bench_test.rb

@@ -0,0 +1,11 @@
+class LoopsBenchTest < AppBenchTest
+
+  test :subject_class do
+    assert subject_class == LoopsBench
+  end
+
+  test :marks do
+    assert subject_class.marks.keys.count.positive?
+  end
+
+end

data/app/dev/commands/calculator_command.rb

@@ -0,0 +1,69 @@
+class CalculatorCommand < NarrativeMethodCommand
+  class Error < Error; end
+
+  def self.sum(a, b)= a + b
+  def self.sub(a, b)= a - b
+  def self.mul(a, b)= a * b
+  def self.div(a, b)= a / b
+
+  # instance methods
+
+  def validate
+    log "Called #{self}.#{__method__}"
+    raise Invalid, "liza calculator 0 + 0" if @args.size != 3
+
+    @a  = @args[0].to_f
+    @op = @args[1].to_sym
+    @b  = @args[2].to_f
+
+    log "@a  = #{@a}"
+    log "@op = #{@op}"
+    log "@b  = #{@b}"
+
+    raise Invalid, "#{@op} is not a valid operator" unless [:+, :-, :*, :/].include? @op
+  end
+
+  def perform
+    log "Called #{self}.#{__method__}"
+    @result = \
+      case @op
+      when :+ then self.class.sum(@a, @b)
+      when :- then self.class.sub(@a, @b)
+      when :* then self.class.mul(@a, @b)
+      when :/ then self.class.div(@a, @b)
+      end
+    log "RESULT: #{@result}"
+    log render "success.txt"
+  end
+
+end
+
+__END__
+
+# help.txt.erb
+
+NAME:
+
+  liza calculator
+
+DESCRIPTION:
+
+  Calculates the result of an arithmetic operation.
+
+USAGE:
+
+  liza calculator <a> <op> <b>
+
+  where <a> and <b> are numbers and <op> is one of the following operators:
+
+  +   addition
+  -   subtraction
+  *   multiplication
+  /   division
+
+EXAMPLES:
+
+  liza calculator 1 + 2
+  liza calculator 3 - 4
+  liza calculator 5 * 6
+  liza calculator 7 / 8

data/app/dev/commands/calculator_command_test.rb

@@ -0,0 +1,58 @@
+class CalculatorCommandTest < NarrativeMethodCommandTest
+
+  test :subject_class do
+    assert subject_class == CalculatorCommand
+  end
+
+  test :settings do
+    assert subject_class.log_level == :normal
+    assert subject_class.log_color == :green
+  end
+
+  test :subject_class, :sum do
+    assert subject_class.sum(1, 2) == 3
+  end
+
+  test :subject_class, :sub do
+    assert subject_class.sub(1, 2) == -1
+  end
+
+  test :subject_class, :mul do
+    assert subject_class.mul(1, 2) == 2
+  end
+
+  test :subject_class, :div do
+    assert subject_class.div(10, 2) == 5
+  end
+
+  test :validate, :valid do
+    subject = subject_class.new
+    subject.instance_variable_set :@args, ["1", "+", "2"]
+    subject.validate
+    assert subject.instance_variable_get(:@a) == 1
+    assert subject.instance_variable_get(:@op) == :+
+    assert subject.instance_variable_get(:@b) == 2
+  end
+
+  test :validate, :invalid do
+    subject = subject_class.new
+    subject.instance_variable_set :@args, ["1", "x", "2"]
+    begin
+      subject.validate
+      assert false
+    rescue CalculatorCommand::Invalid
+      assert true
+    else
+      assert false
+    end
+  end
+
+  test :perform do
+    subject = subject_class.new
+    subject.instance_variable_set :@args, ["1", "+", "2"]
+    subject.validate
+    subject.perform
+    assert subject.instance_variable_get(:@result) == 3
+  end
+
+end

data/app/dev/commands/circle_command.rb

@@ -0,0 +1,70 @@
+class CircleCommand < NarrativeMethodCommand
+  class Error < Error; end
+
+  def self.area(radius)
+    log "Called #{self}.#{__method__} with radius #{radius}"
+    log "The answer is #{radius**2}π"
+    Math::PI * radius**2
+  end
+
+  def self.circumference(radius)
+    log "Called #{self}.#{__method__} with radius #{radius}"
+    log "The answer is #{radius * 2}π"
+    2 * Math::PI * radius
+  end
+
+  # instance methods
+
+  def validate
+    log "Called #{self}.#{__method__}"
+    raise Invalid, "liza circle <formula> <radius>" if @args.size != 2
+    raise Invalid, "liza circle <formula> <radius>" if @args[0] != "area" && @args[0] != "circumference"
+
+    @formula = @args[0].to_sym
+    @radius = @args[1].to_f
+
+    log "@formula = #{@formula}"
+    log "@radius  = #{@radius}"
+
+    raise Invalid, "radius must be greater than 0" if @radius <= 0
+  end
+
+  def perform
+    log "Called #{self}.#{__method__}"
+
+    @result = \
+      case @formula
+      when :area          then self.class.area(@radius)
+      when :circumference then self.class.circumference(@radius)
+      end
+    log "RESULT: #{@result}"
+    log render "success.txt"
+  end
+
+end
+
+__END__
+
+# help.txt.erb
+
+NAME:
+
+  liza circle
+
+DESCRIPTION:
+
+  Calculates a circle formula based on the radius.
+
+USAGE:
+
+  liza circle <formula> <radius>
+
+FORMULAS:
+
+  area          - calculates the area of a circle
+  circumference - calculates the circumference of a circle
+
+EXAMPLES:
+
+  liza circle area 5
+  liza circle circumference 5