remedy 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 346c9d17734819cc9516ee578ae4b647e70c13c876c7a84e3ffe74e9cb956e27
-  data.tar.gz: 4add78044a3161d6eae52452a6a0bd3f3ba46a18b238af7b533f996ac6599ac6
+  metadata.gz: b308f7cf135ba7a8f6ab69ef9c56ff7d640a189c9f44056e14f49b987948ec1f
+  data.tar.gz: 9f1969fea60358a6585974f948f572bdeeeb55afd0f176d6dd220bdd4b29c094
 SHA512:
-  metadata.gz: e3a676f7b7df84dc9732aad2518a4bf2d53625736f0928ed3c2dea7f613d727d3fb6539b724939fa83c427cff098d39fcc7ee09412b195d44dca05d3e28dbbbd
-  data.tar.gz: a6f5a5cc4a4523b6220b426b4016b6370c814f38a2effc993c729a1456e22f3dd9765c43d62bb1f5a8e0ee351a4e14530a87286b58e87409ba9b5c2968cf46ff
+  metadata.gz: 0d664d1b61638b139bd2aef66ed2facd0d25e4dbaa65a39014892bcb3f967895cbf78304a8b4235cce1a5210384e7cadaa6672fa41a2d2e102c22a80c0cd40ef
+  data.tar.gz: ea8a3d1aeaeb8a0e474bf2a69f6837ab300810dfaf3bd014200e284f6e45058875fa5363e73948228806e35e24957ded1d342d07a8622f089726e94da2e93a3b

data/.ruby-version

@@ -1 +1 @@
-2.3.7
+2.6.3

data/README.markdown

@@ -1,10 +1,13 @@
 Remedy
 ======
 
