nvim-wildcat

The Wildcat (WILDfly and tomCAT)

nvim-wildcat is a Neovim plugin written in Lua for running Wildfly, JBoss EAP or Tomcat servers. A useful plugin for Java (or other JVM language) developers who still use the aforemention servers. The base idea was to have a plugin like Eclipse server plugin

Caveats

• Ensure you have Java installed. Although it is a requisite to have Java to run Wildfly, JBoss EAP or Tomcat; this is the first requisite.
• Ensure you have Maven installed. nvim-wildcat will throw an error by executing WildcatRun if Maven is not installed.
• This plugin has been developed on and for Linux following open source philosophy.

Installation

Packer

use {
    'javiorfo/nvim-wildcat',
    requires = 'javiorfo/nvim-popcorn'
}

Lazy

{
    'javiorfo/nvim-wildcat',
    lazy = true,
    cmd = { "WildcatRun", "WildcatUp", "WildcatInfo" },
    dependencies = { 'javiorfo/nvim-popcorn' },
    opts = {
        -- Not necessary. Only if you want to change the setup
        -- The following are the default values

        console_size = 15,
        jboss = {
            home = "JBOSS_HOME",
            app_base = "standalone/deployments",
            default = true
        },
        tomcat = {
            home = "CATALINA_HOME",
            app_base = "webapps",
            default = false
        }
    }
}

Settings

Default Settings

The following are the basics settings you need to use nvim-wildcat

• By default these are de settings. You can modify one or multiple values in your init.lua or init.vim:

require'wildcat'.setup{
   console_size = 15,
   jboss = {
       home = "JBOSS_HOME",
       app_base = "standalone/deployments",
       default = true
   },
   tomcat = {
       home = "CATALINA_HOME",
       app_base = "webapps",
       default = false
   }
}

• nvim-wildcat will take the 'home' values as environment variables and if they not exist, then will take the values as absolute paths.

Example of custom settings:

• If wanted to set only Tomcat server as default and set an absolute path, just set it this way:

require'wildcat'.setup{
    tomcat = {
        home = "/path/to/tomcat",
        default = true
    }
}

Usage

To deploy on the server

• This command will run mvn -q clean package to build your app, it will deploy the war/ear in the deployments folder and it will start the server. To run it, inside the app root folder execute this command :WildcatRun
• If you want to run this command outside the app root folder, pass the path by parameter :WildcatRun /path/to/your/app/root/folder

List of commands:

Command	Description
:WildcatClean	This command will delete the deployed files in app base folder of the server
:WildcatDeploy	This command will copy the current or absolute path of a war/ear the to app base folder of the server
:WildcatDown	This command will stop the server
:WildcatEnableJBoss	This command will enable JBoss (is the default)
:WildcatEnableTomcat	This command will enable Tomcat
:WildcatInfo	This command will show info about your config (server, home, app base and deployed files)
:WildcatRun	This command will build with Maven, copy the war/ear file to the server and start the server
:WildcatUp	This command will start the server

Screenshots

NOTE: The colorscheme umbra from nvim-nyctophilia is used in this image

Documentation

• nvim-wilcat comes with built-in doc :help wildcat

Troubleshooting

• When running Tomcat sometimes an execution permission is needed for catalina.sh. This will help:

[user@host ~]$ chmod +x $CATALINA_HOME/bin/catalina.sh

---

Donate

• Bitcoin (QR) 1GqdJ63RDPE4eJKujHi166FAyigvHu5R7v
• Paypal