Beefy Boxes and Bandwidth Generously Provided by pair Networks
Just another Perl shrine
 
PerlMonks  

comment on

( #3333=superdoc: print w/replies, xml ) Need Help??

Here is a basic example.

My WiringPi::API software wraps wiringPi. That library contains many aspects to it, essentially most things you'd want to do on a Raspberry Pi. In my distribution, I also include a bunch of undocumented functions, as well as functions from libraries external to the main code, but within the same project.

My RPi::WiringPi distribution is a housing type retrieval system for a whole bunch of various individual/specific other RPi:: distributions. Example: RPi::I2C, RPi::ADC::MCP3008, RPi::DAC::MCP4922. Some of those individual/specific dists use WiringPi::API and some don't, because I wrote the IC communication myself. So, you can do this:

my $i2c_dev = RPi::I2C->new($dev_addr);

or, because RPi::WiringPi encompasses/sucks in all sub dists:

my $pi = RPi::WiringPi->new; my $i2c_dev = $pi->i2c($dev_addr);

The benefit of this is that the encompassing dist is a one stop shop for all others, but it provides the benefit of ensuring hardware cleanup/reset if there's a crash or other event. The sub modules do not do this. RPi::WiringPi requires WiringPi::API as well for its own business.

If I add functionality to WiringPi::API's I2C functions for example, I obviously need to update the RPi::I2C distribution with the new code. The other sub dists may not require updating to this new version, and that's all well and good.

However, what if I fixed a bug in part of a core function that operates across all dists? I have so many RPi:: distributions that I can't remember without looking. Instead of going to CPAN and checking, I have now a single command that tells me the entire list and what ver they are currently at. I then revdep test every single one, one at a time after making the bump, then once confirmed, I upload each one individually.

This isn't a problem with interface mis-management, or wanting the latest of everything. It was designed as something that would make my life a lot easier, providing me at-a-glance where I am with what. I just thought it may be useful to others for similar (or even dissimilar) purposes, so I added some extra functionality, and published it.


In reply to Re^5: Checking if your CPAN distributions need to bump their prereq versions (interfaces) by stevieb
in thread Checking if your CPAN distributions need to bump their prereq versions by stevieb

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post; it's "PerlMonks-approved HTML":



  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.
  • Log In?
    Username:
    Password:

    What's my password?
    Create A New User
    Chatterbox?
    and the web crawler heard nothing...

    How do I use this? | Other CB clients
    Other Users?
    Others taking refuge in the Monastery: (4)
    As of 2020-11-26 20:46 GMT
    Sections?
    Information?
    Find Nodes?
    Leftovers?
      Voting Booth?

      No recent polls found

      Notices?