Slashdot Mirror


Reusing and Recycling Code

An anonymous reader sends us to a writeup about when and how to recycle code, excerpting: "As developers, once we start separating our code into abstract ontological typologies, we make use of the human mind's phenomenal ability to work with types. Our code becomes less about jump tables and registers and more about users, email messages and images. What once was a problem of allocating resources and operations within the computer becomes an abstract, logical problem within a collection of objects....Over time, by constantly working to reuse our own code, we choose practices that work well for ourselves and discard practices that don't work as well or slow down our workflow. For developers flying solo or those working on small projects, this evolutionary process is a sufficient way of going about things. But there's trouble when we add other players into the mix--other developers, a user interface person, a database person, a sysadmin, a project mana-jerk: as a developer, they don't have access to our 'experience' of the code and we don't have access to theirs. "

30 of 114 comments (clear)

  1. Saving the environment by VincenzoRomano · · Score: 5, Interesting

    If you think about how much energy is needed to produce (good) code, recycling it will also help to save the environment!
    Seriously!

    --
    Maybe Computers will never be as intelligent as Humans.
    For sure they won't ever become so stupid. [VR-1988]
    1. Re:Saving the environment by xaxa · · Score: 2, Funny

      It's "reduce, reuse, recycle", so we should first try and reduce the amount of unnecessary code that's written, especially when it just duplicates functionality we already have.

      Development of vi will now cease. And Gnome.

    2. Re:Saving the environment by marcosdumay · · Score: 2, Insightful

      I reluctantly have to say that if we want to avoid writting unnecessary code, we should abolish emacs, not vi.

      I'll miss it :(

  2. Nothing to see here.... by panda · · Score: 4, Interesting

    To quote from the fine article itself:

    My psychic abilities tell me you're wondering why this wall of text was worth your time. It probably wasn't.

    What he talks about in terms of PHP is precisely what Lisp macros are about: you identify common patterns in your code, and then you generally break the patterns into a couple of short, generic functions and a macro, or sometimes, just a macro will do.

    In any other language you build a library of functions, classes, etc. to do the common things that you want to reuse.

    The above applies to PHP as well. It has the include filename construct for a reason.

    --
    Just be sure to wear the gold uniform when you beam down -- you know what happens when you wear the red one.
    1. Re:Nothing to see here.... by Gorobei · · Score: 4, Insightful

      I think the article actually hints at a deeper problem. If we broadly divide programmers into categories:

      1. Code monkeys. Write code, happy when it kind of does what is required.
      2. Architects. Design and implement libraries and their APIs to make stuff easily usable.
      3. Ontologists. Design and implement philosophical frameworks that make big systems work.

      then we can put LISP macros somewhere between levels 2 and 3.

      In terms of reuse, level 1 code should just be ignored, level 2 code is a good candidate, and level 3 ideas will be automatically reused.

      Unfortunately, it is natural for programmers to want to crawl up the scale: code monkeys create bad APIs; architects create bad ontological systems; ontologists wander off into category theory. Sometimes, the developer gets it right, but 90% of the time she just leaves an attractive nuisance lying around.

      Given a big system (say 1m+ LOC,) I want something like 3 ontologies, 100 subsystem APIs, and 3000 enduser things (reports, feeds, GUIs, etc.) If I see another 5m LOC system with hundreds of AbstractFactories and XXXFacades and YYYAdaptors, I am going to start shooting people.

  3. Recycling isn't always good by Anonymous Coward · · Score: 2, Insightful

    This assumes the code is good. If it isn't, it's akin to eating your own vomit.

    1. Re:Recycling isn't always good by Javagator · · Score: 2, Interesting

      This assumes the code is good. If it isn't, it's akin to eating your own vomit.

      In my current project we are using a third party library that is very powerful and comprehensive, but the API is overly complex and poorly documented. It takes a year or two before it stops being mysterious and becomes merely frustrating. Writing code that is easy to re-use is an uncommon art.

  4. A great example of code re-use by Lord+Byron+II · · Score: 5, Funny
  5. Ontological Typologies? by Apple+Acolyte · · Score: 5, Funny

    Ontological typologies? Am I reading a philosopohy essay here?

    --
    Part of the hardcore faithful who believed in Apple long before it was cool again to do so
    1. Re:Ontological Typologies? by _Hellfire_ · · Score: 2, Funny

      I recently read through some policy documents at my work. The introduction had a paragraph about how "...notoriously expensive documentation is..." to write and maintain.

      The next sentence was all about making said documentation leaner and thus less expensive. How is that done? By aligning with the principles of [some phrase written in latin] (!), and through "...the principles of ontological parsimony (!)". No Shit!

      I had to use a dictionary to work out what the hell it was saying.

      Talk about the very definition of irony...

      --
      "And then I visited Wikipedia ...and the next 8 hours are a blur..."
  6. That guy is management material! by Anonymous Coward · · Score: 5, Funny

    A programmer who says so little in so many words is a rare sight. Promote promote promote!

    1. Re:That guy is management material! by Thiez · · Score: 4, Funny

      EXTERMINATE! EXTERMINATE!

  7. what the hell is the question? by roman_mir · · Score: 3, Insightful

    What is the question in this 'story'? Is this about coding for money or free source or what?

    If the question is about coding for money then it is the responsibility of the team lead/designer/architect to make sure that the business problem is divided into pieces in a way that allows different people to work in parallel (if there are multiple people on the project.)

    If the question is just about some abstract idea of 'code reuse', then the answer is simple: libraries. Create libraries and document them (otherwise they are useless really, without anyone knowing what the hell is inside.)

    In any case, please document the purpose of the code, and then break the higher level requirements into more granular ones with clear specifications.

    In all cases divide, concur and document well seems to work best...

  8. Hell is other people by leereyno · · Score: 4, Insightful

    Hell is other people.

    Having to work with people for whom the Peter principle has reached its end state is exasperating at best.

    Then you have the emotionally unstable, the delusional, the political operators, the empire builders, the saboteurs, the goldbrickers, and of course the fearful.

    Is there some reason why I would WANT to work with this motley crew of idiots, assholes, nutjobs, and losers?

    Success isn't about a paycheck. Past a certain pay grade the money ceases to be a factor. I'd much rather get an adequate paycheck to work in an environment that is conducive to success than be paid generously to work someplace that sucks.

    --
    Muslim community leaders warn of backlash from tomorrow morning's terrorist attack.
    1. Re:Hell is other people by wkitchen · · Score: 5, Insightful

      And then there's the skilled but arrogant jerks who deride anyone they think they're better than, which is almost everyone. Just one of those guys can bring dysfunction to what would otherwise have been a productive team. You REALLY don't want to get stuck with one of them on your team project.

      And it's a real shame, too. Some of those guys actually are as talented as they believe themselves to be, and if they weren't such assholes, could have made the team better by showing the others better ways to do things. And no, I don't mean hand-holding or playing teacher, but just the influence of having the others see what really good work looks like. Leading by example, in other words.

      These guys aren't useless, however. There are problems that are well-suited to single-handed solutions. Just keep them far away from anything that requires close collaboration, and both they and their employer's will be happy.

    2. Re:Hell is other people by Anonymous Coward · · Score: 2, Insightful

      Success isn't about a paycheck. Past a certain pay grade the money ceases to be a factor.

      Actually, after a couple of decades in IT and enough financial inertia along the way to avoid becoming rich, success is **only** a paycheck. I see the march of cybernetic progress as a superstructure upon which the march of coral-like growth of business and science proceeds. It proceeds, by and large, by the energy system known as money economics with a few motivational impurities thrown in for colloidal structure.

      Very, very few of us code monkeys have reached that pay grade where money ceases to be a factor. After enough years at it, the challenges to be solved aren't that challenging any more and reach a certain "meh" stage. And unless you're one of those rare minds who are both bright as XKCD and willing to stay in the same channels, you'll reach a point where any IT job becomes just a money pump. You need to transcend.

    3. Re:Hell is other people by Mutatis+Mutandis · · Score: 4, Insightful

      Ah well, sometimes I think I am like that. Often, really. Yes: Actually, I do think that in comparison with everybody in our IT department, I am a better coder, and a better architect, and a better ontologist. Arrogant nuisance? You bet.

      So, from a certified jerk's perspective, let me tell what we need to be effective members of a team: An effective sparring partner. Seriously. What makes me a frustrated, tired and emotional team member, is that so many supposed team meetings are only unidirectional exchanges. Sometimes I sit there and watch the other members of the team grinding their way through all the little problems of system integration. Sometimes they sit there and watch me sketch a new ontology, architecture and object model.

      Such a grouping of people is not a team. It is a group of people sitting in the same room, but at cross-purposes, because we are not talking at the same level. At best we succeed in confusing each other, at worst only in boring each other. I think they are parasites. They think I am an arrogant jerk. Rate of progress, in that constellation? Nil.

      Yet I can work in a team. I've worked for years in highly effective teams, and with success. I can tell you what made all the difference: The presence of equals to debate issues with, so that we could talk each other through the problems and emerge from the session with the feeling that we had defined better solutions. Perhaps we are all arrogant nuisances, but as long as we understand and respect each other we keep each other in check, and can function as effective team members.

      The moral of the story, as far as I am concerned: Effective teams need a core group of several people with the same high level of skill. You can put in a few people with less skill, so that they can learn from the others. But you should never try to assemble a team of one wolf and five sheep, because that becomes either a classroom or a dinner opportunity, never a team.

  9. -1 brain fart by Anonymous Coward · · Score: 2, Insightful

    I fear TFA is not a joke! Unobtrusive script starts with valid markup, not garbage like this...

    <input type="star" name="rating" value="4.5" size="5" />

    That (type=star) is fine if you're going to pre-process it on the server, only a moron would boast about sending markup like this to the client. If the author of this rambling bullshit article knew what he was doing, he would have used an input image type and class name of "star".

    The rest of his article is similar 'junior developer above their station' type stuff. I do like the way the author of this article on code reuse makes a swipe at the concept of an "API" before going on to detail his own API (making a decorator with an Event_Manager $events property).

    Being charitable, I could say TFA is incoherent nonsense. I've almost made all my charity contributions for this fiscal year, hopefully the author will keep that in mind before writing any further ludicrous articles.

  10. Simple metaphors... by argent · · Score: 4, Insightful

    That should be called "the lesson of UNIX". UNIX provided an amazing simplification that provided almost everything users and developers needed with fewer than 40 system calls (maybe half a dozen frequently used) and a single way of talking to all the objects in the computer system. People who haven't used older operating systems can't really appreciate this, but just opening and reading files used to require understanding something the size of the X11 documentation, you typically had umpteen kinds of files with half a dozen access methods each, with different calls to read blocks, fixed-size records, variable-sized records, padded and unpadded records, three varieties of carriage control, and if you wanted to read or write to a terminal or printer or card reader you had completely separate sets of calls for each. And to simplify this you had record management systems which had their own walls of documentation. And you had to understand this if all you wanted to do was to read a report from a program, because of course every programmer had learned their own bits of this and used them... so even if you didn't care about block-padded variant numbered record files with Fortran carriage control, you had to be able to deal with it. When I ported a Forth interpreter to one system, I had the whole interpreter called from a Fortran main because that let me push the whole problem off on the Fortran runtime instead of figuring it out myself.

    This was worse than the line ending differences between UNIX and Windows, which are bad enough.

    It's like *every* file, even plain text files, was in its own OOXML format.

    Even if you only dealt with one computer and one OS.

    UNIX didn't do any of that. It just made everything into a stream of bytes. For the cases where that wasn't enough, you got the whole records-oriented stuff back... in libraries. And when you used those libraries you had to deal with all the old complexity, but you only had to deal with it when you actually needed to. And lots of old timers insisted that this was backwards, that the OS was the best place to do that, so all the programs worked the same way... but the fact was that all the programs didn't work the same way, because (just as for text files) they all handled their own files and didn't handle anyone else's, and you still had to have utilities to convert data from one format to another. And you had to do it for everything.

    When you're designing an API, look for simple metaphors. Look for a model where most of the time you don't need to specify any complex parameters or callbacks or helper routines. Leave a way to hook extensions in, sure, but for most software you should be able to do 80% of the things you want without having to turn to the second page of the documentation.

  11. Old School Old Fart by superid · · Score: 4, Insightful

    I'm probably going to be shouted down but in my 30 years of coding, I *rarely* reused code. Platforms change, toolchains and libraries change (glibc vs libc6), languages change, system architectures change (heavy client, client/server, n-tier, distributed) and system requirements change.

    Example, a lot of what I have done over the past 10 years uses some standard navigation libraries that probably could have been 100% portable. Lat/lon to range bearing, rb2ll, etc. We've never even discussed IF it would help to make a single standard project library, even though I can absolutely tell you we will rewrite these again on the next platform.

    I can't even look back on 10 years of coding and say "Oh things would have been so much better if we had shared code". I don't think that is the case. And fwiw, this is teams of 5-20 programmers on significant projects.

    1. Re:Old School Old Fart by Jerry+Coffin · · Score: 2, Insightful

      I'm probably going to be shouted down but in my 30 years of coding, I *rarely* reused code.

      Donald Knuth recently said: "I also must confess to a strong bias against the fashion for reusable code."

      Personally, I think a lot depends on the sorts of things you do, and (probably more importantly) the way you tend to think. A few decades ago (or so) when I started college, Pascal was the cool new thing, and top-down development was going to save the world. At least IMO, top-down development has some very good points -- but code reuse isn't one of them.

      OTOH, some people tend to work and think primarily bottom up. For them, work on a particular project basically consists of building a good library for that type of work, and once they have a good library, that particular project is little more than building a user interface to give access to those components.

      One big problem is that code reuse has been pushed as a good idea for long enough not that a lot of people who simply don't have the mindset to produce reusable code still feel that they should do so, and feel guilty if they don't. IMO, this is silly -- there's a lot of room for both kinds of development, and IME, successful projects rarely stick to one direction or the other -- rather, there's a tendency towards some people working bottom up, and others top-down, and the project as a whole is more or less a "meet in the middle" approach.

      Of course, getting this to work requires a fair amount of care -- in particular, you need to ensure against a major "fault line" where the top and bottom sides meet. Unfortunately, I don't have an easy prescription for preventing that -- if I did, I'd probably be the author of a famous book instead of some unknown guy writing on slashdot... :-)

      --
      The universe is a figment of its own imagination.
    2. Re:Old School Old Fart by Duffy13 · · Score: 2, Interesting

      You also have a hidden point in there. A lot code is just not useful for more then the app it was originally designed for, and breaking it down into smaller modules and functions usually just creates simple loops or recursive functions, and thus no point in saving them for later use as they can be replicated in the same amount of code space.

      I don't really understand what the OP is trying to convey, anyone who has learned programming in the last 5-10 years (probably longer) from a half way decent school should be familiar with OO design, which is all he's blathering on about. I mean, almost anything I develop relies on a collection of APIs and libraries to do a majority of the functionality, its just a matter of combining the blocks to get the desired effect. The "tedious" functions in most development enviroments have already been done for us, hell the only time I can recall adding anything to the development libraries was when I added a split function to the dumb Delphi Pascal crap we were using.

      I'm all for code reuse, as long as it makes sense.

      --
      "Now you know, and knowing is half the battle!"
  12. Simple by pjt33 · · Score: 2, Insightful

    Without RFTAing, I would estimate that it's 95% certain that the question behind this story is "How can I get a few thousand people to hit my ad-laden page?" And the answer is "Anonymous posting of a link to Slashdot."

  13. Re:Knows his stuff by jcuervo · · Score: 3, Funny
    --
    Assume I was drunk when I posted this.
  14. Pontification by Animats · · Score: 4, Interesting

    That's quite a rant on programming for a Javascript form field validator.

    The right answer to this problem was probably WebForms, which added support to HTML for basic form validation. WebForms provided for simple regular expressions in HTML forms like this one for a credit card number:
    <input type="text" pattern="[0-9]{16}" name="cc" />

    If the field didn't match the pattern, the browser would tell the user, in a standardized way, probably at keystroke time. The browser would also do things like prevent alpha entries in a numeric field, something that IBM green screen terminals were doing in the 1970s. (You could even program a keypunch machine to do that.) It's kind of lame that HTML forms never had any built in input validation.

    For some reason, the WebForms proposal made very slow progress and never caught on.

  15. I'll show you metaphor... by Nazlfrag · · Score: 5, Funny

    ShadowBane strode into the room, his pale Night-Elf features enveloped in the shadows of his Technomancer robes. Before him stood the artefact, an eerie light emanating from its crystal face.

    He sat on the throne, in one hand brandishing a strange rune-encrusted clattering device, whilst in the other he wielded a smooth object with wheels and levers emitting a demonic red glow. His hands moved swiftly and glowing runes etched themselves on the crystal device, spelling out:

    "#include <stdio.h>"

    He clicked again, and the runes mystically floated upwards. The next runes were even more cryptic:

    "void main(int argc, char *argv[]) { printf("Hello world"); }"

    He paused, taking a sip from his recycled aluminium goblet, then taking a sheet of recycled parchment and dipping his pen into a pot of genuine organic squid ink. Out of the corner of his eye he glanced a peasant rummaging through his garbage pile. He mused about all of this, then inscribed:

    "I have unlocked a mystery of great potential. By invoking the sacred word of inclusion I have unlocked a compendium, nay a veritable library of invocations and chants. Like the peasant sifting through my rubbish, so can I reuse my incantations. These shall empower me further into my research for the solution to the factorial function, a problem of seemingly infinite complexity."

  16. !saving environment by Anonymous Coward · · Score: 2, Insightful

    I tire of people who claim that _anything_ we do helps to "save the environment". Everything we do helps to _destroy_ the environment! So long as the "saving" factor is less than 100% of the damage we produce, we have done nothing to "save the environment".

    I'm sick of the "we want to have our cake and eat it too" attitude people have over these issues. The way corporations and the majority of consumers live today, almost NOBODY can claim to care about the environment. If you own anything manmade, you've directly contributed to the planet's destruction. Yes, really.

    1. Re:!saving environment by foniksonik · · Score: 2, Insightful

      Uh i tire of people who think that we humans are somehow not a part of the environment... and that everything we do somehow is "destroying it".

      We are a part of the environment and what we do certainly changes it but that doesn't mean we are destroying anything.... in fact the law of conservation of energy states very explicitly that we are quite incapable of destroying anything at all. We can only change things.

      Now given that we can and do change things, some changes we make impact ecosystems which otherwise would not be impacted by other natural phenomenon. The degree to which this can be construed as "destroying the environment" is debatable. As is the nature of this so-called "environment" which you speak of .

      So really what you want to say is :"Save MY environment... the one that i have come to know and love - as change scares me and i'm worried that whatever environment may result if we don't save this one could make my life difficult"

      --
      A fool throws a stone into a well and a thousand sages can not remove it.
  17. A Master of Masters... by flajann · · Score: 2, Interesting
    I have been in the computer field for 30 years, and have done everything from writing low-level drivers for operating systems to creating large applications, and everything in between.

    I am currently a database manager where I work, but that title belies the complexity of what I have to deal with on a daily basis. We are producing our "next gen" web application whilst keeping the old, but money generator up and running under the pressures of increasing user load.

    Even though I am the database guy, my vast experience with software engineering has given me a "unique" role in knowing the developer's side and having a lot of input on their design decisions, as well as having huge impacts on systems.

    One poster mentioned not having access to various skills and expertise in a variety of areas, and yes, there's a lot of that at my shop, so I tend to try to "bridge the gap" as it were, to help my DBA team interactt smoothly with Dev and Systems, etc.

    Code reusability is a big issue in our development of the NextGen system, because the old code (that's currently pulling in the $$$$$) is not supportable, being written badly in PHP4 has resisted all attempts to upgrade. The NextGen approach uses OOP ery heavily, and also relies on stored procedures to keep the SQL out of the code and allow my DBA team to tweak and enhance performance without impacting the code base. It makes for a sweet division.

    But I do find myself doing lots of talking and less actual "hands-on" development these days. Kinda crazy running around talking to various department heads, managers, project leaders, QA, and the like.

    I guess I am speaking to a greater issue than code usability -- human communication to keep us all on the same page and to allow us to leverage each other's expertise. All of our efforts together represent the future success of our endeavors.

  18. This guy is behind the times! by Jane+Q.+Public · · Score: 2, Insightful

    I strongly suggest he read a few (5 or 6 year-old) books on Agile programming techniques, and maybe start working in a modern language like Ruby.

    Do not misunderstand! I do not dispute much of what he writes. The problem is: what he writes about are old problems that have already been addressed by others. Maybe he should spend a bit of time studying what others in the industry are doing/have done, before wasting his time writing what others have already written, and better. Far better.

    If you want to be a cutting-edge programmer (which is what you had better be if you are writing about how others should write their programs), I think it behooves the writer to be more-or-less up-to-date on the subject himself.