incubator-giraph-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Avery Ching (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (GIRAPH-22) Sort out examples from unit test helpers in examples package
Date Wed, 31 Aug 2011 21:12:10 GMT

    [ https://issues.apache.org/jira/browse/GIRAPH-22?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13094901#comment-13094901
] 

Avery Ching commented on GIRAPH-22:
-----------------------------------

Good idea.  I think a few of them are full programs though.  Not sure about the best way to
do this.

> Sort out examples from unit test helpers in examples package
> ------------------------------------------------------------
>
>                 Key: GIRAPH-22
>                 URL: https://issues.apache.org/jira/browse/GIRAPH-22
>             Project: Giraph
>          Issue Type: Improvement
>            Reporter: Jakob Homan
>
> Within src/examples there are quite a few files defined that are mainly used in unit
or other tests:
> * GeneratedVertexInputFormat
> * GeneratedVertexInputFormat
> * LongSumAggregator
> * MaxAggregator
> * MinAggregator
> * SimpleCombinerVertex
> * SimpleFailVertex
> * SimpleMsgVertex
> * SimpleMutateGraphVertex
> * SimpleSumCombiner
> * SumAggregator
> * SuperstepBalancer
> Several of these explicitly say they're designed to aid in unit testing.  If these are
indeed meant for testing, they should be moved to the test directory.  If they're examples,
it would be better to sort out the overly complicated ones and ones that include lots of tests
and asserts, so only to show the essence of the example.  Hopefully the examples directory
have a few, very heavily documented programs of the helloworld/word count/shortest path variety
(with sample inputs) that can be quickly launched.  Once new developers grok these, they can
turn to the unit tests, which can of course be great sources to learn the code from.

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

Mime
View raw message