Eclipse Community Forums
Forum Search:

Search      Help    Register    Login    Home
Home » Eclipse Projects » SWTBot » Documentation - Javadoc, & Snippets
Documentation - Javadoc, & Snippets [message #478923] Fri, 07 August 2009 10:10 Go to next message
Eclipse User
Originally posted by: jconlon.apache.org

I am a newbie just starting to use swtbot. First impressions are that
it is a great tool! Thanks for all the fine work.

In my efforts I need to graduated to the more subtler forms of swtbot -
selecting trees and context menus. It is here that I am encountering a
learning wall.

To help I have search for online Javadocs so I can look at these and
print out some of them, but I could not find them. Where can I find
these published.

Second question is about snippets. I see a simple one at:
http://wiki.eclipse.org/SWTBot/Snippets

But are there any more advanced snippets for context menus and tree
selections?

Thanks again for the fine tool,
John
Re: Documentation - Javadoc, & Snippets [message #478955 is a reply to message #478923] Fri, 07 August 2009 12:09 Go to previous messageGo to next message
Ketan Padegaonkar is currently offline Ketan Padegaonkar
Messages: 873
Registered: July 2009
Senior Member
Hi John,

I'm glad that you like SWTBot.

If you're looking for examples on using SWTBot. I'd say that the SWTBot
tests are the best way to go around.

You can download the tests by pointing subversion to the test plugin
url:http://dev.eclipse.org/svnroot/technology/org.eclipse.sw tbot/trunk/org.eclipse.swtbot.swt.finder.test/


As the author of SWTBot, I'm biased towards saying that SWTBot is too
simple to need documentation more than the simple "getting started
guide". That however is not an excuse to not improve documentation :)

If you have any examples of what kind of things you want to see as part
of the snippets page, please drop in a note, and I'll do my best -- no
promises here. I'm the only committer working on swtbot, and this is not
my day job. Better yet, add your own snippet with a screenshot of the UI :)

--
Ketan
http://studios.thoughtworks.com/twist | http://twitter.com/ketanpkr

On 7/8/09 19:40, John E. Conlon wrote:
> I am a newbie just starting to use swtbot. First impressions are that
> it is a great tool! Thanks for all the fine work.
>
> In my efforts I need to graduated to the more subtler forms of swtbot -
> selecting trees and context menus. It is here that I am encountering a
> learning wall.
>
> To help I have search for online Javadocs so I can look at these and
> print out some of them, but I could not find them. Where can I find
> these published.
>
> Second question is about snippets. I see a simple one at:
> http://wiki.eclipse.org/SWTBot/Snippets
>
> But are there any more advanced snippets for context menus and tree
> selections?
>
> Thanks again for the fine tool,
> John
Re: Documentation - Javadoc, & Snippets [message #479002 is a reply to message #478955] Fri, 07 August 2009 18:28 Go to previous messageGo to next message
Eclipse User
Originally posted by: jconlon.apache.org

Ketan Padegaonkar wrote:
> Hi John,
>
> I'm glad that you like SWTBot.
Very much! We needed this.
>
> If you're looking for examples on using SWTBot. I'd say that the SWTBot
> tests are the best way to go around.
>
> You can download the tests by pointing subversion to the test plugin
> url:http://dev.eclipse.org/svnroot/technology/org.eclipse.sw tbot/trunk/org.eclipse.swtbot.swt.finder.test/
I downloaded this test and reviewed all the tests associated with (and
ran them) the org.eclipse.swtbot.eclipse.finder.AllTests class.

This was helpful. Besides the getting started guides, and the other
references noted on the site and wiki, I read the latest article
mentioned a couple of days ago on the news list:
http://www.ralfebert.de/articles/swtbot/

This was also good as I just needed a little snip to see how to deal
with contexts:
SWTBotTable table = bot.viewByTitle("Adressen").bot().table();
table.select("Heike Winkler", "Marion Graf");
table.contextMenu("Adresse öffnen").click();


>
>
> As the author of SWTBot, I'm biased towards saying that SWTBot is too
> simple to need documentation more than the simple "getting started
> guide". That however is not an excuse to not improve documentation :)

Yes, but I think a couple of more snippets should be all one needs.
How about the Javadoc, is it available on the website somewhere?
>
> If you have any examples of what kind of things you want to see as part
> of the snippets page, please drop in a note, and I'll do my best -- no
> promises here. I'm the only committer working on swtbot, and this is not
> my day job. Better yet, add your own snippet with a screenshot of the UI :)
>
Would you want this submitted as a bugzilla?

thanks again,
John
Re: Documentation - Javadoc, & Snippets [message #479015 is a reply to message #479002] Fri, 07 August 2009 23:13 Go to previous messageGo to next message
Ketan Padegaonkar is currently offline Ketan Padegaonkar
Messages: 873
Registered: July 2009
Senior Member
On 8/8/09 03:58, John E. Conlon wrote:

> Yes, but I think a couple of more snippets should be all one needs.
> How about the Javadoc, is it available on the website somewhere?

Yes the javadoc is available on the website (also available as a
download) [1]. The link is not provided on the download page and I'll
fix this shortly. The source for swtbot is also included in the binaries
so you can view the javadoc for something particular in the ide itself.
I should also investigate providing swtbot help (and snippets) as part
of the eclipse help system.

>> If you have any examples of what kind of things you want to see as
>> part of the snippets page, please drop in a note, and I'll do my best
>> -- no promises here. I'm the only committer working on swtbot, and
>> this is not my day job. Better yet, add your own snippet with a
>> screenshot of the UI :)
>>
> Would you want this submitted as a bugzilla?

It's a wiki, feel free to edit :)

[1] - http://download.eclipse.org/technology/swtbot/galileo/dev-bu ild/

Cheers!
--
Ketan
http://studios.thoughtworks.com/twist | http://twitter.com/ketanpkr
Re: Documentation - Javadoc, & Snippets [message #479056 is a reply to message #479015] Sat, 08 August 2009 12:05 Go to previous message
Eclipse User
Originally posted by: jconlon.apache.org

Ketan Padegaonkar wrote:
> On 8/8/09 03:58, John E. Conlon wrote:
>
>> Yes, but I think a couple of more snippets should be all one needs.
>> How about the Javadoc, is it available on the website somewhere?
>
> Yes the javadoc is available on the website (also available as a
> download) [1].
Thanks!
The link is not provided on the download page and I'll
> fix this shortly.
That should help new folks like me find their way.
The source for swtbot is also included in the binaries
> so you can view the javadoc for something particular in the ide itself.
Yes I have been do this, but it is nice to have it all together for
hyper navigating.
> I should also investigate providing swtbot help (and snippets) as part
> of the eclipse help system.
That would be the best. I don't think you need much more content, just
a few more snippets to the user guide to point out the salient features.
I've used docbook to do both in my projects:
http://wiki.eclipse.org/Authoring_Eclipse_Help_Using_DocBook

>
>>> If you have any examples of what kind of things you want to see as
>>> part of the snippets page, please drop in a note, and I'll do my best
>>> -- no promises here. I'm the only committer working on swtbot, and
>>> this is not my day job. Better yet, add your own snippet with a
>>> screenshot of the UI :)
>>>
>> Would you want this submitted as a bugzilla?
>
> It's a wiki, feel free to edit :)
Okay but I expect what I put up may require review and revision by adults;-)

I have been leveraging (subclassing) the PageObject classes submitted by
Kay-Uwe Graw in https://bugs.eclipse.org/bugs/show_bug.cgi?id=280641

would something like that be useful as higher level snippets?

cheers,
John
Previous Topic:waitUntil
Next Topic:Custom Widgets
Goto Forum:
  


Current Time: Fri Jul 25 14:24:16 EDT 2014

Powered by FUDForum. Page generated in 0.02715 seconds