October 2012 - Pharo-users - lists.pharo.org

Re: [Pharo-users] Documentation from comments

by GÃ¶ran Krampe

On 10/09/2012 04:01 PM, Camillo Bruni wrote: > I made WebDoc once, it's a bit unstable and only works from within the same image... > Basically it's a seaside app that let's you look at the system much like javadoc. > > - All comments are parsed as Markdown and formatted for the website. > - Links to methods and classes are extracted from the comments as well. > - Method references are resolved if possible and a small popup is shown when > hovering the sources Also, Amber has a "live documentation application" that uses class comments and more to present documentation, see it in action: http://amber-lang.net/documentation.html ...might be worth as inspiration etc. And if you are curious about the code you can open a Smalltalk browser (the whole Amber IDE in fact) like this in Chrome: 1. ctrl-shift-j to open console 2. Type in console "smalltalk.Browser._open();" and press enter. 3. Look in package "Documentation" regards, GÃ¶ran

Oct. 10, 2012

Re: [Pharo-users] Documentation from comments

by Camillo Bruni

On 2012-10-09, at 16:01, Camillo Bruni <camillobruni(a)gmail.com> wrote: > I made WebDoc once, it's a bit unstable and only works from within the same image... > Basically it's a seaside app that let's you look at the system much like javadoc. > > - All comments are parsed as Markdown and formatted for the website. > - Links to methods and classes are extracted from the comments as well. > - Method references are resolved if possible and a small popup is shown when > hovering the sources > > You can download and try the image below. of course forgot to paste the image link: http://dl.dropbox.com/u/18184943/webdoc.zip > http://localhost:8080/webdoc/doc/ > > have fun! > > > On 2012-10-09, at 15:53, Santiago Bragagnolo <santiagobragagnolo(a)gmail.com> wrote: > >> Hi all! >> >> Is there any kind of comments-processor to generate documentation?? >> (like javadoc) or any kind of tool to automatize documentation generation >> from the code? >> >> Santiago,. >

Oct. 9, 2012

Re: [Pharo-users] Documentation from comments

by Camillo Bruni

I made WebDoc once, it's a bit unstable and only works from within the same image... Basically it's a seaside app that let's you look at the system much like javadoc. - All comments are parsed as Markdown and formatted for the website. - Links to methods and classes are extracted from the comments as well. - Method references are resolved if possible and a small popup is shown when hovering the sources You can download and try the image below. http://localhost:8080/webdoc/doc/ have fun! On 2012-10-09, at 15:53, Santiago Bragagnolo <santiagobragagnolo(a)gmail.com> wrote: > Hi all! > > Is there any kind of comments-processor to generate documentation?? > (like javadoc) or any kind of tool to automatize documentation generation > from the code? > > Santiago,.

Oct. 9, 2012

Documentation from comments

by Santiago Bragagnolo

Hi all! Is there any kind of comments-processor to generate documentation?? (like javadoc) or any kind of tool to automatize documentation generation from the code? Santiago,.

Oct. 9, 2012

SourceCodeTourGuide updated!

by HwaJong Oh

SourceCodeTourGuide has improved. - loading TGCamp subclass you created to store contents has become easier. A "choose" dialog popups with list of subclasses of TGCamp. - all of thinkable New/Save/Load logic is implemented. (e.g. Ask to save when you close a window if there is unsaved change.) Guaranteed to work on Pharo 1.4 summer. (supporting Pharo 2.0 and Nautilus is about to come) Installation code is wiki of http://www.squeaksource.com/DaliotsPlayground.html Gofer new squeaksource: 'DaliotsPlayground'; package: 'ConfigurationOfDaliotsPlayground'; load. ConfigurationOfDaliotsPlayground project versions last load: 'SourceCodeTourGuide'. Any feedback is appreciated. Do not hestitate. Best regards, HwaJong Oh -- View this message in context: http://forum.world.st/SourceCodeTourGuide-updated-tp4650428.html Sent from the Pharo Smalltalk Users mailing list archive at Nabble.com.

Oct. 8, 2012

