Hackage :: [Package]

self-extract: A Haskell library to make self-extracting executables

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

A Haskell library to make self-extracting executables.

[Skip to Readme]

Properties

Versions 0.1.0.0, 0.2.0.0, 0.2.0.0, 0.2.1, 0.3.0, 0.3.1, 0.3.2, 0.3.3, 0.3.4, 0.4.0, 0.4.1
Change log CHANGELOG.md
Dependencies base (>=4.7 && <5), binary (>=0.8.5 && <0.9), bytestring (>=0.10.8 && <0.11), Cabal (>=2.0 && <3), extra (>=1.6 && <1.7), file-embed (>=0.0.10 && <0.1), path (>=0.6 && <0.7), path-io (>=1.3 && <1.4), process (>=1.6 && <1.7), unix-compat (>=0.5 && <0.6) [details]
License BSD-3-Clause
Author Brandon Chinn <brandon@leapyear.io>
Maintainer Brandon Chinn <brandon@leapyear.io>
Category Distribution
Source repo head: git clone https://github.com/brandon-leapyear/self-extract.git
Uploaded by brandonchinn178 at 2018-05-16T22:47:49Z

Modules

[Index]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Readme for self-extract-0.2.0.0

[back to package description]

self-extract

A Haskell library that can make an executable self-extracting.

Usage

.cabal file

...
build-type: Custom
...

custom-setup
  setup-depends: base, Cabal, self-extract

...

executable name-of-executable
  build-depends: self-extract, ...
  ...

Setup.hs

import Codec.SelfExtract.Distribution (bundle)
import Distribution.Simple

main = defaultMainWithHooks simpleUserHooks
  { postCopy = \args cf pd lbi -> do
      postCopy simpleUserHooks args cf pd lbi
      bundle "name-of-executable" "dir-to-bundle" lbi
  }

Executable file

import Codec.SelfExtract (extractTo)

main = do
  extractTo "dir" -- will extract to $CWD/dir
  extractTo "/usr/local/lib"
  ...

Extract to a temporary directory:

import Codec.SelfExtract (withExtractToTemp)
import System.Directory (removeDirectory)

main = do
  withExtractToTemp $ \tmp -> do
    ...

Details

The above instructions should be a black box, but here is an explanation of the implementation if you need to know the details of how it works.

When the executable containing extractTo is built, some space will be allocated to contain the size of the binary.

bundle will find the executable from LocalBuildInfo's buildDir. It will take the directory specified and run tar on it. It will also get the size of the executable and write the size into the space allocated by extractTo. Then bundle will replace the executable with the executable itself concatenated with the tar archive.

When extractTo is called, it will read the size of the executable that was written in bundle. After seeking to the size of the binary, the tar archive can be extracted to the desired directory.