rubytext 0.0.27 → 0.0.28

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 257ff8769efa6a24875d20ec4b53c863e3152ee8e5cc937f63ef0d7aeb1210d1
-  data.tar.gz: f0e2cec5b63de75e626874e45eb64cb71d6196215575219741dc45876dc0ec26
+  metadata.gz: 94623e9ab70d1b8cc1d743a018fadfbfc036c57532d8fd15bb53a1b1ad24a200
+  data.tar.gz: 40c219776d5735a49e03e4362b4212609b7241963b464b69a22fa1747f404cab
 SHA512:
-  metadata.gz: 3dcbeea59aa67c98851331d2e7edf027b162fe38c4cff9730d5b22e90fe864b9efe04f5e1df383988a9b852d91f2af5a516a24bb1ba1a2494ca780934e039efb
-  data.tar.gz: 4a053e7ad294945854e4e816166561076232cabb4a2564292fdbe5050b1a8a2f91f988ab7e2afae1f35fe6a1ab3ebafb54367f9ffa3fbbdd81ae4e0b37fab738
+  metadata.gz: 34544c7346c4be72e6d1ffb690785eed028f028e901a595f7941e95d9022db5fb4a2f13387e7b01795201d4ba715f974512a3a080772eea12cdfe188f8901309
+  data.tar.gz: af0380bd45ff5f3503aaccffd9f1d5081d5141fd2e360e921f8e7250b6f1175ee97c450e3bfea44b40aad9c0312f0264ebf4c37ac1f207f656675f73bf8f8a70

data/bin/rubytext

@@ -2,4 +2,4 @@
 
 require 'rubytext'
 
-puts RubyText::Path
+STDOUT.puts RubyText::Path

data/examples/README

@@ -0,0 +1,6 @@
+Note that the prog*.rb files are only fragments
+and NOT complete programs.
+
+They are intended to be run via showme.rb (or all
+in sequence via the 'slides' shell script).
+

data/examples/check.rb

@@ -0,0 +1,16 @@
+require 'rubytext'
+
+RubyText.start(:raw, fg: :white, bg: :black)
+
+cmax = STDSCR.cols
+rmax = STDSCR.rows
+
+RubyText.hide_cursor
+
+if rmax < 25 || cmax < 80
+  puts "\n  Your window should be 25x80 or larger,"
+  puts   "  but this one is only  #{rmax}x#{cmax}."
+  puts "  Please resize and run again!"
+  getch
+  exit 1
+end

data/examples/demo.rb

@@ -0,0 +1,114 @@
+$LOAD_PATH.unshift "lib"
+
+require 'rubytext'
+
+def delay(sec)
+  sleep sec/2.0
+end
+
+RubyText.start(log: "mylog.txt", fg: :green, bg: :black)
+
+print "Here goes... "
+delay 2
+
+ymax, xmax = STDSCR.rows, STDSCR.cols
+
+puts "STDSCR is #{ymax.inspect} by #{xmax.inspect}"
+delay 2
+
+print "\nI can write here "
+delay 2
+puts "and then continue."
+
+delay 2
+print "I can jump away "
+
+delay 2
+STDSCR.go(20, 15) { puts "and print somewhere else" }
+# ^ Same as: rcprint(20, 15, "and print somewhere else" }
+
+delay 2
+puts "and then return."
+
+delay 3
+print "I can hide the cursor... "
+delay 1
+RubyText.hide_cursor
+delay 1
+print "then show it again... "
+delay 1
+RubyText.show_cursor
+delay 1
+print "and hide it again. "
+delay 1
+RubyText.hide_cursor
+delay 3
+
+puts "\n\nNow watch as I create a window:"
+
+mywin = RubyText.window(16, 40, 8, 14, true, fg: :blue, bg: :yellow)
+
+delay 3
+mywin.puts "\nNow I'm writing in a window."
+mywin.puts "\nIts size is  #{mywin.rows} rows by #{mywin.cols} cols"
+mywin.puts "(or #{mywin.height}x#{mywin.width} with the frame).\n "
+
+delay 4
+mywin.puts "I always try to honor the borders of my window."
+
+delay 2
+mywin.puts "\nWatch as I place 50 random stars here..."
+
+delay 2
+
+50.times do
+  r = rand(mywin.rows)
+  c = rand(mywin.cols)
+  delay 0.1
+  mywin.rcprint(r, c, "*")
+end
+
+delay 4
+mywin.output do
+  mywin.clear
+  puts "The window method called 'output'"
+  puts "will temporarily override STDSCR so that (in the code)"
+  puts "we don't have to use the window name over and over for stream I/O."
+  delay 4
+# STDSCR.rcprint 25, 3, "Of course I can still print here if I want."
+  STDSCR.go 25, 3
+  STDSCR.print "Of course I can still print here if I want."
+  delay 3
+  puts "\nOne moment..."
+  delay 4
+end
+
+mywin.output do
+  mywin.clear
+  puts "The []= method allows us to place characters in"
+  puts "the window (without auto-refresh)."
+  puts "\nLet's see the '50 stars' trick again:"
+  delay 5
+  50.times do
+    r = rand(mywin.rows)
+    c = rand(mywin.cols)
+    mywin[r, c] =  "*"
+  end
+  mywin.win.refresh 
+end
+
+delay 5
+mywin.output do
+  mywin.clear
+  mywin.puts "The [] method (zero-based) is still buggy, but let's try it."
+  mywin.puts "XYZ"
+  ch = mywin[2,2]
+  mywin.puts "The char at [2,2] is: #{ch.chr.inspect}"
+end
+
+delay 4
+mywin.puts "\nThat's all for now."
+delay 1
+mywin.puts "\nPress any key to exit."
+
+getch

