Vedeu

Vedeu (vee-dee-you; aka VDU) is my attempt at creating a terminal based application framework without the need for Ncurses. I've tried to make Vedeu as simple and flexible as possible.

• Ruby (see .ruby-version for current version)
• Linux/MacOSX

Note: You may have trouble running Vedeu with Windows installations. (Pull requests welcome!)

Vedeu relies on the following gems, these will be automatically installed when you install Vedeu (as documented below).

• bundler
• rake
• vedeu_cli
  • thor

To install Vedeu, simply:

gem install vedeu

To use Vedeu's application scaffolding, see the RubyDoc

Have a look at: Playa. Please browse the source of Playa and Vedeu to get a feel for how it all works.

Note: Playa is based on an old version of Vedeu. Vedeu has significantly improved since then and a better example is coming soon!

If you have produced software which uses Vedeu, please let me know, I'll link to your project here.

Vedeu is documented using Yard. I hope to produce more 'General Usage' documentation shortly. In the meantime, please browse the RubyDoc. Finally, here is some documentation for the various aspects of Vedeu (not comprehensive):

• The Vedeu API
• Borders
• Buffers
• Cell
• Chars
• Colours & Styles
• Configuration
• Cursors
• The Vedeu DSL
• Events
  • Application Events
  • Document Events
  • Focus Events
  • Menu Events
  • Movement Events
  • Refresh Events
  • System Events
  • View Events
  • Visibility Events
• Geometry
• Getting Started
• Groups
• Input
• Interfaces
• Keymaps
• Lines
• Object Graphs
• Output
• Streams
• Template
• Views

There are also some small, simple applications in the examples/ directory to show some concepts and basic functionality. This is not exhaustive, but are being added to and improved fairly regularly.

• Documentation hosted at RubyDoc.
• Source hosted at GitHub.

Pull requests are very welcome! Please try to follow these simple rules if applicable:

• Please create a topic branch for every separate change you make.
• Make sure your patches are well tested.
• Update the Yard documentation. (Use yard stats --list-undoc to locate undocumented code)
• Update the README, if appropriate.
• Please do not change the version number.

Raising issues and finding bugs, updating documentation and improving the code are all welcome contributions. I may also have left some TODO items lying around, which you're quite welcome to and can find with either Yard, or git:

yard list --query '@todo'

git grep --line-number '@todo'

Any branch on the repository that is not master is probably experimental; do not rely on anything in these branches. Typically, twerks will be merged into master before a release, and branches prefixed with spike/ are me playing with ideas- they aren't guaranteed to work at all.

Various environment variables are available to you to help with testing, all of which can be used in combination, prefaced to rake:

• Produce statistics on the slowest performing parts of the application/tests. Useful when used multiple times. See test/test_helper.rb for configuration.

    PERFORMANCE=1 rake
  

• Produce a 'SimpleCov' test coverage report in the coverage/ directory.

    SIMPLECOV=1 rake
  

• Produces a 'SimpleCov' test coverage report with output to the console.

    CONSOLE_COVERAGE=1 rake
  

• Enable Ruby's warnings mode (this can usually be quote verbose, but thankfully more so with gem dependencies rather than Vedeu itself).

    WARNINGS=1 rake
  

• Disable Ruby's garbage collection for this test run.

    DISABLE_GC=1 rake
  

• Use Rubocop to catch coding misdemeanours for this test run. (Or use rake rubocop).

    RUBOCOP=1 rake
  

• Build the Yard documentation for the project. (Or use rake yard).

    YARD=1 rake
  

1. Fork it (https://github.com/gavinlaking/vedeu/fork)
2. Clone it
3. Run bundle
4. Run rake (runs all tests and coverage report) or bundle exec guard
5. Create your feature branch (git checkout -b my-new-feature)
6. Write some tests, write some code, have some fun!
7. Commit your changes (git commit -am 'Add some feature')
8. Push to the branch (git push origin my-new-feature)
9. Create a new pull request.

Gavin Laking (@gavinlaking)

https://github.com/gavinlaking/vedeu/graphs/contributors