-- | Functions for working with streams of input events. -- Unless stated otherwise, these functions will throw exceptions if the underlying C calls fail. module Evdev.Stream ( allDevices, allEvents, makeDevices, newDevices, newDevices', readEvents, readEventsMany, ) where import Data.Bool import Data.Either.Extra import Data.Functor import System.IO import System.IO.Error import Control.Concurrent (threadDelay) import Data.Set (Set) import qualified Data.Set as Set import qualified Data.ByteString.Char8 as BS import RawFilePath.Directory (RawFilePath,doesFileExist,listDirectory) import qualified Streamly.FSNotify as N import Streamly.FSNotify (FSEntryType(NotDir),watchDirectory) import System.FilePath.ByteString (()) import Streamly.Prelude (AsyncT, IsStream, MonadAsync, SerialT) import qualified Streamly.Prelude as S import Evdev --TODO provide a 'group' operation on streams, representing packets as sets -- | Read all events from a device. readEvents :: Device -> SerialT IO Event readEvents = S.repeatM . nextEvent -- | Concurrently read events from multiple devices. -- If a read fails on one, the exception is printed to stderr and the stream continues to read from the others. readEventsMany :: IsStream t => AsyncT IO Device -> t IO (Device, Event) readEventsMany ds = S.fromAsync $ do d <- ds S.map (d,) $ S.fromSerial $ readEvents' d where -- catch all IO errors readEvents' = unfoldM . printIOError' . nextEvent readEvents' :: Device -> SerialT IO Event -- | Create devices for all paths in the stream. makeDevices :: IsStream t => t IO RawFilePath -> t IO Device makeDevices = S.mapM newDevice -- | All events on all valid devices (in /\/dev\/input/). -- Prints any exceptions. -- -- > allEvents == readEventsMany allDevices allEvents :: IsStream t => t IO (Device, Event) allEvents = readEventsMany allDevices --TODO call this 'oldDevices' or 'existingDevices', and have 'allDevices' include 'newDevices'? -- | All valid existing devices (in /\/dev\/input/). -- If a device can't be initialised for an individual path, then the exception is printed, -- and the function continues to try to initialise the others. allDevices :: (IsStream t, Monad (t IO)) => t IO Device allDevices = let paths = S.filterM doesFileExist $ S.map (evdevDir ) $ S.fromFoldable =<< S.fromEffect (reverse <$> listDirectory evdevDir) in S.mapMaybeM (printIOError' . newDevice) paths --TODO perhaps streamly-fsnotify ought to use RawFilePath? --TODO fix this - we don't always seem to get notified of permission changes - -- indeed when we don't, we actually find that 'stat' and 'ls -l' show different permissions to: -- 'fmap (flip showOct "" . fileMode) . getFileStatus' -- | All new devices created (in /\/dev\/input/). -- Watches for new file paths (using \inotify\), and those corresponding to valid devices are added to the stream. newDevices :: (IsStream t, Monad (t IO)) => t IO Device newDevices = let -- 'watching' keeps track of the set of paths which have been added, but don't yet have the right permissions watch :: Set RawFilePath -> N.Event -> IO (Maybe Device, Set RawFilePath) watch watching = \case N.Added (BS.pack -> p) _ NotDir -> tryNewDevice p <&> \case Right d -> -- success - return new device (Just d, watching) Left e -> -- fail - if it's only a permission error then watch for changes on device (Nothing, applyWhen (isPermissionError e) (Set.insert p) watching) N.Modified (BS.pack -> p) _ NotDir -> if p `elem` watching then tryNewDevice p <&> \case Right d -> -- success - no longer watch for changes (Just d, Set.delete p watching) Left _ -> -- fail - continue to watch (Nothing, watching) else -- this isn't an event we care about return (Nothing, watching) N.Removed (BS.pack -> p) _ NotDir -> -- device is gone - no longer watch for changes return (Nothing, Set.delete p watching) _ -> return (Nothing, watching) tryNewDevice = printIOError . newDevice in do (_,es) <- S.fromEffect $ watchDirectory (BS.unpack evdevDir) N.everything scanMaybe watch Set.empty es --TODO just fix 'newDevices' -- | This is a workaround for bugginess in 'newDevices' when it comes to waiting for permissions on a new device -- - it just waits the number of microseconds given before trying to read from the device. newDevices' :: (IsStream t, Monad (t IO)) => Int -> t IO Device newDevices' delay = let f = \case N.Added (BS.pack -> p) _ NotDir -> do threadDelay delay eitherToMaybe <$> tryNewDevice p _ -> return Nothing tryNewDevice = printIOError . newDevice in do (_,es) <- S.fromEffect $ watchDirectory (BS.unpack evdevDir) N.everything S.mapMaybeM f es {- Util -} -- specialized form of S.scanlM' -- for each a, f updates s, and possibly produces a new b, to add to the output stream -- I really can't think of a good name for this... -- TODO perhaps some way to use State monad instead? scanMaybe :: (IsStream t, Monad m) => (s -> a -> m (Maybe b, s)) -> s -> t m a -> t m b scanMaybe f e = S.mapMaybe fst . S.scanlM' (f . snd) (pure (Nothing, e)) -- specialised form of S.unfoldrM -- this should perhaps be in streamly (it's in monad-loops) --TODO this is rather ugly - can it be done in terms of the Unfold type? unfoldM :: (IsStream t, MonadAsync m) => m (Maybe a) -> t m a unfoldM x = S.unfoldrM (const $ fmap (,undefined) <$> x) undefined --TODO get rid - this isn't a great approach for a library -- like tryIOError, but also prints the error to stderr printIOError :: IO a -> IO (Either IOError a) printIOError f = (Right <$> f) `catchIOError` \err -> do hPrint stderr err return $ Left err -- variant of printIOError which doesn't care what the exception was printIOError' :: IO a -> IO (Maybe a) printIOError' = fmap eitherToMaybe . printIOError -- apply the function iff the guard passes applyWhen :: Bool -> (a -> a) -> a -> a applyWhen = flip $ bool id