Beefy Boxes and Bandwidth Generously Provided by pair Networks
Your skill will accomplish
what the force of many cannot

Comment on

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

Oops... how did I get logged-out so fast?

Your constructor, new(), should return a blessed object.   Usually, I define a separate init() method and, if I find that the constructor has been called with parameters, I first create the blessed object and then separately invoke that method to do the rest.

Any Perl object is, almost always, a hash.   It can therefore “hold on to” anything that it wants.   As for the YAML question, what will make the most sense for the user of this module?   If the YAML object is something that the client program will have already, and will otherwise be using for other purposes, then it makes sense to pass it in and keep it.   But maybe your object should, instead, create a YAML object for its own purposes, i.e. “on demand,” and never tell its user about it at all.

In the latter case, I normally would define an internal-only method, named _getYAML (following the human convention that a subroutine-name beginning with an underscore isn’t intended for outside use), which will always return a YAML object.   If it doesn’t already have one, it creates one on-the-fly and stashes away its location in a known-but-to-god field of the hash so that it can return the same object next time.   If you are dealing with some other module, in the course of your work, that you know might be able to trash such an object, well, your object has to know about that and to destroy its own known-but-to-god reference at the appropriate time (by setting the stash to undef).   Your object knows, so nobody else has to, and that’s a big-win for the users of your code because “it just works.™”

In reply to Re: Module authoring and OO perl by sundialsvc4
in thread Module authoring and OO perl by jellisii2

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?

    What's my password?
    Create A New User
    and all is quiet...

    How do I use this? | Other CB clients
    Other Users?
    Others studying the Monastery: (8)
    As of 2018-03-21 17:18 GMT
    Find Nodes?
      Voting Booth?
      When I think of a mole I think of:

      Results (270 votes). Check out past polls.