#-}
-- |Utility functions used internally in this package.
module Network.HTTP.Lucu.Utils
- ( splitBy
+ ( Host
+ , PathSegment
+ , Path
+
+ , splitBy
, quoteStr
, parseWWWFormURLEncoded
+ , uriHost
, uriPathSegments
, trim
import Data.Ascii (Ascii, AsciiBuilder)
import qualified Data.Ascii as A
import Data.ByteString (ByteString)
-import qualified Data.ByteString.Char8 as Strict
+import qualified Data.ByteString.Char8 as BS
+import Data.CaseInsensitive (CI)
+import qualified Data.CaseInsensitive as CI
import Data.Char
import Data.Collections
import Data.Collections.BaseInstances ()
+import Data.Convertible.Base
+import Data.Convertible.Instances.Time ()
+import Data.Maybe
import Data.Monoid.Unicode
-import Data.Ratio
+import Data.Text (Text)
+import qualified Data.Text as T
import Data.Time
-import Data.Time.Clock.POSIX
import Network.URI
import Prelude hiding (last, mapM, null, reverse)
import Prelude.Unicode
import System.Directory
-import System.Time (ClockTime(..))
+
+-- |'Host' represents an IP address or a host name in an URI
+-- authority.
+type Host = CI Text
+
+-- |'PathSegment' represents an URI path segment, split by slashes and
+-- percent-decoded.
+type PathSegment = ByteString
+
+-- |'Path' is a list of URI path segments.
+type Path = [PathSegment]
-- |>>> splitBy (== ':') "ab:c:def"
-- ["ab", "c", "def"]
go (A.toByteString str) (∅) ⊕
A.toAsciiBuilder "\""
where
- go ∷ Strict.ByteString → AsciiBuilder → AsciiBuilder
+ go ∷ ByteString → AsciiBuilder → AsciiBuilder
go bs ab
- = case Strict.break (≡ '"') bs of
+ = case BS.break (≡ '"') bs of
(x, y)
- | Strict.null y
+ | BS.null y
→ ab ⊕ b2ab x
| otherwise
- → go (Strict.tail y)
+ → go (BS.tail y)
(ab ⊕ b2ab x ⊕ A.toAsciiBuilder "\\\"")
- b2ab ∷ Strict.ByteString → AsciiBuilder
+ b2ab ∷ ByteString → AsciiBuilder
b2ab = A.toAsciiBuilder ∘ A.unsafeFromByteString
-- |>>> parseWWWFormURLEncoded "aaa=bbb&ccc=ddd"
)
where
unescape ∷ String → ByteString
- unescape = Strict.pack ∘ unEscapeString ∘ (plusToSpace <$>)
+ unescape = BS.pack ∘ unEscapeString ∘ (plusToSpace <$>)
plusToSpace ∷ Char → Char
plusToSpace '+' = ' '
plusToSpace c = c
+-- |>>> uriHost "http://example.com/foo/bar"
+-- "example.com"
+uriHost ∷ URI → Host
+{-# INLINE uriHost #-}
+uriHost = CI.mk ∘ T.pack ∘ uriRegName ∘ fromJust ∘ uriAuthority
+
-- |>>> uriPathSegments "http://example.com/foo/bar"
-- ["foo", "bar"]
-uriPathSegments ∷ URI → [ByteString]
+uriPathSegments ∷ URI → Path
uriPathSegments uri
= let reqPathStr = uriPath uri
- reqPath = [unEscapeString x | x ← splitBy (≡ '/') reqPathStr, (¬) (null x)]
+ reqPath = [ unEscapeString x
+ | x ← splitBy (≡ '/') reqPathStr, (¬) (null x) ]
in
- Strict.pack <$> reqPath
+ BS.pack <$> reqPath
-- |>>> trim " ab c d "
-- "ab c d"
f = dropWhile isSpace
infixr 5 ⊲
--- | (B2;) = ('<|')
+-- | (⊲) = ('<|')
--
-- U+22B2, NORMAL SUBGROUP OF
(⊲) ∷ Sequence α a ⇒ a → α → α
(⊲) = (<|)
infixl 5 ⊳
--- | (B3;) = ('|>')
+-- | (⊳) = ('|>')
--
-- U+22B3, CONTAINS AS NORMAL SUBGROUP
(⊳) ∷ Sequence α a ⇒ α → a → α
(⊳) = (|>)
infixr 5 ⋈
--- | (C8;) = ('><')
+-- | (⋈) = ('><')
--
-- U+22C8, BOWTIE
(⋈) ∷ Sequence α a ⇒ α → α → α
-- |Get the modification time of a given file.
getLastModified ∷ FilePath → IO UTCTime
-getLastModified = (clockTimeToUTC <$>) ∘ getModificationTime
- where
- clockTimeToUTC ∷ ClockTime → UTCTime
- clockTimeToUTC (TOD sec picoSec)
- = posixSecondsToUTCTime ∘ fromRational
- $ sec % 1 + picoSec % (1000 ⋅ 1000 ⋅ 1000 ⋅ 1000)
+getLastModified = (cs <$>) ∘ getModificationTime