L2 0.6.1 → 0.6.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 63fca1356bc1e875e3e0e099d5446c4a83a52d6d220397a2a926790ebe8a943d
-  data.tar.gz: 90ae8b403f6a46f59ac9e6eed1d48ecc3377fa3f5f9f461083135d2fa5141995
+  metadata.gz: d3a41619068a96d282383ae08345c36ecee67cd278af1fb79dd0e37b0f5b51d6
+  data.tar.gz: 371519f1a8eb08032e016b552a19567627937cba89fdb1111347676ede4e7811
 SHA512:
-  metadata.gz: d49ab94198155f80d37ae124bc05d275b6df447a3b2903de18c89b98b995ca7997adb712a453521e54756b2ddbd5ff5bcd4b7c443a9b9f5dd3a64e6414122270
-  data.tar.gz: 7b1c76d23480f6f8de6c758d677af7fce40f5cac45cb1890941b8044163f44978d312ef4221cdeee3fab42af8251c41f89b99c3bcb9f4263abc9411db09c2327
+  metadata.gz: f5acc5a2b6020db90e7511311477e214fbb3f3c6ad55cdb5b93b617a076d0e934214a9c0a61b834d23616a74fcac81271658cdf36e8e8d962395632aa4b907f3
+  data.tar.gz: 83fc13dba5e1d0881eba0cc12d2a8f1e53dd361a5b13093f4fb9aa49e50973b694374a4f882f7b46a37b3636d851956806a983d7896a697a4a077b4d38538570

data/lib/L2/banner.rb

@@ -0,0 +1,50 @@
+
+module L2 
+    module Banner 
+        def self.title title 
+            width = WIDTH - title.length - 4
+            self.line(WIDTH/8)
+            puts title.rjust(width / 2)
+            self.line(WIDTH/8)
+        end 
+
+        def self.infob *messages
+            puts(separator_pretty(:blue))
+            messages.each { |message| puts(pretty("INFO: #{ message }", :white, :blue)) }
+            puts(separator_pretty(:blue))
+        end
+    
+        def self.successb *messages
+            puts(separator_pretty(:green))
+            messages.each { |message| puts(pretty("SUCCESS: #{ message }", :black, :green)) }
+            puts(separator_pretty(:green))
+        end
+    
+        def self.warningb *messages
+            puts(separator_pretty(:yellow))
+            messages.each { |message| puts(pretty("WARNING: #{ message }", :black, :yellow)) }
+            puts(separator_pretty(:yellow))
+        end
+    
+        def self.dangerb *messages
+            puts(separator_pretty(:red))
+            messages.each { |message| puts(pretty("ERROR: #{ message }", :yellow, :red)) }
+            puts(pretty("PATH: #{ caller[0] }", :yellow, :red))
+            puts(separator_pretty(:red))
+        end
+    
+        def self.fatal *messages
+            puts(separator_pretty(:red))
+            messages.each { |message| puts("\e[5m#{pretty(message, :white, :red)}\e[0m") }
+            puts(pretty("PATH: #{ caller[0] }", :white, :red))
+            puts(separator_pretty(:red))
+        end
+
+        
+        def self.deprecation message
+            puts(separator_pretty(:red))
+            puts(pretty("DEPRECATED METHOD: #{ caller[0] }, #{ message }", :white, :red))
+            puts(separator_pretty(:red))
+        end
+    end
+end 

data/lib/L2/config.rb

@@ -0,0 +1,64 @@
+
+
+module L2 
+    module Config 
+
+        ICONS = {
+            checkmark: "✓",
+            bullet: "•",
+            star: "★"
+        }.freeze
+    
+        # standard color palette for texts
+        COLORS = { 
+            skyblue: '96',
+            default: '38', 
+            yellow: '1;33',
+            white: '1;37', 
+            green: '32',  
+            black: '30', 
+            blue: '36', 
+            red: '31'
+        }.freeze
+    
+        # standard color palette for backgrounds
+        BG_COLORS = { 
+            default: '0', 
+            yellow: '103', 
+            white: '107', 
+            green: '42', 
+            black: '40', 
+            blue: '44',
+            red: '41'
+        }.freeze
+    
+    
+        # calculate the console width
+        # tputcols is not available on windows
+        #WIDTH = `tput cols`.to_i rescue WIDTH = 1;
+        WIDTH = begin
+            term = ENV['TERM']
+            term ? `tput cols`.to_i : 1
+        rescue
+            1
+        end
+
+        def self.colorize(text, colour = :default, bg_colour = :default)
+            colour_code = COLORS[colour]
+            bg_colour_code = BG_COLORS[bg_colour]
+            return "\e[#{bg_colour_code};#{colour_code}m#{text}\e[0m".squeeze(';')
+        end
+        
+    
+        def self.pretty(message, colour = :default, bg_colour = :default)
+            width = 1
+    
+            unless bg_colour == :default
+                width = WIDTH - message.length - 4
+                width = 1 if width.negative?
+            end
+    
+            return colorize("\ \ #{ message } #{"\ " * width}", colour, bg_colour)
+        end
+    end 
+end

