lizarb 0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bdaa95f6c7eb9982be8bfad6a61cd875f48a2aecbdb31a10ea7cf79de78d9ded
-  data.tar.gz: 89d87914888398be77d745450ac65643854e41056c4012704d187c760d729a54
+  metadata.gz: c4e73803f6fe207c86ff2e6799e3bdbe50979bbe9fb409750c067ef6ce299c5b
+  data.tar.gz: 46c590ae60a43c0fd0b901f800da5f8761cc70baae0ace96e64a772941c6512f
 SHA512:
-  metadata.gz: 6eeb9a8ae5e22359a80d97b2fda20460bd1d2412dbfcde448b032582e6a1ef3b8a26ab7f9b8fc3fb8122c8feb3173e2bb206a97bbf93716a1c2628a76cff41f7
-  data.tar.gz: de69455fe9e66be7c22f01b545fc9f6e06903bd30670559f7a9bd4ca6f335dd81f8837b86c753d21979199c3dc3a7a950322a90c2f4537d80f1801b519d412df
+  metadata.gz: 1c83f9babff78a0487784c8c62bf98cf3dd44e64a01267c57bcb1bd4938c980ec09759f4069ef6819088511e25ef6e29f6acc3920ae950c71d00e43d362970c9
+  data.tar.gz: 043bbe7ac4dc5102f3a2b8b261ff13e7a8784d6217a5474b40d8110005b4060d281cf73f938172e0487564c80427d7f63f3e2c1df6c9a3b252f6fd214052070a

data/.ruby-version

@@ -0,0 +1 @@
+3.1.2

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 ## [Unreleased]
 
-## [0.1.0] - 2022-07-03
+- 
 
-- Initial release
+## [1.0.0] - 2022-10-11
+
+- App, Liza and Lizarb
+- Liza::Unit, Liza::Part
+- Liza::Test
+- Liza::Unit has class/instance methods settings/set/set/add/fetch
+- Liza::Unit has class/instance methods log/log_color/log_level/log?/log_level?
+- Liza::System, Liza::Box, Liza::Panel, Liza::Controller
+- DevSystem, Liza::DevBox, Liza::Command, AppCommand, and others
+- HappySystem, Liza::HappyBox, Liza::Axo, Axo, and others
+- NetSystem, Liza::NetBox, Liza::Adapter, Liza::Database, Liza::Model, AppModel, and others
+- WebSystem, Liza::WebBox, Liza::Request, AppRequest, and others

data/Gemfile

@@ -2,7 +2,27 @@
 
 source "https://rubygems.org"
 
-# Specify your gem's dependencies in viral.gemspec
+# Specify your gem's dependencies in lizarb.gemspec
 gemspec
 
-# gem "rake", "~> 13.0"
+group :dev do
+  # gems you only want to load if DevSystem is loaded
+  gem "pry", "~> 0.14.1"
+end
+
+group :happy do
+  # gems you only want to load if HappySystem is loaded
+end
+
+group :net do
+  # gems you only want to load if NetSystem is loaded
+  gem "redis", "~> 5.0"
+  gem "sqlite3", "~> 1.5"
+end
+
+group :web do
+  # gems you only want to load if WebSystem is loaded
+  gem "rack", "~> 3.0"
+  gem "rackup", "~> 0.2.2"
+  gem "puma", "~> 5.6"
+end

data/Gemfile.lock

@@ -0,0 +1,52 @@
+PATH
+  remote: .
+  specs:
+    lizarb (1.0.1)
+      colorize (~> 0.8)
+      dotenv (~> 2.8)
+      zeitwerk (~> 2.6)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    coderay (1.1.3)
+    colorize (0.8.1)
+    connection_pool (2.3.0)
+    dotenv (2.8.1)
+    method_source (1.0.0)
+    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)
+    rackup (0.2.2)
+      rack (>= 3.0.0.beta1)
+      webrick
+    rake (13.0.6)
+    redis (5.0.5)
+      redis-client (>= 0.9.0)
+    redis-client (0.10.0)
+      connection_pool
+    sqlite3 (1.5.3-arm64-darwin)
+    sqlite3 (1.5.3-x86_64-linux)
+    webrick (1.7.0)
+    zeitwerk (2.6.1)
+
+PLATFORMS
+  arm64-darwin-21
+  x86_64-linux
+
+DEPENDENCIES
+  lizarb!
+  pry (~> 0.14.1)
+  puma (~> 5.6)
+  rack (~> 3.0)
+  rackup (~> 0.2.2)
+  rake (~> 13.0)
+  redis (~> 5.0)
+  sqlite3 (~> 1.5)
+
+BUNDLED WITH
+   2.3.22

