Skip to content

AndyObtiva/glimmer-cs-gladiator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Gladiator 0.11.2 - Ugliest Text Editor Ever!

Gem Version

rapid prototyping of desktop app GUI with Gladiator

Gladiator (short for Glimmer Editor) is a Glimmer DSL for SWT beta project under on-going development that explores how to build a text editor in Ruby using Glimmer DSL for SWT (JRuby Desktop Development GUI Library). It is not intended to be a full-fledged editor by any means, yet mostly a fun educational exercise in using Glimmer. Gladiator is also a personal tool for shaping an editor exactly the way I like, with all the keyboard shortcuts I prefer. I leave building truly professional text editors to software tooling experts who would hopefully use Glimmer one day. Otherwise, I have been happily using Gladiator to develop all my projects since May of 2020.

Learn more about how I built Gladiator in the Montreal.rb Talk "How I Built My Code Editor in Ruby".

If you are interested in building a truly great code editor in Ruby, perhaps with plugin support, you are welcome to use the code of this project as a starting point.

Mac

Gladiator

Windows

Gladiator

You may now download a packaged version of Gladiator, including new support for Mac ARM64

Features

Gladiator currently supports the following text editing features (including keyboard shortcuts with Mac CMD=CTRL/CTRL=ALT on Windows/Linux)

Gladiator Demo

Text Editor

  • Text Editor with Colored Syntax Highlighting for Multiple Languages
  • Show Line Numbers
  • Multi-tab support (CMD+SHIFT+[ & CMD+SHIFT+] for tab navigation. CMD+1-9 to jump to a specific tab)
  • Drag and drop split pane (drag a file from File Tree or File Lookup List, and it splits the pane)
  • Duplicate Line(s)/selection (CMD+D)
  • Kill Line(s)/selection (CMD+K)
  • Move line/selection up (CMD+UP)
  • Move line/selection down (CMD+DOWN)
  • Comment/Uncomment line/selection (CMD+/)
  • Indent/Unindent line/selection (CMD+] & CMD+[)
  • Insert/Prefix New Line (CMD+ENTER & CMD+SHIFT+ENTER)

File Explorer Tree

  • Collapsable file explorer tree listing files and directories for open project
  • Context menu to open file, rename, delete, add new file, add new directory, and refresh tree
  • Jump to open file in tree (CMD+T)

File Lookup List Filter

  • Collapsable file lookup list filter (CMD+R)
  • Semi-fuzzy filtering by ignoring slashes, underscores, and dots to ease lookup

Navigation Area

  • Show current text editor file name 0- Show file navigation stats (Caret Position / Line Position / Selection Count / Top Pixel)
  • Jump to Line (CMD+L)
  • Find & Replace (CMD+F)

Menus

  • File Menu:
    • Open Scratchpad for running arbitrary Ruby/Glimmer code (saves a temporary file to project_dir/.gladiator-scratchpad) (CMD+SHIFT+S)
    • Open Project (CMD+O)
    • Quit Project (ALT+F4)
  • View Menu
    • Split Pane
      • Orientation change to Horizontal/Vertical (CMD+SHIFT+O)
      • Maximize Pane: maximizes current pane in split pane to take entire area (CMD+SHIFT+M)
      • Reset Panes: resets pane sizes if split width/height was adjusted (CMD+SHIFT+P)
      • Unsplit: closes the second pane (CMD+SHIFT+U)
    • Maximize Editor: maximizes editor area to hide file lookup list and file explorer tree (CMD+CTRL+M)
    • Reset All: resizes sizes of all areas in the editor (CMD+CTRL+R)
  • Run Menu to run Ruby code (CMD+SHIFT+R)

Watch External Changes

  • Watch open file for external changes to automatically refresh in editor
  • Watch project subdirectories for changes to automatically refresh in file explorer/file lookup

Automatic Data Management

  • Autosave on focus out/quit/open new file
  • Remember opened tabs, caret position, top pixel, window size, and window location
  • Default "ignore paths" to avoid bogging down editor with irrelevant directory files