data/lib/L2/list.rb

@@ -0,0 +1,19 @@
+
+require "l2/Config"
+
+module L2 
+    module List 
+
+        def self.bullet *items
+            items.each { |item| puts(" #{Config::ICONS[:bullet]} #{ item }" )}
+        end
+    
+        def self.check *items
+            items.each { |item| puts(" #{Config::ICONS[:checkmark]} #{ item }" )}
+        end
+    
+        def self.star *items
+            items.each { |item| puts(" #{Config::ICONS[:star]} #{ item }" )}
+        end
+    end
+end 

data/lib/L2/msg.rb

@@ -0,0 +1,35 @@
+
+require "l2/Config"
+
+module L2
+    module Msg 
+        def self.simple messages
+            messages.each { |message| puts(message) }
+        end
+
+        def self.msg messages
+            self.m(messages)
+        end
+    
+        def self.info messages
+            messages.each { |message| puts(Config.pretty("INFO: #{ message }", :blue)) }
+        end
+
+        def self.success messages
+            messages.each { |message| puts(Config.pretty("SUCCESS: #{ message }", :green)) }
+        end
+
+        def self.warning messages
+            messages.each { |message| puts(Config.pretty("WARNING: #{ message }", :yellow)) }
+        end
+
+        def self.danger messages
+            messages.each { |message| puts(Config.pretty("ERROR: #{ message }", :red)) }
+        end
+
+        def self.alert messages
+            messages.each { |message| puts("\e[5m#{message}\e[0m") }
+        end
+    
+    end
+end

data/lib/L2/space.rb

@@ -0,0 +1,19 @@
+
+require "l2/Config"
+
+module L2 
+    module Space 
+
+        def self.br count=1
+            puts("\n" * count);
+        end 
+    
+        def self.line count=8
+            puts('-·-     ' * count)
+        end
+
+        def self.color color
+            Config.pretty("", :black, color)
+        end
+    end
+end

data/lib/L2/table.rb

@@ -0,0 +1,55 @@
+
+require "l2/Config"
+
+module L2 
+    module Table 
+        def self.simple data
+
+            return if Gem.win_platform?
+            return unless data.size > 0
+
+            if data.class.name == "ActiveRecord::Relation"
+                data = data.to_a.map(&:serializable_hash) 
+            end
+
+            # get the available characters in terminal width
+            #terminal_width = `tput cols`.to_i
+            terminal_width = Config::WIDTH
+
+            # get the number of columns to print base on the data hash
+            cols = data.first.keys.count + 1
+
+            # get the available space for every column
+            col_width = (terminal_width / cols) - 1
+
+            # validate that we have minimum space to render the table
+            return if col_width <= 0
+
+            # separator for every column and row
+            separator = ('| ' << ('- ' * (col_width / 2)))
+
+            # add extra blank spaces to adjust the col_width only if col_width not a even number
+            separator += (' ') if (col_width - separator.size).odd?
+        
+            # print data as table :)
+            data.each_with_index do |row, index|
+
+                # only for table header
+                if index == 0 
+
+                    # print table titles
+                    puts '| ' << row.keys.map { |key| key.to_s.upcase.ljust(col_width) }.join('| ')
+
+                    # print header separators, only for visible columns
+                    puts separator * (cols - 1)
+
+                end 
+
+                # join hash values as a line and justify every value to print value
+                # in its own column
+                puts '| ' << row.values.map { |value| value.to_s.ljust(col_width) }.join('| ')
+
+            end
+        end
+    end
+end

data/lib/L2/version.rb

@@ -0,0 +1,34 @@
+=begin
+
+Copyright (c) 2022, Lesli Technologies, S. A.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+Lesli Ruby Messages - Message utilities for the Ruby console
+
+Powered by https://www.lesli.tech
+Building a better future, one line of code at a time.
+
+@contact  <hello@lesli.tech>
+@website  <https://www.lesli.tech>
+@license  GPLv3 http://www.gnu.org/licenses/gpl-3.0.en.html
+@author   The Lesli Development Team
+
+// · ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~
+// · 
+=end
+
+module L2
+    VERSION = "0.6.3"
+end

data/lib/L2.rb

