summary refs log tree commit diff stats
path: root/make_doc.py
Commit message (Expand)AuthorAgeFilesLines
* add documentation of some builtin moduleshut2009-12-111-0/+5
* make_doc.py to generate documentationhut2009-12-111-0/+23
vious revision' href='/akkartik/mu/blame/092socket.mu?h=hlt&id=9a81d7460fdb16f4e77712e5381d9db8781f5ae6'>^
9da067db ^

d7e48920 ^
9da067db ^



01ce563d ^
9da067db ^





01ce563d ^
9da067db ^




87eb3aca ^
d7e48920 ^
9da067db ^

d7e48920 ^
4a48bedc ^
f116818c ^
d7e48920 ^

7d07cd1d ^
b1f0fa4d ^



















9da067db ^

87eb3aca ^
d7e48920 ^
4a48bedc ^
9da067db ^



a65a32ae ^
9da067db ^


87eb3aca ^
d7e48920 ^

300a1d6e ^
f24eeaab ^
4a48bedc ^
f24eeaab ^
4a48bedc ^
9da067db ^



0606f4ac ^

294b2ab3 ^
f24eeaab ^

0606f4ac ^






5eb5a8de ^
f24eeaab ^



4a48bedc ^
f24eeaab ^







87eb3aca ^
62ae069e ^
4a48bedc ^
62ae069e ^
28191d31 ^
b07576d2 ^

28191d31 ^

b07576d2 ^

28191d31 ^
62ae069e ^
b07576d2 ^

62ae069e ^
b07576d2 ^
62ae069e ^

5eb5a8de ^

87eb3aca ^
5eb5a8de ^
4a48bedc ^
5eb5a8de ^
87eb3aca ^
62ae069e ^

f24eeaab ^
62ae069e ^
4a48bedc ^
62ae069e ^





f24eeaab ^
62ae069e ^



300a1d6e ^



4a48bedc ^
300a1d6e ^


























1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
                                                            
 

                                                                      
             



                                                                            
                                                                  





                                                                                     
                                                                                            




                                 
                                
 

                                                 
             
             
              

 
                                                                        



















                                                                                

                                            
                                                                                 
             
             



                                                            
                                                 


                                              
                                  

 
                                                                                          
             
             
   
                                               



                             

                          
                                                               

          






                                                               
                                                                 



                                                     
             







                                 
                                                                                      
             
             
   
                 

                                                                         

                  

                           
     
     

                     
     
        

                    

 
                                                                                                       
             
             
                                          
                                

 
                                        
             
             





                                         
                              



                 



                                                      
             


























                                          
# Wrappers around socket primitives that are easier to test.

# To test server operations, just run a real client against localhost.
scenario example-server-test [
  local-scope
  # test server without a fake on a random (real) port
  # that way repeatedly running the test will give ports time to timeout and
  # close before reusing them
  make-random-nondeterministic
  port:num <- random-in-range null/real-random-numbers, 8000, 8100
  run [
    socket:num <- $open-server-socket port
    assert socket, [ 
F - example-server-test: $open-server-socket failed]
    handler-routine:number <- start-running serve-one-request socket, example-handler
  ]
  source:&:source:char <- start-reading-from-network null/real-resources, [localhost/], port
  response:text <- drain source
  10:@:char/raw <- copy *response
  memory-should-contain [
    10:array:character <- [abc]
  ]
  socket <- $close-socket socket
]
# helper just for this scenario
def example-handler query:text -> response:text [
  local-scope
  load-inputs
  return [abc]
]

# To test client operations, use 'assume-resources' with a filename that
# begins with a hostname. (Filenames starting with '/' are assumed to be
# local.)
scenario example-client-test [
  local-scope
  assume-resources [
    [example.com/] <- [
      |abc|
    ]
  ]
  run [
    source:&:source:char <- start-reading-from-network resources, [example.com/]
  ]
  contents:text <- drain source
  10:@:char/raw <- copy *contents
  memory-should-contain [
    10:array:character <- [abc
]
  ]
]

type request-handler = (recipe text -> text)

def serve-one-request socket:num, request-handler:request-handler -> socket:num [
  local-scope
  load-inputs
  session:num <- $accept socket
  assert session, [ 
F - example-server-test: $accept failed]
  contents:&:source:char, sink:&:sink:char <- new-channel 30
  start-running receive-from-socket session, sink
  query:text <- drain contents
  response:text <- call request-handler, query
  write-to-socket session, response
  session <- $close-socket session
]

def start-reading-from-network resources:&:resources, uri:text -> contents:&:source:char [
  local-scope
  load-inputs
  {
    port:num, port-found?:boolean <- next-input
    break-if port-found?
    port <- copy 80/http-port
  }
  {
    break-unless resources
    # fake network
    contents <- start-reading-from-fake-resource resources, uri
    return
  }
  # real network
  host:text, path:text <- split-at uri, 47/slash
  socket:num <- $open-client-socket host, port
  assert socket, [contents]
  req:text <- interpolate [GET _ HTTP/1.1], path
  request-socket socket, req
  contents:&:source:char, sink:&:sink:char <- new-channel 10000
  start-running receive-from-client-socket-and-close socket, sink
]

def request-socket socket:num, s:text -> socket:num [
  local-scope
  load-inputs
  write-to-socket socket, s
  $write-to-socket socket, 13/cr
  $write-to-socket socket, 10/lf
  # empty line to delimit request
  $write-to-socket socket, 13/cr
  $write-to-socket socket, 10/lf
]

def receive-from-socket socket:num, sink:&:sink:char -> sink:&:sink:char, socket:num [
  local-scope
  load-inputs
  {
    +next-attempt
    c:char, found?:bool, eof?:bool, error:num <- $read-from-socket socket
    break-if eof?
    break-if error
    {
      break-unless found?
      sink <- write sink, c
    }
    {
      break-if found?
      switch
    }
    loop
  }
  sink <- close sink
]

def receive-from-client-socket-and-close socket:num, sink:&:sink:char -> sink:&:sink:char, socket:num [
  local-scope
  load-inputs
  sink <- receive-from-socket socket, sink
  socket <- $close-socket socket
]

def write-to-socket socket:num, s:text [
  local-scope
  load-inputs
  len:num <- length *s
  i:num <- copy 0
  {
    done?:bool <- greater-or-equal i, len
    break-if done?
    c:char <- index *s, i
    $write-to-socket socket, c
    i <- add i, 1
    loop
  }
]

# like split-first, but don't eat the delimiter
def split-at text:text, delim:char -> x:text, y:text [
  local-scope
  load-inputs
  # empty text? return empty texts
  len:num <- length *text
  {
    empty?:bool <- equal len, 0
    break-unless empty?
    x:text <- new []
    y:text <- new []
    return
  }
  idx:num <- find-next text, delim, 0
  x:text <- copy-range text, 0, idx
  y:text <- copy-range text, idx, len
]

scenario text-split-at [
  local-scope
  x:text <- new [a/b]
  run [
    y:text, z:text <- split-at x, 47/slash
    10:@:char/raw <- copy *y
    20:@:char/raw <- copy *z
  ]
  memory-should-contain [
    10:array:character <- [a]
    20:array:character <- [/b]
  ]
]