From JGSmith at TAMU.Edu  Sun May 16 13:21:45 2004
From: JGSmith at TAMU.Edu (James G Smith)
Date: Mon Aug  2 21:29:26 2004
Subject: [Dahut-pm] [RFC] Test reporting framework
Message-ID: <200405161821.i4GILjx5001109@moya.tamu.edu>

A few weeks ago, I received a new supervisor.  I haven't changed jobs
or positions, but my previous supervisor had too many direct reports,
so he hired someone to take care of the application developers.

After talking with this new person about my work (especially the
application framework that saw it's broken 0.01 release a couple
months ago), he suggested that I put together some reports that show
dependencies between parts of the project and how far along we are on
those parts.  This would help us demonstrate a need for more people
working on the project as well as show where they could work.

Being a lazy Perl programmer, I didn't want to write information down
twice, so I have developed a set of scripts that do a lot of the work
for me.

I'm thinking about putting a lot of this together into a package for
CPAN.  I'm looking for feedback in a number of areas: naming of
package, information in reports, anything else that might be useful
that I haven't thought about.  I'm toying with the idea of adding
benchmarking capabilities similar to the tests embedded in Pod.  We
could probably do some blame tracking (who last touched a method,
etc.) using CVS.


  make_spec.pl

This is a script that will go through any existing specification that
might have been created by this script before, any modules listed on
the command line, and the MANIFEST (looking for files beginning with
lib/).  It will then create the spec.xml file which lists all the
modules, their dependencies within the project, and their public
methods.

For example:

<specification>
  <module name="Gestinanna::Util">   
    <interface>
      <method name="path2regex"/>
      <method name="path_cmp">
        <dependence method="path2regex"/>
      </method>
    </interface>
  </module>
  <module name="Gestinanna::Authz">
    <interface>
      <constructor/>
      <method name="can_grant"/>  
      <method name="fetch_acls"/>
      <method name="grant"/>
      <method name="has_attribute"/>
      <method name="query_acls"/>
      <method name="query_attributes"/>
      <method name="query_point_attributes"/>
      <method name="set_point_attributes"/>
    </interface>
    <dependence module="Gestinanna::Util"/>
    <dependence module="Gestinanna::Schema"/>
  </module>
</specification>

This documents that I have to test path2regex before testing path_cmp
since path_cmp depends on path2regex.  The method dependencies have
to be entered by hand.  The module dependencies do not if they are
documented with a `use' statement in the code.  The default
constructor is `new'.  If a module has constructors, they are tested
first at the moment.


  make_tests.pl

This script will generate all the t/ tests based on the
specification, honoring the module dependencies.  A module is only
tested after its dependencies are tested.  The methods/functions
within a module are done likewise.  Test results are tallied on a
per-method/function basis even though all the functions in a module
are tested in one file (beauty of Test::Builder and Module::Build :).

Additional tests are created to test module compilation, pod
correctness and coverage, and to handle any cleanup required after
running the tests.

Tests are pulled from the specification file and the module Pod.  The
Pod is processed using Pod::Tests.  Documentation coverage is handled
by Pod::Cover.

I do have a few special symbols for tests embedded in Pod.
__OBJECT__ is the default object created by the constructor test.
__PACKAGE__ is the package being tested; the tests run in main::.


  make_crc.pl

This script generates a series of reports based on the test results.
An example can be seen at
http://gorgik.tamu.edu/gestinanna/crc/index.html .  We use Perl::Tidy
to handle the line counts.  Gestinanna::Util is completely tested and
documented.  Gestinanna::Authz demonstrates a module with
constructors, and both public and private methods being tested.
--
James Smith <JGSmith@TAMU.Edu>, 979-862-3725
Senior Software Applications Developer,
Texas A&M CIS Operating Systems Group, Unix

From chris at prather.org  Tue May 18 23:43:21 2004
From: chris at prather.org (Chris)
Date: Mon Aug  2 21:29:26 2004
Subject: [Dahut-pm] Questions ... 
Message-ID: <20040519044140.M41114@prather.org>


Hey All,

