Great question! I look forward to reading the replies you get, since I often find myself in a similar mess. It's hard to find the right balance between flexibility and simplicity, but I am making an effort to err on the side of simplicity, to focus primarily on something that can solve today's problems, while being mindful that these problems will evolve (i.e. don't hard-code every magic number, IP address, and pathname in your program, etc.). The trickiest are the interfaces, of course, because you are trying to anticipate interaction and that is bewildering. Here's where I'm being most emphatic about keeping things simple, offering fewer options to begin with, and refactoring up as needed. (Your discussion elsewhere of choosing between using map or making your subs capable of handling any number of elements is a good one; I'd start with the map option, and upgrade to the "listable" option if it turns out to be really useful.

But as I said, I am as much in need of clues as you are, so take what I am saying with a bucket of salt.

the lowliest monk

In reply to Re: Writing general code: real world example - and doubts! by tlm
in thread Writing general code: real world example - and doubts! by polettix

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, details, 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, summary, 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.