diff --git a/LICENSE b/LICENSE new file mode 100644 --- /dev/null +++ b/LICENSE @@ -0,0 +1,22 @@ +Copyright (c) 2013 Gabriel Gonzalez, 2018 Metrix.AI + +Permission is hereby granted, free of charge, to any person +obtaining a copy of this software and associated documentation +files (the "Software"), to deal in the Software without +restriction, including without limitation the rights to use, +copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the +Software is furnished to do so, subject to the following +conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES +OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT +HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +OTHER DEALINGS IN THE SOFTWARE. diff --git a/Setup.hs b/Setup.hs new file mode 100644 --- /dev/null +++ b/Setup.hs @@ -0,0 +1,2 @@ +import Distribution.Simple +main = defaultMain diff --git a/acquire.cabal b/acquire.cabal new file mode 100644 --- /dev/null +++ b/acquire.cabal @@ -0,0 +1,49 @@ +name: + acquire +version: + 0.1 +synopsis: + Abstraction over management of resources +description: + An implementation of the abstraction suggested in + . +category: + Resources +homepage: + https://github.com/metrix-ai/acquire +bug-reports: + https://github.com/metrix-ai/acquire/issues +author: + Nikita Volkov +maintainer: + Metrix.AI Ninjas +copyright: + (c) 2013 Gabriel Gonzalez, 2018 Metrix.AI +license: + MIT +license-file: + LICENSE +build-type: + Simple +cabal-version: + >=1.10 + +source-repository head + type: + git + location: + git://github.com/metrix-ai/acquire.git + +library + hs-source-dirs: + library + default-extensions: + Arrows, BangPatterns, ConstraintKinds, DataKinds, DefaultSignatures, DeriveDataTypeable, DeriveFoldable, DeriveFunctor, DeriveGeneric, DeriveTraversable, EmptyDataDecls, FlexibleContexts, FlexibleInstances, FunctionalDependencies, GADTs, GeneralizedNewtypeDeriving, InstanceSigs, LambdaCase, LiberalTypeSynonyms, MagicHash, MultiParamTypeClasses, MultiWayIf, NoImplicitPrelude, NoMonomorphismRestriction, OverloadedStrings, PatternGuards, ParallelListComp, QuasiQuotes, RankNTypes, RecordWildCards, ScopedTypeVariables, StandaloneDeriving, TemplateHaskell, TupleSections, TypeFamilies, TypeOperators, UnboxedTuples + default-language: + Haskell2010 + exposed-modules: + Acquire + other-modules: + Acquire.Prelude + build-depends: + base >=4.7 && <5 diff --git a/library/Acquire.hs b/library/Acquire.hs new file mode 100644 --- /dev/null +++ b/library/Acquire.hs @@ -0,0 +1,48 @@ +module Acquire +( + Acquire(..), + with, +) +where + +import Acquire.Prelude + + +{-| +Implementation of http://www.haskellforall.com/2013/06/the-resource-applicative.html +-} +newtype Acquire resource = + Acquire (IO (resource, IO ())) + +instance Functor Acquire where + fmap f (Acquire io) = + Acquire $ do + (resource, release) <- io + return (f resource, release) + +instance Applicative Acquire where + pure resource = + Acquire (pure (resource, pure ())) + Acquire io1 <*> Acquire io2 = + Acquire $ do + (f, release1) <- io1 + (x, release2) <- onException io2 release1 + return (f x, release2 >> release1) + +instance Monad Acquire where + return = pure + (>>=) (Acquire io1) k2 = + Acquire $ do + (resource1, release1) <- io1 + (resource2, release2) <- case k2 resource1 of Acquire io2 -> onException io2 release1 + return (resource2, release2 >> release1) + +instance MonadIO Acquire where + liftIO io = + Acquire (fmap (, return ()) io) + +with :: Acquire resource -> (resource -> IO a) -> IO a +with (Acquire io) handle = + do + (resource, release) <- io + finally (handle resource) release diff --git a/library/Acquire/Prelude.hs b/library/Acquire/Prelude.hs new file mode 100644 --- /dev/null +++ b/library/Acquire/Prelude.hs @@ -0,0 +1,69 @@ +module Acquire.Prelude +( + module Exports, +) +where + +-- base +------------------------- +import Control.Applicative as Exports +import Control.Arrow as Exports +import Control.Category as Exports +import Control.Concurrent as Exports +import Control.Exception as Exports +import Control.Monad as Exports hiding (mapM_, sequence_, forM_, msum, mapM, sequence, forM) +import Control.Monad.IO.Class as Exports +import Control.Monad.Fix as Exports hiding (fix) +import Control.Monad.ST as Exports +import Data.Bits as Exports +import Data.Bool as Exports +import Data.Char as Exports +import Data.Coerce as Exports +import Data.Complex as Exports +import Data.Data as Exports +import Data.Dynamic as Exports +import Data.Either as Exports +import Data.Fixed as Exports +import Data.Foldable as Exports +import Data.Function as Exports hiding (id, (.)) +import Data.Functor as Exports +import Data.Int as Exports +import Data.IORef as Exports +import Data.Ix as Exports +import Data.List as Exports hiding (sortOn, isSubsequenceOf, uncons, concat, foldr, foldl1, maximum, minimum, product, sum, all, and, any, concatMap, elem, foldl, foldr1, notElem, or, find, maximumBy, minimumBy, mapAccumL, mapAccumR, foldl') +import Data.Maybe as Exports +import Data.Monoid as Exports +import Data.Ord as Exports +import Data.Proxy as Exports +import Data.Ratio as Exports +import Data.STRef as Exports +import Data.String as Exports +import Data.Traversable as Exports +import Data.Tuple as Exports +import Data.Unique as Exports +import Data.Version as Exports +import Data.Word as Exports +import Debug.Trace as Exports +import Foreign.ForeignPtr as Exports +import Foreign.Ptr as Exports +import Foreign.StablePtr as Exports +import Foreign.Storable as Exports +import GHC.Conc as Exports hiding (withMVar, threadWaitWriteSTM, threadWaitWrite, threadWaitReadSTM, threadWaitRead) +import GHC.Exts as Exports (lazy, inline, sortWith, groupWith) +import GHC.Generics as Exports (Generic) +import GHC.IO.Exception as Exports +import Numeric as Exports +import Prelude as Exports hiding (concat, foldr, mapM_, sequence_, foldl1, maximum, minimum, product, sum, all, and, any, concatMap, elem, foldl, foldr1, notElem, or, mapM, sequence, id, (.)) +import System.Environment as Exports +import System.Exit as Exports +import System.IO as Exports (Handle, hClose) +import System.IO.Error as Exports +import System.IO.Unsafe as Exports +import System.Mem as Exports +import System.Mem.StableName as Exports +import System.Timeout as Exports +import Text.ParserCombinators.ReadP as Exports (ReadP, ReadS, readP_to_S, readS_to_P) +import Text.ParserCombinators.ReadPrec as Exports (ReadPrec, readPrec_to_P, readP_to_Prec, readPrec_to_S, readS_to_Prec) +import Text.Printf as Exports (printf, hPrintf) +import Text.Read as Exports (Read(..), readMaybe, readEither) +import Unsafe.Coerce as Exports