Return-Path: X-Original-To: apmail-flink-dev-archive@www.apache.org Delivered-To: apmail-flink-dev-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 0A4C51156F for ; Thu, 11 Sep 2014 13:32:28 +0000 (UTC) Received: (qmail 24362 invoked by uid 500); 11 Sep 2014 13:32:27 -0000 Delivered-To: apmail-flink-dev-archive@flink.apache.org Received: (qmail 24295 invoked by uid 500); 11 Sep 2014 13:32:27 -0000 Mailing-List: contact dev-help@flink.incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@flink.incubator.apache.org Delivered-To: mailing list dev@flink.incubator.apache.org Received: (qmail 24278 invoked by uid 99); 11 Sep 2014 13:32:27 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 11 Sep 2014 13:32:27 +0000 X-ASF-Spam-Status: No, hits=-1999.5 required=5.0 tests=ALL_TRUSTED,HTML_MESSAGE,RP_MATCHES_RCVD X-Spam-Check-By: apache.org Received: from [140.211.11.3] (HELO mail.apache.org) (140.211.11.3) by apache.org (qpsmtpd/0.29) with SMTP; Thu, 11 Sep 2014 13:32:24 +0000 Received: (qmail 23209 invoked by uid 99); 11 Sep 2014 13:32:04 -0000 Received: from minotaur.apache.org (HELO minotaur.apache.org) (140.211.11.9) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 11 Sep 2014 13:32:04 +0000 Received: from localhost (HELO mail-yh0-f47.google.com) (127.0.0.1) (smtp-auth username fhueske, mechanism plain) by minotaur.apache.org (qpsmtpd/0.29) with ESMTP; Thu, 11 Sep 2014 13:32:03 +0000 Received: by mail-yh0-f47.google.com with SMTP id f10so2167912yha.6 for ; Thu, 11 Sep 2014 06:32:02 -0700 (PDT) MIME-Version: 1.0 X-Received: by 10.236.65.133 with SMTP id f5mr1238428yhd.66.1410442322812; Thu, 11 Sep 2014 06:32:02 -0700 (PDT) Received: by 10.170.145.136 with HTTP; Thu, 11 Sep 2014 06:32:02 -0700 (PDT) In-Reply-To: References: Date: Thu, 11 Sep 2014 15:32:02 +0200 Message-ID: Subject: Re: Scala API rewrite almost complete From: Fabian Hueske To: dev@flink.incubator.apache.org Content-Type: multipart/alternative; boundary=001a11c3d980a0a5c70502ca31a7 X-Virus-Checked: Checked by ClamAV on apache.org --001a11c3d980a0a5c70502ca31a7 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable +1 for removing RelationalQuery IMO, the Scala examples should mirror the Java examples. So, we should rather port Java examples to Scala instead of updating existing Scala examples. I am also done with the PageRank implementation. Final tests are currently running and I'll open a PR soon. I found some things that need to be solved or should at least be mentioned in the documentation: - It is crucial to import org.apache.flink.api.scala._. Eclipse shows many errors regarding type extraction but does not help to solve the problem by adding this import. - The method ExecutionEnvironment.generateSequence appears to be missing in Scala ExecutionEnvironment - It is not possible to use arrays of Scala primitives such as Int, Long which are mapped to Java Primitives int, long. Instead you need to force Java types, e.g., Array[java.lang.Long]. - It is not possible to use Scala List. List is a Trait and considered to be an Interface which is not supported by the TypeExtractor. Cheers, Fabian 2014-09-11 15:04 GMT+02:00 Aljoscha Krettek : > By the way, what was called BatchGradientDescent in the Scala examples > should be replaced by a port of the LinearRegression Example from > Java. I had them as two separate examples earlier. > > What about RelationalQuery and TPC-H-Q3. Any thoughts about removing > RelationalQuery? > > On Thu, Sep 11, 2014 at 11:43 AM, Aljoscha Krettek > wrote: > > I added the Triangle Enumeration Examples, thanks Fabian. > > > > So far we have ported: WordCount, KMeans, ConnectedComponents, > > WebLogAnalysis, TransitiveClosureNaive, TriangleEnumerationNaive/Opt > > > > These are the examples people called dibs on: > > - PageRank (Fabian) > > - BatchGradientDescent (M=C3=A1rton) > > - ComputeEdgeDegrees (Hermann) > > > > Those are unclaimed (if I'm not mistaken): > > - The relational Stuff > > - LinearRegression > > > > On Wed, Sep 10, 2014 at 6:04 PM, Aljoscha Krettek > wrote: > >> Thanks, I added it. I'll keep a running list of ported/unported > >> examples in my mails. I'll rename the java example package to examples > >> once the Scala API merge is done. > >> > >> I think the termination criterion is fine as it is. Just because Scala > >> enables functional programming doesn't mean it's always the best > >> choice. :D > >> > >> So far we have ported: WordCount, KMeans, ConnectedComponents, > >> WebLogAnalysis, TransitiveClosureNaive > >> > >> These are the examples people called dibs on: > >> - TriangleEnumration and PageRank (Fabian) > >> - BatchGradientDescent (M=C3=A1rton) > >> - ComputeEdgeDegrees (Hermann) > >> > >> Those are unclaimed (if I'm not mistaken): > >> - The relational Stuff > >> - LinearRegression > >> > >> Cheers, > >> Aljoscha > >> > >> On Wed, Sep 10, 2014 at 4:23 PM, Kostas Tzoumas > wrote: > >>> Transitive closure here, I also added a termination criterion in the > Java > >>> version: > https://github.com/ktzoumas/incubator-flink/tree/tc-scala-example > >>> > >>> Perhaps you can make the termination criterion in Scala more > functional? > >>> > >>> I noticed that the examples package name is example.java but > examples.scala > >>> > >>> Kostas > >>> > >>> On Tue, Sep 9, 2014 at 6:12 PM, Kostas Tzoumas > wrote: > >>>> > >>>> I'll take TransitiveClosure and PiEstimation (was not on your list). > >>>> > >>>> If nobody volunteers for the relational stuff I can take those as > well. > >>>> > >>>> How about removing the "RelationalQuery" from both Scala and Java? I= t > >>>> seems to be a proper subset of TPC-H Q3. Does it add some teaching > value on > >>>> top of TPC-H Q3? > >>>> > >>>> Kostas > >>>> > >>>> On Tue, Sep 9, 2014 at 5:57 PM, Aljoscha Krettek > > >>>> wrote: > >>>>> > >>>>> Thanks, I added it, along with an ITCase. > >>>>> > >>>>> So far we have ported: WordCount, KMeans, ConnectedComponents, > >>>>> WebLogAnalysis > >>>>> > >>>>> These are the examples people called dibs on: > >>>>> - TriangleEnumration and PageRank (Fabian) > >>>>> - BatchGradientDescent (M=C3=A1rton) > >>>>> - ComputeEdgeDegrees (Hermann) > >>>>> > >>>>> Those are unclaimed (if I'm not mistaken): > >>>>> - TransitiveClosure > >>>>> - The relational Stuff > >>>>> - LinearRegression > >>>>> > >>>>> Cheers, > >>>>> Aljoscha > >>>>> > >>>>> On Tue, Sep 9, 2014 at 5:21 PM, Kostas Tzoumas > >>>>> wrote: > >>>>> > WebLog here: > >>>>> > > >>>>> > > https://github.com/ktzoumas/incubator-flink/tree/webloganalysis-example-s= cala > >>>>> > > >>>>> > Do you need any more done? > >>>>> > > >>>>> > On Tue, Sep 9, 2014 at 3:08 PM, Aljoscha Krettek < > aljoscha@apache.org> > >>>>> > wrote: > >>>>> > > >>>>> >> I added the ConnectedComponents Example from Vasia. > >>>>> >> > >>>>> >> Keep 'em coming, people. :D > >>>>> >> > >>>>> >> On Mon, Sep 8, 2014 at 6:07 PM, Fabian Hueske > > >>>>> >> wrote: > >>>>> >> > Alright, will do. > >>>>> >> > Thanks! > >>>>> >> > > >>>>> >> > 2014-09-08 17:48 GMT+02:00 Aljoscha Krettek < > aljoscha@apache.org>: > >>>>> >> > > >>>>> >> >> Ok people, executive decision. :D > >>>>> >> >> > >>>>> >> >> Please look at KMeansData.java and KMeans.scala. I'm storing > the > >>>>> >> >> data > >>>>> >> >> in multi-dimensional object arrays and then converting it to > the > >>>>> >> >> required Java or Scala objects. > >>>>> >> >> > >>>>> >> >> Also, I changed isEqualTo to equalTo to make it consistent > with the > >>>>> >> >> Java > >>>>> >> >> API. > >>>>> >> >> > >>>>> >> >> Regarding Join (and coGroup). There is no need for a keyword, > you > >>>>> >> >> can > >>>>> >> >> just write: > >>>>> >> >> > >>>>> >> >> left.join(right).where(0).equalTo(1) { (le, re) =3D> new > MyResult(le, > >>>>> >> >> re) > >>>>> >> } > >>>>> >> >> > >>>>> >> >> On Mon, Sep 8, 2014 at 2:07 PM, Fabian Hueske < > fhueske@apache.org> > >>>>> >> wrote: > >>>>> >> >> > Aside from the DataSet issue, I also found an inconsistency > with > >>>>> >> >> > the > >>>>> >> Java > >>>>> >> >> > API. In Java join is done as: > >>>>> >> >> > > >>>>> >> >> > ds1.join(ds2).where(...).equalTo(...) > >>>>> >> >> > > >>>>> >> >> > where in the current Scala this is: > >>>>> >> >> > > >>>>> >> >> > ds1.join(d2).where(...).isEqualTo(...) > >>>>> >> >> > > >>>>> >> >> > isEqualTo() should be renamed to equalTo(), IMO. > >>>>> >> >> > Also, join (+cross and coGroup?) lacks the with() method > because > >>>>> >> "with" > >>>>> >> >> is > >>>>> >> >> > a keyword in Scala. Should be offer something similar for > Scala > >>>>> >> >> > or go > >>>>> >> >> with > >>>>> >> >> > map() on Tuple2(left, right)? > >>>>> >> >> > > >>>>> >> >> > 2014-09-08 13:51 GMT+02:00 Stephan Ewen : > >>>>> >> >> > > >>>>> >> >> >> Instead of Strings, Object[][] would work as well. That is= a > >>>>> >> >> >> generic > >>>>> >> >> >> representation of a Tuple. > >>>>> >> >> >> > >>>>> >> >> >> Alternatively, they could be stored as Java or Scala Tuple= s, > >>>>> >> >> >> with a > >>>>> >> >> generic > >>>>> >> >> >> utility method to convert between the two. > >>>>> >> >> >> > >>>>> >> >> >> On Mon, Sep 8, 2014 at 10:55 AM, Fabian Hueske > >>>>> >> >> >> > >>>>> >> >> wrote: > >>>>> >> >> >> > >>>>> >> >> >> > Yeah, I ran into the same problem... > >>>>> >> >> >> > > >>>>> >> >> >> > +1 for using Strings and parsing them, but using the > >>>>> >> >> >> > CSVFormat > >>>>> >> won't > >>>>> >> >> >> work > >>>>> >> >> >> > because this is based on a FileInputFormat. > >>>>> >> >> >> > So we would need to parse the Strings manually... > >>>>> >> >> >> > > >>>>> >> >> >> > 2014-09-08 10:35 GMT+02:00 Aljoscha Krettek > >>>>> >> >> >> > : > >>>>> >> >> >> > > >>>>> >> >> >> > > Hi, > >>>>> >> >> >> > > on second thought. Maybe we should just change all the > >>>>> >> >> >> > > example > >>>>> >> input > >>>>> >> >> >> > > data to strings and use CSV input formats in all the > >>>>> >> >> >> > > examples. > >>>>> >> What > >>>>> >> >> do > >>>>> >> >> >> > > you think? > >>>>> >> >> >> > > > >>>>> >> >> >> > > Cheers, > >>>>> >> >> >> > > Aljoscha > >>>>> >> >> >> > > > >>>>> >> >> >> > > On Mon, Sep 8, 2014 at 7:46 AM, Aljoscha Krettek < > >>>>> >> >> aljoscha@apache.org> > >>>>> >> >> >> > > wrote: > >>>>> >> >> >> > > > Hi, > >>>>> >> >> >> > > > yes it's unfortunate that the data types are > incompatible. > >>>>> >> >> >> > > > I'm > >>>>> >> >> afraid > >>>>> >> >> >> > > > you have to to what you proposed: move the data to a > >>>>> >> >> >> > > > static > >>>>> >> field > >>>>> >> >> and > >>>>> >> >> >> > > > convert it in the getDefaultEdgeDataSet() method in > Scala. > >>>>> >> >> >> > > > It's > >>>>> >> >> not > >>>>> >> >> >> > > > nice, but copying would duplicate the data and make = it > >>>>> >> >> >> > > > easier > >>>>> >> for > >>>>> >> >> it > >>>>> >> >> >> > > > to go out of sync in the Java and Scala versions. > >>>>> >> >> >> > > > > >>>>> >> >> >> > > > What do the others think? This will probably occur i= n > all > >>>>> >> >> >> > > > the > >>>>> >> >> >> examples. > >>>>> >> >> >> > > > > >>>>> >> >> >> > > > Cheers, > >>>>> >> >> >> > > > Aljoscha > >>>>> >> >> >> > > > > >>>>> >> >> >> > > > On Sun, Sep 7, 2014 at 10:04 PM, Vasiliki Kalavri > >>>>> >> >> >> > > > wrote: > >>>>> >> >> >> > > >> Hey, > >>>>> >> >> >> > > >> > >>>>> >> >> >> > > >> I have ported the Connected Components example, but > I am > >>>>> >> >> >> > > >> not > >>>>> >> sure > >>>>> >> >> >> how > >>>>> >> >> >> > to > >>>>> >> >> >> > > >> reuse the example input data from java-examples. > >>>>> >> >> >> > > >> In the ConnectedComponentsData class, the vertices > and > >>>>> >> >> >> > > >> edges > >>>>> >> data > >>>>> >> >> >> are > >>>>> >> >> >> > > >> produced by the methods getDefaultVertexDataSet() > >>>>> >> >> >> > > >> and getDefaultEdgeDataSet(), which take > >>>>> >> >> >> > > >> an org.apache.flink.api.java.ExecutionEnvironment a= s > >>>>> >> parameter. > >>>>> >> >> >> > > >> > >>>>> >> >> >> > > >> One way is to provide public static fields (like in > the > >>>>> >> >> >> WordCountData > >>>>> >> >> >> > > >> class), but this introduces a conversion > >>>>> >> >> >> > > >> from org.apache.flink.api.java.tuple.Tuple2 to Scal= a > >>>>> >> >> >> > > >> tuple and > >>>>> >> >> from > >>>>> >> >> >> > > >> java.lang.Long to scala.Long and I guess this is an > >>>>> >> unnecessary > >>>>> >> >> >> > > complexity > >>>>> >> >> >> > > >> for an example (?). > >>>>> >> >> >> > > >> Another way is, of course, to copy the example data > in > >>>>> >> >> >> > > >> the > >>>>> >> Scala > >>>>> >> >> >> > > example. > >>>>> >> >> >> > > >> > >>>>> >> >> >> > > >> Am I missing something here? > >>>>> >> >> >> > > >> > >>>>> >> >> >> > > >> Thanks! > >>>>> >> >> >> > > >> > >>>>> >> >> >> > > >> Cheers, > >>>>> >> >> >> > > >> V. > >>>>> >> >> >> > > >> > >>>>> >> >> >> > > >> > >>>>> >> >> >> > > >> On 5 September 2014 15:52, Aljoscha Krettek < > >>>>> >> aljoscha@apache.org > >>>>> >> >> > > >>>>> >> >> >> > > wrote: > >>>>> >> >> >> > > >> > >>>>> >> >> >> > > >>> Alright, I updated my repo: > >>>>> >> >> >> > > >>> > >>>>> >> >> > https://github.com/aljoscha/incubator-flink/commits/scala-rework > >>>>> >> >> >> > > >>> > >>>>> >> >> >> > > >>> This now has a working WordCount example. It's > pretty > >>>>> >> >> >> > > >>> much a > >>>>> >> >> copy > >>>>> >> >> >> of > >>>>> >> >> >> > > >>> the Java example with some fixups for the syntax a= nd > >>>>> >> >> >> > > >>> lambda > >>>>> >> >> >> > functions. > >>>>> >> >> >> > > >>> You'll also notice that I added the java-examples > as a > >>>>> >> >> dependency > >>>>> >> >> >> for > >>>>> >> >> >> > > >>> the scala-examples. I did this to reuse the exampl= e > >>>>> >> >> >> > > >>> input > >>>>> >> data. > >>>>> >> >> >> > > >>> > >>>>> >> >> >> > > >>> When you ported a program you can do a pull reques= t > >>>>> >> >> >> > > >>> against > >>>>> >> my > >>>>> >> >> repo > >>>>> >> >> >> > > >>> and I will collect the examples. > >>>>> >> >> >> > > >>> > >>>>> >> >> >> > > >>> Happy coding. :D > >>>>> >> >> >> > > >>> > >>>>> >> >> >> > > >>> On Fri, Sep 5, 2014 at 12:19 PM, Hermann G=C3=A1bo= r < > >>>>> >> >> >> reckoner42@gmail.com > >>>>> >> >> >> > > > >>>>> >> >> >> > > >>> wrote: > >>>>> >> >> >> > > >>> > +1 > >>>>> >> >> >> > > >>> > > >>>>> >> >> >> > > >>> > ComputeEdgeDegrees for me! > >>>>> >> >> >> > > >>> > > >>>>> >> >> >> > > >>> > > >>>>> >> >> >> > > >>> > On Fri, Sep 5, 2014 at 11:44 AM, M=C3=A1rton Bal= assi < > >>>>> >> >> >> > > >>> balassi.marton@gmail.com> > >>>>> >> >> >> > > >>> > wrote: > >>>>> >> >> >> > > >>> > > >>>>> >> >> >> > > >>> >> +1 > >>>>> >> >> >> > > >>> >> > >>>>> >> >> >> > > >>> >> BatchGradientDescent for me :) > >>>>> >> >> >> > > >>> >> > >>>>> >> >> >> > > >>> >> > >>>>> >> >> >> > > >>> >> On Fri, Sep 5, 2014 at 11:15 AM, Kostas Tzoumas= < > >>>>> >> >> >> > > ktzoumas@apache.org> > >>>>> >> >> >> > > >>> >> wrote: > >>>>> >> >> >> > > >>> >> > >>>>> >> >> >> > > >>> >> > +1 > >>>>> >> >> >> > > >>> >> > > >>>>> >> >> >> > > >>> >> > I go for WebLogAnalysis. > >>>>> >> >> >> > > >>> >> > > >>>>> >> >> >> > > >>> >> > My experience with Scala consists of going > through > >>>>> >> >> >> > > >>> >> > a > >>>>> >> >> tutorial > >>>>> >> >> >> so > >>>>> >> >> >> > > this > >>>>> >> >> >> > > >>> >> will > >>>>> >> >> >> > > >>> >> > be a good stress test both for me and the new > API > >>>>> >> >> >> > > >>> >> > :-) > >>>>> >> >> >> > > >>> >> > > >>>>> >> >> >> > > >>> >> > > >>>>> >> >> >> > > >>> >> > On Thu, Sep 4, 2014 at 9:09 PM, Vasiliki > Kalavri < > >>>>> >> >> >> > > >>> >> > vasilikikalavri@gmail.com> > >>>>> >> >> >> > > >>> >> > wrote: > >>>>> >> >> >> > > >>> >> > > >>>>> >> >> >> > > >>> >> > > +1 for having other people implement the > >>>>> >> >> >> > > >>> >> > > examples! > >>>>> >> >> >> > > >>> >> > > Connected Components and Kmeans for me :) > >>>>> >> >> >> > > >>> >> > > > >>>>> >> >> >> > > >>> >> > > -V. > >>>>> >> >> >> > > >>> >> > > > >>>>> >> >> >> > > >>> >> > > > >>>>> >> >> >> > > >>> >> > > On 4 September 2014 21:03, Fabian Hueske < > >>>>> >> >> >> fhueske@apache.org> > >>>>> >> >> >> > > >>> wrote: > >>>>> >> >> >> > > >>> >> > > > >>>>> >> >> >> > > >>> >> > > > I go for TriangleEnumeration and PageRank= . > >>>>> >> >> >> > > >>> >> > > > > >>>>> >> >> >> > > >>> >> > > > Let's also do the examples similar to the > Java > >>>>> >> >> examples: > >>>>> >> >> >> > > >>> >> > > > - running out-of-the-box without paramete= rs > >>>>> >> >> >> > > >>> >> > > > - parameters for external data > >>>>> >> >> >> > > >>> >> > > > - follow a similar code structure > >>>>> >> >> >> > > >>> >> > > > > >>>>> >> >> >> > > >>> >> > > > > >>>>> >> >> >> > > >>> >> > > > > >>>>> >> >> >> > > >>> >> > > > 2014-09-04 20:56 GMT+02:00 Aljoscha > Krettek < > >>>>> >> >> >> > > aljoscha@apache.org > >>>>> >> >> >> > > >>> >: > >>>>> >> >> >> > > >>> >> > > > > >>>>> >> >> >> > > >>> >> > > > > Will do, then people can reserve their > >>>>> >> >> >> > > >>> >> > > > > favourite > >>>>> >> >> >> examples > >>>>> >> >> >> > > here. > >>>>> >> >> >> > > >>> >> > > > > > >>>>> >> >> >> > > >>> >> > > > > On Thu, Sep 4, 2014 at 8:55 PM, Fabian > Hueske > >>>>> >> >> >> > > >>> >> > > > > < > >>>>> >> >> >> > > >>> fhueske@apache.org> > >>>>> >> >> >> > > >>> >> > > > wrote: > >>>>> >> >> >> > > >>> >> > > > > > Hi, > >>>>> >> >> >> > > >>> >> > > > > > > >>>>> >> >> >> > > >>> >> > > > > > I think having examples implemented b= y > >>>>> >> >> >> > > >>> >> > > > > > different > >>>>> >> >> >> people > >>>>> >> >> >> > > >>> proved to > >>>>> >> >> >> > > >>> >> > be > >>>>> >> >> >> > > >>> >> > > > > > valuable in the past. > >>>>> >> >> >> > > >>> >> > > > > > I'd help with two or three examples. > >>>>> >> >> >> > > >>> >> > > > > > > >>>>> >> >> >> > > >>> >> > > > > > It might be helpful if you'd port a > simple > >>>>> >> >> >> > > >>> >> > > > > > first > >>>>> >> >> one > >>>>> >> >> >> > such > >>>>> >> >> >> > > as > >>>>> >> >> >> > > >>> >> > > WordCount. > >>>>> >> >> >> > > >>> >> > > > > > > >>>>> >> >> >> > > >>> >> > > > > > Fabian > >>>>> >> >> >> > > >>> >> > > > > > > >>>>> >> >> >> > > >>> >> > > > > > > >>>>> >> >> >> > > >>> >> > > > > > 2014-09-04 18:47 GMT+02:00 Aljoscha > Krettek > >>>>> >> >> >> > > >>> >> > > > > > < > >>>>> >> >> >> > > >>> aljoscha@apache.org > >>>>> >> >> >> > > >>> >> >: > >>>>> >> >> >> > > >>> >> > > > > > > >>>>> >> >> >> > > >>> >> > > > > >> Hi, > >>>>> >> >> >> > > >>> >> > > > > >> I have a working rewrite of the Scal= a > API > >>>>> >> >> >> > > >>> >> > > > > >> here: > >>>>> >> >> >> > > >>> >> > > > > >> > >>>>> >> >> >> > > >>> >> > >>>>> >> >> >> > https://github.com/aljoscha/incubator-flink/commits/scala-rework > >>>>> >> >> >> > > >>> >> > > > > >> > >>>>> >> >> >> > > >>> >> > > > > >> I'm hoping that I'll only have to > write > >>>>> >> >> >> > > >>> >> > > > > >> the > >>>>> >> tests > >>>>> >> >> and > >>>>> >> >> >> > > port > >>>>> >> >> >> > > >>> the > >>>>> >> >> >> > > >>> >> > > > > >> examples. Do you think it makes sens= e > to > >>>>> >> >> >> > > >>> >> > > > > >> let > >>>>> >> other > >>>>> >> >> >> > people > >>>>> >> >> >> > > >>> port > >>>>> >> >> >> > > >>> >> the > >>>>> >> >> >> > > >>> >> > > > > >> examples, so that someone else uses > it and > >>>>> >> maybe > >>>>> >> >> >> > notices > >>>>> >> >> >> > > some > >>>>> >> >> >> > > >>> >> > quirks > >>>>> >> >> >> > > >>> >> > > > > >> in the API? > >>>>> >> >> >> > > >>> >> > > > > >> > >>>>> >> >> >> > > >>> >> > > > > >> Cheers, > >>>>> >> >> >> > > >>> >> > > > > >> Aljoscha > >>>>> >> >> >> > > >>> >> > > > > >> > >>>>> >> >> >> > > >>> >> > > > > > >>>>> >> >> >> > > >>> >> > > > > >>>>> >> >> >> > > >>> >> > > > >>>>> >> >> >> > > >>> >> > > >>>>> >> >> >> > > >>> >> > >>>>> >> >> >> > > >>> > >>>>> >> >> >> > > > >>>>> >> >> >> > > >>>>> >> >> >> > >>>>> >> >> > >>>>> >> > >>>> > >>>> > >>> > --001a11c3d980a0a5c70502ca31a7--