[prev in list] [next in list] [prev in thread] [next in thread] 

List:       python-distutils-sig
Subject:    [Distutils]  layout and setup.py for packaging documentation
From:       Jean Daniel <jeandaniel.browne () gmail ! com>
Date:       2010-02-28 21:03:16
Message-ID: b61c19e71002281303s79c55e61u1eef6c82e07796ed () mail ! gmail ! com
[Download RAW message or body]

Hello,

I am looking for the simplest way to package the html files related to
a pure python module. At this point, I would like to just embed them
in the source tarball generated by distribute and leave it to a debian
or fedora package to install them. I would like a source tarball laid
out as the following:

    wordish-1.0.2/
        setup.py
        wordish.py
        docs/
            index.html
            command-ref.html

So far, I tended to use a single file python module because there was
no need for more and I wanted to keep it simple:

    wordish/
        setup.py
        wordish.py
        test_wordish.py

The setup.py is minimal:  setup( py_modules = [ 'wordish' ], ... )

But If I want to include docs, I must use the package_data command
which expects a package name. So I think that to embed documentation
in the source tarball, I should change the way I lay out the source
repository to something like  :

    wordish/
        setup.py
        wordish
            wordish.py
            __init__.py
            docs/
                index.html
                command-ref.html
       test_wordish.py

The corresponding setup.py would be

setup(
    packages = [ 'wordish' ],
    package_data = {'wordish':['docs/*']}, ...

I am not sure this is the right way to do it, just to include
documentations in the tarball:

- the package_data requires a package name, so I turn my pure python
module into a package just for this reason

- package_data requires the data directory to be inside the package
directory even though the html files are generated from doc sources
located elsewhere,

- there is an extra level of directory to get to the Python sources
module, it is my_virtualenv/wordish/wordish/wordish.py which does not
add much.

Can this be simpler?

Thanks for your help,
_______________________________________________
Distutils-SIG maillist  -  Distutils-SIG@python.org
http://mail.python.org/mailman/listinfo/distutils-sig
[prev in list] [next in list] [prev in thread] [next in thread]