suplemon 0,0 travis-ci python

:lemon: Console (CLI) text editor with multi cursor support. Suplemon replicates Sublime Text like functionality in the terminal. Try it out, give feedback, fork it!

Suplemon :lemon:

Build Status Join the chat at https://gitter.im/richrd/suplemon

      ___________   _________  ___     ______________________________   ___
     /  _____/  /  /  /  _   \/  /\   /  ______/        /  ___   /   | /  /\
    /  /____/  /  /  /  /_/  /  / /  /  /_____/  /  /  /  /  /  /    |/  / /
   /____   /  /  /  /  _____/  / /  /  ______/  /  /  /  /  /  /  /|    / /
  _____/  /  /__/  /  /\___/  /____/  /_____/  /  /  /  /__/  /  / |   / /
 /_______/\_______/__/ /  /_______/________/__/__/__/________/__/ /|__/ /
 \_______\ \______\__\/   \_______\________\__\__\__\________\__\/ \__\/

          Remedying the pain of command line editing since 2014

Suplemon is a modern, powerful and intuitive console text editor with multi cursor support. Suplemon replicates Sublime Text style functionality in the terminal with the ease of use of Nano. http://github.com/richrd/suplemon

Suplemon in action

Features

  • Proper multi cursor editing, as in Sublime Text
  • Syntax highlighting with Text Mate themes
  • Autocomplete (based on words in the files that are open)
  • Easy Undo/Redo (Ctrl + Z, Ctrl + Y)
  • Copy & Paste, with multi line support (and native clipboard support on X11 / Unix)
  • Multiple files in tabs
  • Powerful Go To feature for jumping to files and lines
  • Find, Find next and Find all (Ctrl + F, Ctrl + D, Ctrl + A)
  • Custom keyboard shortcuts (and easy-to-use defaults)
  • Mouse support
  • Restores cursor positions in when reopenning files
  • Extensions (easy to write your own)
  • Lots more…

Caveats

  • Currently no built in selections (regions). To copy part of a line select it with your mouse and use Ctrl + Shift + C

Try it!

You can just clone the repo, and try Suplemon, or also install it system wide.

git clone https://github.com/richrd/suplemon.git
cd suplemon
python3 suplemon.py

Installation

Install the latest version from PIP:

sudo pip3 install suplemon

To install Suplemon from the repo run the setup script:

sudo python3 setup.py install

Usage

suplemon # New file in the current directory
suplemon [filename]... # Open one or more files

Notes

  • Must use Python 3.3 or higher for proper character encoding support.
  • Python2.7 (and maybe lower) versions work, but aren’t officially supported (some special characters won’t work etc).
  • The master branch is considered stable.
  • Tested on Unix.

Dev Branch Status: Build Status

No dependencies outside the Python Standard Library required.

Optional dependencies

  • Pygments > For support for syntax highlighting over 300 languages.

  • Flake8 > For showing linting for Python files.

  • xsel > For system clipboard support on X Window (Linux).

See docs/optional-dependencies.md for installation instructions.

Description

Suplemon is an intuitive command line text editor. It supports multiple cursors out of the box. It is as easy as nano, and has much of the power of Sublime Text. It also supports extensions to allow all kinds of customizations. To get more help hit Ctrl + H in the editor. Suplemon is licensed under the MIT license.

Goals

  1. [X] Create a command line text editor with built in multi cursor support. It’s awesome!
  2. [X] Usability should be even better and easier than nano. It’s on par with desktop editors.
  3. [X] Multi cursor should be comparable to Sublime Text.
  4. [X] Develop Suplemon with Suplemon!!! I’ve used Suplemon for a long time as my main editor (replacing ST and nano) for all developement, Git commits and everything else.

Configuration

Main Config

The suplemon config file is stored at ~/.config/suplemon/suplemon-config.json.

The best way to edit it is to run the config command (Run commands via Ctrl+E). That way Suplemon will automatically reload the configuration when you save the file. To view the default configuration and see what options are available run config defaults via Ctrl+E.

Keymap Config

