Hackage :: [Package]

xfconf: FFI bindings to xfconf

[ gpl, library, system, xfce ] [ Propose Tags ]

Xfconf is a simple client-server configuration storage and query system build on top of glib and used by XFCE.

[Skip to Readme]

Flags

Automatic Flags
NameDescriptionDefault
buildtests

Build the two test suites

Disabled

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 4.8.0.0
Dependencies base (>=3.0 && <5.0), glib (>=0.12), HUnit (>=1.2 && <1.3), QuickCheck (>=2.1), test-framework (>=0.3 && <0.4), test-framework-hunit (>=0.2 && <0.3), test-framework-quickcheck2 (>=0.2 && <0.3) [details]
License GPL-3.0-only
Author John Obbele
Maintainer john.obbele@gmail.com
Revised Revision 1 made by HerbertValerioRiedel at 2016-08-21T12:59:55Z
Category System, XFCE
Home page http://patch-tag.com/r/obbele/xfconf/home
Source repo head: darcs get http://patch-tag.com/r/obbele/xfconf/home
Uploaded by JohnObbele at 2011-04-15T17:52:19Z
Distributions
Reverse Dependencies 1 direct, 0 indirect [details]
Executables testGlib, tests
Downloads 1169 total (5 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Successful builds reported [all 3 reports]

Readme for xfconf-4.8.0.0

[back to package description] 
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 hThemes[0], a small
utility to quickly save and load pre-configured xfconf settings (notably
wallpapers, gtk+2 & xfwm4 themes).

[0]: https://patch-tag.com/r/obbele/hThemes/home

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.