I was thinking of Registering Dahut.pm as a user group with Ora
(http://ug.oreilly.com/) and wanted your take on some of the questions.
Technically Bender will be registering the group so the contact info I can
deal with.

Contact First Name: *    
Bender

Contact Last Name: *    
Unit

Position: *    
Leader

User Group Name: *    
Dahut.pm

Shipping Address: *    
[CENSORED]

City: *    
St. Paul

State: *    
MN

Zip: *    
55101

Country:    
USA

Phone: * (For shipping purposes only)
651-269-6P0T

Email: *
Bender@dahut.pm.org

Do you prefer email or snailmail? *    
Email  (Bender can't read snailmail because I don't have a scanner)

URL:    
http://dahut.pm.org

Meeting Date: * (ie. "2nd Tuesday")    
1st OSCON of every year. (???)

Meeting Time: *    
???

Meeting Location: * 
???

Size of membership: *    
erm ... 15 I think ... plus some lurkers who didn't give Long/Lat when Darobin
was offering free beer.

Average number of members that attend meetings: *    
we currently have had 100% attendance at all of our meetings to date.

Group Interests/Topics: * (Unix, Linux, Perl, Oracle, Mac, etc.)    
Perl, Alpine Mythological Beasts, XML, Non-Cabal-Activities, Left Handedness,
Right Handedness, AxKit...

Do you have a print newsletter? *
No

Do you have an email mailing list? *
Yes

Do you have a group library? *
???

Does your User Group participate in tradeshows or conferences? *     Yes No
Yes

If so, which ones?    
There are too many for me to list I think...

Does your User Group publish book/software reviews? *     Yes No
???

Does your User Group produce any special events? *     Yes No
???

If so, what and when?    
???

Do you want to receive a weekly newsletter from the UG program with news and
info from O'Reilly and other sources? *    

Yes (Bender won't care)

Do you want O'Reilly catalogs for your members on a quarterly basis? *  
No. how would we pass them out?

If so, how many?

Any ideas on these or other questions in the form?
???


Being a member of a Ora user group gives 20% off on Conferences and Products.
If there's any opposition to my doing this, please bring it up now. Else I'll
submit this when I can.

-Chris

--
Prather.org (powered by OpenWebmail, Perl, and Apache)



From mirod at xmltwig.com  Tue May 18 09:49:14 2004
From: mirod at xmltwig.com (Michel Rodriguez)
Date: Mon Aug  2 21:29:26 2004
Subject: [Dahut-pm] Questions ... 
In-Reply-To: <20040519044140.M41114@prather.org>
References: <20040519044140.M41114@prather.org>
Message-ID: <Pine.LNX.4.58.0405181046260.13086@mirlin.xmltwig.com>

On Tue, 18 May 2004, Chris wrote:

> Group Interests/Topics: * (Unix, Linux, Perl, Oracle, Mac, etc.)    
> Perl, Alpine Mythological Beasts, XML, Non-Cabal-Activities, Left Handedness,
> Right Handedness, AxKit...

I would replace XML by just SAX, which is more accurate, on top of being
obviously technically superior.


--
Michel Rodriguez
Perl &amp; XML
http://www.xmltwig.com

From robin.berjon at expway.fr  Tue May 18 10:18:02 2004
From: robin.berjon at expway.fr (Robin Berjon)
Date: Mon Aug  2 21:29:26 2004
Subject: [Dahut-pm] Questions ...
In-Reply-To: <Pine.LNX.4.58.0405181046260.13086@mirlin.xmltwig.com>
References: <20040519044140.M41114@prather.org>
	<Pine.LNX.4.58.0405181046260.13086@mirlin.xmltwig.com>
Message-ID: <40AA292A.8030106@expway.fr>

Michel Rodriguez wrote:
> On Tue, 18 May 2004, Chris wrote:
>>Group Interests/Topics: * (Unix, Linux, Perl, Oracle, Mac, etc.)    
>>Perl, Alpine Mythological Beasts, XML, Non-Cabal-Activities, Left Handedness,
>>Right Handedness, AxKit...
> 
> I would replace XML by just SAX, which is more accurate, on top of being
> obviously technically superior.

Feeding on twigs as all dahuts do should also be shortlisted.

-- 
Robin Berjon, stuck in NYC

From geoff at modperlcookbook.org  Tue May 18 10:38:50 2004
From: geoff at modperlcookbook.org (Geoffrey Young)
Date: Mon Aug  2 21:29:26 2004
Subject: [Dahut-pm] Questions ...
In-Reply-To: <40AA292A.8030106@expway.fr>
References: <20040519044140.M41114@prather.org>	<Pine.LNX.4.58.0405181046260.13086@mirlin.xmltwig.com>
	<40AA292A.8030106@expway.fr>
Message-ID: <40AA2E0A.3070107@modperlcookbook.org>



Robin Berjon wrote:
> Michel Rodriguez wrote:
> 
>> On Tue, 18 May 2004, Chris wrote:
>>
>>> Group Interests/Topics: * (Unix, Linux, Perl, Oracle, Mac, etc.)   
>>> Perl, Alpine Mythological Beasts, XML, Non-Cabal-Activities, Left
>>> Handedness,
>>> Right Handedness, AxKit...
>>
>>
>> I would replace XML by just SAX, which is more accurate, on top of being
>> obviously technically superior.
> 
> 
> Feeding on twigs as all dahuts do should also be shortlisted.
> 

I believe that several of us (robin, matt, and james at least) met via
mod_perl, so apache and mod_perl seem appropriate as well.

I also like pasta of varying sorts.  and garlic.

--Geoff

From mirod at xmltwig.com  Tue May 18 10:48:51 2004
From: mirod at xmltwig.com (Michel Rodriguez)
Date: Mon Aug  2 21:29:26 2004
Subject: [Dahut-pm] Questions ...
In-Reply-To: <40AA2E0A.3070107@modperlcookbook.org>
References: <20040519044140.M41114@prather.org>
	<Pine.LNX.4.58.0405181046260.13086@mirlin.xmltwig.com>
	<40AA292A.8030106@expway.fr> <40AA2E0A.3070107@modperlcookbook.org>
Message-ID: <Pine.LNX.4.58.0405181143530.13086@mirlin.xmltwig.com>

On Tue, 18 May 2004, Geoffrey Young wrote:
> 
> Robin Berjon wrote:
> > Michel Rodriguez wrote:
> > 
> >> On Tue, 18 May 2004, Chris wrote:
> >>
> >>> Group Interests/Topics: * (Unix, Linux, Perl, Oracle, Mac, etc.)   
> >>> Perl, Alpine Mythological Beasts, XML, Non-Cabal-Activities, Left
> >>> Handedness,
> >>> Right Handedness, AxKit...
> >>
> >>
> >> I would replace XML by just SAX, which is more accurate, on top of being
> >> obviously technically superior.
> > 
> > 
> > Feeding on twigs as all dahuts do should also be shortlisted.
> > 
> 
> I believe that several of us (robin, matt, and james at least) met via
> mod_perl, so apache and mod_perl seem appropriate as well.
> 
> I also like pasta of varying sorts.  and garlic.

Whether I like pasta or not, I will soon be eating lots of it, so I guess 
I'll have to agree.

Oh, and too bad for the dahuts, but this twig has thorns: 
http://www.xmltwig.com/not_for_dahuts.jpeg

--
Michel Rodriguez
Perl &amp; XML
http://www.xmltwig.com

From robin.berjon at expway.fr  Tue May 18 10:50:42 2004
From: robin.berjon at expway.fr (Robin Berjon)
Date: Mon Aug  2 21:29:26 2004
Subject: [Dahut-pm] Questions ...
In-Reply-To: <20040519044140.M41114@prather.org>
References: <20040519044140.M41114@prather.org>
Message-ID: <40AA30D2.2010804@expway.fr>

Chris,

thanks for jumping on this, I've been wondering for a while if we could 
get away with it :) For some groups (eg london.pm) ORA restricts their 
advantages to a specific geographic area so there's been speculation as 
to whether they'd like us or not. We'll see :)

