Skip to content

Latest commit

 

History

History
225 lines (169 loc) · 7.72 KB

features.md

File metadata and controls

225 lines (169 loc) · 7.72 KB
Raw

Features

  • Contextual code completion (i.e. auto-complete / IntelliSense) using [popup.el][] or [ido-mode][] or [company-mode][] if it is installed. Currently popup and ido-mode can complete symbols in all namespaces if so configured.
    • Popup.el and company-mode provide a more sophisticated interface, with the possibility to fall back on all of ido's flexible matching power.
    • Also shows documentation like other IDEs
  • Show type of the current symbol in the minibuffer. With prefix argument, add it to kill ring. Optional eldoc support available to show this automatically when point is on a symbol (see the source for help)
  • Navigation helpers
    • Go to definition of a type/variable/method etc. With the prefix argument (C-u), use another window.
    • Find usages of the current symbol in the solution
    • Find implementations/derived types of the current type
    • Go to definition of a type in the current file with [ido-mode][] (fast).
    • Go to definition of a member in the current type with [ido-mode][] (likewise fast :)).
    • Go to region / endregion in current file
    • Go to any member in the solution (property, method etc.)
    • Go to file, then go to member (type, property, method) in that file.
  • Rename the current symbol and all references to it
    • Rename only semantic references ("smart" rename)
    • Rename as verbatim text ("dumb" rename)
  • Solution manipulation
    • Add/remove the current file
    • Add/remove selected files in the dired directory editor
    • The user may choose whether they want to build in the emacs *compilation* buffer or at OmniSharp's end (non-asynchronous, that is, blocking)
    • Jump to errors like in normal *compilation* output
    • Request for a list of compilation errors/warnings directly from omnisharp server w/o a compilation, using M-x omnisharp-solution-errors
  • Override selected superclass member
  • Run a refactoring on the current position
    • Uses the refactorings from the NRefactory library, which is also used by the MonoDevelop and SharpDevelop IDEs
    • When used with a selection, prompts to extract a method from the selection where possible
  • Format the current buffer
    • Currently only one formatting style supported, easy to add more.
  • Fix using statements
    • Sorts, removes and adds any missing using statements for the current buffer
  • Syntax checker for parse errors
    • Runs using the provided [Flycheck][] checker in the background.
  • Syntax checker for code issues (refactoring suggestions)
    • This automatically runs when there are no syntax errors
    • Fix the first suggested error on the current line with omnisharp-fix-code-issue-at-point
  • OmniSharp server instance manipulation
    • Start server
  • Test runner
    • Can run test at point, fixture or all tests in project.

Details

Autocompletion

company-mode interface

company-mode showing parameters and return values, and the selected function description in the minibuffer. As you can see, the completion works with non-trivial code.

Pressing F1 with a candidate selected in the the company-mode popup shows a buffer with documentation.

Omnisharp's company-mode support ignores case by default, but can be made case sensitive by setting omnisharp-company-ignore-case to nil.

popup.el interface

popup.el with documentation. The documentation may be disabled if you need the screen space. There is an option to show documentation in a help buffer.

To (not) complete from all namespaces, use the prefix argument when calling. This inverts the omnisharp-auto-complete-want-importable-types setting temporarily.

Ido interface

Ido allows for flexible matching of all text that the completions have. Each pressed character will narrow the list down to fewer options. It's also possible to do a cross search at any point with a new search term by pressing C-SPC.

This makes it really easy to e.g. narrow the list down to members that handle a specific type, such as bool.

To (not) complete from all namespaces, use the prefix argument when calling. This inverts the omnisharp-auto-complete-want-importable-types setting temporarily.

Go to type in current file

This is a standard functionality in e.g. Visual Studio. The types are shown in the order they occur in the source file.

Go to member in current type

This too is standard in various IDEs. Using ido makes navigating fast and intuitive. The members too are shown in the order they occur in the source file.

Rename

Renaming suggests the current type as a basis.

Overriding members

When invoked, displays a list of possible override targets.

When a target is chosen, a stub member is inserted.

Refactoring suggestions

For now, this must be manually invoked. It can do different things depending on the symbol under point. In this picture it has been invoked on a method parameter.

Solution building

Here is an example of an asynchronous build within Emacs. It works by getting the build command from the backend and executing that in the compilation buffer.

Syntax errors checking

It is possible to check the current buffer for syntax errors using the flycheck library. This is done asynchronously, and errors are shown when found. Note that this is not a type checker, only syntax is currently checked.

To start the check, use (flycheck-mode) or select it in the menu. The check will then be performed after the current buffer has been idle for a certain number of seconds or when it is saved, depending on your flycheck configuration.

To make syntax checking start sooner/later, use:

(setq flycheck-idle-change-delay 2) ; in seconds

ElDoc integration

ElDoc support is switched on by default. This shows type information for the symbol at point in the echo area. To switch it off, set omnisharp-eldoc-support to nil.

Imenu integration

Omnisharp's Imenu support allows you to quickly view and jump to function and variable definitions within your file. This can be used either natively or in combination with helm-imenu Imenu support is off by default, but can be turned on by setting omnisharp-imenu-support to t

Helm integration

If you have Helm installed, Omnisharp offers several integrations. First of all, there's helm-imenu:

There's also 'omnisharp-helm-find-usages', which allows you to easily navigate to references in your project:

And then there's 'omnisharp-helm-find-symbols', which allows you find and jump to any symbol in your project:

company-mode integration

To enable company-mode autocompletion, omnisharp requires at least version 0.7 of company-mode to be installed. Then add the following to your init file:

(eval-after-load 'company
  '(add-to-list 'company-backends 'company-omnisharp))

company-mode completion will only trigger when omnisharp-mode is active.

Test runner integration

Can run the test at point, fixture at point, or all tests in project.

Specify the path and parameters to your test runner on the server here :- https://github.com/nosami/OmniSharpServer/blob/0eb8644f67c020fc570aaf6629beabb7654ac944/OmniSharp/config.json#L10