Path: csiph.com!usenet.pasdenom.info!aioe.org!news.stack.nl!newsfeed.xs4all.nl!newsfeed2.news.xs4all.nl!xs4all!newsgate.cistron.nl!newsgate.news.xs4all.nl!post.news.xs4all.nl!not-for-mail
Newsgroups: comp.lang.python
Date: Tue, 26 Mar 2013 04:52:49 -0700 (PDT)
In-Reply-To: <mailman.3727.1364292472.2939.python-list@python.org>
Complaints-To: groups-abuse@google.com
Injection-Info: glegroupsg2000goo.googlegroups.com; posting-host=89.68.221.197; posting-account=oknH1QoAAABqzbD_5ziFTvLQsqNk2LbU
References: <68da956e-ebe0-4f58-92cd-f7ffff0075b4@googlegroups.com> <mailman.3727.1364292472.2939.python-list@python.org>
User-Agent: G2/1.0
MIME-Version: 1.0
Subject: Re: Help me pick an API design (OO vs functional)
From: Michael Herrmann <michael.herrmann@getautoma.com>
To: comp.lang.python@googlegroups.com
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
Cc: python-list@python.org, Michael Herrmann <michael.herrmann@getautoma.com>
Precedence: list
Message-ID: <mailman.3737.1364298778.2939.python-list@python.org>
Lines: 53
NNTP-Posting-Host: 2001:888:2000:d::a6
Xref: csiph.com comp.lang.python:41884

On Tuesday, March 26, 2013 11:07:45 AM UTC+1, Jean-Michel Pichavant wrote:
> ----- Original Message -----
> > 	notepad_1 =3D start("Notepad")
> > 	notepad_2 =3D start("Notepad")
> > 	notepad_1.write("Hello World!")
> > 	notepad_1.press(CTRL + 'a', CTRL + 'c')
> > 	notepad_2.press(CTRL + 'v')
> >=20
> > The problem with this design is that it effectively duplicates our
> > API: We want to keep our "global" functions because they are so easy
> > to read.=20
>=20
> So is the example above. This is the best solution in my opinion.=20

Thanks for your reply. What do you mean by "So is the example above" though=
?=20

> I think you're having the same issue that some other APIs, let's say matp=
lotlib for example. They try to accommodate scientists (matlab) and program=
mers(python) by having a double API style.
>=20
> One looks like
>=20
> legend()
> title()
> plot()
> save()
>=20
> the other looks like
>=20
> fig =3D figure()
> fig.add_legend()
> fig.title()
> fig.plot()
> fig.save()
>=20
> The problem is, when searching for example on the net, you'll end up with=
 a mix of both, it can become a nightmare.

Interesting point. I'll google a little about matplotlib.

> I definitely prefer the later, for the reasons that have already been giv=
en to you in this thread and by the fact that with the correct (I)python sh=
ell, you can create your window object and get auto-completion on its metho=
ds just by hitting <tab>, very helpful when introspecting objects. Can be a=
chieved of course in any python shell with function like dir() ; my point b=
eing that OOO design keeps things in their place, see the zen of python "Na=
mespaces are one honking great idea -- let's do more of those!"

Doesn't the IPython do auto-completion for "global" functions?=20

Thanks,
Michael (www.getautoma.com)