name: regions version: 0.4 cabal-version: >=1.6 build-type: Simple license: BSD3 license-file: LICENSE copyright: 2010 Bas van Dijk author: Bas van Dijk maintainer: Bas van Dijk stability: experimental category: Control, Monadic Regions synopsis: Provides the region monad for safely opening and working with scarce resources. description: This package provides the region monad transformer. Scarce resources like files, memory pointers or USB devices for example can be opened in a region. When the region terminates, all opened resources will be automatically closed. The main advantage of regions is that the opened resources can not be returned from the region which ensures no I/O with closed resources is possible. . The primary technique used in this package is called \"Lightweight monadic regions\" which was invented by Oleg Kiselyov and Chung-chieh Shan. See: . . Also see the @regions-monadsfd@ and @regions-monadstf@ packages which provide instances for the classes in the respected monads packages. . For an example on how to use this library see the @safer-file-handles@, @usb-safe@ or @regional-pointers@ packages. . Note that if you want to open /your/ type of scarce resource in a region, the only thing you have to do is define an instance for the @Resource@ class (which you can find in: @Control.Resource@). source-repository head Type: darcs Location: http://code.haskell.org/~basvandijk/code/regions Library GHC-Options: -Wall build-depends: base >= 4 && < 4.3 , base-unicode-symbols >= 0.1.1 && < 0.2 , transformers >= 0.1.4 && < 0.2 , MonadCatchIO-transformers >= 0.0.2.0 && < 0.1 exposed-modules: Control.Resource Control.Monad.Trans.Region Control.Monad.Trans.Region.Unsafe Data.RegionRef other-modules: Control.Monad.Trans.Region.Internal