data/README.md

@@ -1,18 +1,82 @@
-# Viral
+# Liza
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/viral`. To experiment with that code, run `bin/console` for an interactive prompt.
+Liza is a light, experimental framework primarily developed to help study the Ruby language and the Ruby ecosystem.
 
-TODO: Delete this and the text above, and describe your gem
+## Install
 
-## Installation
+Install the gem by executing:
 
-Install the gem and add to the application's Gemfile by executing:
+    $ gem install lizarb
 
-    $ bundle add viral
+You will get the following three shims:
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+    $ lizarb version
+    $ liza version
 
-    $ gem install viral
+## 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
+
+    $ 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';"
+
+```
+
+## Web Server
+
+Try Liza with the Rack Web Server
+
+    $ liza web
+
+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
 
 ## Usage
 
@@ -20,13 +84,25 @@ TODO: Write usage instructions here
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+To install dependencies, run this bash script:
+
+    $ bin/setup
+
+For development experiments, use the local executable script
+
+    $ exe/lizarb test
+
+To build and install lizarb in your local machine
+
+    $ bundle exec rake install
+
+## Release    
 
-To install this gem onto your local machine, run `bundle exec rake install`. 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).
+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).
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/viral. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/viral/blob/master/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/rubyonrails-brasil/lizarb. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/rubyonrails-brasil/lizarb/blob/master/CODE_OF_CONDUCT.md).
 
 ## License
 
@@ -34,4 +110,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the Viral project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/viral/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the Lizarb project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/rubyonrails-brasil/lizarb/blob/master/CODE_OF_CONDUCT.md).

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,148 @@
+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 "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 "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 "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/app_command.rb

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

data/app/dev/commands/app_command_test.rb

@@ -0,0 +1,7 @@
+class AppCommandTest < Liza::CommandTest
+
+  test :subject_class do
+    assert subject_class == AppCommand
+  end
+
+end

data/app/dev/commands/example_command.rb

@@ -0,0 +1,57 @@
+class ExampleCommand < AppCommand
+
+  def self.call(args)
+    log :higher, "Called #{self}.#{__method__} with args #{args}"
+
+    class_helper_method_1(args)
+    class_helper_method_2(args)
+    class_helper_method_3(args)
+
+    command = new(args)
+    command.helper_method_1(args)
+    command.helper_method_2(args)
+    command.helper_method_3(args)
+  end
+
+  #
+
+  def self.class_helper_method_1(args)
+    log :higher, "Called #{self}.#{__method__} with args #{args}"
+    1
+  end
+
+  def self.class_helper_method_2(args)
+    log :higher, "Called #{self}.#{__method__} with args #{args}"
+    2
+  end
+
+  def self.class_helper_method_3(args)
+    log :higher, "Called #{self}.#{__method__} with args #{args}"
+    3
+  end
+
+  #
+
+  def initialize(args)
+    log :higher, "Called #{self}.#{__method__} with args #{args}"
+    @init_args = args
+  end
+
+  #
+
+  def helper_method_1(args)
+    log :higher, "Called #{self}.#{__method__} (which has @init_args #{@init_args}) with args #{args}"
+    @init_args[0]
+  end
+
+  def helper_method_2(args)
+    log :higher, "Called #{self}.#{__method__} (which has @init_args #{@init_args}) with args #{args}"
+    @init_args[1]
+  end
+
+  def helper_method_3(args)
+    log :higher, "Called #{self}.#{__method__} (which has @init_args #{@init_args}) with args #{args}"
+    @init_args[2]
+  end
+
+end

data/app/dev/commands/example_command_test.rb

@@ -0,0 +1,43 @@
+class ExampleCommandTest < AppCommandTest
+
+  test :subject_class do
+    assert subject_class == ExampleCommand
+  end
+
+  group "class methods" do
+
+    test :class_helper_method_1 do
+      assert subject_class.class_helper_method_1([]) == 1
+    end
+
+    test :class_helper_method_2 do
+      assert subject_class.class_helper_method_2([]) == 2
+    end
+
+    test :class_helper_method_3 do
+      assert subject_class.class_helper_method_3([]) == 3
+    end
+
+  end
+
+  group "instance methods" do
+
+    before do
+      @subject = subject_class.new([1, 2, 3])
+    end
+
+    test :helper_method_1 do
+      assert @subject.helper_method_1([]) == 1
+    end
+
+    test :helper_method_2 do
+      assert @subject.helper_method_2([]) == 2
+    end
+
+    test :helper_method_3 do
+      assert @subject.helper_method_3([]) == 3
+    end
+
+  end
+
+end

