3.9 KiB
This document explains why tview was forked to create cview. It also explains any differences between the projects and tracks which tview pull requests have been merged into cview.
Why fork?
rivo, the creator and sole maintainer of tview, explains his reviewing and merging process in a GitHub comment.
He states that he does not have the necessary time or interest to review, discuss and merge pull requests:
this project is quite low in priority. It doesn't generate any income for me and, unfortunately, reviewing issues and PRs is also not much "fun".
But some other people submitted large PRs which will cost me many hours to review. (I had to chuckle a bit when I saw this comment.)
Lastly, I'm the one who ends up maintaining this code. I have to be 100% behind it, understand it 100%, and be able to make changes to it later if necessary.
cview aims to solve these issues by increasing the number of project maintainers and allowing code changes which may be outside of tview's scope.
Differences
Primitive methods do not return the primitive they belong to
When chaining multiple method calls on a primitive together, application
developers might accidentally end the chain with a different return type than
the first method call. This could result in unexpected return types. For
example, ending a chain with SetTitle would result in a Box rather than the
original primitive.
cview is thread-safe
tview is not thread-safe.
Application.QueueUpdate and Application.QueueUpdateDraw do not block
tview blocks until the queued function returns.
Double clicks are not handled by default
All clicks are handled as single clicks until an interval is set with Application.SetDoubleClickInterval.
Tables are sorted when a fixed row is clicked by default
Call Table.SetSortClicked to disable this behavior.
Lists and Forms do not wrap around by default
Call List.SetWrapAround to wrap around when navigating.
Setting a primitive's background color to tcell.ColorDefault does not result in transparency
Call Box.SetBackgroundTransparent to enable background transparency.
TextViews store their text as []byte instead of string
This greatly improves buffer efficiency. TextView.Write is 90% faster and TextView.Draw is 50% faster.
Merged pull requests
The following tview pull requests have been merged into cview: