Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

<table class="wysiwyg-macro" data-macro-name="unmigrated-inline-wiki-markup" data-macro-parameters="atlassian-macro-output-type=BLOCK" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e3VubWlncmF0ZWQtaW5saW5lLXdpa2ktbWFya3VwOmF0bGFzc2lhbi1tYWNyby1vdXRwdXQtdHlwZT1CTE9DS30&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>{iframe:src=http://update.sonarsource.org/plugins/thucydides.html|width=700|height=250|frameborder=0}
Your browser does not support iframes.
{iframe}</pre></td></tr></table><h2>Description / Features</h2><p style="margin-left: 0.0px;text-align: justify;">Thucydides was the<a href="http://en.wikipedia.org/wiki/Thucydides"> most famous Greek Historian</a> and nowadays is a very promising open source library that lets you use WebDriver/Selenium 2 to write better acceptance tests.</p><p style="margin-left: 0.0px;text-align: justify;">In a few words Thucydides helps you:</p><ul style="text-align: justify;"><li>Write tests that are more flexible and easier to maintain</li><li>Produce illustrated, narrative reports about your tests</li><li>Map your automated tests back to your requirements more easily</li><li>See how much of your application is actually being tested</li><li>And measure project progress</li></ul><p>More information about Thucydides you can find at <a href="http://www.wakaleo.com/resources/thucydides-automated-testing-library">the official Thucydides web site </a>and read the <a href="http://thucydides.wakaleo.com/">User Manual</a> </p><p>The plugin calculates several Thycudides metrics and imports them in Sonar ( see metics definitions below )<br />It adds also a new dashboard widget that supports localiztion.</p><h2>Usage &amp; Installation</h2><p>On the sonar side, just copy the sonar-thucydides-plugin jar to the extensions/plugins directory just like any regular sonar plugin. </p><p>The current version of the plugin supports only maven projects and does not execute thucydides tests itself, so thucydides reports must be available before sonar analysis. <br />The default location of thucydides report files is under target/site/thucydides and although you can define your own report path with a maven property, the plugin expects to find them in this location.<br /> More on Thucydides reporting you can find here <a href="http://thucydides.wakaleo.com/#_thucydides_reporting">http://thucydides.wakaleo.com/#_thucydides_reporting</a></p><h2>Configuration</h2><p>Currently there is no available configuration as the plugin uses the default values of thucydides properties<br />Thucydides plugin widget is available under the category <em>Tests</em> </p><h2>Try the plugin</h2><p>To try the plugin you may find a maven sample project under src/main/resources.</p><ol><li>Unzip sample project in a local folder</li><li><p>Add to your settings.xml the following</p><table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>&lt;settings>
   &lt;pluginGroups>
       &lt;pluginGroup>net.thucydides.maven.plugins&lt;/pluginGroup>
       ...
   &lt;/pluginGroups>
&lt;/settings></pre></td></tr></table></li><li><p>Run the following maven command</p><table class="wysiwyg-macro" data-macro-name="noformat" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e25vZm9ybWF0fQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>mvn clean verify thucydides:aggregate</pre></td></tr></table></li><li>Run a Sonar analysis for the project ( mvn sonar:sonar )</li></ol><h2>Compatibility Matrix</h2><table class="confluenceTable"><tbody><tr><th class="confluenceTh"><p>Plugin version</p></th><th colspan="1" class="confluenceTh">0.1</th></tr><tr><td colspan="1" class="confluenceTd"><strong><span style="color: rgb(0,51,102);">Thucydides version</span></strong></td><td colspan="1" class="confluenceTd"> </td></tr><tr><td class="confluenceTd"><p><strong><a href="http://thucydides-webtests.com/2012/05/15/thucydides-release-0-8-12-adding-tag-support-to-easyb-stories/">0.8.15</a></strong></p></td><td colspan="1" class="confluenceTd"><p><img class="emoticon emoticon-tick" data-emoticon-name="tick" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/check.png" alt="(tick)" title="(tick)" /></p></td></tr><tr><td colspan="1" class="confluenceTd"><strong><a href="http://thucydides-webtests.com/2012/05/26/thucydides-release-0-8-20-more-simplified-tagging/">0.8.20</a></strong></td><td colspan="1" class="confluenceTd"><img class="emoticon emoticon-tick" data-emoticon-name="tick" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/check.png" alt="(tick)" title="(tick)" /></td></tr></tbody></table><h2>Known Limitations</h2><p>Plugin works only for projects analysed by maven<br />No details are shown about features and user stories<br />No drill-down links are available </p><h2>Metrics Definitions</h2><table class="confluenceTable"><tbody><tr><th class="confluenceTh"><p>Name</p></th><th class="confluenceTh"><p>Key</p></th><th colspan="1" class="confluenceTh"><span style="color: rgb(0,51,102);">Qualitative</span></th><th class="confluenceTh"><p>Description</p></th></tr><tr><td class="confluenceTd"><p><strong>Tests</strong></p></td><td class="confluenceTd"><p>thucydides-tests</p></td><td colspan="1" class="confluenceTd">no</td><td class="confluenceTd"><p>Number of Thucydides tests</p></td></tr><tr><td class="confluenceTd"><p><strong>Passed</strong></p></td><td class="confluenceTd"><p>thucydides-tests-passed</p></td><td colspan="1" class="confluenceTd">no</td><td class="confluenceTd"><p>Number of Passed Thucydides tests ( Succesful tests )</p></td></tr><tr><td class="confluenceTd"><p><strong>Failed</strong></p></td><td class="confluenceTd"><p><span>thucydides-tests-failed</span></p></td><td colspan="1" class="confluenceTd">no</td><td class="confluenceTd"><p><span>Number of Failed Thucydides tests ( Failed assertions or errors)</span></p></td></tr><tr><td class="confluenceTd"><p><strong>Pending</strong></p></td><td class="confluenceTd"><p><span>thucydides-tests-pending</span></p></td><td colspan="1" class="confluenceTd">no</td><td class="confluenceTd"><p><span>Number of Pedning Thucydides tests. These tests have not been executed yet.</span></p></td></tr><tr><td class="confluenceTd"><p><strong>Duration</strong></p></td><td class="confluenceTd"><p><span>thucydides-tests-duration</span></p></td><td colspan="1" class="confluenceTd">no</td><td class="confluenceTd"><p>Execution duration of Thucydides tests</p></td></tr><tr><td colspan="1" class="confluenceTd"><strong>Succes Density</strong></td><td colspan="1" class="confluenceTd"><span>thucydides-success-density</span></td><td colspan="1" class="confluenceTd">no</td><td colspan="1" class="confluenceTd">Passed Tests / Tests * 100</td></tr><tr><td colspan="1" class="confluenceTd"><strong>Features</strong></td><td colspan="1" class="confluenceTd"><span>thucydides-features</span></td><td colspan="1" class="confluenceTd">no</td><td colspan="1" class="confluenceTd">Number of Features tested by Thucydides</td></tr><tr><td colspan="1" class="confluenceTd"><strong>User Stores</strong></td><td colspan="1" class="confluenceTd"><span>thucydides-stories</span></td><td colspan="1" class="confluenceTd">no</td><td colspan="1" class="confluenceTd">Number of User Stories tested by Thucydides</td></tr></tbody></table><p> </p><h2>Future Work</h2><p>Plenty !!!</p><h2>Change Log</h2><p><img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e2ppcmFpc3N1ZXM6YW5vbnltb3VzPXRydWV8dGl0bGU9UmVsZWFzZSAwLjF8aGVpZ2h0PTcwfHdpZHRoPTkwMHxjb2x1bW5zPXR5cGU7a2V5O3N1bW1hcnk7cHJpb3JpdHk7c3RhdHVzO3Jlc29sdXRpb258dXJsPWh0dHA6Ly9qaXJhLmNvZGVoYXVzLm9yZy9zci9qaXJhLmlzc3Vldmlld3M6c2VhcmNocmVxdWVzdC14bWwvdGVtcC9TZWFyY2hSZXF1ZXN0LnhtbD9maXhmb3I9MTg1MzkmcGlkPTExOTExJnNvcnRlci9maWVsZD1pc3N1ZWtleSZzb3J0ZXIvb3JkZXI9REVTQyZ0ZW1wTWF4PTEwMDB9&amp;locale=en_GB&amp;version=2" data-macro-name="jiraissues" data-macro-parameters="anonymous=true|columns=type;key;summary;priority;status;resolution|height=70|title=Release 0.1|url=http://jira.codehaus.org/sr/jira.issueviews:searchrequest-xml/temp/SearchRequest.xml?fixfor\=18539&amp;pid\=11911&amp;sorter/field\=issuekey&amp;sorter/order\=DESC&amp;tempMax\=1000|width=900"></p>