termgui 0.0.4 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d6f70b10cb11cfc112b4ff9887817ffe36595facee0801121e4ffd1471c9a379
-  data.tar.gz: cec5a76cadece64fa9bd381c43ad1ab207949991c2de1c683a5e5a6cac582c76
+  metadata.gz: af01d169693ceefa3a955883a770af3768f7a902e526ce00cd4aa11b09afa73d
+  data.tar.gz: 4360e7b85f248e64074ae8371d3725d92518a1d9571ce0005884c5af3081226f
 SHA512:
-  metadata.gz: c6b601e0ebd61b28b32ed6740a585b5eb8d3c9f7451ed3615f6bd918646fe7a845e54cb34a091f464625f4790ecaa86f0a54be40c327220c4830e8b612fb310b
-  data.tar.gz: d569497fe644f5d51c91fa6e7e2c50da6abc7a8ce5ea9739198449b34bff01d8ef8ad0a83ee16f4362d1c5b46b1278ea4bc3c46715aee2cd8193de6a5d411623
+  metadata.gz: 2e929dcad6d63589630c51c62ffd1638e3409a613b00acdac8d661e2b16ae9a93070e90b479259518b637b14d66729a5e404a4f657fcbf7fc3e943cdbe1f1111
+  data.tar.gz: 34ab0ae4d6c7754b6e0b0806367c5f05584182c7d787d16c73abfeb058f2a5407da1e4bab8d666075af06399cb2fdc2ced757568858580c7a5f30f29bfd41319

data/lib/termgui.rb

@@ -1 +1 @@
-require_relative '../src/termgui'
+require_relative '../src/termgui'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: termgui
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
 platform: ruby
 authors:
 - Sebastián Gurin
@@ -9,12 +9,39 @@ autorequire:
 bindir: bin
 cert_chain: []
 date: 2020-02-10 00:00:00.000000000 Z
-dependencies: []
-description: "\n * Repository: https://github.com/cancerberoSgx/termgui\n\n * Pure
-  Ruby library for creating desktop-like interfaces in the command line.\n\n * Flexible
-  and easy to use utilities for focus/actions/scroll/events/cursor.\n\n * Support
-  high level APIs similar to HTML DOM APIs like layouts, styles, box-model, cascade
-  styles, XML/ERB, boxes, fonts, images, colors, easing,\n\n * Low level utilities
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: chunky_png
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.3.11
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.3.11
+- !ruby/object:Gem::Dependency
+  name: rexml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.2.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.2.4
+description: "\n * Pure Ruby library for creating desktop-like interfaces in the command
+  line.\n\n * Flexible and easy to use utilities for focus/actions/scroll/events/cursor.\n\n
+  * Support high level APIs similar to HTML DOM APIs like layouts, styles, box-model,
+  cascade styles, XML/ERB, boxes, fonts, images, colors, easing,\n\n * Low level utilities
   can be used independently without bloating the performance\n\n * Event loop supporting
   set_timeout, wait_for, set_interval\n\n * Many high level widgets, utilities implemented
   expected in GUIs.\n\n * WIP (my first Ruby project)\n "
@@ -23,109 +50,15 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- Gemfile
-- README.md
 - lib/termgui.rb
