cef3-raw-0.1.0: README.md

[![Linux Build Status][linux-build-icon]][linux-build]  [![Mac Build Status][mac-build-icon]][mac-build]  [![Windows Build Status][windows-build-icon]][windows-build]

Haskell bindings to [cef3].

There is also a WIP [cef3-simple] for some higher level functionality of some
common tasks. For usage example you can check the [cef3-example] repo.

## Installation

If you use nix or if you are on windows - see the specific subsections below.

Here is a general gist if you'd like to do it in some alternative way.

First you will need libcef (branch 1750) installed somewhere on your machine.
For linux or windows 64bit you can download it from the release page of this
repo. Alternatively you can build it [from source][cef3-1750] if you prefer.

Next you will need to tell ghc where the required lib and include dirs are, with
cabal you can do it like so:

```
cabal configure \
  --extra-lib-dirs="<cef3-location>/Release" \
  --extra-include-dirs="<cef3-location>" \
  --extra-include-dirs="<cef3-location>/include" \
  --extra-include-dirs="<cef3-location>/include/capi"
```

Then you should be able to install and use it.

### Linux - Nix/NixOS

If you don't have nix:

```
curl https://nixos.org/nix/install | sh
```

Otherwise

```
nix-build default.nix
```

Beware:
It takes about 20min and ~800M ram to build it on my machine.
I will add this package to nixpkgs in the future so you will be able
to automatically download it prebuild from binary caches, but for now
beware.

### Windows - Stack

You will need to have stack, curl and 7zip installed and in your PATH
for `setup.bat` to work.

```
.\scripts\setup.bat
```
This will download cef lib and place it in `C:\cef3-dev`

```
stack setup
.\scripts\configure.bat
```

The `configure.bat` will point stack to where `setup.bat` installed
the library.

Alternatively if you already have cef (branch 1750) installed
somewhere you can just point the configure in that direction:

```
.\scripts\configure.bat <path-to-cef>
```

Finally run `stack install` and you're golden.

### Mac
TODO...

---

Disclaimer: This bindings are based on one done by Daniel Austin
[here][bindings-cef3].

[cef3]: https://bitbucket.org/chromiumembedded/cef
[cef3-1750]: https://bitbucket.org/chromiumembedded/cef/branch/1750
[example]: https://github.com/haskell-ui/cef3-raw-example
[cef3-simple]: https://github.com/haskell-ui/cef3-simple
[cef3-example]: https://github.com/haskell-ui/cef3-example
[bindings-cef3]: https://github.com/fluffynukeit/bindings-cef3

[linux-build-icon]: https://img.shields.io/travis/haskell-ui/cef3-raw/master.svg?label=Linux%20build
[linux-build]: https://travis-ci.org/haskell-ui/cef3-raw
[mac-build-icon]: https://img.shields.io/badge/Mac%20build-TODO-lightgrey.svg
[mac-build]: https://github.com/haskell-ui/cef3-raw
[windows-build-icon]: https://img.shields.io/appveyor/ci/MaxOw/cef3-raw/master.svg?label=Windows%20build
[windows-build]: https://ci.appveyor.com/project/MaxOw/cef3-raw