7.1 Distribuzione di Python puro (tramite moduli)

Se si sta semplicemente distribuendo una coppia di moduli, specialmente se non risiedono in un particolare package, si possono specificare individualmente usando l'opzione dello script di setup py_modules.

Nel caso più semplice, si avranno due file di cui preoccuparsi: uno script di setup ed il singolo modulo che si sta distribuendo, in questo esempio il file foo.py:

<root>/
        setup.py
        foo.py

(In tutti i diagrammi in questa sezione, <root> si riferisce alla directory principale della distribuzione.) Uno script di setup minimale per descrivere questa situazione potrebbe essere:

from distutils.core import setup
setup(name='foo',
      version='1.0',
      py_modules=['foo'],
      )

Si noti che il nome della distribuzione viene specificato in modo indipendente attraverso l'opzione name e non ci sono regole che dicano che deve avere lo stesso nome dell'unico modulo della distribuzione (anche se potrebbe essere comunque una buona convenzione da seguire). Comunque, il nome della distribuzione viene usato per generare i nomi dei file, dovreste far uso di un buon numero di lettere, numeri, trattini bassi e trattini di congiunzione.

Visto che py_modules è una lista, si possono specificare moduli multipli, per esempio se si stanno distribuendo i moduli foo e bar, il setup dovrebbe somigliare a questo:

<root>/
        setup.py
        foo.py
        bar.py

E lo script di setup potrebbe essere

from distutils.core import setup
setup(name='foobar',
      version='1.0',
      py_modules=['foo', 'bar'],
      )

Si possono mettere i file sorgenti dei moduli in un'altra directory, ma se si hanno abbastanza moduli per fare ciò, è probabilmente più facile specificare i moduli per package anziché specificarli individualmente.

Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.