百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
V

vedeu

> 编程语言
开源

一个使用 Ruby 编写的框架,用于构建 GUI/TUI 终端/控制台应用程序。

579 stars0 点赞3 次浏览
访问官网GitHub

工具介绍

一个使用 Ruby 编写的框架,用于构建 GUI/TUI 终端/控制台应用程序。

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.

Requirements

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

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

Dependencies

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

  • bundler
  • rake
  • vedeu_cli
    • thor

Installation

To install Vedeu, simply:

gem install vedeu

To use Vedeu's application scaffolding, see the RubyDoc

Example

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.

Documentation & Usage

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.

Development / Contributing

  • 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:

bash
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

General contribution help

  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.

Author & Contributors

Author

Gavin Laking (@gavinlaking)

Contributors

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

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Ruby

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言