Multiple Language Syntax Highlighting

Here is an exhaustive list of all the file formats supported by Gladiator (if you would like support for more file formats, feel free to suggest in a GitHub Issue or submit a Pull Request):

  1. C ('c', 'h')
  2. C++ ('cpp', 'cc', 'C', 'cxx', 'c++', 'hpp', 'hh', 'H', 'hxx', 'h++')
  3. C# ('cs')
  4. Crystal ('cr')
  5. CSS ('css')
  6. Conf ('conf')
  7. CoffeeScript ('coffee')
  8. Elixir ('ex', 'exs')
  9. Embedded Elixir ('eex', 'leex', 'heex')
  10. ERB ('erb')
  11. Gherkin Feature ('feature')
  12. Gradle ('gradle')
  13. Haml ('haml')
  14. HTML ('html')
  15. INI ('ini')
  16. Java ('java')
  17. JavaScript ('js', 'cjs', 'mjs', 'es6', 'es')
  18. JSON ('json')
  19. JSP ('jsp')
  20. JSX ('jsx')
  21. Kotlin ('kt', 'ktm', 'kts')
  22. Lisp ('lisp', 'cl', 'el', 'asd')
  23. Make ('Makefile', 'makefile', 'GNUmakefile')
  24. Markdown ('md', 'markdown')
  25. Diff Patch ('patch')
  26. Perl ('pl')
  27. Plist ('plist')
  28. Puppet ('pp')
  29. Properties ('properties')
  30. PostScript ('ps')
  31. PowerShell ('ps1')
  32. Python ('py')
  33. Ruby ('rb', 'rbw', 'rake', 'gemspec')
  34. Rust ('rs')
  35. SASS ('sass')
  36. Scheme ('scm', 'sps', 'sls', 'sld')
  37. SCSS ('scss')
  38. Shell ('sh')
  39. SQL ('sql')
  40. Tcl ('tcl')
  41. TypeScript ('ts')
  42. TSX ('tsx')
  43. Yaml ('yaml', 'yml')
  44. XML ('xml')

Platforms

  • Mac: Gladiator works best on the Mac. This is the platform it is most used on and receives the most maintenance for.
  • Windows: Gladiator works OK on Windows, but has a few annoying issues.
  • Linux: Gladiator works with handicaps on Linux (performing some text editing operations causes scroll jitter). Contributers could help fix.

Pre-requisites

Download

Download Gladiator 0.11.2 Mac DMG Installer (ARM64 Ventura 13.4.1 & Older) (this version starts in about 2.5 seconds)

Download Gladiator 0.11.1 Mac DMG Installer (x64 Ventura 13.4.1 & Older)

Download Gladiator 0.10.0 Mac DMG Installer (x64 Catalina & Older)

Download Gladiator 0.10.0 Windows MSI Installer (x64 Windows 10)

The packaged version starts with a dialog asking you what project to open. Gladiator does not fully show up until you have selected a project directory.

Otherwise, if you prefer a command line version, then follow the Setup Instructions below.

Setup Instructions

Note: if you encounter any issues, check if they are documented in TODO.md, issues, or pull requests as they might be on my radar to fix. Otherwise, please report as an issue or better yet fix and submit a pull request. Also, try going back to a previous version of the gem until you find one that works. Keep in mind this is open-source software provided as is, so there are no guarantees of functionality. If you would like such guarantees, you are welcome to hire me full-time.

Install Gladiator gem by running (jgem, jruby -S gem, or gem directly if you have RVM):

jgem install glimmer-cs-gladiator -v0.11.2

Or add to a JRuby project Bundler Gemfile under the :developement group:

group :development do
  gem 'glimmer-cs-gladiator', '> 0'
end

Run (jruby -S bundle or bundle directly if you have RVM):

jruby -S bundle

Afterwards, if you are using RVM and want to ensure system wide availablility of the gladiator command across Ruby versions, run this command in an environment that has JRuby (not needed without RVM):

gladiator-setup
source ~/.gladiator_source

You should be able to run gladiator from anywhere now.

