The purpose of excercism GUI is to provide an alternative to the command line interface (CLI) for exercism.io.
It aims to be a cross-platform desktop app that lowers the barrier of entry for people which feel more comfortable with a graphical interface than the command line.
Note:
Currently there is no installer available, this is a planned feature. Check ticket #6 for more details
The application is distributed using a compressed package (.tar.gz for Linux/MacOS and .zip for Windows)
To start using it, simply download the appropiate package for your platform from here
and extract it anywhere you like in the file system.
All the needed files for the app to run are contained within the extracted folder, nothing is installed outside of it.
To start the app, go to the extracted folder and double click on the exercism-gui executable.
Until an installer is available, upgrading is a manual process. To "upgrade" simply download the new package and extract over the old files.
Or extract to a new folder and remove the old version.
Removing the old folder is completely safe as no user information is stored in it (unless you explicitly configure the exercism folder to be
under it, which is not recommended)
Until an installer is available, removing is simply a matter of deleting the extracted folder.
| Platform | Architecture |
|---|---|
| GNU/Linux (any distro) | 64 Bits (x64) |
| MacOS X | 64 Bits (x64) |
| Windows 7,8,10 | 64 Bits (x64) |
| Windows 7,8,10 | 32 Bits (x86, ia32) |
Contributions are more than welcome!
To help with the code a basic knowledge of Javascript is required.
If Javascript or programming is not your thing, there are many ways to help:
- Testing the app on the different supported platforms (nothing fancy, just using it normally is enough)
- Design: if you have some thoughts on how to improve the UI or UX, let's hear them!
- Writing docs to help newcomers getting started
- Giving feedback: things that are not clear or hard to understand
This is an application written with the help of the following technologies:
- ember.js An awesome javascript web framework
- electron To build the cross-platform desktop app
- ember-electron an ember.js addon that facilitates ember and electron integration (dev, packaging, running tests, etc.)
- node.js and node packages to communicate with the desktop (notifications, file system, etc.)
This is a standard ember.js app (wrapped with electron) so if you are familiar with ember and ember-cli you can jump right into.
If you are not familiar with the framework, getting to know ember is needed, but it is very easy to get started with. Some resources:
- The ember.js guides
- Great free ebook (but you can pay for it if you find it useful): https://leanpub.com/ember-cli-101
- Great free learning videos https://www.emberscreencasts.com/
The project uses the "pod" folder structure (you don't need to worry about this if using ember-cli generators as this is handled automatically, just be aware if creating files manually)
At build time, files are inspected with jshint so make sure there are not warnings.
- Follow ember conventions as close as possible https://guides.emberjs.com/v2.6.0/testing/
- Use data-test-XYZ selectors to find HTML components during tests, which helps decoupling
the HTML layout from finding stuff (thus we avoid breaking tests if we decide to do some
re-designing). We use
ember-test-selectorsaddon to help manage this.
- Node.js 6 or later (check install instructions at https://nodejs.org/en/)
- Bower:
npm install -g bower - Yarn (check install instructions at https://yarnpkg.com/en/docs/install)
- Watchman: optional but highly recommended (to listen on file changes for automatic rebuilds during dev: https://facebook.github.io/watchman/)
- Python 2.7: A dependency of this project, node-gyp, requires Python 2.7 (check install instructions at https://www.python.org/downloads/). Python 3 is not supported. If you have Python 3 as your primary Python environment you can use the
--pythonswitch when runningnpm install:npm install --python=python2.7
After forking and cloning the exercism/gui repo, install the dependencies:
$ cd /path/to/repo
$ yarn install
$ bower install
Start the dev app
$ ember electron
Note: The dev server by default uses ember-cli-mirage to intercept outgoing requests and mock API responses. This has the purpose of avoiding extra load on the API and be able to develop even if the API servers are down. If you want to disable this, set an envar DISABLE_EMBER_CLI_MIRAGE with a value of true:
$ DISABLE_EMBER_CLI_MIRAGE=true ember electron
To run the tests, do
$ ember electron:test
If you want to leave the test running on each file save, TDD style:
$ ember electron:test --server
You have the regular debugging tools at your disposal: chromium dev tools, devtron and ember inspector.
You can access the chromium dev tools via the menu in the dev server window (View -> Toggle Developer Tools) or by shortcut (Ctrl+Shift+I on Linux)
TODO: specify dev tools shortcuts for Mac/Windows
You can access the ember inspector and devtron from their respective tabs within the dev tools.
In production, chrome dev tools can be accessed by right clicking on at app and selecting View -> Toggle Developer Tools
In order to package the app, run the following
ember electron:package --platform <your_platform> --arch <your_architecture>
This will output a package under the ./electron-builds folder
Note: If you are on OSX or Linux and Have Wine configured, you can also cross-compile for Windows
- If there is a ticket connected to the PR, add it as prefix in the subject. e.g.
gh-3 some comment closes #3 - If the commit closes one or several tickets, add comment like so
closes #<ticket_number>