-- src/action.rb
-- src/box.rb
-- src/color.rb
-- src/cursor.rb
-- src/editor/editor_base.rb
-- src/editor/editor_base_handlers.rb
-- src/element.rb
-- src/element_bounds.rb
-- src/element_box.rb
-- src/element_render.rb
-- src/element_style.rb
-- src/emitter.rb
-- src/emitter_state.rb
-- src/enterable.rb
-- src/event.rb
-- src/focus.rb
-- src/geometry.rb
-- src/image.rb
-- src/input.rb
-- src/input_grab.rb
-- src/input_time.rb
-- src/key.rb
-- src/log.rb
-- src/node.rb
-- src/node_attributes.rb
-- src/node_visit.rb
-- src/renderer.rb
-- src/renderer_cursor.rb
-- src/renderer_draw.rb
-- src/renderer_image.rb
-- src/renderer_print.rb
-- src/screen.rb
-- src/screen_element.rb
-- src/screen_input.rb
-- src/screen_renderer.rb
-- src/style.rb
-- src/tco/colouring.rb
-- src/tco/config.rb
-- src/tco/palette.rb
-- src/tco/tco_termgui.rb
-- src/termgui.rb
-- src/util.rb
-- src/util/css.rb
-- src/util/css_query.rb
-- src/util/easing.rb
-- src/util/hash_object.rb
-- src/util/imagemagick.rb
-- src/util/justify.rb
-- src/util/unicode-categories.rb
-- src/util/wrap.rb
-- src/widget/button.rb
-- src/widget/checkbox.rb
-- src/widget/col.rb
-- src/widget/image.rb
-- src/widget/inline.rb
-- src/widget/input_number.rb
-- src/widget/inputbox.rb
-- src/widget/label.rb
-- src/widget/modal.rb
-- src/widget/row.rb
-- src/widget/selectbox.rb
-- src/widget/textarea.rb
-- src/xml/xml.rb
-- test/action_test.rb
-- test/box_test.rb
-- test/css_test.rb
-- test/editor/editor_base_test.rb
-- test/element_bounds_test.rb
-- test/element_box_test.rb
-- test/element_render_test.rb
-- test/element_style_test.rb
-- test/element_test.rb
-- test/emitter_test.rb
-- test/event_test.rb
-- test/focus_test.rb
-- test/geometry_test.rb
-- test/input_test.rb
-- test/key_test.rb
-- test/log_test.rb
-- test/node_test.rb
-- test/performance/performance1.rb
-- test/renderer_test.rb
-- test/renderer_test_rect.rb
-- test/screen_test.rb
-- test/style_test.rb
-- test/termgui_test.rb
-- test/test_all.rb
-- test/util_hash_object_test.rb
-- test/util_test.rb
-- test/widget/checkbox_test.rb
-- test/widget/col_test.rb
-- test/widget/inline_test.rb
-- test/widget/label_test.rb
-- test/widget/row_test.rb
-- test/wrap_test.rb
-- test/xml_test.rb
-homepage: https://rubygems.org/gems/termgui
+homepage: https://github.com/cancerberoSgx/termgui
 licenses:
 - MIT
-metadata: {}
+metadata:
+  bug_tracker_uri: https://github.com/cancerberoSgx/termgui
+  documentation_uri: https://github.com/cancerberoSgx/termgui
+  homepage_uri: https://github.com/cancerberoSgx/termgui
+  source_code_uri: https://github.com/cancerberoSgx/termgui
 post_install_message: 
 rdoc_options: []
 require_paths:

data/Gemfile

@@ -1,14 +0,0 @@
-source 'https://rubygems.org'
-
-git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
-
-gem 'chunky_png'
-# gem 'justify'
-gem 'rexml'
-gem 'strings'
-
-gem 'filewatcher', group: :development
-gem 'rubocop', require: false, group: :development
-gem 'solargraph', require: false, group: :development
-gem 'test-unit', group: :development
-# gem 'yarn', require: false, group: :development

data/README.md

