lizarb 0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bdaa95f6c7eb9982be8bfad6a61cd875f48a2aecbdb31a10ea7cf79de78d9ded
-  data.tar.gz: 89d87914888398be77d745450ac65643854e41056c4012704d187c760d729a54
+  metadata.gz: c859781b1927e69f516b2b6d057b19a4e8d6603945636ce0ec7306640fbd1956
+  data.tar.gz: d5849f4bcbf610ee5a94df16dbd92feab78a4f724e2ac77eeae05e93aebfbef5
 SHA512:
-  metadata.gz: 6eeb9a8ae5e22359a80d97b2fda20460bd1d2412dbfcde448b032582e6a1ef3b8a26ab7f9b8fc3fb8122c8feb3173e2bb206a97bbf93716a1c2628a76cff41f7
-  data.tar.gz: de69455fe9e66be7c22f01b545fc9f6e06903bd30670559f7a9bd4ca6f335dd81f8837b86c753d21979199c3dc3a7a950322a90c2f4537d80f1801b519d412df
+  metadata.gz: 4e4ffd81acfddf2a8aadebc0fcc10911141b3a8fc55e164d050fc3c8156a7ee560a7a84133c12d19e1491ff9c720b8a6afd857b6c22bdf14844ac03550c2dc6e
+  data.tar.gz: bd421065bc059d7ebeac4d3d805e2133a18d0bb31745bc95a4b62d785f2b2368fbd80482cd2a7cac2cec03a239dc58b988844c1a234f4a0aa9a84ef99fc77256

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,26 @@
 
 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
+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,44 @@
+PATH
+  remote: .
+  specs:
+    lizarb (1.0.0)
+      colorize (~> 0.8)
+      dotenv (~> 2.8)
+      zeitwerk (~> 2.6)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    colorize (0.8.1)
+    connection_pool (2.3.0)
+    dotenv (2.8.1)
+    nio4r (2.5.8)
+    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.2-x86_64-linux)
+    webrick (1.7.0)
+    zeitwerk (2.6.1)
+
+PLATFORMS
+  x86_64-linux
+
+DEPENDENCIES
+  lizarb!
+  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.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 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/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,69 @@
+class NewCommand < AppCommand
+
+  def self.call args
+    log :higher, "Called #{self}.#{__method__} with args #{args}"
+
+    # setup
+
+    name = args.shift || "app_1"
+
+    from = "#{Lizarb::APP_DIR}/app_new"
+    to = name
+
+    return log "Directory #{to.light_green} already exists." if Dir.exist? to
+
+    log "Liza Application initializing at `#{to}`"
+
+    # init
+
+    require "fileutils"
+    FileUtils.cp_r from, to, verbose: true
+
+    `cd #{to}; git init .`
+
+    # extra
+
+    puts
+    FileUtils.mkdir_p "#{to}/app", verbose: true
+
+    FileUtils.mkdir_p "#{to}/lib", verbose: true
+    FileUtils.touch "#{to}/lib/.gitkeep", verbose: true
+    FileUtils.mkdir_p "#{to}/tmp", verbose: true
+    FileUtils.touch "#{to}/tmp/.gitkeep", verbose: true
+
+    # systems
+
+    App.systems.keys.each { |system_name| copy name, system_name }
+
+    FileUtils.rm "#{to}/app/dev/commands/new_command.rb"
+    FileUtils.rm "#{to}/app/dev/commands/new_command_test.rb"
+
+    FileUtils.cp_r "#{Lizarb::APP_DIR}/.ruby-version", "#{to}/.ruby-version", verbose: true
+    FileUtils.cp_r "#{Lizarb::APP_DIR}/README.md", "#{to}/README.md", verbose: true
+    FileUtils.cp_r "#{Lizarb::APP_DIR}/app.rb", "#{to}/app.rb", verbose: true
+    FileUtils.cp_r "#{Lizarb::APP_DIR}/app.env", "#{to}/app.env", verbose: true
+    FileUtils.cp_r "#{Lizarb::APP_DIR}/app.code.env", "#{to}/app.code.env", verbose: true
+    puts
+
+    log "Liza Application initialized at `#{to}`"
+  end
+
+  def self.copy name, system_name
+    from = "#{Lizarb::APP_DIR}/app/#{system_name}_box.rb"
+    to = "#{name}/app"
+    if File.exist? from
+      FileUtils.cp_r from, to, verbose: true
+    else
+      puts "file not found #{from}"
+    end
+
+    from = "#{Lizarb::APP_DIR}/app/#{system_name}"
+    to = "#{name}/app"
+    if File.exist? from
+      FileUtils.cp_r from, to, verbose: true
+    else
+      puts "file not found #{from}"
+    end
+  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

