Skip to content
Unified way to perform IDE-like tasks across multiple languages and frameworks in Emacs.
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc/images feat: misc improvements. Apr 16, 2019
headers feat: include basic templates, headers and snippets in the project. Apr 5, 2019
snippets feat: include basic templates, headers and snippets in the project. Apr 5, 2019
templates feat: include basic templates, headers and snippets in the project. Apr 5, 2019
test feat: misc improvements. Apr 16, 2019
.gitignore Initial commit May 10, 2018
Cask feat: misc changes. Mar 19, 2019
LICENSE Initial commit May 10, 2018
Makefile
README.org feat: misc improvements. Apr 16, 2019
header.txt
idee-actions.el
idee-bindings.el refactor: renamed project to idee. May 14, 2018
idee-clojure.el feat: misc improvements. Apr 16, 2019
idee-comments.el
idee-dap.el refactor: reorganize code, cleanup add tests." Aug 29, 2018
idee-elisp.el
idee-evil.el feat: Add maven hydra, add maven history support. Misc improvements. Apr 14, 2019
idee-golang.el feat: misc improvements. Apr 16, 2019
idee-headers.el chore: tune handling of snippets, headers and templates. Apr 5, 2019
idee-hydra.el feat: misc improvements. Apr 16, 2019
idee-java.el
idee-javascript.el feat: misc improvements. Apr 16, 2019
idee-lsp-intellij.el chore: remove newline parenthesis. Apr 4, 2019
idee-lsp-java.el fix: align idee-lsp-java with new function names. Apr 18, 2019
idee-maven.el fix: idee-maven-also-install-module goals. Apr 16, 2019
idee-meghanada.el
idee-navigation.el chore: remove newline parenthesis. Apr 4, 2019
idee-pkg.el refactor: renamed project to idee. May 14, 2018
idee-projects.el
idee-python.el chore: remove newline parenthesis. Apr 4, 2019
idee-quarkus.el chore: remove newline parenthesis. Apr 4, 2019
idee-spring.el chore: remove newline parenthesis. Apr 4, 2019
idee-templates.el chore: tune handling of snippets, headers and templates. Apr 5, 2019
idee-utils.el chore: remove uneeded message. Apr 17, 2019
idee-vars.el feat: include basic templates, headers and snippets in the project. Apr 5, 2019
idee-views.el feat: Add maven hydra, add maven history support. Misc improvements. Apr 14, 2019
idee-visitors.el feat: misc improvements. Apr 16, 2019
idee.el

README.org

IDE for Emacs

Unified way to perform IDE-like tasks across multiple languages and frameworks in Emacs.

./doc/images/idee-ide-view.png

Features

  • Integration with projectile, treemacs and yasnippet.
  • Global shortcuts and functions for all languages and frameworks.
    • java
    • clojure
    • python
    • go
    • javascipt
  • Traditional IDE-like swapable layouts.
  • Advanced navigation control (back and forth).
  • File template support.
  • File header management.
  • Project factory support.

Installation

This project is not available on any emacs package repository so you will either have to install it manually, or using something like straight-use-package:

(use-package idee :straight (idee :host github :repo "iocanel/idee"))
(require 'idee-evil)
(require 'idee-elisp)
(require 'idee-java)
(require 'idee-lsp-java)
(require 'idee-maven)
(require 'idee-spring)
(require 'idee-quarkus)

Using `require` you can enable additional modules, for example:

(require 'idee-javascript)
(require 'idee-python)
(require 'idee-golang)

Overview

The initial idea behind this project was to provide an IDE-like window layout (project tree, editor & command line interface). This is functionality already provided by existing plugins, so this plugin was meant to better integrate these plugins.

Global shortcuts and functions for all languages and frameworks.

Golang developers may be using the oracle or guru, two different plugins with similar functions. To jump to the definition of a symbol guru users use `go-guru-definition` while oracle users use `go-oracle-definition`. In python the same functionality is provided by `anacoda-mode-find-definitions` (for anacoda users) and so on.

The more languages and frameworks added, the harder it gets to remember the right functions and their shortcuts.

This plugin provides a gloabl set of functions and shortcuts that works for all underlying modes, languages and frameworks. Also this is backed by a hydra, which makes these functions easier to remember.

./doc/images/idee-hydra.png

Advanced navigation control

Jumping to a symbols definition, finding callers, looking up functions etc, is of no use if you can’t easily return to the point from which the query was originated. Some plugins do provide `jump back` functionality, others don’t. Even the ones that do provide `jump back` most of the time don’t provide `jump further back` or `jump forth`. And of course this is something that doesn’t play nicely in polyglot projects or even across different projects.

This plugin does provide the following functions:

  • idee-jump-back
  • idee-jump-forward
  • idee-forget-current-buffer (remove the current buffer/point from the back/forth stacks).

File template support

For code snippets yasnippet has been an excellent choice. I often use yasnippet to provide a full-file template. But I always felt that there should be a line between snippets and templates (even though if the backing plugin is the same, e.g. yasnippet).

Why?

Because, I’d like the file template mechanism to kick in automatically when a new file is created. And this is how this plugin approaches file templates:

How it works?

When a new file is created, the plugin checks the file extension and detects the corresponding major mode that is going to be used. Then it searches for the target major mode, all available file templates that are found under <template dir>/<major mode>. A list of all available templates is provided to the user and after the user selected a new file based on the template is created.

For example for java files, the list of available templates can be: (“class”, “annotation”, “enum”, “interface”).

./doc/images/idee-file-templates.png

File header management

Open-source developers are familiar with the processes of adding license headers to their files. But even if this is a pretty common use-case nowadays, even commercial IDE doesn’t have a good story around that. Most of the times, this is a configuration that needs to be performed per project with very little room for re usability.

This project introduces the idea of `global license header repository` that its a folder that users can store multiple different header profiles, which can then be selected per project.

./doc/images/idee-select-header.png

Regardless, of how you specify the header of choice, you can add a call to `idee-header` in your file template, so that all new files create contain the header.

./doc/images/idee-file-template.png

Project factories

Each language and framework has its own way of creating or scaffolding a project. The idea behind project factories is to allow integrating these approaches into this plugin, so that its easy to create new project.

Each time the users want to create a new project, he is prompted to select one among the known project factories. Then the factory is invoked to generate the project. The factory may or may not require further input.

Provided factories:

Spring intializer project factory

A simple project factory that uses https://start.spring.io to scaffold a new project.

./doc/images/idee-spring-project-factory-1.png

The factory prompts the user to select from a list of:

  • languages
  • build tools
  • dependencies

and then it generates and opens the project.

Maven support

To make life with maven easier the following features have been added:

  • Per project profile management.
  • Shortcut function to run maven project builds.
  • Shortcut function to run maven module builds.
  • Execute maven build from history.
  • Maven hydra.

Per project profile management

Under project root, you can create a file called `.idee/maven.el` and in there you can set the desired profiles:

(setq idee-maven-profiles ("profile-a" "profile-b"))

These profiles will be automatically used for all maven operations triggered through this plugin.

Maven command history

Being able to execute the last maven command, using a short cut is cool. Being able to easily repeat any previously executed maven command is even cooler.

./doc/images/maven-history.png

Maven hydra

./doc/images/maven-hydra.png

The maven hydra can be called via `idee-maven-hydra/body` or using `<SPC> m` if you enabled `idee-evil`.

You can’t perform that action at this time.