Login | Register For Free | Help
Search for: (Advanced)

Mailing List Archive: Python: Python

Running a script to build docs from setup.py

 

 

Python python RSS feed   Index | Next | Previous | View Threaded


h at realh

Jul 9, 2009, 9:33 AM

Post #1 of 3 (264 views)
Permalink
Running a script to build docs from setup.py

I want to write a setup.py script, using distutils, for a python library
called ROX-Lib2 (package name "rox"). The library includes a script to
build HTML documentation from the pydoc strings. I'd like to run that
script from setup.py but I don't know the best way to do that. I've
looked through the manual but I can't find any hooks in distutils for
generating files at install time other than extension modules and .pyc
files. Should I just run the script from somewhere in my setup.py before
calling distutils' setup function?

--
TH * http://www.realh.co.uk

--
http://mail.python.org/mailman/listinfo/python-list


ben+python at benfinney

Jul 9, 2009, 6:06 PM

Post #2 of 3 (238 views)
Permalink
Re: Running a script to build docs from setup.py [In reply to]

Tony Houghton <h [at] realh> writes:

> I've looked through the manual but I can't find any hooks in distutils
> for generating files at install time other than extension modules and
> .pyc files. Should I just run the script from somewhere in my setup.py
> before calling distutils' setup function?

Indirectly related: Ian Bicking's article on using Python's ‘setup.py’
as a ‘Makefile’ replacement:

<URL:http://blog.ianbicking.org/pythons-makefile.html>

If one is writing a ‘setup.py’ anyway, I think it makes sense to use
that as the build program for the whole project if possible. Good
hunting!

--
\ “I have an answering machine in my car. It says, ‘I'm home now. |
`\ But leave a message and I'll call when I'm out.’” —Steven Wright |
_o__) |
Ben Finney
--
http://mail.python.org/mailman/listinfo/python-list


h at realh

Jul 10, 2009, 10:43 AM

Post #3 of 3 (234 views)
Permalink
Re: Running a script to build docs from setup.py [In reply to]

On Fri, 10 Jul 2009 11:06:34 +1000
Ben Finney <ben+python [at] benfinney> wrote:

> Tony Houghton <h [at] realh> writes:
>
> > I've looked through the manual but I can't find any hooks in distutils
> > for generating files at install time other than extension modules and
> > .pyc files. Should I just run the script from somewhere in my setup.py
> > before calling distutils' setup function?
>
> Indirectly related: Ian Bicking's article on using Python's ‘setup.py’
> as a ‘Makefile’ replacement:
>
> <URL:http://blog.ianbicking.org/pythons-makefile.html>

Thanks, but I don't think that adds much to the distutils manual.

> If one is writing a ‘setup.py’ anyway, I think it makes sense to use
> that as the build program for the whole project if possible. Good
> hunting!

Yes. Really I only want to write a setup.py because it makes it easier
to make a debian package, but the more of the installation that's done
by setup.py the better I suppose, then other people might find it
useful.

--
TH * http://www.realh.co.uk

--
http://mail.python.org/mailman/listinfo/python-list

Python python RSS feed   Index | Next | Previous | View Threaded
 
 


Interested in having your list archived? Contact Gossamer Threads
 
  Web Applications & Managed Hosting Powered by Gossamer Threads Inc.