Beefy Boxes and Bandwidth Generously Provided by pair Networks
Don't ask to ask, just ask

Re: Re: Ingy's "Swiss Army Light Sabre" - or, "how do you design your APIs?"

by mvc (Scribe)
on Mar 27, 2004 at 16:07 UTC ( #340268=note: print w/replies, xml ) Need Help??

in reply to Re: Ingy's "Swiss Army Light Sabre" - or, "how do you design your APIs?"
in thread Ingy's "Swiss Army Light Sabre" - or, "how do you design your APIs?"

My main objection:

my $foo = io('some/thing');

Yes it would be better to trap such a mistake ASAP. Would this be OK?

my $foo = io(-filename => 'some/thing');

You could even add some kind of policy enforcement aspect that will trap all dubious instantiations on runtime.

I am not worried about a developer calling $foo->slurp when the intention was to use $foo as a directory, for the same reason that I am not worried about it being used as a Person object. It is just a coincidence that file and directory features are in the same physical package.

BTW: The Java class is also a file or a directory, and it implements some methods that are directory specific, like listFiles(). So it is a similar situation, despite the static typing. Of course that is a poor example, and anybody with a brain would use a util lib, e.g. the apache commons.

It is leaky abstraction, but it looks like a pretty cool one to me! The freedom from having to check return values is a justification for this by itself.

Log In?

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://340268]
and all is quiet...

How do I use this? | Other CB clients
Other Users?
Others contemplating the Monastery: (2)
As of 2018-01-21 21:24 GMT
Find Nodes?
    Voting Booth?
    How did you see in the new year?

    Results (230 votes). Check out past polls.