data/examples/ide.rb

@@ -0,0 +1,71 @@
+$LOAD_PATH << "lib"
+
+if ARGV.size != 2
+  STDERR.puts "Usage: ruby ide.rb libname.rb progname.rb"
+  exit
+end
+
+require 'rubytext'
+
+print " "  # FIXME - bug requires this?
+
+@lib, @code = ARGV
+
+def menu
+$debug.puts "Entering menu"
+  m = @mywin
+  m.boxme   # FIXME - dumb hack
+  m.clear
+  m.puts
+  m.puts " World's Simplest Ruby IDE\n "
+  m.puts " Lib  = #{@lib}"
+  m.puts " Code = #{@code}"
+  m.puts 
+  m.puts " 1  Edit lib"
+  m.puts " 2  Edit code"
+  m.puts " 3  Run code"
+  m.puts " 4  pry"
+  m.puts " 5  Shell"
+  m.puts " 6  irb"
+  m.puts " 7  RubyDocs"
+  m.puts
+  m.puts " 0  Quit"
+  m.print "\n  Choice = "
+  m.refresh   # FIXME - dumb hack
+$debug.puts "Exiting menu"
+end
+
+def shell(str)
+  STDSCR.clear
+  RubyText.show_cursor
+  system("stty sane")   # FIXME - dumb hack
+  STDSCR.puts "\n\n  When you exit, you will\n  return to the IDE.\n "
+  system(str)
+  X.noecho   # FIXME Shouldn't have to do this stuff
+  X.stdscr.keypad(true)
+  X.cbreak   # by default
+end
+
+@mywin = RubyText.window(19, 30, 1, 2, true)
+
+loop do 
+  menu
+  # $debug.puts "about to call getch"
+  cmd = getch.chr
+  # $debug.puts "called getch - '#{cmd}'"
+  case cmd
+    when "1"; system("vi #{@lib}")
+    when "2"; system("vi #{@code}") 
+    when "3"; system("tput clear; ruby #{@code}; sleep 5")
+    when "4"; shell("pry")
+    when "5"; shell("bash")
+    when "6"; shell("irb")
+    when "7"; system("open -a Safari http://ruby-doc.org")
+    when "0"; exit
+    else 
+      @mywin.rcprint 12, 4, "\n\n  No such command '#{cmd}'"
+      sleep 2
+      next
+  end
+end
+

data/examples/prog01.rb

@@ -0,0 +1,6 @@
+win = RubyText.window(6, 25, 2, 4, 
+                      # 6 rows, 25 cols; upper left at 2,4
+                      true, # has a border
+                      fg: :blue, bg: :white) # foreground, background
+
+win.puts "This is a window..."