Chris wrote:
> Meeting Date: * (ie. "2nd Tuesday")    
> 1st OSCON of every year. (???)

I'd say "international conferences and similar gatherings". 
Unfortunately I'll miss OSCon again this year, but there'll be a small 
dahut gathering (Antoine and I, and two worshippers of Jenny The 
Goddess[0] from the SVG Chapter) at the Workshop on WebApps and Compound 
Document Formats in San Jose two weeks from now. Just like YAPC::EU, 
non-quorate gatherings count as well!

[0]http://shiny-donkey.com/shinyDonkey.svg

> Meeting Time: *    

24/7

> Meeting Location: * 

The Bar.

> Size of membership: *    
> erm ... 15 I think ... plus some lurkers who didn't give Long/Lat when Darobin
> was offering free beer.

I'd say circa 20 members, plus less committed sympathisers.

> Average number of members that attend meetings: *    
> we currently have had 100% attendance at all of our meetings to date.

Nah, I'd say it varies widely, but is roughly 10.

> Group Interests/Topics: * (Unix, Linux, Perl, Oracle, Mac, etc.)    
> Perl, Alpine Mythological Beasts, XML, Non-Cabal-Activities, Left Handedness,
> Right Handedness, AxKit...

Should it be non-cabal or uncabal? I'd say "Alpine Mythological Beasts 
and Cryptozoology in general".