data/app/dev_box.rb

@@ -0,0 +1,13 @@
+class DevBox < Liza::DevBox
+
+  commands do
+    # Set up your command panel per the DSL in http://guides.lizarb.com/panels/command.html
+
+  end
+
+  logs do
+    # Set up your log panel per the DSL in http://guides.lizarb.com/panels/log.html
+
+  end
+
+end

data/app/happy/axos/axo.rb

@@ -0,0 +1,50 @@
+class Axo < Liza::Axo
+
+  # Set up your request controllers per the DSL in http://guides.lizarb.org/controllers/axo.html
+
+  def self.call args
+    cycles = args[0] || "3"
+    sleep_time = args[1] || "3"
+
+    cycles = cycles.to_i
+    sleep_time = sleep_time.to_f / 10
+
+    array = <<-HEREDOC.split("\n")
+                >(.___.)<
+                 >(.__.)<
+                 >(.___.)<    code
+                  >(.__.)<    code to
+                  >(.___.)<   code to the
+                   >(.__.)<   code to the right
+                   >(.___.)<  code to the right
+                   >(.__.)<
+code                >(.___.)<
+code to             >(.__.)<
+code to the        >(.___.)<
+code to the left   >(.__.)<
+code to the left  >(.___.)<
+                >(.__.)<
+    HEREDOC
+
+    cycles.times do |i|
+      array.each_with_index do |s, j|
+        system "clear"
+
+        puts "Axo v0"
+        puts "frame: #{j}/#{array.size}"
+        puts "cycle: #{i}/#{cycles} (#{sleep_time}spf)"
+        puts
+        puts
+        puts " " * 3 + s.bold.light_white
+        puts
+
+        sleep sleep_time
+      end
+    end
+
+    puts "That was actually quite a nice workout session!".black.on_white
+    puts "        We should do this again some time.     ".black.on_white
+
+  end
+
+end

data/app/happy_box.rb

@@ -0,0 +1,8 @@
+class HappyBox < Liza::HappyBox
+
+  axo do
+    # Set up your axo panel per the DSL in http://guides.lizarb.com/panels/axo.html
+
+  end
+
+end

data/app/net/databases/redis_db.rb

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

data/app/net/databases/redis_db_test.rb

@@ -0,0 +1,12 @@
+class RedisDbTest < Liza::RedisDbTest
+
+  test :subject_class do
+    assert subject_class == RedisDb
+    assert RedisDb.current.class == RedisDb
+    assert Liza::RedisDb.current.class == RedisDb
+    assert RedisDb.current == Liza::RedisDb.current
+    assert RedisDb.current.adapter == Liza::RedisDb.current.adapter
+    assert RedisDb.current.adapter.conn == Liza::RedisDb.current.adapter.conn
+  end
+
+end

data/app/net/databases/sqlite_db.rb

@@ -0,0 +1,11 @@
+class SqliteDb < Liza::SqliteDb
+
+  # Set up your database controllers per the DSL in http://guides.lizarb.org/controllers/database.html
+
+  def table_names
+    result = call "SELECT name FROM sqlite_schema;"
+    result.delete_at 0
+    result.flatten
+  end
+
+end