data/examples/prog02.rb

@@ -0,0 +1,7 @@
+win = RubyText.window(9, 36, 2, 6, true, fg: :white, bg: :red) 
+
+win.output do
+  puts "Because this code uses #output,"
+  puts "it doesn't have to specify the"
+  puts "window as a receiver each time."
+end

data/examples/prog03.rb

@@ -0,0 +1,4 @@
+win = RubyText.window(9, 35, 3, 7, false, fg: :black, bg: :green)
+
+win.puts "A window doesn't have to"
+win.puts "have a border."

data/examples/prog04.rb

@@ -0,0 +1,7 @@
+win = RubyText.window(8, 39, 4, 9, true, fg: :black, bg: :blue)
+
+win.puts "If your text is longer than " +
+         "the width of the window, by default it will " +
+         "wrap around."
+
+win.puts "Scrolling is not yet supported."

data/examples/prog05.rb

@@ -0,0 +1,12 @@
+win = RubyText.window(10, 70, 2, 14, true, fg: :yellow, bg: :black)
+
+win.output do
+  puts "Without scrolling, this is what happens when your window fills up..."
+  puts "This behavior will probably change later."
+  sleep 2
+  puts "Let's print 10 more lines now:"
+  sleep 2
+  
+  10.times {|i| puts "Printing line #{i}..."; sleep 0.5 }
+end
+

data/examples/prog06.rb

@@ -0,0 +1,13 @@
+win = RubyText.window(10, 60, 2, 14, true, fg: :blue, bg: :black)
+
+win.output do
+  puts "The #print and #p methods also act as you expect."
+
+  print "This will all "
+  print "go on a single "
+  puts "line."
+
+  puts
+  array = [1, 2, 3]
+  p array
+end

data/examples/prog07.rb

@@ -0,0 +1,15 @@
+win = RubyText.window(10, 50, 2, 5, true, fg: :yellow, bg: :blue)
+
+win.output do
+  puts "Of course, #puts and #print are unaffected \nfor other receivers."
+
+  out = File.new("/tmp/junk", "w")
+  out.puts "Nothing to see here."
+  sleep 2
+
+  print "\nHowever, if you print to STDOUT or STDERR \nwithout redirection, "
+  STDOUT.print "you will have some "
+  STDERR.print "unexpected/undefined results "
+  puts " in more ways than one."
+end
+

data/examples/prog08.rb

@@ -0,0 +1,14 @@
+win = RubyText.window(10, 50, 2, 5, true, fg: :yellow, bg: :blue)
+
+win.puts "We can use the []= method (0-based)"
+win.puts "to address individual window locations"
+win.puts "and place characters there.\n "
+
+sleep 2
+win[4,2] = "X"
+
+sleep 2
+win[6,20] = "y"
+
+sleep 2
+win[8,8] = "Z"

data/examples/prog09.rb

@@ -0,0 +1,10 @@
+win = RubyText.window(12, 60, 2, 5, true, fg: :yellow, bg: :blue)
+
+win.puts "ABCDE    Method [] can retrieve characters "
+win.puts "FGHIJ    from a window."
+win.puts "KLMNO\nPQRST\nUVWZYZ"
+win.puts
+
+sleep 2
+win.puts "(2,2) => '#{win[2,2]}'    (0,4)  => '#{win[0,4]}'"
+win.puts "(6,7) => '#{win[6,7]}'    (0,15) => '#{win[0,15]}'"

data/examples/prog10.rb

@@ -0,0 +1,15 @@
+win = RubyText.window(6, 30, 2, 5, true, fg: :black, bg: :blue)
+
+win.puts "You can write to a window..."
+
+sleep 2
+9.times { STDSCR.puts }
+STDSCR.puts "...or you can write to STDSCR (standard screen)"
+
+sleep 1
+puts "STDSCR is the default receiver."
+
+sleep 2
+STDSCR.go 5, 0
+puts "Nothing stops you from overwriting a window."
+

data/examples/prog11.rb

