in reply to Re: Style Question: small and modular, or big enough to do the job in one piece?
in thread Style Question: small and modular, or big enough to do the job in one piece?

++ Brother derby! This is exactly the kind of analysis that needs to be done.

The most important thing in the vast majority of coding projects is maintainability, or "How easily can someone who's never seen this code before go in and make a change with a reasonable certainty that nothing else was adversely affected?" The answer to that question determines the code's maintainability.

Run-time analysis is, in my mind, overused. 99.999% of all coding projects do not have a run-time constraint. Yeah, we all want our code to finish NOW, but if it takes 2 seconds instead of 1.8 seconds, that's ok. If adding .2 seconds to its runtime allows a programmer to safely make a change in 5 minutes instead of 2 hours, that's worth it.

Memory constraints should be treated the same way. Most machines are much more powerful hardware-wise than can be used by a reasonable user. Do the right thing for yourself. It's only a machine.

------
We are the carpenters and bricklayers of the Information Age.

Don't go borrowing trouble. For programmers, this means Worry only about what you need to implement.

Replies are listed 'Best First'.
Re: Re: Re: Style Question: small and modular, or big enough to do the job in one piece?
by Anonymous Monk on Feb 15, 2002 at 06:01 UTC
    Maintainability is exactly the issue here. My architect freind says break it up so each piece is small and easily digestible w.r.t. function, even if this means calling multiple scripts to do the "job". My view is to have it all in one place so I don't have to chase around multiple files/locations to figure out what the job is doing.

    I don't think the two are completely at odds. Even though my script ended up longer than I expected, I did:
    - use subroutines to avoid repeating the same constructs
    - commented liberally, since I and my admins are all relatively new to perl
    - wrote a pretty comprehensive perldoc, that describes what the control file looks like and how to call the script with the control file and the available args.