I've only just started uploading packages to hackage (my package listing is
here) but currently there's a lot of repetitive activities for creating and updating packages.
For example, here's the steps in creating a package:
- Initialise a repository on github
- Initialise git repository locally
- Set github repository as remote
- Add a LICENSE file
- Add a standard ".gitignore file"
- Create a cabal file with the appropriate files that hackage requires including:
- Git repository source
- Issues page
- Licence
- Licence file
- Run multi-ghc-travis to create a ".travis.yml" file
- Make an initial commit and push
- Refresh travis-ci.org's repository list so it detects the new repository
There's also the stack stuff, but the GUI I'm using, IntelliJ with a Haskell plugin, handles most of that. It also creates a cabal file, but it's missing a number of key fields as mentioned above.
When I actually want to upload the package I go though these steps:
- Push to github
- Wait for Travis-CI to compile the package (this is a test to ensure it builds in a clean remote environment).
- Run "cabal sdist 2>&1"
- Parse the output of sdist to see where the dist file is.
- Run "hup packup fileFromSDist" to upload the package, putting in my hackage user/pass
- Run "hup docboth", to both build and upload the documentation.
- Tag the commit as a release
Currently, I've got two scripts with help with a lot of this, but it's a bit adhoc, and it's not fully automated (for example, I still have to manually ensure all the correct fields are in the cabal file, usually by copy/pasting from another package and modifying).
Are there any tools that I haven't found that make this process a bit more painless? I'm a bit new to this area, and I've only started using git recently as a prelude to uploading my Haskell packages, so admittedly I may have missed something obvious or perhaps I'm just doing it all wrong.
But if other people do find it painful like me, perhaps I'll put some effort into rewriting my perl scripts into nice haskell packages and executables for others to use.