| Safe Haskell | Safe-Inferred |
|---|---|
| Language | Haskell2010 |
Test.WebDriver.Common.Profile
Description
A type for profile preferences. These preference values are used by both Firefox and Opera profiles.
Synopsis
- data Profile b = Profile {}
- newtype PreparedProfile b = PreparedProfile ByteString
- data ProfilePref
- = PrefInteger !Integer
- | PrefDouble !Double
- | PrefString !Text
- | PrefBool !Bool
- class ToPref a where
- toPref :: a -> ProfilePref
- getPref :: Text -> Profile b -> Maybe ProfilePref
- addPref :: ToPref a => Text -> a -> Profile b -> Profile b
- deletePref :: Text -> Profile b -> Profile b
- addExtension :: FilePath -> Profile b -> Profile b
- deleteExtension :: String -> Profile b -> Profile b
- hasExtension :: String -> Profile b -> Bool
- addFile :: FilePath -> FilePath -> Profile b -> Profile b
- deleteFile :: FilePath -> Profile b -> Profile b
- hasFile :: String -> Profile b -> Bool
- unionProfiles :: Profile b -> Profile b -> Profile b
- onProfileFiles :: Profile b -> (HashMap FilePath FilePath -> HashMap FilePath FilePath) -> Profile b
- onProfilePrefs :: Profile b -> (HashMap Text ProfilePref -> HashMap Text ProfilePref) -> Profile b
- prepareLoadedProfile_ :: MonadBase IO m => FilePath -> m (PreparedProfile a)
- prepareZippedProfile :: MonadBase IO m => FilePath -> m (PreparedProfile a)
- prepareZipArchive :: Archive -> PreparedProfile a
- prepareRawZip :: ByteString -> PreparedProfile a
- newtype ProfileParseError = ProfileParseError String
Profiles and profile preferences
This structure allows you to construct and manipulate profiles in pure code, deferring execution of IO operations until the profile is "prepared". This type is shared by both Firefox and Opera profiles; when a distinction must be made, the phantom type parameter is used to differentiate.
Constructors
| Profile | |
Fields
| |
newtype PreparedProfile b Source #
Represents a profile that has been prepared for network transmission. The profile cannot be modified in this form.
Constructors
| PreparedProfile ByteString |
Instances
| FromJSON (PreparedProfile s) Source # | |
Defined in Test.WebDriver.Common.Profile Methods parseJSON :: Value -> Parser (PreparedProfile s) # parseJSONList :: Value -> Parser [PreparedProfile s] # | |
| ToJSON (PreparedProfile s) Source # | |
Defined in Test.WebDriver.Common.Profile Methods toJSON :: PreparedProfile s -> Value # toEncoding :: PreparedProfile s -> Encoding # toJSONList :: [PreparedProfile s] -> Value # toEncodingList :: [PreparedProfile s] -> Encoding # | |
| Show (PreparedProfile b) Source # | |
Defined in Test.WebDriver.Common.Profile Methods showsPrec :: Int -> PreparedProfile b -> ShowS # show :: PreparedProfile b -> String # showList :: [PreparedProfile b] -> ShowS # | |
| Eq (PreparedProfile b) Source # | |
Defined in Test.WebDriver.Common.Profile Methods (==) :: PreparedProfile b -> PreparedProfile b -> Bool # (/=) :: PreparedProfile b -> PreparedProfile b -> Bool # | |
data ProfilePref Source #
A profile preference value. This is the subset of JSON values that excludes arrays, objects, and null.
Constructors
| PrefInteger !Integer | |
| PrefDouble !Double | |
| PrefString !Text | |
| PrefBool !Bool |
Instances
| FromJSON ProfilePref Source # | |
Defined in Test.WebDriver.Common.Profile | |
| ToJSON ProfilePref Source # | |
Defined in Test.WebDriver.Common.Profile Methods toJSON :: ProfilePref -> Value # toEncoding :: ProfilePref -> Encoding # toJSONList :: [ProfilePref] -> Value # toEncodingList :: [ProfilePref] -> Encoding # | |
| Show ProfilePref Source # | |
Defined in Test.WebDriver.Common.Profile Methods showsPrec :: Int -> ProfilePref -> ShowS # show :: ProfilePref -> String # showList :: [ProfilePref] -> ShowS # | |
| Eq ProfilePref Source # | |
Defined in Test.WebDriver.Common.Profile | |
| ToPref ProfilePref Source # | |
Defined in Test.WebDriver.Common.Profile Methods toPref :: ProfilePref -> ProfilePref Source # | |
A typeclass to convert types to profile preference values
Methods
toPref :: a -> ProfilePref Source #
Instances
Preferences
getPref :: Text -> Profile b -> Maybe ProfilePref Source #
Retrieve a preference from a profile by key name.
addPref :: ToPref a => Text -> a -> Profile b -> Profile b Source #
Add a new preference entry to a profile, overwriting any existing entry with the same key.
deletePref :: Text -> Profile b -> Profile b Source #
Delete an existing preference entry from a profile. This operation is silent if the preference wasn't found.
Extensions
addExtension :: FilePath -> Profile b -> Profile b Source #
Add a new extension to the profile. The file path should refer to a .xpi file or an extension directory on the filesystem.
deleteExtension :: String -> Profile b -> Profile b Source #
Delete an existing extension from the profile. The string parameter should refer to an .xpi file or directory located within the extensions directory of the profile. This operation has no effect if the extension was never added to the profile.
hasExtension :: String -> Profile b -> Bool Source #
Determines if a profile contains the given extension. specified as an .xpi file or directory name
Other files and directories
addFile :: FilePath -> FilePath -> Profile b -> Profile b Source #
Add a file to the profile directory. The first argument is the source of the file on the local filesystem. The second argument is the destination as a path relative to a profile directory. Overwrites any file that previously pointed to the same destination
deleteFile :: FilePath -> Profile b -> Profile b Source #
Delete a file from the profile directory. The first argument is the name of file within the profile directory.
hasFile :: String -> Profile b -> Bool Source #
Determines if a profile contains the given file, specified as a path relative to the profile directory.
Miscellaneous profile operations
unionProfiles :: Profile b -> Profile b -> Profile b Source #
Takes the union of two profiles. This is the union of their HashMap
fields.
onProfileFiles :: Profile b -> (HashMap FilePath FilePath -> HashMap FilePath FilePath) -> Profile b Source #
Modifies the profileFiles field of a profile
onProfilePrefs :: Profile b -> (HashMap Text ProfilePref -> HashMap Text ProfilePref) -> Profile b Source #
Modifies the profilePrefs field of a profile.
Preparing profiles from disk
prepareLoadedProfile_ :: MonadBase IO m => FilePath -> m (PreparedProfile a) Source #
Efficiently load an existing profile from disk and prepare it for network transmission.
Preparing zipped profiles
prepareZippedProfile :: MonadBase IO m => FilePath -> m (PreparedProfile a) Source #
Prepare a zip file of a profile on disk for network transmission. This function is very efficient at loading large profiles from disk.
prepareZipArchive :: Archive -> PreparedProfile a Source #
Prepare a zip archive of a profile for network transmission.
prepareRawZip :: ByteString -> PreparedProfile a Source #
Prepare a ByteString of raw zip data for network transmission
Profile errors
newtype ProfileParseError Source #
An error occured while attempting to parse a profile's preference file.
Constructors
| ProfileParseError String |
Instances
| Exception ProfileParseError Source # | |
Defined in Test.WebDriver.Common.Profile Methods toException :: ProfileParseError -> SomeException # | |
| Read ProfileParseError Source # | |
Defined in Test.WebDriver.Common.Profile Methods readsPrec :: Int -> ReadS ProfileParseError # readList :: ReadS [ProfileParseError] # | |
| Show ProfileParseError Source # | |
Defined in Test.WebDriver.Common.Profile Methods showsPrec :: Int -> ProfileParseError -> ShowS # show :: ProfileParseError -> String # showList :: [ProfileParseError] -> ShowS # | |
| Eq ProfileParseError Source # | |
Defined in Test.WebDriver.Common.Profile Methods (==) :: ProfileParseError -> ProfileParseError -> Bool # (/=) :: ProfileParseError -> ProfileParseError -> Bool # | |