Project

rbcurse-core

0.03
No commit activity in last 3 years
No release in over 3 years
rbcurse-corerkumar/rbcurse-coreHomepageDocumentationSource CodeBug TrackerWiki
Ruby curses/ncurses widgets for easy application development on text terminals (ruby 1.9)
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
47,106
Stars
42
Forks
13
Watchers
2
 Releases
Current version
0.0.14
Total releases
15
First release
2011-12-05
Latest release
2013-04-14
 Issues
Open Issues
2
Closed Issues
1
Total Issues
3
Issue Closure Rate
33%
 Pull Requests
Open Pull Requests
2
Closed Pull Requests
0
Merged Pull Requests
1
Pull Request Acceptance Rate
33%
 Development
Primary Language
Ruby
Average date of last 50 commits
2013-09-25
Reverse Dependencies
6

 Dependencies

Runtime

ffi-ncurses
>= 0.4.0
 Project Readme

rbcurse-core

** Works on 1.9.3 and now 2.0 **

Contains core widgets and infrastructure of rbcurse ncurses toolkit. rbcurse helps to easily build ncurses application for text terminals.

rbcurse-core contains basic widgets for constructing applications. These include:

  • field

  • buttons - checkbox, radio, toggle

  • list

  • textview

  • dialogs and popup

  • table

  • menu

  • tabbedpane

  • tree

  • application header

  • status line

Core intends to be :

  • stable,

  • have very few changes,

  • be backward compatible.

  • simple, maintainable code

Testing Status

  • Works on 1.9.3-p392 (my environment is zsh 5.0.x, tmux, TERM=screen-256color, OSX ML/Lion/Mavericks)
  • Cannot promise if working on 1.8.7, am making some fixes (thanks hramrach), but may not be able to to support 1.8.7 indefinitely. Please submit bugs on 1.8.7 if you find them.

Other

I shall be standardizing core over the next one or two minor versions. I shall also be simplifying code as much as possible to make it maintainable and more bug-free.

Method names in some classes may change, and one or two widget names will change. rbasiclistbox will become listbox while the old listbox that has moved to extras will become something like editlistbox. Similarly the old table will become edittable in extras, whereas tabularwidget will becoming table in core. The new tabbedpane and messagebox will replace the old ones, while the old ones will move to /deprecated.

Color formatting needs to be standardized and a proper API firmed up for that, so user code does not get affected by internal changes. Similarly, work on textpad may get integrated into some widgets since it could simplify their code.

I have not yet begun working on extras and experimental as yet. This contains code that was working in rbcurse-1.5, but not tested or touched since then. I will only get around there after polishing the core a bit more. The code lies on github.

Install

gem install rbcurse-core # just the core

To install more:

gem install rbcurse-extras # the core, and extra stuff

gem install rbcurse # the core, extra and experimental stuff

Examples

Some examples have dependencies.

  • dbdemo requires sqlite3 gem (and sqlite).
  • testlistbox require ri documentation rvm docs generate-ri I have improved this demo and released it as the gem 'ribhu' (ri browser).

Tutorial

I have begun work on a tutorial (as of 2014-03-22). See https://github.com/rkumar/rbcurse-tutorial/

See also

License

Same as ruby license.

(c) copyright rkumar, 2008-2013.