data/app/dev/commands/macro_child_command.rb

@@ -0,0 +1,32 @@
+class MacroChildCommand < MacroParentCommand
+
+  class_macro_method_1 :important_thing
+  class_macro_method_2 :other_thing
+  class_macro_method_3 :other_important_thing
+  class_macro_method_4 :ruby_is_awesome
+
+  #
+
+  def call(args)
+    log :higher, "Called #{self}.#{__method__} (which has @init_args #{@init_args}) with args #{args}"
+
+    if @@class_macro_3
+      @result << :YES_from_instance_call
+    else
+      @result << :NO_from_instance_call
+    end
+
+    @result << helper_method(args)
+  end
+
+  def helper_method(args)
+    log :higher, "Called #{self}.#{__method__} (which has @init_args #{@init_args}) with args #{args}"
+
+    if @@class_macro_4
+      :Yes_from_helper_method
+    else
+      :No_from_helper_method
+    end
+  end
+
+end

data/app/dev/commands/macro_child_command_test.rb

@@ -0,0 +1,7 @@
+class MacroChildCommandTest < AppCommandTest
+
+  test :subject_class do
+    assert subject_class == MacroChildCommand
+  end
+
+end

data/app/dev/commands/macro_parent_command.rb

@@ -0,0 +1,70 @@
+class MacroParentCommand < AppCommand
+
+  def self.class_macro_method_1(arg)
+    log :higher, "Called #{self}.#{__method__} with arg #{arg}"
+    @@class_macro_1 = arg
+  end
+
+  def self.class_macro_method_2(arg)
+    log :higher, "Called #{self}.#{__method__} with arg #{arg}"
+    @@class_macro_2 = arg
+  end
+
+  def self.class_macro_method_3(arg)
+    log :higher, "Called #{self}.#{__method__} with arg #{arg}"
+    @@class_macro_3 = arg
+  end
+
+  def self.class_macro_method_4(arg)
+    log :higher, "Called #{self}.#{__method__} with arg #{arg}"
+    @@class_macro_4 = arg
+  end
+
+  #
+
+  def self.call(args)
+    log :higher, "Called #{self}.#{__method__} with args #{args}"
+
+    if @@class_macro_1
+      args << :yes_from_class_call
+    else
+      args << :no_from_class_call
+    end
+
+    command = new(args)
+    result = command.call(args)
+
+    puts <<-OUTPUT
+
+      self: #{self}
+      args: #{args}
+      command: #{command}
+      result: #{result}
+
+    OUTPUT
+  end
+
+  #
+
+  attr_reader :result
+
+  def initialize(args)
+    log :higher, "Called #{self}.#{__method__} with args #{args}"
+    @init_args = args
+
+    @result = [args]
+
+    if @@class_macro_2
+      @result << :yes_from_initialize
+    else
+      @result << :no_from_initialize
+    end
+  end
+
+  #
+
+  def call(args)
+    raise NotImplementedError, "implement this on MacroChildCommand"
+  end
+
+end

data/app/dev/commands/macro_parent_command_test.rb

@@ -0,0 +1,7 @@
+class MacroParentCommandTest < AppCommandTest
+
+  test :subject_class do
+    assert subject_class == MacroParentCommand
+  end
+
+end

data/app/dev/commands/my_command.rb

@@ -0,0 +1,7 @@
+class MyCommand < AppCommand
+
+  def self.call args
+    log :higher, "Called #{self}.#{__method__} with args #{args}"
+  end
+
+end

data/app/dev/commands/my_command_test.rb

@@ -0,0 +1,7 @@
+class MyCommandTest < AppCommandTest
+
+  test :subject_class do
+    assert subject_class == MyCommand
+  end
+
+end

data/app/dev/commands/new_command.rb

@@ -0,0 +1,9 @@
+class NewCommand < AppCommand
+
+  def self.call args
+    log :higher, "Called #{self}.#{__method__} with args #{args}"
+
+    Liza::GenerateCommand.call ["app", *args]
+  end
+
+end

data/app/dev/commands/new_command_test.rb

@@ -0,0 +1,7 @@
+class NewCommandTest < AppCommandTest
+
+  test :subject_class do
+    assert subject_class == NewCommand
+  end
+
+end