Below are the default key mappings used in suplemon. They can be edited by running the keymap command. To view the default keymap file run keymap default

  • Ctrl + Q > Exit

  • Ctrl + C > Copy line(s) to buffer

  • Ctrl + X > Cut line(s) to buffer

  • Ctrl + V > Insert buffer

  • Ctrl + K > Duplicate line

  • Ctrl + G > Go to line number or file (type the beginning of a filename to switch to it). > You can also use ‘filena:42’ to go to line 42 in filename.py etc.

  • Ctrl + F > Search for a string or regular expression (configurable)

  • Ctrl + D > Search for next occurrence or find the word the cursor is on. Adds a new cursor at each new occurrence.

  • Alt + Arrow Key > Add new cursor in arrow direction

  • Ctrl + Left / Right > Jump to previous or next word or line

  • ESC > Revert to a single cursor / Cancel input prompt

  • Alt + Page Up > Move line(s) up

  • Alt + Page Down > Move line(s) down

  • Ctrl + S > Save current file

  • F1 > Save file with new name

  • F2 > Reload current file

  • Ctrl + O > Open file

  • Ctrl + W > Close file

  • Ctrl + Page Up > Switch to next file

  • Ctrl + Page Down > Switch to previous file

  • Ctrl + E > Run a command.

  • Ctrl + Z and F5 > Undo

  • Ctrl + Y and F6 > Redo

  • F7 > Toggle visible whitespace

  • F8 > Toggle mouse mode

  • F9 > Toggle line numbers

  • F11 > Toggle full screen

Mouse shortcuts

  • Left Click > Set cursor at mouse position. Reverts to a single cursor.

  • Right Click > Add a cursor at mouse position.

  • Scroll Wheel Up / Down > Scroll up & down.

Support

If you experience problems, please submit a new issue. If you have a question, need help, or just want to chat head over to the IRC channel #suplemon @ Freenode. I’ll be happy to chat with you, see you there!

Development

If you are interested in contributing to Suplemon, development dependencies can be installed via:

# For OS cleanliness, we recommend using `virtualenv` to prevent global contamination
pip install -r requirements-dev.txt

After those are installed, tests can be run via:

./test.sh

PRs are very welcome and appreciated. When making PRs make sure to set the target branch to dev. I only push to master when releasing new versions.

Todo

  • [ ] Design proper API for plugins/extensions/macros
  • [ ] Documentation for v 1.0.0

Wishlist (Stuff that would be nice, but not planning to do yet. Maybe for 2.0.0)

  • [ ] Core
    • [ ] Setting for enabling/disabling undo for cursor changes
    • [ ] Selections
    • [ ] List of recent files
    • [X] Optionally Remember cursor positions in files (and restore when opened again)
    • [ ] Read only viewer
      • And disable editing Don’t disable editing. Instead enable save as.
  • [ ] Extensions:
    • [ ] Peer to peer colaborative editing. Could be implemented as an extension.
    • [ ] Auto backup. Activate on n changes or every n seconds
    • [ ] File selector, kind of like what nano has
      • [ ] This should be implemented as an extension
      • [ ] Could be triggered with a key binding (and/or override open file)
      • [ ] Need to refactor App class to support views instead of just files
      • [ ] A view could be an editor or an extension ui
      • [ ] Extensions should be able to control both status bars and key legend

Rationale

For many the command line is a different environment for text editing. Most coders are familiar with GUI text editors and for many vi and emacs have a too steep learning curve. For them (like for me) nano was the weapon of choice. But nano feels clunky and it has its limitations. That’s why I wrote my own editor with built in multi cursor support to fix the situation. Another reason is that developing Suplemon is simply fun to do.

Related Repositories

suplemon

suplemon

:lemon: Console (CLI) text editor with multi cursor support. Suplemon replicates Sublime Text like functionality in the terminal. Try it out, give feedback, fork it! ...

test_suplemon

test_suplemon

Console text editor with multi cursor support. Suplemon replicates Sublime Text style functionality in the terminal. Try it out, give feedback, fork it! ...

suplemon

suplemon

Console text editor with multi cursor support. Suplemon replicates Sublime Text style functionality in the terminal. Try it out, give feedback, fork it! ...

suplemon

suplemon

Console text editor with multi cursor support. Suplemon replicates Sublime Text style functionality in the terminal. Try it out, give feedback, fork it! ...

suplemon

suplemon

Console text editor with multi cursor support. Suplemon replicates Sublime Text style functionality in the terminal. Try it out, give feedback, fork it! ...


Top Contributors

richrd Jimx- twolfson trylle severin31 Gnewbee

Releases

-   v0.1.44 zip tar
-   v0.1.40 zip tar
-   v0.1.38 zip tar
-   v0.1.37 zip tar
-   v0.1.36 zip tar
-   v0.1.34 zip tar
-   v0.1.33 zip tar
-   v0.1.31 zip tar
-   v0.1.22 zip tar
-   0.1.70 zip tar
-   0.1.56 zip tar
-   0.1.55 zip tar
-   0.1.54 zip tar
-   0.1.53 zip tar
-   0.1.52 zip tar
-   0.1.51 zip tar
-   0.1.50 zip tar