You can pass a project path as a first argument to open a particular project.

Alternatively, open in app mode (gives you a dialog to open any project) by passing APP_MODE=true argument/env-var.

Usage

You may run the gladiator command to bring up the text editor in the project directory you would like to edit:

gladiator

On Linux, you may need to run with extra memory via this command instead:

gladiator -J-Xmx1200M

On Windows, you may need to run with extra memory via this command instead:

gladiator -J-Xmx3000M

If you are in a different directory from the project you would like to edit, then pass its path as an argument:

gladiator relative-or-absolute-path/to/project

Note: If you cloned this project and bundle installed, you may invoke via bin/gladiator instead.

Glimmer Custom Shell Reuse

To reuse Gladiator as a Glimmer Custom Shell inside another Glimmer application, add the following to the application's Gemfile:

gem 'glimmer-cs-gladiator', '~> 0.11.2'

Run:

jruby -S bundle

And, then instantiate the Gladiator custom shell in your Glimmer DSL for SWT application via the gladiator keyword assuming you already have include Glimmer in your class, module, or main object.

Env Var Options

Gladiator supports these environment variable options.

LOCAL_DIR

(String / default: '.')

Gladiator opens with the current directory as the root by default. If you would like to open another directory, set LOCAL_DIR environment variable.

Example:

LOCAL_DIR="/Users/User/code" gladiator

Opens Gladiator with "/Users/User/code" as the root directory.

APP_MODE

(true or false / default: false from terminal/command-line and true from packaged Gladiator)

Specifies whether to run in app mode, thus providing a dialog to open any project path instead of starting with a specific project from the get-go.

Example:

APP_MODE=true gladiator

Configuration

Gladiator automatically saves configuration data in a .gladiator file at the directory it is run from. It may be edited to add extra ignore paths.

It currently remembers:

  • Last opened files (in both split panes if split)
  • Window size and position
  • Ignore Paths under Glimmer::Gladiator::Dir::IGNORE_PATHS (default: ['.gladiator', '.git', 'coverage', 'packages', 'node_modules', 'tmp', 'vendor', 'pkg', 'dist'])

Gotchas

Signaling Error

Gladiator repetitively displays a signaling error that is harmless in practice:

The signal HUP is in use by the JVM and will not work correctly on this platform
The signal INT is in use by the JVM and will not work correctly on this platform
The signal TERM is in use by the JVM and will not work correctly on this platform

App Is Not Responding

If you run the gladiator command from the root directory or some parent directory to many projects, it assumes that is the project directory and attempts to pre-load all files (just part of Gladiator's architectural design and assumptions for optimizing use per project), taking a very long time and not responding for quite a while.

To avoid this problem, always make sure you are running the gladiator command from a single project's directory.

Also, if you encounter this issue with projects that contain a lot of extra files that you do not need to edit, you could later open the generated .gladiator file at the root of the project directory and add unnecessary subdirectories to the ignore_paths array.

Freezing in large projects

Gladiator right now assumes smaller projects with a few files only as it always opens all file contents in memory for better searching. So, when a file is updated externally (e.g. change git branch), it reloads its entire tree, including all the file contents too, which causes a temporary freeze. This may get fixed in the future, but it is not annoying enough in smaller projects to be fixed right away. The change might include diffing the tree to avoid refreshing file contents for unchanged files, and perhaps multi-threaded loading of file contents to avoid freezing the GUI.

TODO

TODO.md

Change Log

CHANGELOG.md

Contributing to glimmer-cs-gladiator

  • Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
  • Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
  • Fork the project.
  • Start a feature/bugfix branch.
  • Commit and push until you are happy with your contribution.
  • Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
  • Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
  • On windows, add this Git config: git config core.autocrlf input (or globally if you're working on multiple Glimmer projects)

Copyright

MIT

Copyright (c) 2020-2022 Andy Maleh. See LICENSE.txt for further details.

--

Built with Glimmer DSL for SWT (JRuby Desktop Development GUI Framework)

Gladiator icon made by Freepik from www.flaticon.com