[gentoo-portage-dev] [Fwd: Re: equery refactorization]

[gentoo-portage-dev] [Fwd: Re: equery refactorization]

[Michael A. Smith]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

I sent this to Douglas, but not to the list. Re-sending.


- -------- Original Message --------
From: Michael Smith <michael@smith-li.com>
To: gentoo-portage-dev+subscribe@lists.gentoo.org, Douglas Anderson
<dja@gendja.com>
Subject: Re: equery refactorization
Date: Tue, 2 Dec 2008 17:21:14 -0500

I had the same idea and even began working on a roadmap for it.

Step 1: move gentoolkit to site-packages
Step 2: move individual command classes to functionally-organized
module-files
Step 3: refactor and enhance docstrings to allow primary help/usage()
function to construct from individual modules. (The goal here is to
create a drop-in mechanism for adding new modules, so that usage() is
automatically updated when a new module is added.)
Step 4: Profit!

Actually another approach would be to create a core __init__.py that
handled the usage() and getopt functionality I outlined in Step 3
above, and then one-by-one modify the individual modules that are in
the current equery so they could be dropped in.

Thoughts?

Michael

On Dec 2, 2008, at 5:01 AM, Douglas Anderson wrote:

| Hi, I'm interesting in tinkering with equery and doing some
| refactorization in my spare time...<SNIP>
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.9 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iEYEARECAAYFAkk7DOsACgkQzwtr5yY0JZwRugCfaK9FzFe5fPmTDMIe9VWSNyK9
PzAAn2yA/8+ZZ5WdNL/FsI/94Mrlviry
=ugqe
-----END PGP SIGNATURE-----

Re: [gentoo-portage-dev] [Fwd: Re: equery refactorization]

[Paul Varner]

I'm just picking a message to reply to.

Overall, I like where this is headed with just a few comments.

1. I would like to see /usr/lib/gentoolkit/pym go away and the python
modules moved into the python site-packages directory.
2. I do not want to see any of the long and short option names change.
There are too many scripts out there that I do not want to break.
3. In reference to above, any changes to how equery is called by the
user needs to still keep the old way of doing things. We can add a
deprecation notice, but it will be a long time before we can actually
remove that support.

Regards,
Paul

[gentoo-portage-dev] Re: [Fwd: Re: equery refactorization]

[Duncan]

Paul Varner <fuzzyray@gentoo.org> posted
1228770919.17376.10.camel@txslpc1d36.wkst.vzwnet.com, excerpted below, on 
Mon, 08 Dec 2008 15:15:19 -0600:

> Overall, I like where this is headed with just a few comments.
> 
> 1. I would like to see /usr/lib/gentoolkit/pym go away and the python
> modules moved into the python site-packages directory.
> 2. I do not want to see any of the long and short option names change.
> There are too many scripts out there that I do not want to break.
> 3. In reference to above, any changes to how equery is called by the
> user needs to still keep the old way of doing things. We can add a
> deprecation notice, but it will be a long time before we can actually
> remove that support.

As someone that has a bunch of his own scripts for such things...

++

As long as there's a documentation of the new and a deprecation notice on 
the old for awhile (say a year), go ahead and add the new options.  Just 
don't remove the old ones until that after that year of notice and 
documentation, and preferably be sure you use the glep-42 news feature 
for notification when you DO drop them.  If I've not upgraded my scripts 
in that time, and don't see or ignore that news item, well, that's my 
fault.

Thanks! =:^)

-- 
Duncan - List replies preferred.   No HTML msgs.
"Every nonfree program has a lord, a master --
and if you use the program, he is your master."  Richard Stallman