Why types matter
@volpegabriel87
@gvolpe
A motivating example
@volpegabriel87
@gvolpe
showName :: String -> String -> String -> String
showName username name email =
"Hi " <> name <> "! "
<> "Your username is " <> username
<> " and your email is " <> email
main :: IO ()
main = putStrLn $
showName "gvolpe@github.com" "12345" "foo"
Dealing with Strings
A motivating example
@volpegabriel87
@gvolpe
Let's do better!
@volpegabriel87
@gvolpe
newtype Username = Username { unUsername :: String }
newtype Name = Name { unName :: String }
newtype Email = Email { unEmail :: String }
main :: IO ()
main = putStrLn $ showName' u n e
where
u = Username "gvolpe@github.com"
n = Name "12345"
e = Email ""
{-# LANGUAGE RecordWildCards #-}
showName' :: Username -> Name -> Email -> String
showName' Username {..} Name {..} Email {..} =
"Hi " <> unName <> "! "
<> "Your username is " <> unUsername
<> " and your email is " <> unEmail
Newtypes
Let's do better!
@volpegabriel87
@gvolpe
mkUsername :: String -> Maybe Username
mkUsername [] = Nothing
mkUsername u = Just (Username u)
mkName :: String -> Maybe Name
mkName [] = Nothing
mkName n = Just (Name n)
-- Let's pretend we validate it properly
mkEmail :: String -> Maybe Email
mkEmail e =
if '@' `elem` e then Just (Email e) else Nothing
main :: IO ()
main = putStrLn $ showName' u n e
where
u = fromMaybe (error "Invalid username") (mkUsername "g")
n = fromMaybe (error "Invalid name") (mkName "G")
e = fromMaybe (error "Invalid email") (mkEmail "123")
Smart Constructors
Let's do better!
@volpegabriel87
@gvolpe
λ main
types-matter: Invalid email
CallStack (from HasCallStack):
error, called at app/Main.hs:20:25 in main:Main
Smart Constructors
RUNTIME VALIDATION
Refinement Types
@volpegabriel87
@gvolpe
{-# LANGUAGE DataKinds, FlexibleInstances #-}
{-# LANGUAGE MultiParamTypeClasses, TypeSynonymInstances #-}
import Refined
data EmailPred
instance Predicate EmailPred String where
validate p value = unless ('@' `elem` value)
$ throwRefineOtherException (typeOf p) "Invalid email"
type Username' = Refined NonEmpty String
type Name' = Refined NonEmpty String
type Email' = Refined EmailPred String
Because we can do better
Refinement Types
@volpegabriel87
@gvolpe
{-# LANGUAGE TemplateHaskell #-}
main :: IO ()
main = putStrLn $ showNameRefined u n e
where
u = $$(refineTH "gvolpe") :: Username'
n = $$(refineTH "Gabriel") :: Name'
e = $$(refineTH "123#abc") :: Email'
Because we can do better
showNameRefined :: Username' -> Name' -> Email' -> String
showNameRefined username name email =
"Hi " <> unrefine name <> "! "
<> "Your username is " <> unrefine username
<> " and your email is " <> unrefine email
Refinement Types
@volpegabriel87
@gvolpe
COMPILE TIME VALIDATION
λ app/Main.hs:23:18: error:
* The predicate (EmailPred) does not hold:
Invalid email
* In the Template Haskell splice $$(refineTH "123#abc")
In the expression: $$(refineTH "123#abc") :: Email'
In an equation for email':
email' = $$(refineTH "123#abc") :: Email'
|
23 | email' = $$(refineTH "123#abc") :: Email'
| ^^^^^^^^^^^^^^^^^^
Refinement Types
@volpegabriel87
@gvolpe
Creation functions
Another example
@volpegabriel87
@gvolpe
newtype HttpHost = HttpHost { unHost :: Text }
newtype HttpPort = HttpPort { unPort :: Int }
newtype HttpUri = HttpUri { unUri :: Text }
mkHttpHost :: Text -> Maybe HttpHost
mkHttpHost (null -> True) = Nothing
mkHttpHost h = Just (HttpHost h)
-- Validation happens at runtime
mkHttpPort :: Int -> Maybe HttpPort
mkHttpPort n =
if n >= 1024 && n <= 49151
then Just (HttpPort n)
else Nothing
-- We assume the inputs are validated
mkUri :: HttpHost -> HttpPort -> HttpUri
mkUri HttpHost {..} HttpPort {..} =
HttpUri (pack $ unHost <> ":" <> show unPort)
Validated Http URI
Another example
@volpegabriel87
@gvolpe
main :: IO ()
main = print $ mkUri h p
where
h = fromMaybe (error "Invalid host") (mkHttpHost "127.0.0.1")
p = fromMaybe (error "Invaild port") (mkHttpPort 123)
Validated Http URI
λ main
types-matter: Invaild port
CallStack (from HasCallStack):
error, called at app/Main.hs:31:22 in main:Main
RUNTIME VALIDATION
Refinement Types
@volpegabriel87
@gvolpe
type HttpHost' = Refined NonEmpty Text
type HttpPort' = Refined (FromTo 1024 49151) Int
mkUri' :: HttpHost' -> HttpPort' -> HttpUri
mkUri' host port =
HttpUri (unrefine host <> ":" <> pack (show $ unrefine port))
Validated Http URI
{-# LANGUAGE OverloadedStrings, TemplateHaskell #-}
main :: IO ()
main = print $ mkUri h p
where
h = $$(refineTH "localhost") :: HttpHost'
p = $$(refineTH 123) :: HttpPort'
Refinement Types
@volpegabriel87
@gvolpe
Validated Http URI
λ app/Main.hs:33:14: error:
* The predicate (FromTo 1024 49151) does not hold:
Value is out of range (minimum: 1024, maximum: 49151)
* In the Template Haskell splice $$(refineTH 123)
In the expression: $$(refineTH 123) :: HttpPort'
In an equation for port': port' = $$(refineTH 123) :: HttpPort'
|
33 | port' = $$(refineTH 123) :: HttpPort'
| ^^^^^^^^^^^^
COMPILE TIME VALIDATION
Refinement Types
@volpegabriel87
@gvolpe
-
Logical Predicates
- Not, And, Or
-
Numeric Predicates
- LessThan
- GreaterThan
- EqualTo
- From, To, FromTo
- Positive, Negative
-
Foldable Predicates
- SizeEqualTo
- NonEmpty
Refinement Types
@volpegabriel87
@gvolpe
{-# LANGUAGE DataKinds, FlexibleInstances #-}
{-# LANGUAGE MultiParamTypeClasses, TypeSynonymInstances #-}
import Refined
data LowerCase
instance Predicate LowerCase String where
validate p value = unless (all isLower value)
$ throwRefineOtherException (typeOf p) "Not all chars are lowercase"
type LowerCaseString = Refined LowerCase String
Custom Predicates
Performance
@volpegabriel87
@gvolpe
The unrefine function bears zero overhead, since it mearly unwraps newtype. The refineTH function bears zero runtime overhead as well, since it simply packs a value into newtype.
Quoting Nikita Volkov (author):
¡Muchas gracias!
@volpegabriel87
@gvolpe
A type-safe world
By Gabriel Volpe
A type-safe world
A type-safe world
- 2,054