|
1 | 1 | # CloudShell-PyCharm-Plugin |
2 | | -A plugin for publishing drivers developed with JetBrains PyCharm products to CloudShell |
| 2 | +A plugin for publishing drivers developed with JetBrains PyCharm products to CloudShell |
| 3 | + |
| 4 | +# How to install Quali PyCharm python driver plugin |
| 5 | + |
| 6 | +When working with Python resource drivers, a plugin enables updating Python drivers straight from PyCharm. |
| 7 | +If you don't have PyCharm you can get it from here: https://www.jetbrains.com/pycharm/download/ |
| 8 | + |
| 9 | +## Step-by-step installation guide |
| 10 | + |
| 11 | +1. First get the latest plugin release from GitHub over here: |
| 12 | + https://github.com/QualiSystemsLab/CloudShell-PyCharm-Plugin/releases |
| 13 | +2. Once you have the plugin `.jar` file (`intelli-qs-plugin.jar`) open the settings window from within PyCharm. |
| 14 | + Pressing `Ctrl + Alt + S` will open the settings window. |
| 15 | +  |
| 16 | +3. Then, choose "Plugins", and click "Install plugin from disk...". |
| 17 | +4. Browse and choose to the .jar plugin file (intelli-qs-plugin.jar) you just downloaded. |
| 18 | +5. Then, click "Restart PyCharm". |
| 19 | +  |
| 20 | +6. After PyCharm restarts the plugin would be installed. |
| 21 | + |
| 22 | +## Using the Quali python driver plugin |
| 23 | +1. The plugin adds the update and deploy action to two places: |
| 24 | + 1. The module menu, opened up by right clicking the module in the project tool window on the left: |
| 25 | +  |
| 26 | + 2. The run and run toolbar on the top right: |
| 27 | +  |
| 28 | + |
| 29 | +2. Before running the plugin, you'll need to have a file named deployment.xml in the project root folder, |
| 30 | + this file tells the plugin how and which driver you're trying to update, you can use this snippet as a template: |
| 31 | + |
| 32 | + ``` xml |
| 33 | + <?xml version="1.0" encoding="UTF-8" standalone="no"?> |
| 34 | + <!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd"> |
| 35 | + <properties> |
| 36 | + <!-- The address of the Quali server on which to deploy, mandatory --> |
| 37 | + <entry key="serverRootAddress">serverRootAddress</entry> |
| 38 | + <!-- The port of the Quali server on which to deploy, defaults to "8029" --> |
| 39 | + <entry key="port">port</entry> |
| 40 | + <!-- The unique name of the driver as seen on the portal management, mandatory --> |
| 41 | + <entry key="driverUniqueName">driverUniqueName</entry> |
| 42 | + <!-- The server admin username, password and domain to use when deploying, defaults to "admin","admin" and "Global" --> |
| 43 | + <entry key="username">username</entry> |
| 44 | + <entry key="password">password</entry> |
| 45 | + <entry key="domain">domain</entry> |
| 46 | + <!-- Simple patterns to filter when sending the driver to the server separated by semicolons (e.g. "file.xml;logs/"), |
| 47 | + on top of the patterns specified here the plugin will automatically filter the "deployment/" and ".idea/" folders and the "deployment.xml" file --> |
| 48 | + <entry key="fileFilters">fileFilters</entry> |
| 49 | + </properties> |
| 50 | + ``` |
0 commit comments