Come posso creare un file .tar.gz adatto per l'uso con `cabal upload`?

Question

Il modo standard per condividere una libreria Haskell con altri programmatori è creare un pacchetto Cabal e caricarlo su http://hackage.haskell.org. Ho scritto una libreria che desidero condividere e Ho creato con successo un pacchetto Cabal utilizzando le linee guida online per la creazione di file cabal. Ho creato il pacchetto e l'ho installato localmente. — funziona correttamente. Ora voglio caricarlo su Hackage. Ma cabal upload vuole un file .tar.gz. Ci sono risme della documentazione di Cabal, e non riesco a trovare quello che dovrebbe entrare in questo .tar.gz o come dovrei crearlo.

Chi sa, o sa dove posso scoprire, come creare un .tar.gz che funzionerà correttamente con cabal upload?

Answer 1

Da the wiki:

Dal momento che il codice è cabalised, possiamo creare un tarball con cabala-install direttamente (si può anche usare runhaskell Setup.hs sdist, ma è necessario il catrame sul sistema 1):

$ cabal sdist 
Building source dist for haq-0.0... 
Source tarball created: dist/haq-0.0.tar.gz 

Questo ha il vantaggio che Cabala farà un po 'più di controllo, e garantire che l'archivio ha la struttura che HackageDB aspetta. Si noti che richiede il file LICENSE per esistere. Riunisce i file necessari per costruire il progetto; per includere altri file (come ad esempio Test.hs nell'esempio di cui sopra, e la nostra README), abbiamo bisogno di aggiungere:

extra-source-files: Tests.hs README 

al file .cabal di avere tutto incluso.

Answer 2

Oppure, se si sta utilizzando darcs,

darcs dist 

Nota che cabal sdist sarà solo raccogliere i file elencati nel file .cabal, quindi potrebbe essere necessario aggiungere file README ecc sotto extra-source-files:

È possibile controllare hai un tarball valido con

cabal check 

che esegue gli stessi test eseguiti da Hackage.