https://github.com/ekino/jcv-idea-plugin

IntelliJ IDEA plugin for an enhanced coding experience on JCV based projects.
https://github.com/ekino/jcv-idea-plugin

autocomplete idea idea-plugin intellij jcv json kotlin

Last synced: about 1 year ago
JSON representation

IntelliJ IDEA plugin for an enhanced coding experience on JCV based projects.

• Host: GitHub
• URL: https://github.com/ekino/jcv-idea-plugin
• Owner: ekino
• License: mit
• Created: 2020-03-02T15:13:57.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2023-03-13T05:56:40.000Z (over 3 years ago)
• Last Synced: 2025-03-26T00:04:04.660Z (over 1 year ago)
• Topics: autocomplete, idea, idea-plugin, intellij, jcv, json, kotlin
• Language: Kotlin
• Homepage: https://plugins.jetbrains.com/plugin/13916-jcv
• Size: 19.5 MB
• Stars: 7
• Watchers: 20
• Forks: 0
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
# JCV plugin

IntelliJ IDEA plugin for an enhanced coding experience on JCV based projects.

[![Release](https://img.shields.io/github/release/ekino/jcv-idea-plugin/all.svg)](https://github.com/ekino/jcv-idea-plugin/releases)

[![License](https://img.shields.io/github/license/ekino/jcv-idea-plugin.svg)](https://github.com/ekino/jcv-idea-plugin/blob/master/LICENSE.md)

[![Jetbrains plugin](https://img.shields.io/jetbrains/plugin/v/13916-jcv.svg)](https://plugins.jetbrains.com/plugin/13916-jcv)

[![Downloads](https://img.shields.io/jetbrains/plugin/d/13916-jcv.svg)](https://plugins.jetbrains.com/plugin/13916-jcv)

This plugin brings the JCV language support injected in JSON language.

## Auto-completion and documentation

Any identified validator will get a quick documentation and even external links to official documentation for official JCV validators:

![Validator documentation screenshot](./screenshots/jcv-demo-validator_documentation.png)

As you start typing in the JCV template pattern, a list of available validators will be suggested to you:

![Completion list screenshot](./screenshots/jcv-demo-validator_completion_list.png)

You will also get parameter values completion if available, for example with the [date_time_format](https://ekino.github.io/jcv/documentation/validators.html#date_time_format) from [JCV](https://github.com/ekino/jcv):

![Auto completion screencast](./screenshots/jcv-demo-auto_completion.gif)

## Supported validators

### Official ones

[JCV](https://github.com/ekino/jcv) is a library allowing you to compare JSON contents with embedded validation.

It comes with plenty of pre-defined validators (listed [here](https://github.com/ekino/jcv/wiki/Predefined-validators))

designed to cover the most common needs when validating data with non-predictable values.

[JCV-DB](https://github.com/ekino/jcv-db) reuses these validators and also defines a list of its own

(listed [here](https://github.com/ekino/jcv-db/wiki/Validators)) that are specific to a database-oriented usage.

This plugin offers autocompletion on all the validators of these two projects to date if detected in your project external libraries.

Using an official validator without the actual library linked to the current project module will give you a warning and can guide you to the Maven Central library page to get it:

![Missing library screencast](./screenshots/jcv-demo-missing_library.gif)

### Your custom ones

You can define your own custom validator definitions by adding a `.jcvdefinitions.json` file in the project root directory or just let the plugin do it for you:

![Custom validator definition screencast](./screenshots/jcv-demo-custom_validator_definition.gif)

Here is an example definition you can customize:

`ROOT_PROJECT_DIRECTORY/.jcvdefinitions.json`

```json

{

  "validators" : [ {

    "id" : "my_custom_validator",

    "parameters" : [ {

      "description" : "My first param",

      "required" : true,

      "suggested_values" : [ "Value 1", "Value 2" ]

    }, {

      "description" : "Another parameter",

      "required" : false,

      "suggested_values" : [ "Another value to suggest" ]

    } ]

  } ]

}

```

## Replacements suggestions

The plugin can find raw JSON value that can be replaced by official matching validators.

![Replacement suggestions screenshot](./screenshots/jcv-demo-replacements_suggestions.png)

Note that it also supports multi-caret replacement with matching validators for all JSON values find at each caret.

![Replacement suggestions screencast](./screenshots/jcv-demo-replacements_suggestions.gif)

## Settings

### Color scheme

You can configure the color scheme settings:

![Color scheme settings screenshot](./screenshots/jcv-demo-color_settings.png)

### Inspections

Here are the available inspections that you can customize:

![Inspections screenshot](./screenshots/jcv-demo-inspections.png)

### Intentions

You can find the JCV replacement suggestions on JSON values in the intentions:

![Intentions screenshot](./screenshots/jcv-demo-intentions.png)