glimmer-cs-gladiator
Advanced tools
Gladiator 0.11.2 - Ugliest Text Editor Ever!
Glimmer Custom Shell
(Montreal.rb Talk - How I Built My Code Editor in Ruby)
Mac
Windows
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.
You may now download a packaged version of Gladiator, including new support for Mac ARM64
Gladiator currently supports the following text editing features (including keyboard shortcuts with Mac CMD=CTRL/CTRL=ALT on Windows/Linux)
project_dir/.gladiator-scratchpad) (CMD+SHIFT+S)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):
'c', 'h')'cpp', 'cc', 'C', 'cxx', 'c++', 'hpp', 'hh', 'H', 'hxx', 'h++')'cs')'cr')'css')'conf')'coffee')'ex', 'exs')'eex', 'leex', 'heex')'erb')'feature')'gradle')'haml')'html')'ini')'java')'js', 'cjs', 'mjs', 'es6', 'es')'json')'jsp')'jsx')'kt', 'ktm', 'kts')'lisp', 'cl', 'el', 'asd')'Makefile', 'makefile', 'GNUmakefile')'md', 'markdown')'patch')'pl')'plist')'pp')'properties')'ps')'ps1')'py')'rb', 'rbw', 'rake', 'gemspec')'rs')'sass')'scm', 'sps', 'sls', 'sld')'scss')'sh')'sql')'tcl')'ts')'tsx')'yaml', 'yml')'xml') 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.
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.
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.
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.
Gladiator supports these environment variable options.
(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.
(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
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:
Glimmer::Gladiator::Dir::IGNORE_PATHS (default: ['.gladiator', '.git', 'coverage', 'packages', 'node_modules', 'tmp', 'vendor', 'pkg', 'dist'])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
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.
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.
git config core.autocrlf input (or globally if you're working on multiple Glimmer projects)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
FAQs
Unknown package
We found that glimmer-cs-gladiator demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
A malicious npm package disguised as a WhatsApp client is exploiting authentication flows with a remote kill switch to exfiltrate data and destroy files.
Security News
PyPI now supports digital attestations, enhancing security and trust by allowing package maintainers to verify the authenticity of Python packages.
Security News
GitHub removed 27 malicious pull requests attempting to inject harmful code across multiple open source repositories, in another round of low-effort attacks.