@@ -0,0 +1,14 @@
+win = RubyText.window(6, 30, 2, 5, true, fg: :black, bg: :blue)
+
+win.puts "We default to cbreak mode, so that characters are "
+win.puts "accepted instantly, but control-C still works."
+sleep 2
+win.puts "\nIf we set raw mode, control-C is disallowed."
+
+RubyText.set(:raw)
+
+win.puts "\nGo ahead, type a ^C."
+sleep 5
+
+win.puts "\nI'm still here."
+RubyText.set(:_raw)

data/examples/prog12.rb

@@ -0,0 +1,12 @@
+win = RubyText.window(12, 65, 1, 5, true, fg: :black, bg: :blue)
+
+win.output do
+  puts "You can detect the size and cursor position of any window."
+  puts "\nSTDSCR is #{STDSCR.rows} rows by #{STDSCR.cols} columns"
+  puts "win is     #{win.rows} rows by #{win.cols} columns"
+  puts "\nSlightly Heisenbergian report of cursor position:"
+  puts "  STDSCR.rc = #{STDSCR.rc.inspect}\n  win.rc    = #{win.rc.inspect}"
+  puts "\nFor fun, I'll print \"ABC\" to STDSCR..."
+  sleep 2
+  STDSCR.print "ABC"
+end

data/examples/prog13.rb

@@ -0,0 +1,14 @@
+win = RubyText.window(12, 65, 0, 15, true, fg: :blue, bg: :black)
+
+win.puts "The #go method will move the cursor to a specific location."
+win.go 2, 5
+win.puts "x  <-- The x is at 2,5"
+
+win.puts "\nWith a block, it will execute the block and then"
+win.puts "return to its previous location."
+
+win.print "\n   ABC..."
+sleep 2
+win.go(8, 20) { win.print "XYZ" }
+sleep 2
+win.print "DEF"

data/examples/slides

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+rc = system("ruby examples/check.rb")
+exit unless rc
+
+system("ruby showme.rb examples/prog01.rb")
+system("ruby showme.rb examples/prog02.rb")
+system("ruby showme.rb examples/prog03.rb")
+system("ruby showme.rb examples/prog04.rb")
+system("ruby showme.rb examples/prog05.rb")
+system("ruby showme.rb examples/prog06.rb")
+system("ruby showme.rb examples/prog07.rb")
+system("ruby showme.rb examples/prog08.rb")
+system("ruby showme.rb examples/prog09.rb")
+system("ruby showme.rb examples/prog10.rb")
+#system("ruby showme.rb examples/prog11.rb")
+system("ruby showme.rb examples/prog12.rb")

data/lib/version.rb

@@ -1,6 +1,6 @@
 
 module RubyText
-  VERSION = "0.0.27"
+  VERSION = "0.0.28"
 
   Path  = File.expand_path(File.join(File.dirname(__FILE__)))
 end

data/rubytext.gemspec

@@ -20,11 +20,12 @@ Gem::Specification.new do |s|
   # Files...
   main = Find.find("lib").to_a
   bin  = Find.find("bin").to_a
+  ex   = Find.find("examples").to_a
 
   misc = %w[./README.md ./rubytext.gemspec]
 # test = Find.find("test").to_a
 
-  s.files       =  main + bin + misc # + test
+  s.files       =  main + bin + ex + misc # + test
   s.homepage    = 'https://github.com/Hal9000/rubytext'
   s.license     = "Ruby License"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rubytext
 version: !ruby/object:Gem::Version
-  version: 0.0.27
+  version: 0.0.28
 platform: ruby
 authors:
 - Hal Fulton
@@ -34,6 +34,24 @@ files:
 - "./README.md"
 - "./rubytext.gemspec"
 - bin/rubytext
+- examples/README
+- examples/check.rb
+- examples/demo.rb
+- examples/ide.rb
+- examples/prog01.rb
+- examples/prog02.rb
+- examples/prog03.rb
+- examples/prog04.rb
+- examples/prog05.rb
+- examples/prog06.rb
+- examples/prog07.rb
+- examples/prog08.rb
+- examples/prog09.rb
+- examples/prog10.rb
+- examples/prog11.rb
+- examples/prog12.rb
+- examples/prog13.rb
+- examples/slides
 - lib/rubytext.rb
 - lib/version.rb
 homepage: https://github.com/Hal9000/rubytext