annotate lib/ur/basis.urs @ 1102:8d0f195710f1

Update manual's description of implicit arguments
author Adam Chlipala <adamc@hcoop.net>
date Wed, 30 Dec 2009 09:48:32 -0500
parents 118ab9641a64
children 72670131dace
rev   line source
adamc@56 1 type int
adamc@56 2 type float
adamc@56 3 type string
adamc@821 4 type char
adamc@436 5 type time
adamc@737 6 type blob
adamc@91 7
adamc@119 8 type unit = {}
adamc@119 9
adamc@186 10 datatype bool = False | True
adamc@186 11
adamc@288 12 datatype option t = None | Some of t
adamc@284 13
adamc@757 14 datatype list t = Nil | Cons of t * list t
adamc@757 15
adamc@91 16
adamc@256 17 (** Basic type classes *)
adamc@256 18
adamc@256 19 class eq
adamc@256 20 val eq : t ::: Type -> eq t -> t -> t -> bool
adamc@257 21 val ne : t ::: Type -> eq t -> t -> t -> bool
adamc@256 22 val eq_int : eq int
adamc@394 23 val eq_float : eq float
adamc@256 24 val eq_string : eq string
adamc@821 25 val eq_char : eq char
adamc@256 26 val eq_bool : eq bool
adamc@437 27 val eq_time : eq time
adamc@422 28 val mkEq : t ::: Type -> (t -> t -> bool) -> eq t
adamc@256 29
adamc@389 30 class num
adamc@417 31 val zero : t ::: Type -> num t -> t
adamc@389 32 val neg : t ::: Type -> num t -> t -> t
adamc@389 33 val plus : t ::: Type -> num t -> t -> t -> t
adamc@389 34 val minus : t ::: Type -> num t -> t -> t -> t
adamc@389 35 val times : t ::: Type -> num t -> t -> t -> t
adamc@775 36 val divide : t ::: Type -> num t -> t -> t -> t
adamc@389 37 val mod : t ::: Type -> num t -> t -> t -> t
adamc@389 38 val num_int : num int
adamc@390 39 val num_float : num float
adamc@389 40
adamc@391 41 class ord
adamc@391 42 val lt : t ::: Type -> ord t -> t -> t -> bool
adamc@391 43 val le : t ::: Type -> ord t -> t -> t -> bool
adamc@391 44 val gt : t ::: Type -> ord t -> t -> t -> bool
adamc@391 45 val ge : t ::: Type -> ord t -> t -> t -> bool
adamc@391 46 val ord_int : ord int
adamc@394 47 val ord_float : ord float
adamc@394 48 val ord_string : ord string
adamc@821 49 val ord_char : ord char
adamc@394 50 val ord_bool : ord bool
adamc@437 51 val ord_time : ord time
adamc@961 52 val mkOrd : t ::: Type -> {Lt : t -> t -> bool, Le : t -> t -> bool} -> ord t
adamc@391 53
adamc@256 54
adamc@1061 55 (** Character operations *)
adamc@1061 56
adamc@1061 57 val isalnum : char -> bool
adamc@1061 58 val isalpha : char -> bool
adamc@1061 59 val isblank : char -> bool
adamc@1061 60 val iscntrl : char -> bool
adamc@1061 61 val isdigit : char -> bool
adamc@1061 62 val isgraph : char -> bool
adamc@1061 63 val islower : char -> bool
adamc@1061 64 val isprint : char -> bool
adamc@1061 65 val ispunct : char -> bool
adamc@1061 66 val isspace : char -> bool
adamc@1061 67 val isupper : char -> bool
adamc@1061 68 val isxdigit : char -> bool
adamc@1061 69 val tolower : char -> char
adamc@1061 70 val toupper : char -> char
adamc@1061 71
adamc@1061 72
adamc@283 73 (** String operations *)
adamc@283 74
adamc@828 75 val strlen : string -> int
adamc@283 76 val strcat : string -> string -> string
adamc@821 77 val strsub : string -> int -> char
adamc@821 78 val strsuffix : string -> int -> string
adamc@829 79 val strchr : string -> char -> option string
adamc@829 80 val strindex : string -> char -> option int
adamc@831 81 val strcspn : string -> string -> option int
adamc@829 82 val substring : string -> int -> int -> string
adamc@1023 83 val str1 : char -> string
adamc@283 84
adamc@286 85 class show
adamc@286 86 val show : t ::: Type -> show t -> t -> string
adamc@286 87 val show_int : show int
adamc@286 88 val show_float : show float
adamc@286 89 val show_string : show string
adamc@821 90 val show_char : show char
adamc@286 91 val show_bool : show bool
adamc@436 92 val show_time : show time
adamc@452 93 val mkShow : t ::: Type -> (t -> string) -> show t
adamc@286 94
adamc@290 95 class read
adamc@290 96 val read : t ::: Type -> read t -> string -> option t
adamc@292 97 val readError : t ::: Type -> read t -> string -> t
adamc@292 98 (* [readError] calls [error] if the input is malformed. *)
adamc@290 99 val read_int : read int
adamc@290 100 val read_float : read float
adamc@290 101 val read_string : read string
adamc@821 102 val read_char : read char
adamc@290 103 val read_bool : read bool
adamc@436 104 val read_time : read time
adamc@777 105 val mkRead : t ::: Type -> (string -> t) -> (string -> option t) -> read t
adamc@288 106
adamc@283 107
adamc@564 108 (** * Monads *)
adamc@564 109
adamc@711 110 class monad :: (Type -> Type) -> Type
adamc@564 111 val return : m ::: (Type -> Type) -> t ::: Type
adamc@564 112 -> monad m
adamc@564 113 -> t -> m t
adamc@564 114 val bind : m ::: (Type -> Type) -> t1 ::: Type -> t2 ::: Type
adamc@564 115 -> monad m
adamc@564 116 -> m t1 -> (t1 -> m t2)
adamc@564 117 -> m t2
adamc@564 118
adamc@456 119 con transaction :: Type -> Type
adamc@564 120 val transaction_monad : monad transaction
adamc@456 121
adamc@565 122 con source :: Type -> Type
adamc@565 123 val source : t ::: Type -> t -> transaction (source t)
adamc@575 124 val set : t ::: Type -> source t -> t -> transaction unit
adamc@601 125 val get : t ::: Type -> source t -> transaction t
adamc@565 126
adamc@565 127 con signal :: Type -> Type
adamc@565 128 val signal_monad : monad signal
adamc@565 129 val signal : t ::: Type -> source t -> signal t
adamc@841 130 val current : t ::: Type -> signal t -> transaction t
adamc@456 131
adamc@456 132
adamc@1006 133 (** * Time *)
adamc@1006 134
adamc@1006 135 val now : transaction time
adamc@1050 136 val minTime : time
adamc@1006 137
adamc@1006 138
adamc@456 139 (** HTTP operations *)
adamc@456 140
adamc@456 141 val requestHeader : string -> transaction (option string)
adamc@456 142
adamc@459 143 con http_cookie :: Type -> Type
adamc@459 144 val getCookie : t ::: Type -> http_cookie t -> transaction (option t)
adamc@1050 145 val setCookie : t ::: Type -> http_cookie t -> {Value : t,
adamc@1050 146 Expires : option time,
adamc@1050 147 Secure : bool} -> transaction unit
adamc@1050 148 val clearCookie : t ::: Type -> http_cookie t -> transaction unit
adamc@459 149
adamc@456 150
adamc@566 151 (** JavaScript-y gadgets *)
adamc@566 152
adamc@566 153 val alert : string -> transaction unit
adamc@694 154 val spawn : transaction unit -> transaction unit
adamc@695 155 val sleep : int -> transaction unit
adamc@566 156
adamc@908 157 val rpc : t ::: Type -> transaction t -> transaction t
adamc@908 158
adamc@566 159
adamc@678 160 (** Channels *)
adamc@678 161
adamc@678 162 con channel :: Type -> Type
adamc@678 163 val channel : t ::: Type -> transaction (channel t)
adamc@678 164 val send : t ::: Type -> channel t -> t -> transaction unit
adamc@678 165 val recv : t ::: Type -> channel t -> transaction t
adamc@678 166
adamc@682 167 type client
adamc@682 168 val self : transaction client
adamc@682 169
adamc@678 170
adamc@203 171 (** SQL *)
adamc@203 172
adamc@705 173 con sql_table :: {Type} -> {{Unit}} -> Type
adamc@753 174 con sql_view :: {Type} -> Type
adamc@753 175
adamc@753 176 class fieldsOf :: Type -> {Type} -> Type
adamc@753 177 val fieldsOf_table : fs ::: {Type} -> keys ::: {{Unit}}
adamc@753 178 -> fieldsOf (sql_table fs keys) fs
adamc@753 179 val fieldsOf_view : fs ::: {Type}
adamc@753 180 -> fieldsOf (sql_view fs) fs
adamc@203 181
adamc@704 182 (*** Constraints *)
adamc@704 183
adamc@707 184 (**** Primary keys *)
adamc@707 185
adamc@707 186 class sql_injectable_prim
adamc@707 187 val sql_bool : sql_injectable_prim bool
adamc@707 188 val sql_int : sql_injectable_prim int
adamc@707 189 val sql_float : sql_injectable_prim float
adamc@707 190 val sql_string : sql_injectable_prim string
adamc@1011 191 val sql_char : sql_injectable_prim char
adamc@707 192 val sql_time : sql_injectable_prim time
adamc@737 193 val sql_blob : sql_injectable_prim blob
adamc@707 194 val sql_channel : t ::: Type -> sql_injectable_prim (channel t)
adamc@707 195 val sql_client : sql_injectable_prim client
adamc@707 196
adamc@707 197 con primary_key :: {Type} -> {{Unit}} -> Type
adamc@707 198 val no_primary_key : fs ::: {Type} -> primary_key fs []
adamc@707 199 val primary_key : rest ::: {Type} -> t ::: Type -> key1 :: Name -> keys :: {Type}
adamc@707 200 -> [[key1] ~ keys] => [[key1 = t] ++ keys ~ rest]
adamc@707 201 => $([key1 = sql_injectable_prim t] ++ map sql_injectable_prim keys)
adamc@707 202 -> primary_key ([key1 = t] ++ keys ++ rest)
adamc@707 203 [Pkey = [key1] ++ map (fn _ => ()) keys]
adamc@707 204
adamc@707 205 (**** Other constraints *)
adamc@707 206
adamc@705 207 con sql_constraints :: {Type} -> {{Unit}} -> Type
adamc@705 208 (* Arguments: column types, uniqueness implications of constraints *)
adamc@704 209
adamc@705 210 con sql_constraint :: {Type} -> {Unit} -> Type
adamc@704 211
adamc@705 212 val no_constraint : fs ::: {Type} -> sql_constraints fs []
adamc@705 213 val one_constraint : fs ::: {Type} -> unique ::: {Unit} -> name :: Name
adamc@705 214 -> sql_constraint fs unique
adamc@705 215 -> sql_constraints fs [name = unique]
adamc@705 216 val join_constraints : fs ::: {Type}
adamc@705 217 -> uniques1 ::: {{Unit}} -> uniques2 ::: {{Unit}} -> [uniques1 ~ uniques2]
adamc@705 218 => sql_constraints fs uniques1 -> sql_constraints fs uniques2
adamc@705 219 -> sql_constraints fs (uniques1 ++ uniques2)
adamc@705 220
adamc@709 221
adamc@705 222 val unique : rest ::: {Type} -> t ::: Type -> unique1 :: Name -> unique :: {Type}
adamc@705 223 -> [[unique1] ~ unique] => [[unique1 = t] ++ unique ~ rest]
adamc@705 224 => sql_constraint ([unique1 = t] ++ unique ++ rest) ([unique1] ++ map (fn _ => ()) unique)
adamc@704 225
adamc@712 226 class linkable :: Type -> Type -> Type
adamc@712 227 val linkable_same : t ::: Type -> linkable t t
adamc@712 228 val linkable_from_nullable : t ::: Type -> linkable (option t) t
adamc@712 229 val linkable_to_nullable : t ::: Type -> linkable t (option t)
adamc@712 230
adamc@709 231 con matching :: {Type} -> {Type} -> Type
adamc@709 232 val mat_nil : matching [] []
adamc@712 233 val mat_cons : t1 ::: Type -> rest1 ::: {Type} -> t2 ::: Type -> rest2 ::: {Type}
adamc@709 234 -> nm1 :: Name -> nm2 :: Name
adamc@709 235 -> [[nm1] ~ rest1] => [[nm2] ~ rest2]
adamc@712 236 => linkable t1 t2
adamc@712 237 -> matching rest1 rest2
adamc@712 238 -> matching ([nm1 = t1] ++ rest1) ([nm2 = t2] ++ rest2)
adamc@709 239
adamc@709 240 con propagation_mode :: {Type} -> Type
adamc@709 241 val restrict : fs ::: {Type} -> propagation_mode fs
adamc@709 242 val cascade : fs ::: {Type} -> propagation_mode fs
adamc@709 243 val no_action : fs ::: {Type} -> propagation_mode fs
adamc@709 244 val set_null : fs ::: {Type} -> propagation_mode (map option fs)
adamc@709 245
adamc@709 246
adamc@709 247 val foreign_key : mine1 ::: Name -> t ::: Type -> mine ::: {Type} -> munused ::: {Type}
adamc@709 248 -> foreign ::: {Type} -> funused ::: {Type}
adamc@709 249 -> nm ::: Name -> uniques ::: {{Unit}}
adamc@709 250 -> [[mine1] ~ mine] => [[mine1 = t] ++ mine ~ munused]
adamc@709 251 => [foreign ~ funused] => [[nm] ~ uniques]
adamc@709 252 => matching ([mine1 = t] ++ mine) foreign
adamc@709 253 -> sql_table (foreign ++ funused) ([nm = map (fn _ => ()) foreign] ++ uniques)
adamc@709 254 -> {OnDelete : propagation_mode ([mine1 = t] ++ mine),
adamc@709 255 OnUpdate : propagation_mode ([mine1 = t] ++ mine)}
adamc@709 256 -> sql_constraint ([mine1 = t] ++ mine ++ munused) []
adamc@709 257
adamc@714 258 con sql_exp :: {{Type}} -> {{Type}} -> {Type} -> Type -> Type
adamc@1072 259 val sql_exp_weaken : fs ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type} -> t ::: Type
adamc@1072 260 -> fs' ::: {{Type}} -> agg' ::: {{Type}} -> exps' ::: {Type}
adamc@1072 261 -> [fs ~ fs'] => [agg ~ agg'] => [exps ~ exps'] =>
adamc@1072 262 sql_exp fs agg exps t
adamc@1072 263 -> sql_exp (fs ++ fs') (agg ++ agg') (exps ++ exps') t
adamc@714 264
adamc@714 265 val check : fs ::: {Type}
adamc@714 266 -> sql_exp [] [] fs bool
adamc@714 267 -> sql_constraint fs []
adamc@714 268
adamc@714 269
adamc@704 270
adamc@204 271 (*** Queries *)
adamc@204 272
adamc@233 273 con sql_query :: {{Type}} -> {Type} -> Type
adamc@233 274 con sql_query1 :: {{Type}} -> {{Type}} -> {Type} -> Type
adamc@204 275
adamc@223 276 con sql_subset :: {{Type}} -> {{Type}} -> Type
adamc@223 277 val sql_subset : keep_drop :: {({Type} * {Type})}
adamc@354 278 -> sql_subset
adamc@621 279 (map (fn fields :: ({Type} * {Type}) => fields.1 ++ fields.2) keep_drop)
adamc@621 280 (map (fn fields :: ({Type} * {Type}) => fields.1) keep_drop)
adamc@354 281 val sql_subset_all : tables :: {{Type}} -> sql_subset tables tables
adamc@1072 282 val sql_subset_concat : big1 ::: {{Type}} -> little1 ::: {{Type}}
adamc@1072 283 -> big2 ::: {{Type}} -> little2 ::: {{Type}}
adamc@1072 284 -> [big1 ~ big2] => [little1 ~ little2] =>
adamc@1072 285 sql_subset big1 little1
adamc@1072 286 -> sql_subset big2 little2
adamc@1072 287 -> sql_subset (big1 ++ big2) (little1 ++ little2)
adamc@223 288
adamc@748 289 con sql_from_items :: {{Type}} -> Type
adamc@748 290
adamc@753 291 val sql_from_table : t ::: Type -> fs ::: {Type}
adamc@753 292 -> fieldsOf t fs -> name :: Name
adamc@753 293 -> t -> sql_from_items [name = fs]
adamc@748 294 val sql_from_comma : tabs1 ::: {{Type}} -> tabs2 ::: {{Type}}
adamc@748 295 -> [tabs1 ~ tabs2]
adamc@748 296 => sql_from_items tabs1 -> sql_from_items tabs2
adamc@748 297 -> sql_from_items (tabs1 ++ tabs2)
adamc@749 298 val sql_inner_join : tabs1 ::: {{Type}} -> tabs2 ::: {{Type}}
adamc@749 299 -> [tabs1 ~ tabs2]
adamc@749 300 => sql_from_items tabs1 -> sql_from_items tabs2
adamc@749 301 -> sql_exp (tabs1 ++ tabs2) [] [] bool
adamc@749 302 -> sql_from_items (tabs1 ++ tabs2)
adamc@748 303
adamc@750 304 class nullify :: Type -> Type -> Type
adamc@750 305 val nullify_option : t ::: Type -> nullify (option t) (option t)
adamc@750 306 val nullify_prim : t ::: Type -> sql_injectable_prim t -> nullify t (option t)
adamc@750 307
adamc@750 308 val sql_left_join : tabs1 ::: {{Type}} -> tabs2 ::: {{(Type * Type)}}
adamc@750 309 -> [tabs1 ~ tabs2]
adamc@750 310 => $(map (fn r => $(map (fn p :: (Type * Type) => nullify p.1 p.2) r)) tabs2)
adamc@750 311 -> sql_from_items tabs1 -> sql_from_items (map (map (fn p :: (Type * Type) => p.1)) tabs2)
adamc@750 312 -> sql_exp (tabs1 ++ map (map (fn p :: (Type * Type) => p.1)) tabs2) [] [] bool
adamc@750 313 -> sql_from_items (tabs1 ++ map (map (fn p :: (Type * Type) => p.2)) tabs2)
adamc@750 314
adamc@751 315 val sql_right_join : tabs1 ::: {{(Type * Type)}} -> tabs2 ::: {{Type}}
adamc@751 316 -> [tabs1 ~ tabs2]
adamc@751 317 => $(map (fn r => $(map (fn p :: (Type * Type) => nullify p.1 p.2) r)) tabs1)
adamc@751 318 -> sql_from_items (map (map (fn p :: (Type * Type) => p.1)) tabs1) -> sql_from_items tabs2
adamc@751 319 -> sql_exp (map (map (fn p :: (Type * Type) => p.1)) tabs1 ++ tabs2) [] [] bool
adamc@751 320 -> sql_from_items (map (map (fn p :: (Type * Type) => p.2)) tabs1 ++ tabs2)
adamc@751 321
adamc@751 322 val sql_full_join : tabs1 ::: {{(Type * Type)}} -> tabs2 ::: {{(Type * Type)}}
adamc@751 323 -> [tabs1 ~ tabs2]
adamc@751 324 => $(map (fn r => $(map (fn p :: (Type * Type) => nullify p.1 p.2) r)) (tabs1 ++ tabs2))
adamc@751 325 -> sql_from_items (map (map (fn p :: (Type * Type) => p.1)) tabs1)
adamc@751 326 -> sql_from_items (map (map (fn p :: (Type * Type) => p.1)) tabs2)
adamc@751 327 -> sql_exp (map (map (fn p :: (Type * Type) => p.1)) (tabs1 ++ tabs2)) [] [] bool
adamc@751 328 -> sql_from_items (map (map (fn p :: (Type * Type) => p.2)) (tabs1 ++ tabs2))
adamc@751 329
adamc@748 330 val sql_query1 : tables ::: {{Type}}
adamc@354 331 -> grouped ::: {{Type}}
adamc@354 332 -> selectedFields ::: {{Type}}
adamc@354 333 -> selectedExps ::: {Type}
adamc@1070 334 -> empties :: {Unit}
adamc@1070 335 -> [empties ~ selectedFields]
adamc@1070 336 => {Distinct : bool,
adamc@993 337 From : sql_from_items tables,
adamc@748 338 Where : sql_exp tables [] [] bool,
adamc@748 339 GroupBy : sql_subset tables grouped,
adamc@748 340 Having : sql_exp grouped tables [] bool,
adamc@1070 341 SelectFields : sql_subset grouped (map (fn _ => []) empties ++ selectedFields),
adamc@748 342 SelectExps : $(map (sql_exp grouped tables [])
adamc@705 343 selectedExps) }
adamc@748 344 -> sql_query1 tables selectedFields selectedExps
adamc@229 345
adamc@229 346 type sql_relop
adamc@229 347 val sql_union : sql_relop
adamc@229 348 val sql_intersect : sql_relop
adamc@229 349 val sql_except : sql_relop
adamc@260 350 val sql_relop : tables1 ::: {{Type}}
adamc@354 351 -> tables2 ::: {{Type}}
adamc@354 352 -> selectedFields ::: {{Type}}
adamc@354 353 -> selectedExps ::: {Type}
adamc@354 354 -> sql_relop
adamc@354 355 -> sql_query1 tables1 selectedFields selectedExps
adamc@354 356 -> sql_query1 tables2 selectedFields selectedExps
adamc@1072 357 -> sql_query1 [] selectedFields selectedExps
adamc@1071 358 val sql_forget_tables : tables ::: {{Type}} -> selectedFields ::: {{Type}} -> selectedExps ::: {Type}
adamc@1071 359 -> sql_query1 tables selectedFields selectedExps
adamc@1072 360 -> sql_query1 [] selectedFields selectedExps
adamc@229 361
adamc@230 362 type sql_direction
adamc@230 363 val sql_asc : sql_direction
adamc@230 364 val sql_desc : sql_direction
adamc@230 365
adamc@234 366 con sql_order_by :: {{Type}} -> {Type} -> Type
adamc@234 367 val sql_order_by_Nil : tables ::: {{Type}} -> exps :: {Type} -> sql_order_by tables exps
adamc@234 368 val sql_order_by_Cons : tables ::: {{Type}} -> exps ::: {Type} -> t ::: Type
adamc@354 369 -> sql_exp tables [] exps t -> sql_direction
adamc@354 370 -> sql_order_by tables exps
adamc@354 371 -> sql_order_by tables exps
adamc@230 372
adamc@231 373 type sql_limit
adamc@231 374 val sql_no_limit : sql_limit
adamc@231 375 val sql_limit : int -> sql_limit
adamc@354 376
adamc@232 377 type sql_offset
adamc@232 378 val sql_no_offset : sql_offset
adamc@232 379 val sql_offset : int -> sql_offset
adamc@232 380
adamc@229 381 val sql_query : tables ::: {{Type}}
adamc@354 382 -> selectedFields ::: {{Type}}
adamc@354 383 -> selectedExps ::: {Type}
adamc@354 384 -> {Rows : sql_query1 tables selectedFields selectedExps,
adamc@354 385 OrderBy : sql_order_by tables selectedExps,
adamc@354 386 Limit : sql_limit,
adamc@354 387 Offset : sql_offset}
adamc@354 388 -> sql_query selectedFields selectedExps
adamc@204 389
adamc@354 390 val sql_field : otherTabs ::: {{Type}} -> otherFields ::: {Type}
adamc@354 391 -> fieldType ::: Type -> agg ::: {{Type}}
adamc@354 392 -> exps ::: {Type}
adamc@354 393 -> tab :: Name -> field :: Name
adamc@354 394 -> sql_exp
adamc@354 395 ([tab = [field = fieldType] ++ otherFields] ++ otherTabs)
adamc@354 396 agg exps fieldType
adamc@234 397
adamc@354 398 val sql_exp : tabs ::: {{Type}} -> agg ::: {{Type}} -> t ::: Type -> rest ::: {Type}
adamc@354 399 -> nm :: Name
adamc@354 400 -> sql_exp tabs agg ([nm = t] ++ rest) t
adamc@209 401
adamc@221 402 class sql_injectable
adamc@676 403 val sql_prim : t ::: Type -> sql_injectable_prim t -> sql_injectable t
adamc@676 404 val sql_option_prim : t ::: Type -> sql_injectable_prim t -> sql_injectable (option t)
adamc@676 405
adamc@354 406 val sql_inject : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adamc@354 407 -> t ::: Type
adamc@354 408 -> sql_injectable t -> t -> sql_exp tables agg exps t
adamc@209 409
adamc@470 410 val sql_is_null : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adamc@470 411 -> t ::: Type
adamc@470 412 -> sql_exp tables agg exps (option t)
adamc@470 413 -> sql_exp tables agg exps bool
adamc@470 414
adamc@559 415 class sql_arith
adamc@559 416 val sql_int_arith : sql_arith int
adamc@559 417 val sql_float_arith : sql_arith float
adamc@559 418
adamc@220 419 con sql_unary :: Type -> Type -> Type
adamc@220 420 val sql_not : sql_unary bool bool
adamc@354 421 val sql_unary : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adamc@354 422 -> arg ::: Type -> res ::: Type
adamc@354 423 -> sql_unary arg res -> sql_exp tables agg exps arg
adamc@354 424 -> sql_exp tables agg exps res
adamc@220 425
adamc@559 426 val sql_neg : t ::: Type -> sql_arith t -> sql_unary t t
adamc@559 427
adamc@220 428 con sql_binary :: Type -> Type -> Type -> Type
adamc@220 429 val sql_and : sql_binary bool bool bool
adamc@220 430 val sql_or : sql_binary bool bool bool
adamc@234 431 val sql_binary : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adamc@354 432 -> arg1 ::: Type -> arg2 ::: Type -> res ::: Type
adamc@354 433 -> sql_binary arg1 arg2 res -> sql_exp tables agg exps arg1
adamc@354 434 -> sql_exp tables agg exps arg2
adamc@354 435 -> sql_exp tables agg exps res
adamc@220 436
adamc@559 437 val sql_plus : t ::: Type -> sql_arith t -> sql_binary t t t
adamc@559 438 val sql_minus : t ::: Type -> sql_arith t -> sql_binary t t t
adamc@559 439 val sql_times : t ::: Type -> sql_arith t -> sql_binary t t t
adamc@559 440 val sql_div : t ::: Type -> sql_arith t -> sql_binary t t t
adamc@559 441 val sql_mod : sql_binary int int int
adamc@559 442
adamc@559 443 val sql_eq : t ::: Type -> sql_binary t t bool
adamc@559 444 val sql_ne : t ::: Type -> sql_binary t t bool
adamc@559 445 val sql_lt : t ::: Type -> sql_binary t t bool
adamc@559 446 val sql_le : t ::: Type -> sql_binary t t bool
adamc@559 447 val sql_gt : t ::: Type -> sql_binary t t bool
adamc@559 448 val sql_ge : t ::: Type -> sql_binary t t bool
adamc@203 449
adamc@235 450 val sql_count : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adamc@544 451 -> sql_exp tables agg exps int
adamc@235 452
adamc@236 453 con sql_aggregate :: Type -> Type
adamc@354 454 val sql_aggregate : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adamc@354 455 -> t ::: Type
adamc@354 456 -> sql_aggregate t -> sql_exp agg agg exps t
adamc@354 457 -> sql_exp tables agg exps t
adamc@236 458
adamc@236 459 class sql_summable
adamc@236 460 val sql_summable_int : sql_summable int
adamc@236 461 val sql_summable_float : sql_summable float
adamc@236 462 val sql_avg : t ::: Type -> sql_summable t -> sql_aggregate t
adamc@236 463 val sql_sum : t ::: Type -> sql_summable t -> sql_aggregate t
adamc@236 464
adamc@236 465 class sql_maxable
adamc@236 466 val sql_maxable_int : sql_maxable int
adamc@236 467 val sql_maxable_float : sql_maxable float
adamc@236 468 val sql_maxable_string : sql_maxable string
adamc@437 469 val sql_maxable_time : sql_maxable time
adamc@236 470 val sql_max : t ::: Type -> sql_maxable t -> sql_aggregate t
adamc@236 471 val sql_min : t ::: Type -> sql_maxable t -> sql_aggregate t
adamc@236 472
adamc@441 473 con sql_nfunc :: Type -> Type
adamc@441 474 val sql_nfunc : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adamc@441 475 -> t ::: Type
adamc@441 476 -> sql_nfunc t -> sql_exp tables agg exps t
adamc@441 477 val sql_current_timestamp : sql_nfunc time
adamc@441 478
adamc@746 479 con sql_ufunc :: Type -> Type -> Type
adamc@746 480 val sql_ufunc : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adamc@746 481 -> dom ::: Type -> ran ::: Type
adamc@746 482 -> sql_ufunc dom ran -> sql_exp tables agg exps dom
adamc@746 483 -> sql_exp tables agg exps ran
adamc@746 484 val sql_octet_length : sql_ufunc blob int
adamc@746 485
adamc@235 486
adamc@1081 487 val sql_nullable : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type} -> t ::: Type
adamc@1081 488 -> sql_injectable_prim t
adamc@1081 489 -> sql_exp tables agg exps t
adamc@1081 490 -> sql_exp tables agg exps (option t)
adamc@1081 491
adamc@243 492 (*** Executing queries *)
adamc@243 493
adamc@354 494 val query : tables ::: {{Type}} -> exps ::: {Type}
adamc@629 495 -> [tables ~ exps] =>
adamc@354 496 state ::: Type
adamc@354 497 -> sql_query tables exps
adamc@621 498 -> ($(exps ++ map (fn fields :: {Type} => $fields) tables)
adamc@354 499 -> state
adamc@354 500 -> transaction state)
adamc@354 501 -> state
adamc@354 502 -> transaction state
adamc@243 503
adamc@243 504
adamc@299 505 (*** Database mutators *)
adamc@299 506
adamc@299 507 type dml
adamc@299 508 val dml : dml -> transaction unit
adamc@299 509
adamc@705 510 val insert : fields ::: {Type} -> uniques ::: {{Unit}}
adamc@705 511 -> sql_table fields uniques
adamc@621 512 -> $(map (fn t :: Type => sql_exp [] [] [] t) fields)
adamc@354 513 -> dml
adamc@299 514
adamc@705 515 val update : unchanged ::: {Type} -> uniques ::: {{Unit}} -> changed :: {Type} ->
adamc@629 516 [changed ~ unchanged] =>
adamc@621 517 $(map (fn t :: Type => sql_exp [T = changed ++ unchanged] [] [] t) changed)
adamc@705 518 -> sql_table (changed ++ unchanged) uniques
adamc@354 519 -> sql_exp [T = changed ++ unchanged] [] [] bool
adamc@354 520 -> dml
adamc@299 521
adamc@705 522 val delete : fields ::: {Type} -> uniques ::: {{Unit}}
adamc@705 523 -> sql_table fields uniques
adamc@354 524 -> sql_exp [T = fields] [] [] bool
adamc@354 525 -> dml
adamc@299 526
adamc@338 527 (*** Sequences *)
adamc@338 528
adamc@338 529 type sql_sequence
adamc@338 530 val nextval : sql_sequence -> transaction int
adamc@1073 531 val setval : sql_sequence -> int -> transaction unit
adamc@338 532
adamc@299 533
adamc@203 534 (** XML *)
adamc@203 535
adamc@721 536 type css_class
adamc@718 537
adamc@720 538 con tag :: {Type} -> {Unit} -> {Unit} -> {Type} -> {Type} -> Type
adamc@91 539
adamc@720 540 con xml :: {Unit} -> {Type} -> {Type} -> Type
adamc@720 541 val cdata : ctx ::: {Unit} -> use ::: {Type} -> string -> xml ctx use []
adamc@354 542 val tag : attrsGiven ::: {Type} -> attrsAbsent ::: {Type}
adamc@354 543 -> ctxOuter ::: {Unit} -> ctxInner ::: {Unit}
adamc@354 544 -> useOuter ::: {Type} -> useInner ::: {Type}
adamc@354 545 -> bindOuter ::: {Type} -> bindInner ::: {Type}
adamc@629 546 -> [attrsGiven ~ attrsAbsent] =>
adamc@629 547 [useOuter ~ useInner] =>
adamc@629 548 [bindOuter ~ bindInner] =>
adamc@721 549 option css_class
adamc@721 550 -> $attrsGiven
adamc@629 551 -> tag (attrsGiven ++ attrsAbsent)
adamc@720 552 ctxOuter ctxInner useOuter bindOuter
adamc@720 553 -> xml ctxInner useInner bindInner
adamc@720 554 -> xml ctxOuter (useOuter ++ useInner) (bindOuter ++ bindInner)
adamc@140 555 val join : ctx ::: {Unit}
adamc@720 556 -> use1 ::: {Type} -> bind1 ::: {Type} -> bind2 ::: {Type}
adamc@720 557 -> [use1 ~ bind1] => [bind1 ~ bind2] =>
adamc@720 558 xml ctx use1 bind1
adamc@720 559 -> xml ctx (use1 ++ bind1) bind2
adamc@720 560 -> xml ctx use1 (bind1 ++ bind2)
adamc@354 561 val useMore : ctx ::: {Unit} -> use1 ::: {Type} -> use2 ::: {Type}
adamc@720 562 -> bind ::: {Type}
adamc@629 563 -> [use1 ~ use2] =>
adamc@720 564 xml ctx use1 bind
adamc@720 565 -> xml ctx (use1 ++ use2) bind
adamc@91 566
adamc@110 567 con xhtml = xml [Html]
adamc@139 568 con page = xhtml [] []
adamc@720 569 con xbody = xml [Body] [] []
adamc@720 570 con xtr = xml [Body, Tr] [] []
adamc@720 571 con xform = xml [Body, Form] [] []
adamc@110 572
adamc@718 573
adamc@204 574 (*** HTML details *)
adamc@204 575
adamc@140 576 con html = [Html]
adamc@140 577 con head = [Head]
adamc@140 578 con body = [Body]
adamc@361 579 con form = [Body, Form]
adamc@760 580 con subform = [Body, Subform]
adamc@332 581 con tabl = [Body, Table]
adamc@332 582 con tr = [Body, Tr]
adamc@93 583
adamc@724 584 type url
adamc@1065 585 val show_url : show url
adamc@724 586 val bless : string -> url
adamc@770 587 val checkUrl : string -> option url
adamc@1085 588 val currentUrl : transaction url
adamc@1065 589 val url : transaction page -> url
adamc@1065 590 val redirect : t ::: Type -> url -> transaction t
adamc@724 591
adamc@847 592 val dyn : ctx ::: {Unit} -> use ::: {Type} -> bind ::: {Type} -> [ctx ~ body] => unit
adamc@847 593 -> tag [Signal = signal (xml (body ++ ctx) use bind)] (body ++ ctx) [] use bind
adamc@568 594
adamc@720 595 val head : unit -> tag [] html head [] []
adamc@720 596 val title : unit -> tag [] head [] [] []
adamc@1047 597 val link : unit -> tag [Id = string, Rel = string, Typ = string, Href = url, Media = string] head [] [] []
adamc@110 598
adamc@892 599 val body : unit -> tag [Onload = transaction unit, Onresize = transaction unit, Onunload = transaction unit]
adamc@892 600 html body [] []
adamc@354 601 con bodyTag = fn (attrs :: {Type}) =>
adamc@354 602 ctx ::: {Unit} ->
adamc@629 603 [[Body] ~ ctx] =>
adamc@720 604 unit -> tag attrs ([Body] ++ ctx) ([Body] ++ ctx) [] []
adamc@354 605 con bodyTagStandalone = fn (attrs :: {Type}) =>
adamc@354 606 ctx ::: {Unit}
adamc@629 607 -> [[Body] ~ ctx] =>
adamc@720 608 unit -> tag attrs ([Body] ++ ctx) [] [] []
adamc@141 609
adamc@1047 610 val br : bodyTagStandalone [Id = int]
adamc@119 611
adamc@892 612 con focusEvents = [Onblur = transaction unit, Onfocus = transaction unit]
adamc@892 613 con mouseEvents = [Onclick = transaction unit, Ondblclick = transaction unit,
adamc@892 614 Onmousedown = transaction unit, Onmousemove = transaction unit,
adamc@892 615 Onmouseout = transaction unit, Onmouseover = transaction unit,
adamc@894 616 Onmouseup = transaction unit]
adamc@895 617 con keyEvents = [Onkeydown = int -> transaction unit, Onkeypress = int -> transaction unit,
adamc@895 618 Onkeyup = int -> transaction unit]
adamc@895 619 (* Key arguments are character codes. *)
adamc@892 620 con resizeEvents = [Onresize = transaction unit]
adamc@691 621
adamc@892 622 con boxEvents = focusEvents ++ mouseEvents ++ keyEvents ++ resizeEvents
adamc@892 623 con tableEvents = focusEvents ++ mouseEvents ++ keyEvents
adamc@140 624
adamc@1047 625 con boxAttrs = [Id = string] ++ boxEvents
adamc@1047 626 con tableAttrs = [Id = string] ++ tableEvents
adamc@469 627
adamc@1047 628 val span : bodyTag boxAttrs
adamc@1047 629 val div : bodyTag boxAttrs
adamc@140 630
adamc@1047 631 val p : bodyTag boxAttrs
adamc@1047 632 val b : bodyTag boxAttrs
adamc@1047 633 val i : bodyTag boxAttrs
adamc@1047 634 val tt : bodyTag boxAttrs
adamc@410 635
adamc@1047 636 val h1 : bodyTag boxAttrs
adamc@1047 637 val h2 : bodyTag boxAttrs
adamc@1047 638 val h3 : bodyTag boxAttrs
adamc@1047 639 val h4 : bodyTag boxAttrs
adamc@1047 640 val h5 : bodyTag boxAttrs
adamc@1047 641 val h6 : bodyTag boxAttrs
adamc@717 642
adamc@1047 643 val li : bodyTag boxAttrs
adamc@1047 644 val ol : bodyTag boxAttrs
adamc@1047 645 val ul : bodyTag boxAttrs
adamc@140 646
adamc@1047 647 val hr : bodyTag boxAttrs
adamc@1047 648
adamc@1047 649 val a : bodyTag ([Link = transaction page, Href = url] ++ boxAttrs)
adamc@892 650
adamc@892 651 val img : bodyTag ([Src = url, Onabort = transaction unit, Onerror = transaction unit,
adamc@1047 652 Onload = transaction unit] ++ boxAttrs)
adamc@892 653
adamc@720 654 val form : ctx ::: {Unit} -> bind ::: {Type}
adamc@1004 655 -> [[Body, Form] ~ ctx] =>
adamc@1004 656 xml ([Body, Form] ++ ctx) [] bind
adamc@756 657 -> xml ([Body] ++ ctx) [] []
adamc@756 658
adamc@756 659 val subform : ctx ::: {Unit} -> use ::: {Type} -> bind ::: {Type}
adamc@756 660 -> [[Form] ~ ctx] =>
adamc@756 661 nm :: Name -> [[nm] ~ use] =>
adamc@1004 662 xml ([Form] ++ ctx) [] bind
adamc@756 663 -> xml ([Form] ++ ctx) use [nm = $bind]
adamc@758 664
adamc@758 665 val subforms : ctx ::: {Unit} -> use ::: {Type} -> bind ::: {Type}
adamc@1004 666 -> [[Form, Subform] ~ ctx] =>
adamc@758 667 nm :: Name -> [[nm] ~ use] =>
adamc@1004 668 xml ([Subform] ++ ctx) [Entry = $bind] []
adamc@758 669 -> xml ([Form] ++ ctx) use [nm = list ($bind)]
adamc@758 670
adamc@758 671 val entry : ctx ::: {Unit} -> bind ::: {Type}
adamc@1004 672 -> [[Subform, Form] ~ ctx] =>
adamc@1004 673 xml ([Form] ++ ctx) [] bind
adamc@758 674 -> xml ([Subform] ++ ctx) [Entry = $bind] []
adamc@758 675
adamc@361 676 con formTag = fn (ty :: Type) (inner :: {Unit}) (attrs :: {Type}) =>
adamc@354 677 ctx ::: {Unit}
adamc@629 678 -> [[Form] ~ ctx] =>
adamc@354 679 nm :: Name -> unit
adamc@720 680 -> tag attrs ([Form] ++ ctx) inner [] [nm = ty]
adamc@1047 681 val hidden : formTag string [] [Id = string, Value = string]
adamc@892 682 val textbox : formTag string [] ([Value = string, Size = int, Source = source string, Onchange = transaction unit,
adamc@1047 683 Ontext = transaction unit] ++ boxAttrs)
adamc@1047 684 val password : formTag string [] ([Value = string, Size = int] ++ boxAttrs)
adamc@892 685 val textarea : formTag string [] ([Rows = int, Cols = int, Onchange = transaction unit,
adamc@1047 686 Ontext = transaction unit] ++ boxAttrs)
adamc@153 687
adamc@1047 688 val checkbox : formTag bool [] ([Checked = bool] ++ boxAttrs)
adamc@190 689
adamc@737 690 type file
adamc@737 691 val fileName : file -> option string
adamc@740 692 val fileMimeType : file -> string
adamc@737 693 val fileData : file -> blob
adamc@737 694
adamc@1047 695 val upload : formTag file [] ([Value = string, Size = int] ++ boxAttrs)
adamc@737 696
adamc@741 697 type mimeType
adamc@741 698 val blessMime : string -> mimeType
adamc@770 699 val checkMime : string -> option mimeType
adamc@741 700 val returnBlob : t ::: Type -> blob -> mimeType -> transaction t
adamc@745 701 val blobSize : blob -> int
adamc@741 702
adamc@153 703 con radio = [Body, Radio]
adamc@1047 704 val radio : formTag string radio [Id = string]
adamc@1068 705 val radioOption : unit -> tag ([Value = string, Checked = bool] ++ boxAttrs) radio [] [] []
adamc@142 706
adamc@154 707 con select = [Select]
adamc@1047 708 val select : formTag string select ([Onchange = transaction unit] ++ boxAttrs)
adamc@720 709 val option : unit -> tag [Value = string, Selected = bool] select [] [] []
adamc@154 710
adamc@720 711 val submit : ctx ::: {Unit} -> use ::: {Type}
adamc@629 712 -> [[Form] ~ ctx] =>
adamc@354 713 unit
adamc@1047 714 -> tag ([Value = string, Action = $use -> transaction page] ++ boxAttrs)
adamc@720 715 ([Form] ++ ctx) ([Form] ++ ctx) use []
adamc@283 716
adamc@1047 717 val label : bodyTag ([For = string, Accesskey = string] ++ tableAttrs)
adamc@1047 718
adamc@1047 719
adamc@601 720 (*** AJAX-oriented widgets *)
adamc@601 721
adamc@797 722 con cformTag = fn (attrs :: {Type}) (inner :: {Unit}) =>
adamc@601 723 ctx ::: {Unit}
adamc@629 724 -> [[Body] ~ ctx] =>
adamc@797 725 unit -> tag attrs ([Body] ++ ctx) inner [] []
adamc@601 726
adamc@892 727 val ctextbox : cformTag ([Value = string, Size = int, Source = source string, Onchange = transaction unit,
adamc@1047 728 Ontext = transaction unit] ++ boxAttrs) []
adamc@1047 729 val button : cformTag ([Value = string] ++ boxAttrs) []
adamc@797 730
adamc@1047 731 val ccheckbox : cformTag ([Value = bool, Size = int, Source = source bool] ++ boxAttrs) []
adamc@817 732
adamc@797 733 con cselect = [Cselect]
adamc@1047 734 val cselect : cformTag ([Source = source string, Onchange = transaction unit] ++ boxAttrs) cselect
adamc@797 735 val coption : unit -> tag [Value = string, Selected = bool] cselect [] [] []
adamc@601 736
adamc@1099 737 val ctextarea : cformTag ([Value = string, Rows = int, Cols = int, Source = source string, Onchange = transaction unit,
adamc@1099 738 Ontext = transaction unit] ++ boxAttrs) []
adamc@1099 739
adamc@720 740 (*** Tables *)
adamc@720 741
adamc@892 742 val tabl : other ::: {Unit} -> [other ~ [Body, Table]] => unit
adamc@1047 743 -> tag ([Border = int] ++ boxAttrs)
adamc@892 744 ([Body] ++ other) ([Body, Table] ++ other) [] []
adamc@892 745 val tr : other ::: {Unit} -> [other ~ [Body, Table, Tr]] => unit
adamc@1047 746 -> tag tableAttrs
adamc@892 747 ([Body, Table] ++ other) ([Body, Tr] ++ other) [] []
adamc@892 748 val th : other ::: {Unit} -> [other ~ [Body, Tr]] => unit
adamc@1047 749 -> tag ([Colspan = int] ++ tableAttrs)
adamc@892 750 ([Body, Tr] ++ other) ([Body] ++ other) [] []
adamc@892 751 val td : other ::: {Unit} -> [other ~ [Body, Tr]] => unit
adamc@1047 752 -> tag ([Colspan = int] ++ tableAttrs)
adamc@892 753 ([Body, Tr] ++ other) ([Body] ++ other) [] []
adamc@720 754
adamc@283 755
adamc@283 756 (** Aborting *)
adamc@283 757
adamc@726 758 val error : t ::: Type -> xbody -> t
adamc@720 759
adamc@729 760 (* Client-side-only handlers: *)
adamc@726 761 val onError : (xbody -> transaction unit) -> transaction unit
adamc@728 762 val onFail : (string -> transaction unit) -> transaction unit
adamc@729 763 val onConnectFail : transaction unit -> transaction unit
adamc@729 764 val onDisconnect : transaction unit -> transaction unit
adamc@729 765 val onServerError : (string -> transaction unit) -> transaction unit
adamc@727 766
adamc@727 767 val show_xml : ctx ::: {Unit} -> use ::: {Type} -> bind ::: {Type} -> show (xml ctx use bind)
adamc@1075 768
adamc@1075 769
adamc@1075 770 (** Tasks *)
adamc@1075 771
adamc@1075 772 type task_kind
adamc@1075 773 val initialize : task_kind