-Remedy is a console interaction framework along the lines of Curses written in pure Ruby with an Object-Oriented approach and well-seperated concerns making it easy to use what you need and ignore the rest.
+Remedy is a console interaction framework along the lines of Curses written in pure Ruby. It is modular, making it easy to use what you need and ignore the rest.
+
+[![Gem Version](https://img.shields.io/gem/v/remedy.svg?style=for-the-badge)](https://rubygems.org/gems/remedy)
+[![Gem Downloads](https://img.shields.io/gem/dt/remedy.svg?style=for-the-badge)](https://rubygems.org/gems/remedy)
+[![Build Status](https://img.shields.io/travis/acook/remedy.svg?style=for-the-badge)](https://travis-ci.org/acook/remedy)
+[![Code Climate maintainability](https://img.shields.io/codeclimate/maintainability/acook/remedy?style=for-the-badge)](https://codeclimate.com/github/acook/remedy/maintainability)
 
-[![TravisCI](http://img.shields.io/travis/acook/remedy.svg?style=flat)](https://travis-ci.org/acook/remedy)
-[![Code Climate](https://codeclimate.com/github/acook/remedy/badges/gpa.svg)](https://codeclimate.com/github/acook/remedy)
 
 If you have any suggestions or find any bugs, drop them in GitHub/issues so I can keep track of them. Thanks!
 
@@ -42,6 +45,8 @@ There are objects for input as well as output, including low level console keyst
 
 The `Interaction` object wraps raw keyboard reads and streamlines some aspects of accepting keyboard input.
 
+For instance to get a keypress from the terminal and display it:
+
 ```ruby
   include Remedy
   user_input = Interaction.new
@@ -67,7 +72,7 @@ The `Interaction` object wraps raw keyboard reads and streamlines some aspects o
 
 `Remedy::Partial` has the subclasses `Header`, `Footer`, and `Content`.
 
-You can use the above classes to divide your Views into 3 seperate pieces. Content will be truncated as needed to accomodate the header and footer and the dimensions of the console. You can also specify the cursor/scroll position of the content being drawn, and when specifying headers or footers, you must.
+You can use the above classes to divide your Views into 3 separate pieces. Content will be truncated as needed to accommodate the header and footer and the dimensions of the console. You can also specify the cursor/scroll position of the content being drawn, and when specifying headers or footers, you must.
 
 ```ruby
   include Remedy
@@ -95,14 +100,31 @@ The most interesting function in my opinion is the callback that gets triggered
   include Remedy
 
   screen = Viewport.new
-  notice = Content.new
-  notice << "You just resized your screen!\n\nBrilliant!"
 
-  Console.set_console_resized_hook! do
+  Console.set_console_resized_hook! do |size|
+    notice = Content.new
+    notice << "You just resized your screen!\n\nNew size:"
+    notice << size
     screen.draw notice
   end
 ```
 
+Remedy in the Wild
+------------------
+
+Remedy was originally written for my own console-based game which was sort of like Dwarf Fortress. Most of the project files were lost, but since Remedy was extracted from it and open-sourced it has lived on.
+
+Here are a couple of projects that use many of Remedy's features:
+- A multiplayer Yahtzee for web and console: [YahtzeeGame](https://github.com/ProgrammingPractice/YahtzeeGame)
+- Twitter/RSS/Facebook reader: [noizee](https://github.com/acook/noizee)
+
+Check them out!
+
+Examples
+--------
+
+The `examples` directory has a couple of running implementations to get you started!
+
 Contributing
 ------------
 

data/examples/from_readme/readme.rb

@@ -1,13 +1,16 @@
+require 'bundler'
+Bundler.require
 require 'remedy'
 
 include Remedy
 
 screen = Viewport.new
 
-notice = Content.new
-notice << "You just resized your screen!\n\nBrilliant!"
+Console.set_console_resized_hook! do |size|
+  notice = Content.new
+  notice << "You just resized your screen!\n\nNew size:"
+  notice << size
 
-Console.set_console_resized_hook! do
   screen.draw notice
 end
 
@@ -36,11 +39,12 @@ screen.draw jokes, Size.new(0,0), title, disclaimer
 user_input.get_key
 
 ANSI.cursor.next_line!
-loop_demo = Interaction.new "press q to exit, or any other key to display it\n"
+keys = Content.new
+loop_demo = Interaction.new "press q to exit, or any other key to display that key's name\n"
 loop_demo.loop do |key|
-  ANSI.cursor.beginning_of_line!
-  ANSI.command.clear_line!
-  puts key
+  keys << key
+
+  screen.draw keys
   break if key == ?q
 end
 

data/examples/menu/menu.rb

@@ -1,12 +1,23 @@
+require 'bundler'
+Bundler.require
 require 'remedy'
 
 class Menu
   include Remedy
 
+  def initialize
+    @viewport = Viewport.new
+  end
+
   # will do basic setup and then loop over user input
   def listen
+    # get the screen in a reliable state and clear it
+    ANSI.screen.safe_reset!
+    ANSI.cursor.home!
+    ANSI.command.clear_screen!
+
     # if the user resizes the screen we redraw it to fit the new dimensions
-    Console.set_console_resized_hook! do
+    Console.set_console_resized_hook! do |size|
       draw
     end
 
@@ -28,12 +39,15 @@ class Menu
 
   # this tells the Viewport to draw to the screen
   def draw
-    Viewport.new.draw content, Size([0,0]), header, footer
+    @viewport.draw content, Size([0,0]), header, footer
   end
 
   # this is the body of our menu, it will be squished if the terminal is too small
   def content
-    c = Partial.new
+    # this creates a new content every time we draw
+    # you may want to only create a new content/header/footer when they change
+    # or create your own Partial subclass
+    c = Content.new
     c << <<-CONTENT
 
     1. Do the thing
@@ -52,7 +66,7 @@ class Menu
 
   # footers are displayed the bottom of the viewport
   def footer
-    Footer.new << "You pressed: #{@last_key}"
+    Footer.new << "Screen size: #{Console.size} You pressed: #{@last_key}"
   end
 end
 

data/lib/remedy/console.rb

@@ -42,19 +42,19 @@ module Remedy
     end
 
     def columns
-      size.last
+      size.cols
     end
     alias_method :width, :columns
 
     def rows
-      size.first
+      size.rows
     end
     alias_method :height, :rows
 
     def size
       str = [0, 0, 0, 0].pack('SSSS')
       if input.ioctl(TIOCGWINSZ, str) >= 0 then
-        str.unpack('SSSS').first 2
+        Size.new str.unpack('SSSS').first 2
       else
         raise UnknownConsoleSize, "Unable to get console size"
       end
@@ -65,8 +65,8 @@ module Remedy
     end
 
     def set_console_resized_hook!
-      Console::Resize.set_console_resized_hook! do
-        yield
+      Console::Resize.set_console_resized_hook! do |*args|
+        yield *args
       end
     end
 

data/lib/remedy/console_resize.rb

@@ -24,18 +24,21 @@ module Remedy; module Console; module Resize
   def set_console_resized_hook!
     @resize_count = 0
 
-    command = lambda { |x|
+    Signal.trap 'SIGWINCH' do
       resizing!
-      sleep 0.25
 
       if resized? then
-        yield
+        begin
+          yield Console.size
+        rescue Exception => ex
+          # Ruby will eat *any* errors inside a trap,
+          # so we need to expose them for debuggability
+          p ex
+        end
       end
 
       resized!
-    }
-
-    Signal.trap 'SIGWINCH', command
+    end
   end
 
   def default_console_resized_hook!

data/lib/remedy/key.rb

@@ -15,6 +15,10 @@ module Remedy
       seq
     end
 
+    def enc
+      seq.dump[1..-2]
+    end
+
     def name
       @name ||= Characters[seq] || :unknown
     end
@@ -51,6 +55,10 @@ module Remedy
       @recognized ||= name != :unknown
     end
 
+    def known?
+      !!Characters[seq]
+    end
+
     def single?
       @single ||= raw.length == 1
     end
@@ -60,7 +68,7 @@ module Remedy
     end
 
     def to_s
-      @to_s ||= name.to_s
+      @to_s ||= known? ? name.to_s : enc
     end
 
     def value

data/lib/remedy/partial.rb

@@ -14,6 +14,7 @@ module Remedy
 
     def << line
       reset_width!
+      line = "#{line}" # opportunistically convert any object into a string
       @lines += clean line unless line.nil? || line.empty?
     end
 
@@ -64,7 +65,7 @@ module Remedy
     end
 
     def split line
-      line.split /\r\n|\n\r|\n|\r/
+      line.split(/\r\n|\n\r|\n|\r/)
     end
   end
 end

data/lib/remedy/size.rb

@@ -39,12 +39,13 @@ module Remedy
     end
 
     def rows
-      dimensions.first
+      dimensions[0]
     end
 
     def cols
       dimensions[1]
     end
+    alias :columns :cols
 
     def [] index
       dimensions[index]

data/lib/remedy/version.rb

@@ -1,3 +1,3 @@
 module Remedy
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: remedy
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Anthony M. Cook
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-06-16 00:00:00.000000000 Z
+date: 2021-03-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -83,7 +83,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.4
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: Pure Ruby Console Interaction Library