Re: [Pharo-users] OAuth and Twitter

by Janko MivÅ¡ek

Hi Adrian, Try with latest Pharo 1.4 OneClick which has SSL plugin included so that you won't need tuneling but use SSL directly with Zodiak. Cloudfork SSO works that way too. Best regards Janko Dne 06. 10. 2012 17:44, piÅ¡e Adrian Fernandez: > > Hello All, > I'm trying to get working the example shown in: > > http://blog.doit.st/2011/02/23/cloudforksso-on-pharo-with-stunnel/ > > I loaded the package without probles doing > > |1| |Gofer ||new| > > |2| | ||squeaksource: ||'Cloudfork'||;| > > |3| | ||package: ||'ConfigurationOfCloudforkSSO'||;| > > |4| | ||load.| > > |5| |(Smalltalk at: ||#ConfigurationOfCloudforkSSO) project > latestVersion load: 'Tests'| > > > When I try to evaluate the piece of code that follows, > > > |1| |self| |default httpClient: ((CFHttpClientTunnelAccess ||new||)| > > |2| | ||client: CFHttpClientZincAccess ||new| |;| > > |3| | ||tunnel: ||'www.google.com > <http://www.google.com>'| |through: ||'localhost:20011'| |;| > > |4| | ||tunnel: ||'api.twitter.com > <http://api.twitter.com>'| |through: ||'localhost:20012'||;| > > |5| | ||tunnel: ||'graph.facebook.com > <http://graph.facebook.com>'| |through:||'localhost:20013'| |;| > > |6| | ||tunnel: ||'open.login.yahooapis.com > <http://open.login.yahooapis.com>'| |through:||'localhost:20014'| |;| > > |7| | ||tunnel: ||'openid.hyves-api.nl > <http://openid.hyves-api.nl>'| |through:||'localhost:20015'| |;| > > |8| | ||yourself )| > > > I found CFHttpClientTunnelAccess class is not in my image. Browsing, I > found CFTunneledHttpClient, but the protocol > > of this class is different from the missing one. > > Furthermore, I don't understand where this code should be located, so > that self reference makes sense. > > I'm using Pharo 1.3 , as I think it is the Pharo version contemporary > with this package and post. > > Is there some updated documentation for this? is someone using this > package or connecting to twitter from pharo? > > Thanks > > af > > -- Janko MivÅ¡ek Aida/Web Smalltalk Web Application Server http://www.aidaweb.si

Oct. 6, 2012

OAuth and Twitter

by Adrian Fernandez

Hello All, I'm trying to get working the example shown in: http://blog.doit.st/2011/02/23/cloudforksso-on-pharo-with-stunnel/ I loaded the package without probles doing 1 Gofer new 2 squeaksource: 'Cloudfork'; 3 package: 'ConfigurationOfCloudforkSSO'; 4 load. 5 (Smalltalk at: #ConfigurationOfCloudforkSSO) project latestVersion load: 'Tests' When I try to evaluate the piece of code that follows, 1 self default httpClient: ((CFHttpClientTunnelAccess new) 2 client: CFHttpClientZincAccess new ; 3 tunnel: 'www.google.com' through: 'localhost:20011' ; 4 tunnel: 'api.twitter.com' through: 'localhost:20012'; 5 tunnel: 'graph.facebook.com' through:'localhost:20013' ; 6 tunnel: 'open.login.yahooapis.com' through:'localhost:20014' ; 7 tunnel: 'openid.hyves-api.nl' through:'localhost:20015' ; 8 yourself ) I found CFHttpClientTunnelAccess class is not in my image. Browsing, I found CFTunneledHttpClient, but the protocol of this class is different from the missing one. Furthermore, I don't understand where this code should be located, so that self reference makes sense. I'm using Pharo 1.3 , as I think it is the Pharo version contemporary with this package and post. Is there some updated documentation for this? is someone using this package or connecting to twitter from pharo? Thanks af

Oct. 6, 2012

Re: [Pharo-users] Polling sockets

by Mariano Martinez Peck