SVG and Donkey-Goddess workshipping could reasonably make it to the 
list, they're begging to spread farther ;)

> Do you have a group library? *

CPAN?

> If so, which ones?    
> There are too many for me to list I think...

OSCon, YAPC::*, WWWCon, XML, XML Europe, SVG Open...

> Does your User Group publish book/software reviews? *     Yes No

I'd say yes, we kind of do it on IRC...

> Does your User Group produce any special events? *     Yes No

Yes.

> If so, what and when?    

DahutCon, several times a year.


Go Little Hobbit!

-- 
Robin Berjon

From robin.berjon at expway.fr  Tue May 18 11:04:09 2004
From: robin.berjon at expway.fr (Robin Berjon)
Date: Mon Aug  2 21:29:26 2004
Subject: [Dahut-pm] Questions ...
In-Reply-To: <Pine.LNX.4.58.0405181143530.13086@mirlin.xmltwig.com>
References: <20040519044140.M41114@prather.org>
	<Pine.LNX.4.58.0405181046260.13086@mirlin.xmltwig.com>
	<40AA292A.8030106@expway.fr> <40AA2E0A.3070107@modperlcookbook.org>
	<Pine.LNX.4.58.0405181143530.13086@mirlin.xmltwig.com>
Message-ID: <40AA33F9.3090205@expway.fr>

Michel Rodriguez wrote:
> Oh, and too bad for the dahuts, but this twig has thorns: 
> http://www.xmltwig.com/not_for_dahuts.jpeg

Heh, nice try. But that's when us Dahuts invoke Jenny:

   http://svg.jibbering.com/svg/2004-04-30.html#T14-27-15

And she won't mind *crunch* *crunch* *crunch*!

-- 
Robin Berjon

From chris at prather.org  Tue May 18 19:31:39 2004
From: chris at prather.org (Chris Prather)
Date: Mon Aug  2 21:29:26 2004
Subject: [Dahut-pm] Questions ...
In-Reply-To: <40AA30D2.2010804@expway.fr>
References: <20040519044140.M41114@prather.org> <40AA30D2.2010804@expway.fr>
Message-ID: <200405181931.39600.chris@prather.org>

On Tuesday 18 May 2004 10:50 am, Robin Berjon wrote:
> I'd say "international conferences and similar gatherings".
> Unfortunately I'll miss OSCon again this year, but there'll be a small
> dahut gathering (Antoine and I, and two worshippers of Jenny The
> Goddess[0] from the SVG Chapter) at the Workshop on WebApps and Compound
> Document Formats in San Jose two weeks from now. Just like YAPC::EU,
> non-quorate gatherings count as well!

That's too bad, I made plans today to go. I could make arrangements for Bender 
to go too, but he'd end up having to go on some form of CD Rom which would 
seriously impair his drinking abilities.

-Chris

From chris at prather.org  Tue May 18 19:42:15 2004
From: chris at prather.org (Chris Prather)
Date: Mon Aug  2 21:29:26 2004
Subject: [Dahut-pm] Questions ...
In-Reply-To: <40AA30D2.2010804@expway.fr>
References: <20040519044140.M41114@prather.org> <40AA30D2.2010804@expway.fr>
Message-ID: <200405181942.15975.chris@prather.org>

Right, submission sent.

Bender is so thrilled by this he's speechless.

-Chris