Skip to content

Commit 904868f

Browse files
committed
gui
1 parent becab7a commit 904868f

40 files changed

+109
-215
lines changed

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,3 +2,4 @@
22
.venv/
33
ibex_developers_manual.egg-info/
44
build/
5+
_build/

doc/Gui.md

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
# IBEX GUI (Eclipse)
2+
3+
## Getting Started
4+
5+
```{toctree}
6+
:glob:
7+
:titlesonly:
8+
9+
client/Building-the-GUI
10+
client/GUI-Development-Workflow
11+
client/Maven-and-Tycho
12+
```
13+
14+
## Coding
15+
16+
```{toctree}
17+
:glob:
18+
:titlesonly:
19+
20+
client/GUI-Coding-Conventions
21+
client/An-Introduction-to-Databinding
22+
client/Adding-a-Plugin-or-Feature-to-Maven-Build
23+
client/Connecting-a-View-to-a-PV
24+
client/Static-analysis
25+
client/Instrument-switching
26+
client/PV-Switching
27+
client/OPI-Creation
28+
client/Adding-a-Button-to-the-Perspective-Switcher
29+
```
30+
31+
## Testing
32+
33+
```{toctree}
34+
:glob:
35+
:titlesonly:
36+
37+
client/An-Introduction-to-Unit-Testing
38+
client/Adding-Unit-Tests
39+
client/Using-Mockito-for-Testing-in-the-GUI
40+
client/System-Testing-with-Squish
41+
client/Test-naming
42+
```
43+
44+
# Web Dashboard

doc/Processes.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ processes/Tickets-and-their-Workflow
99
processes/Umbrella-Tickets
1010
processes/Dependency-Updates
1111
processes/External-Contributions
12+
processes/Component-and-Activity-Stewards
1213
```
1314

1415
# Meetings
@@ -25,6 +26,7 @@ processes/Sprint-Planning
2526
processes/Sprint-Review-and-Retro
2627
processes/Program-Increment-Planning
2728
processes/Technical-Debt-Stand-down
29+
processes/Code-Chats-and-Lightning-Talks
2830
```
2931

3032
## External meetings
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
> [Wiki](Home) > [The GUI](The-GUI) > [Testing](GUI-Testing) > Adding tests
1+
# Adding tests
22

33
For more detailed information see [an_introduction_to_unit_testing.rst](https://github.com/ISISComputingGroup/ibex_developers_manual/wiki/An-Introduction-to-Unit-Testing).
44

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
1-
> [Wiki](Home) > [The GUI](The-GUI) > [Coding](GUI-Coding) > Adding a perspective
1+
# Adding a perspective
2+
23
![Perspective Switcher](GUI_development/images/adding_a_button_to_the_perspective_switcher/IBEX_complete_perspective_switcher_highlighted.png)
34

45

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
> [Wiki](Home) > [The GUI](The-GUI) > [Coding](GUI-Coding) > Adding a plugin or feature to Maven
1+
# Adding a plugin or feature to Maven
22

33
The steps for adding a plug-in (one small part of IBEX, such as the blocks view) or feature (a larger collection of plug-ins, such as CSS) to the maven build are below:
44

5-
# Step by step:
5+
## Step by step:
66
* Add the plug-in to `feature.base`:
77
* Open `feature.xml` in `uk.ac.stfc.isis.ibex.feature.base`
88
* Go to "Included Plug-ins" (or "Included Features") tab and click "Add..."
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
> [Wiki](Home) > [The GUI](The-GUI) > [Coding](GUI-Coding) > Data binding
1+
# Data binding
22

33
Note: there are some helpful tips to common errors/mistakes [here](Databinding---common-mistakes).
44

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,4 @@
1-
> [Wiki](Home) > [The GUI](The-GUI) > [Testing](GUI-Testing) > An introduction to unit testing
2-
3-
# Unit Testing
1+
# An introduction to unit testing
42

53
To create unit tests for an Eclipse plug-in a Fragment Project is used. When creating a Fragment Project we assign the plug-in we wish to test as a Host Plug-in.
64
Eclipse automatically gives the Fragment access to the classes in the original plug-in.
@@ -218,9 +216,9 @@ From the results it can be seen that 63.2% of the StringManipulator code is used
218216
The code that isn't used is highlighted in red - for this example we can see that we need to write a test that tests the reverseString method.
219217

220218

221-
# Eclipse is complaining
219+
## Troubleshooting
222220

223-
## ClassNotFoundException
221+
### ClassNotFoundException
224222

225223
Running the tests in Eclipse might crash with an error like:
226224

@@ -244,14 +242,14 @@ This is a known bug and there is a workaround:
244242
* On the original dialog, click "Apply" and then "Run"
245243
* Hopefully, the tests will now work and you should be able to re-run them in the normal way
246244

247-
## Eclipse is not picking up new tests
245+
### Eclipse is not picking up new tests
248246

249247
If Eclipse is not picking up changes when you add tests you may need to change the default output folder for tests for Maven to pick it up.
250248

251249
* Right-click on the tests plug-in, go to properties, Java build path
252250
* Change the output folder to target/test-classes (you may need to create this folder first by clicking browse, selecting target and adding the test-classes folder)
253251
* If this does not work try deleting the target/test-classes folder first, if it existed already, and do a clean rebuild of the workspace
254252

255-
## IncompatibleClassChangeError
253+
### IncompatibleClassChangeError
256254

257255
If the tests are failing because of an IncompatibleClassChangeError error then the solution is to delete the bin and target folders for both the main plug-in and the corresponding test plug-in
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
> [Wiki](Home) > [The GUI](The-GUI) > [Getting started](GUI-Getting-Started) > Building the GUI
1+
# Building the GUI
22

33
Before building and running the GUI please make sure you have followed the steps from here: [First time installing and building (Windows)](First-time-installing-and-building-(Windows)). In particular make sure Git and genie_python are installed.
44

File renamed without changes.

0 commit comments

Comments
 (0)