On Fri, Oct 5, 2012 at 12:59 PM, Sven Van Caekenberghe <sven(a)stfx.eu> wrote: > On 05 Oct 2012, at 12:47, Santiago Bragagnolo < > santiagobragagnolo(a)gmail.com> wrote: > > > Hi guys, theres something like the select or poll C functions in order > to wait for incoming-data from a set of sockets? I searched at the list and > in the pharo by example book without any success and i didn't find a method > named poll / select ( select in terms of sockets ) in the image. > > As far as I know there is no such primitive. It would be very nice to have > though, it is one of the building blocks to do asynchroneous IO. But this > is just one way to do polling. > > > Maybe i need to spawn a process per socket? > > > Indeed, this would be the classic way to do it: just do a blocking read > until ConnectionTimedOut and loop. > Yes, in DBXTalk we do more or less the same: processNextResultSet: aConnection querySettings: aQuerySettings "Gets the next resultSet of the query. Depending on the type of query, it will return a DBXResult or DBXResultSet. If there is a timeout, it will cicle till this is finished." | returnCode | [self nextResultSet: aConnection querySettings: aQuerySettings onReturn: [:handle :code | returnCode := code. code = OpenDBX resultWithRows ifTrue: [ ^ self processResultWithRows: aConnection resultHandle: handle querySettings: aQuerySettings]. code = OpenDBX resultWithoutRows ifTrue: [ ^ self processResultWithoutRows: aConnection resultHandle: handle querySettings: aQuerySettings]. code = OpenDBX resultDone ifTrue: [^ nil]. (code = OpenDBX resultTimeout) ifTrue: [ (Delay forMilliseconds: (aQuerySettings timeout asMiliseconds)) wait ]. ]] doWhileTrue: [returnCode = OpenDBX resultTimeout]. OpenDBXDriverError signal: 'Uknown problem with executeStatement'. > > You could experiment with #isDataAvailable and/or very short timeouts to > service more connections with one thread, but that won't be easy (you would > be at the mercy of the primitives with their subtle platform differences). > > -- > Sven Van Caekenberghe > http://stfx.eu > Smalltalk is the Red Pill > > > -- Mariano http://marianopeck.wordpress.com

Oct. 5, 2012

Re: [Pharo-users] Polling sockets

by David T. Lewis

On Fri, Oct 05, 2012 at 12:47:55PM +0200, Santiago Bragagnolo wrote: > Hi guys, theres something like the select or poll C functions in order to > wait for incoming-data from a set of sockets? I searched at the list and in > the pharo by example book without any success and i didn't find a method > named poll / select ( select in terms of sockets ) in the image. > > Maybe i need to spawn a process per socket? > See AioEventHandlerExample and AioEventHandlerTestCase in OSProcess. The primitives are in AioPlugin (http://www.squeaksource.com/AioPlugin/) which connects to the low level select() implementation that Ian Piumarta developed for the unix VMs. I think that this works on Mac and on Cog VMs also if the plugin is provided (but it will not work on Windows). Note that the socket that you use in the image may already be using select() to respond to incoming data. HTH, Dave

Oct. 5, 2012

Re: [Pharo-users] Polling sockets

by Sven Van Caekenberghe

On 05 Oct 2012, at 12:47, Santiago Bragagnolo <santiagobragagnolo(a)gmail.com> wrote: > Hi guys, theres something like the select or poll C functions in order to wait for incoming-data from a set of sockets? I searched at the list and in the pharo by example book without any success and i didn't find a method named poll / select ( select in terms of sockets ) in the image. As far as I know there is no such primitive. It would be very nice to have though, it is one of the building blocks to do asynchroneous IO. But this is just one way to do polling. > Maybe i need to spawn a process per socket? Indeed, this would be the classic way to do it: just do a blocking read until ConnectionTimedOut and loop. You could experiment with #isDataAvailable and/or very short timeouts to service more connections with one thread, but that won't be easy (you would be at the mercy of the primitives with their subtle platform differences). -- Sven Van Caekenberghe http://stfx.eu Smalltalk is the Red Pill

Oct. 5, 2012