Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sebthom/findview-eclipse-plugin

Convenient search view for Eclipse to find/replace within the currently active editor.
https://github.com/sebthom/findview-eclipse-plugin

eclipse-plugin java

Last synced: about 10 hours ago
JSON representation

Convenient search view for Eclipse to find/replace within the currently active editor.

Awesome Lists containing this project

README

        

# Find/Replace View plugin for Eclipse

[![Build Status](https://github.com/sebthom/findview-eclipse-plugin/actions/workflows/build.yml/badge.svg)](https://github.com/sebthom/findview-eclipse-plugin/actions/workflows/build.yml)
[![License](https://img.shields.io/github/license/sebthom/findview-eclipse-plugin.svg?color=blue)](LICENSE.txt)
[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg)](CODE_OF_CONDUCT.md)
[![Eclipse Marketplace](https://img.shields.io/eclipse-marketplace/dt/findreplace-view-plugin?logo=eclipse&label=Downloads)](https://marketplace.eclipse.org/content/findreplace-view-plugin)

**Feedback and high-quality pull requests are highly welcome!**

1. [What is it?](#what-is-it)
1. [Installation](#installation)
1. [Building from Sources](#building)
1. [License](#license)

## What is it?

This plugin extends [EclipseⓇ](https://eclipse.org) with a **Find/Replace** view that allows to conveniently
perform find/replace operations within the currently active editor.

![](src/site/img/screen.png)

The following hot keys are configured by default:
- [CTRL]+[ALT]+[F] - open the **F**ind/Replace view
- [CTRL]+[ALT]+[N] - go to the **n**ext match
- [CTRL]+[ALT]+[P] - go to the **p**revious match
- [ESC] - return focus to the editor (default) or close the Find/Replace view. can be configured in the preferences

This plugin is a spiritual successor to the abandoned [Eclipse Search Tab](https://code.google.com/archive/p/eclipse-search-tab/) plug-in
which aimed to provide a Firefox-like search tab.

## Installation

To install the plugin into an existing Eclipse installation do:
1. Within Eclipse go to: Help -> Install New Software...
1. Enter the following update site URL: https://raw.githubusercontent.com/sebthom/findview-eclipse-plugin/updatesite
1. Select the `Find/Replace View` feature to install.
1. Ensure that the option `Contact all update sites during install to find required software` is enabled.
1. Click `Next` twice.
1. Read/accept the license terms and click `Finish`.
1. Eclipse will now download the necessary files in the background.
1. When the download has finished, Eclipse will ask about installing unsigned content. You need to accept if you want to
1. After installation you will be prompted for a restart of Eclipse, which is recommended.

## Building from Sources

To ensure reproducible builds this Maven project inherits from the [vegardit-maven-parent](https://github.com/vegardit/vegardit-maven-parent)
project which declares fixed versions and sensible default settings for all official Maven plug-ins.

The project also uses the [maven-toolchains-plugin](http://maven.apache.org/plugins/maven-toolchains-plugin/) which decouples the JDK that is
used to execute Maven and it's plug-ins from the target JDK that is used for compilation and/or unit testing. This ensures full binary
compatibility of the compiled artifacts with the runtime library of the required target JDK.

To build the project follow these steps:

1. Download and install a Java 17 SDK, e.g. from:
- https://adoptium.net/releases.html?variant=openjdk17
- https://www.azul.com/downloads/?version=java-17-lts&architecture=x86-64-bit&package=jdk

1. Download and install the latest [Maven distribution](https://maven.apache.org/download.cgi).

1. In your user home directory create the file `.m2/toolchains.xml` with the following content:

```xml



jdk

17
default


[PATH_TO_YOUR_JDK_17]



```

Set the `[PATH_TO_YOUR_JDK_17]` parameter accordingly.

1. Checkout the code using one of the following methods:

- `git clone https://github.com/sebthom/findview-eclipse-plugin`
- `svn co https://github.com/sebthom/findview-eclipse-plugin findview-eclipse-plugin`

1. Run `mvn clean verify` in the project root directory. This will execute compilation, unit-testing, integration-testing and
packaging of all artifacts.

## License

If not otherwise specified (see below), files in this repository fall under the [Eclipse Public License 2.0](LICENSE.txt).

Individual files contain the following tag instead of the full license text:
```
SPDX-License-Identifier: EPL-2.0
```

This enables machine processing of license information based on the SPDX License Identifiers that are available here: https://spdx.org/licenses/.

An exception is made for:
1. files in readable text which contain their own license information, or
2. files in a directory containing a separate `LICENSE.txt` file, or
3. files where an accompanying file exists in the same directory with a `.LICENSE.txt` suffix added to the base-name of the original file.
For example `foobar.js` is may be accompanied by a `foobar.LICENSE.txt` license file.