Skip to content

Commit 6260942

Browse files
committed
added installation and usage instructions to readme.md
1 parent 231f4a4 commit 6260942

File tree

5 files changed

+49
-1
lines changed

5 files changed

+49
-1
lines changed

README.md

Lines changed: 49 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,50 @@
11
# 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+
![Settings Window](/docs/images/settings_window.png)
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+
![Restart Button](/docs/images/restart_button.png)
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+
![Project Tool Window](/docs/images/module_menu.png)
26+
2. The run and run toolbar on the top right:
27+
![Runner Actions](/docs/images/build_menu.png)
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+
```

docs/images/build_menu.png

4.33 KB
Loading

docs/images/module_menu.png

19.7 KB
Loading

docs/images/restart_button.png

2.39 KB
Loading

docs/images/settings_window.png

22.3 KB
Loading

0 commit comments

Comments
 (0)