@@ -30,10 +30,10 @@ Building a better future, one line of code at a time.
 =end
 
 
-require "l2/msg"
-require "l2/list"
-require "l2/table"
-require "l2/space"
+require "L2/msg"
+require "L2/list"
+require "L2/table"
+require "L2/space"
 
 
 # ·

data/readme.md

@@ -0,0 +1,145 @@
+<p align="center">
+	<a href="https://www.lesli.dev" target="_blank">
+		<img alt="Lesli Ruby Message logo" width="200px" src="./docs/l2-logo.svg" />
+	</a>
+</p>
+<h3 align="center">Message utilities for the Ruby console</h3>
+
+Version 0.5.2
+
+## Installation
+
+Install the gem and add to the application's Gemfile by executing:
+
+    $ bundle add l2
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+    $ gem install l2
+
+Rails apps
+
+    $ gem "L2", "~> 0.4.0"
+
+## Usage
+
+
+**Simple message:**
+
+```ruby
+L2.m("hola")
+L2.m("hola", "hello", "hallo", 1, [2], {"a":"b"})
+```
+
+
+**Simple message with dividing line:**
+
+```ruby
+L2.msg("hola")
+L2.msg("hola", "hello", "hallo", 1, [2], {"a":"b"})
+```
+
+
+**Informative message:**
+
+```ruby
+L2.info("hola")
+L2.info("hola", "hello", "hallo", 1, [2], {"a":"b"})
+```
+
+
+**Sucessful message:**
+
+```ruby
+L2.success("hola")
+L2.success("hola", "hello", "hallo", 1, [2], {"a":"b"})
+```
+
+
+**Simple message:**
+
+```ruby
+L2.warning("hola")
+L2.warning("hola", "hello", "hallo", 1, [2], {"a":"b"})
+```
+
+
+**Error message:**
+
+```ruby
+L2.danger("hola")
+L2.danger("hola", "hello", "hallo", 1, [2], {"a":"b"})
+```
+
+
+**Error with flashing message:**
+
+```ruby
+L2.fatal("hola")
+L2.fatal("hola", "hello", "hallo", 1, [2], {"a":"b"})
+```
+
+
+**Flashing message:**
+
+```ruby
+L2.alert("hola")
+L2.alert("hola", "hello", "hallo", 1, [2], {"a":"b"})
+```
+
+
+**Useful to give instructions in deprecated methods or code:**
+
+```ruby
+L2.deprecation("hola")
+```
+
+
+**Print a simple list:**
+
+```ruby
+L2.list("hola", "hello", "hallo", 1, [2], {"a":"b"})
+```
+
+
+**Show data as table:**
+
+```ruby
+L2.table([
+    { español: "hola", english: "hello", deutsch: "hallo" },
+    { español: "hola", english: "hello", deutsch: "hallo" },
+    { español: "hola", english: "hello", deutsch: "hallo" }
+])
+```
+
+
+**Display a cow message:**
+
+```ruby
+L2.cow("Hello little cow!")
+```
+
+
+### Development
+------
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+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).
+
+### Contributing
+------
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/LesliTech/l2.
+
+
+### License  
+------
+
+Software developed in [Guatemala](http://visitguatemala.com/) distributed under the *General Public License v 3.0* you can read the full license [here](http://www.gnu.org/licenses/gpl-3.0.html)
+
+<p align="center">
+	<a href="https://www.lesli.tech" target="_blank">
+		<img alt="LesliTech logo" width="150" src="https://cdn.lesli.tech/leslitech/brand/leslitech-logo.svg" />
+	</a>
+</p>

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: L2
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.6.3
 platform: ruby
 authors:
 - The Lesli Development Team
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-09 00:00:00.000000000 Z
+date: 2024-06-13 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -18,6 +18,14 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/L2.rb
+- lib/L2/banner.rb
+- lib/L2/config.rb
+- lib/L2/list.rb
+- lib/L2/msg.rb
+- lib/L2/space.rb
+- lib/L2/table.rb
+- lib/L2/version.rb
+- readme.md
 homepage: https://github.com/LesliTech/L2
 licenses:
 - GPL-3.0
@@ -25,7 +33,7 @@ metadata:
   homepage_uri: https://github.com/LesliTech/L2
   source_code_uri: https://github.com/LesliTech/L2
   bug_tracker_uri: https://github.com/LesliTech/L2/issues
-  changelog_uri: https://github.com/LesliTech/L2/releases/tag/v0.6.1
+  changelog_uri: https://github.com/LesliTech/L2/releases/tag/v0.6.3
 post_install_message:
 rdoc_options: []
 require_paths: