IDE icons for experimental and beta Java annotations
This is an IntelliJ/Android Studio IDE plugin to detect the code with @Experimental and @Beta annotations and show a custom icon on the gutter when you use it.
Note that the method
switchMapSingle() is annotated with the
io.reactivex.annotations.Experimental annotation. Another example of function annotated with a custom
Why would I want to use this plugin?
We are developers, and we write hundreds of lines of code and use tons of libraries each day. How many of these libraries contain beta and experimental classes and functions?. Which is the answer?. Well, you've probably never thought of that, but I can tell you that there are many!
You don't trust me? Take a look to RxJava (I ???? RxJava). You are probably using beta and experimental functions/classes in your production code and you don't know it!
With this plugin you know when you are using a beta or experimental piece of code
Install the plugin
There are two methods to install this plugin. The first, clone this repo and build the plugin jar to install it manually into the IDE. The second method, the recommended, search into the Jetbrains plugin manager this plugin
Icons for Java annotations and install it
Note that at this moment the plugin is pending JetBrains approval. If you want to test it you need to install it manually!
You can download the plugin using the Jetbrains plugin manager from your IntelliJ or Android Studio. Go to
Settings -> Plugins -> Browse repositories... and search for
Icons for Java annotations. Install and restart. This is the recommended option. You can check the plugin page here.
First clone this repo:
git clone https://github.com/fooock/detect-experimental-and-beta-code.git
Build the plugin using gradle
The compiled plugin is in the
build/libs directory. Now open your IDE and go to
Settings -> Plugins -> Install plugin from disk... and select the plugin. Restart your IDE.
Do you have any question? Ask here
How it works?
The operation of this plugin is very simple, it reads the code of the file that is currently open and if it finds an annotation that is called
Beta it paints an icon in the IDE gutter. That's all!
Is important to note that the annotation package name is ignored. Using this behavior allows us to always display the icons, regardless of the library that is being used to annotate our code. Do you have any question? Ask here
The icons used by this plugin are from the github markdown emoji markup. I found in this repo a complete list. For the detected
@Experimental annotations the ???? icon is used, and for the
@Beta annotation the ???? icon is used.
- Petar Marijanović: Show tooltip text when on mouse hover
Copyright (c) 2018 Javi <nhitbh at gmail dot com>
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.