@hackage / xfconf

Summary

Haskell bindings to XFCE 4.8 xfconf settings daemon.

Original xfconf API documentation can be found on: http://docs.xfce.org/api/xfconf/

Requirement

GHC and xfconf-devel/libxfconf obviously :)

You will need a fairly new version of haddock too (>= 2.8).

Cabal should take care of the rest.

Status

Presently, the whole thing is (almost) no more hackish. The system was integrated with cabal, a set of QuickCheck tests prove the storing and retrieving of large data sets to work properly and the XfconfChannel* objects inherit from regular gtk2hs-glib.GObjects.

Only Tests/TestGlib.hs appears broken.

Example

An application of this library can be found with hThemes0, a small utility to quickly save and load pre-configured xfconf settings (notably wallpapers, gtk+2 & xfwm4 themes).

How to build

Just try this:

bash $ make            # shortcut for cabal configure -f buildTests
                       #          and cabal build

How to use the Tests/*.hs binaries

Those tests require a working version of XFCE >= 4.8, as well as the haskell packages test-framework, test-framework-hunit, HUnit, test-framework-quickcheck2 and QuickCheck. The demo program requires the haskell binding for gtk. You can ask cabal to build it for you by specifying the flag "buildTests":

bash $ cabal configure -fbuildTests
bash $ cabal build
bash $ ./dist/build/tests/tests
bash $ ./dist/build/testGlib/testGlib
bash $ runghc Demo/Demo.hs

Or you can just quickly run them with one of the following shortcuts:

bash $ make test(s)         # run with 500 test samples
bash $ make testGlib        # test glib signals
                            # (need a -threaded binary)
bash $ make demo            # run the small xfconf bindings demo

You're welcomed to report any suggestions / bug reports to john obbele AT gmail.

© Copyright 2010-2011 John Obbele. All Rights Reserved.