@@ -1,321 +0,0 @@
-# termgui
-
-Repository: https://github.com/cancerberoSgx/termgui
-
- * Command line graphical user interface Ruby toolkit.
- * Create desktop-like interfaces in the command line.
- * Personal ruby-learning project at the beginning
- * 100% ruby, no binaries, no dependencies
- * some ideas taken from npm.org/blessed and my own npm.org/accursed
- * HTML DOM like high level API with styles, layouts, box-model, cascade styles
- * xml / edb support for declaring components in XML syntax
- * rendered optionally supporting a buffer to print out the current screen for testing
- * very well tested
- * flexible managers for focus, actions, scroll, keys, input grab, input grab, cursor
- * event loop supporting set_timeout, wait_for, set_interval 
- * text-area / editor support
- * all colors and attributes
- * some basic high level widgets: Button, Label, InputBox, TextArea, Editor, Select, 
- * independent low level APIs can be used without the high level overhead for listening stdin, drawing, etc
- * box drawing, easing, css parser and dom selector 
-
-
-## TODO / Status
-
-See [TODO](TODO.md)
-
-
-## Motivation
-
- * I don't want to use ncurses based dependencies since is binary
- * I know there are a couple of initiatives 100% in ruby now, but I didn't knew them when I started this project
- * I'm the author of npm.org/accursed which is a similar library so I can of already implemented this in JavaScript
- * Initially a pet project to learn Ruby
-
-## Usage
-
-```
-gem install termgui
-```
-
-### Example
-
-```rb
-require 'termgui'
-screen = Screen.new
-left =  screen.append_child Col.new(width: 0.4, height: 0.99, style: { bg: 'red' })
-(0..8).map { |i| left.append_child Label.new(text: "Label_#{i}") }
-right = screen.append_child Col.new(width: 0.6, height: 0.99, x: 0.4, style: {bg: 'blue'))
-(0..4).map do |i|
-  right.append_child Button.new(
-    text: "Button_#{i}", x: 0.5,
-    style: {focus: {fg: '#ed5525'}},
-    action: proc { open_modal(screen: screen, title: "Button_#{i}") }
-  )
-end
-screen.start
-```
-
-Result:
-
-![readme_screenshot01](readme_screenshot01.jpg)
-
-## Development commands
-
-```sh
-cd termui
-bundler install
-sh bin/test
-sh bin/doc
-sh bin/dev   # rails server
-sh bin/watch # tests in watch mode
-```
-
-## API Reference
-
-TODO
-
-### low level (working) examples
-
-TODO
-
-#### No DOM - just draw
-
-TODO
-
-#### Only Input
-
-TODO
-
-#### Only Renderer
-
-TODO
-
-
-
-
-## Element attributes
-
-Some high level element attributes implemented:
-
-### style-cascade
-
-By default, children inherit parent style. If `element.get_attribute('style-cascade') == 'prevent'` it won't happen - this is the children won't be affected by its parent style and only its own is rendered. 
-
-### focusable, focused and screen.focus.keys, focus, blur
-
-elements with focusable attribute will be able to be focused when user press focus keys (configurable in screen.focus.keys ). By default screen.focus.keys ==  { next: ['tab'], prev: ['S-tab'] }. 
-
-focusable elements will emit "focus" and "blur" events
-
-When focused, the attribute focused will be true and the element is able to receive "action" event (see actionable, action-keys below)
-
-### actionable, action-keys, action
-
-this is useful to implement actionable widgets like buttons that, when focused, can emit "action" events when certain keys are pressed (by default ENTER)
-
-focused elements with attribute "actionable" will emit "action" events if user press action-keys (enter by default) when they are focused. Action keys can be configured globally using screen.action.keys or by element with attribute action-keys. Both could be a string or array. 
-
-
-### action-on-focus
-
-automatically trigger an action event wneh an element is focused. helpful for selectbox so no enter is needed for working
-
-### escape-on-blur
-
-automatically escapes an entered element on blur. helpful for selectbox so no escape is needed for switching focus - so it behaves like buttons
-
-
-### enterable, entered, change, input, escape, escape-keys
-
-This is useful to implement textarea / textinput widgets for which we don't want to trigger focus or action events when user is writing text. When an enterable element (that also should be focusable) receives "action" it is set to "entered" mode. (whey you are writing text, you want TAB S-tab, enter, etc to actually insert characters and don't emit "focus" "action", etc events...)
-
-When an element is on this mode (only one at a time) the rest of the elements will stop receiving common events like focus or action until it leaves the entered mode. . This could happen programmatically or by receiving "escape" event, by default pressing ESC will provoke "escape" event which will set entered = false and enable normal events again (like focus, action, etc). When entered==true, the entered element will listen for input independently and emit "input" events. 
-
-the enter event by default is provoked by "action" (enter) so it can be configured individually using action-keys. 
-
-the escape event by default pressing "escape" can be configurable per element using attribute escape-keys (just like action-keys)
-
-TODO: configure to better play with focus: enter-on-focus to automatically "entered" without "action" and automatically "escape" on "blur" (focus will keep working on this case). Also is not clear how escape plays with change 
-
-
-
-
-## Performance notes
-
- * disabling renderer buffer speeds up rendering about 30%: `screen.renderer.no_buffer = true`. Genereally don't needed in production.
-
-
-## API example prototypes (WIP)
-
-** initial design stories**
-
-### layout
-
-TODO  / proposal
-
-```
-require 'termgui'
-class AppExplorer < Column
-  def initialize(model)
-    super
-    @model=model
-    @text = append_child(text: Textarea.new model.text, onChange: {|e| print e.key})
-    @text.onChange {|e| print e.key}
-  end
-end
-screen = Screen.new
-main = Row.new
-left = main.append_child(Column.new 0.3)
-right = main.append_child(Column.new 0.7)
-explorer = left.append_child(AppExplorer.new model)
-editor = right.append_child(AppEditor.new model)
-screen start
-```
-
-### structure
-
-TODO  / proposal
-
-```
-class MyWidget < Column
-  def initialize
-    super 0.5
-    append_children [
-      {type: Row, height: 0.6, children: [
-        {type: Input, value: 'edit me', width: 0.5, onChange: {|e|print e} },
-        {type: Label, text: 'edit me'},
-      ]}
-      {type: Button, text: 'click me', onClick: {|e|print e}},
-    ]
-  end
-end
-```
-
-#### aside
-
-```
-{type: Button, text: 'click me', onclick: {|e|print e}},
-vs
-Button.new text: 'click me', onclick: {|e|print e}},
-
-{type: Row, height: 0.6, children: [
-  {type: Input, value: 'edit me', width: 0.5, onChange: {|e|print e} },
-  {type: Label, text: 'hello'},
-]}
-vs
-Row.new height: 0.6, children: [
-  Input.new value: 'edit me', width: 0.5, onChange: {|e|print e},
-  Label new: label: 'hello'
-]
-```
-
-### style
-
-style = {
-  '.primary': {
-    bg: 'red',
-    fg: 'black'
-    bold: true
-  }
-}
-screen.append_child(Column.new children: [
-  Label.new text: 'are you sure?',
-  Button.new
-])
-
-
-### high level no layout
-
-TODO / proposal
-
-```
-s=Screen.new
-b=Button.new(parent: s.document, width: 0.3, height: 0.3, left: 0, top: 0, label: 'click me', onClick: { |e| alert "#{e.target.label} clicked!" })
-s.start
-```
-
-### example low level
-
-(no HTML DOM at all, just drawing)
-```
-screen = Screen.new
-screen.renderer.rect(2,3,9,3,'-', {fg: 'yellow', bg: 'gray'})
-screen.renderer.text(x: 3, y: 4,text; 'click me', style: Style.new(fg: '#ffee11', bg: 'black', bold: true))
-```
-
-### events
-
-```
-screen=Screen.new
-screen.event.add_listener('key', {|e| exit 0 if e.key=='q'})
-renderer.text(text: 'press q to exit')
-```
-
-
-
-## Design
-
-### concepts
-
-Screen: contains document, renderer, buffer, Input
-
-Renderer: responsible of drawing given pixels to the terminal
-
-Buffer: maintains screen as bitmap structure (so users can read the current screen contents like a bitmap)
-
-Document: Node subclass analog to html's (access to parent screen)
-
-Node: DOM like representation analog to html's (children, attributes)
-
-Element: Node subclass analog to html's (border, margin, padding)
-
-Input: responsible of user input - notifies screen - emitter
-
-## Summary
-
-I'm author of npm.org/flor that although has superior terminal support (tput) I would like to re implement a similar library for ruby, writing it from scratch (currently learning ruby).
-
- * low level html-canvas like to set attributes and write strings
-  * try to stick to html canvas api for Renderer
-  * user is responsible of setting the 'active style' like canvas' stroke-width - this simplifies renderer
- * renderer of styled strings supporting cursor management,
-  *  responsible of translating user's `{bg: 'red', s: 'hello'}` into a string with ansi codes
- * screen maintains a virtual Buffer so current drawn screen can be accessed like a bitmap
- * a DOM like API for children, attributes, box model, style
-  * supports user input events also like html dom EventSource (element.add_listener('key', ...))
-  * basic widget implementations: button,input,textarea
- * style: fg, bg, ch, bold, etc.
- * focus management: focused/focusable - element.style.focus
- * input event loop : set_timeout
- * easy keyboard event representation and API
-
-## Future
-
-add features from npm.org/flor:
-
- * scroll (element.scrollX=0.2) - dom support
- * a xmlish syntax for defining GUI.
-   * support function attributes for event handlers as ruby fragments
-
-## Side projects
-
- * cli/driver for ruby : for properly testing termgui we need cli-driver for ruby. see probes/stdin.rb for working exec and writing to process stdin async
-
-
-## Design notes
-
-TODO
-
-Screen, renderer, input are responsible of basic terminal styles like bg, fg, bold, etc.
-
-On top of the screen, renderer and input a document object model like HTML DOM is supported. See Node, Element, Style, etc. Some features based on HTML supported are:
-
- * box model similar
- * children rendering
- * text
- * element query
- * border
- * padding
-
-Some high level utilities, like the focus/action management, work on top of this DOM so probably 99% of users will want to go that way for building their GUIs.