The xfconf package

[ Tags: 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]

Properties

Versions 4.8.0.0
Dependencies base (>=3.0 && <5.0), glib (>=0.12), HUnit (==1.2.*), QuickCheck (>=2.1), test-framework (==0.3.*), test-framework-hunit (==0.2.*), test-framework-quickcheck2 (==0.2.*) [details]
License GPL-3
Author John Obbele
Maintainer john.obbele@gmail.com
Category System, XFCE
Home page http://patch-tag.com/r/obbele/xfconf/home
Source repository head: darcs get http://patch-tag.com/r/obbele/xfconf/home
Uploaded Fri Apr 15 17:52:19 UTC 2011 by JohnObbele
Updated Sun Aug 21 12:59:55 UTC 2016 by HerbertValerioRiedel to revision 1   [What is this?]
Distributions NixOS:4.8.0.0
Executables testGlib, tests
Downloads 355 total (4 in the last 30 days)
Rating (no votes yet) [estimated by rule of succession]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Successful builds reported [all 3 reports]
Hackage Matrix CI

Modules

[Index]

Flags

NameDescriptionDefaultType
buildtests

Build the two test suites

DisabledAutomatic

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

For package maintainers and hackage trustees


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.