[Distutils] setuptools and man pages

2011-01-25 Thread Andrew McNabb
I am maintaining a package that includes several scripts, and I recently
added a man page.  Unfortunately, I was unable to figure out how to
specify the man page with setuptools.  I ended up switching back to
vanilla distutils, which allowed me to specify the man page in setup.py:

data_files=[('man/man1', ['man/man1/pssh.1'])]

Is there an equivalent way to do this with setuptools?  The closest
thing I could find in the setuptools documentation was, Note, by the
way, that this encapsulation of data files means that you can't actually
install data files to some arbitrary location on a user's machine; this
is a feature, not a bug.  I appreciate the well-intended thought, but I
can't find any feature for specifying man pages.  I don't want to
install to an arbitrary location, but I need to be able to install to
$PREFIX/man/man1).

Is there a way to do this with setuptools, or do I need to keep using
distutils?  I would love to be able to use the console_scripts
feature, so it would be great if I could use setuptools, but obviously
the man pages are higher priority.  I feel like I must be missing
something obvious.  Thanks.


-- 
Andrew McNabb
http://www.mcnabbs.org/andrew/
PGP Fingerprint: 8A17 B57C 6879 1863 DE55  8012 AB4D 6098 8826 6868
___
Distutils-SIG maillist  -  Distutils-SIG@python.org
http://mail.python.org/mailman/listinfo/distutils-sig


Re: [Distutils] setuptools and man pages

2011-01-25 Thread P.J. Eby

At 12:03 PM 1/25/2011 -0700, Andrew McNabb wrote:

I am maintaining a package that includes several scripts, and I recently
added a man page.  Unfortunately, I was unable to figure out how to
specify the man page with setuptools.  I ended up switching back to
vanilla distutils, which allowed me to specify the man page in setup.py:

data_files=[('man/man1', ['man/man1/pssh.1'])]

Is there an equivalent way to do this with setuptools?  The closest
thing I could find in the setuptools documentation was, Note, by the
way, that this encapsulation of data files means that you can't actually
install data files to some arbitrary location on a user's machine; this
is a feature, not a bug.  I appreciate the well-intended thought, but I
can't find any feature for specifying man pages.  I don't want to
install to an arbitrary location, but I need to be able to install to
$PREFIX/man/man1).

Is there a way to do this with setuptools, or do I need to keep using
distutils?  I would love to be able to use the console_scripts
feature, so it would be great if I could use setuptools, but obviously
the man pages are higher priority.  I feel like I must be missing
something obvious.  Thanks.


Setuptools has a distutils-compatible installation mode:

   setup.py install --single-version-externally-managed --record=somefile

It's a bit awkward to type, but it should do what you want.

___
Distutils-SIG maillist  -  Distutils-SIG@python.org
http://mail.python.org/mailman/listinfo/distutils-sig


Re: [Distutils] setuptools and man pages

2011-01-25 Thread Andrew McNabb
On Tue, Jan 25, 2011 at 03:10:09PM -0500, P.J. Eby wrote:
 
 Setuptools has a distutils-compatible installation mode:
 
setup.py install --single-version-externally-managed --record=somefile
 
 It's a bit awkward to type, but it should do what you want.

But wouldn't this require all end users to know the incantation?
Presumably I could add the following to the top of setup.py:

sys.args += ['--single-version-externally-managed', '--record=somefile']

But that seems sort of dirty. :)

-- 
Andrew McNabb
http://www.mcnabbs.org/andrew/
PGP Fingerprint: 8A17 B57C 6879 1863 DE55  8012 AB4D 6098 8826 6868
___
Distutils-SIG maillist  -  Distutils-SIG@python.org
http://mail.python.org/mailman/listinfo/distutils-sig


Re: [Distutils] setuptools and man pages

2011-01-25 Thread P.J. Eby

At 02:41 PM 1/25/2011 -0700, Andrew McNabb wrote:

On Tue, Jan 25, 2011 at 03:10:09PM -0500, P.J. Eby wrote:

 Setuptools has a distutils-compatible installation mode:

setup.py install --single-version-externally-managed --record=somefile

 It's a bit awkward to type, but it should do what you want.

But wouldn't this require all end users to know the incantation?


Well, those who want the man pages, certainly.  ;-)



Presumably I could add the following to the top of setup.py:

sys.args += ['--single-version-externally-managed', '--record=somefile']

But that seems sort of dirty. :)


It also won't do anything if they're installing via another tool such 
as pip, easy_install, buildout, etc.


___
Distutils-SIG maillist  -  Distutils-SIG@python.org
http://mail.python.org/mailman/listinfo/distutils-sig


Re: [Distutils] setuptools and man pages

2011-01-25 Thread Andrew McNabb
On Tue, Jan 25, 2011 at 05:46:40PM -0500, P.J. Eby wrote:
 
 It also won't do anything if they're installing via another tool
 such as pip, easy_install, buildout, etc.

Do each of those support some way to install man pages?

-- 
Andrew McNabb
http://www.mcnabbs.org/andrew/
PGP Fingerprint: 8A17 B57C 6879 1863 DE55  8012 AB4D 6098 8826 6868
___
Distutils-SIG maillist  -  Distutils-SIG@python.org
http://mail.python.org/mailman/listinfo/distutils-sig


Re: [Distutils] setuptools and man pages

2011-01-25 Thread P.J. Eby

At 03:53 PM 1/25/2011 -0700, Andrew McNabb wrote:

On Tue, Jan 25, 2011 at 05:46:40PM -0500, P.J. Eby wrote:

 It also won't do anything if they're installing via another tool
 such as pip, easy_install, buildout, etc.

Do each of those support some way to install man pages?


I imagine one could write a buildout plugin that would do it.  There 
was some discussion a while back about a buildout plugin for documentation.


Really, distutils2 is probably a better candidate for solving this 
problem, but it's not yet released and in any case not widely installed as yet.


___
Distutils-SIG maillist  -  Distutils-SIG@python.org
http://mail.python.org/mailman/listinfo/distutils-sig


[Distutils] Fwd: [Catalog-sig] Trove categories for Buildout recipes and extensions

2011-01-25 Thread Baiju M
Hi,
I am forwarding a mail from Catalog-sig regarding two new trove categories
for Buildout recipes and extensions. Those who publish Buildout recipes and
extensions to PyPI, please use the new trove classifiers in addition to
the existing Framework :: Buildout.

If you are developing a recipe, use this classifier:

  classifiers=[
...
Framework :: Buildout,
Framework :: Buildout :: Recipe,
...
],

If you are developing an extension, use this classifier:

  classifiers=[
...
Framework :: Buildout,
Framework :: Buildout :: Extension,
...
],

If the distribution contains both extension and recipe, use:

  classifiers=[
...
Framework :: Buildout,
Framework :: Buildout :: Extension,
Framework :: Buildout :: Recipe,
...
],

Regards,
Baiju M


-- Forwarded message --
From: Richard Jones rich...@python.org
Date: Wed, Jan 26, 2011 at 4:08 AM
Subject: Re: [Catalog-sig] Trove categories for Buildout recipes and extensions
To: Baiju M baiju.m.m...@gmail.com
Cc: catalog-...@python.org


On Tue, Jan 18, 2011 at 5:33 PM, Baiju M baiju.m.m...@gmail.com wrote:
 It would be nice if we can add two sub categories:

  Framework :: Buildout :: Recipe
  Framework :: Buildout :: Extension

There being no objections I've added these classifiers.


    Richard
___
Distutils-SIG maillist  -  Distutils-SIG@python.org
http://mail.python.org/mailman/listinfo/distutils-sig