Nim in Action

contents......Page 7
preface......Page 13
acknowledgments......Page 14
Who should read this book......Page 16
How the book is organized......Page 17
Book forum......Page 18
about the author......Page 19
about the cover illustration......Page 20
Part 1 The basics of Nim......Page 21
1 Why Nim?......Page 23
1.1.1 Use cases......Page 24
1.1.2 Core features......Page 26
1.1.3 How does Nim work?......Page 31
1.2.1 Benefits......Page 32
1.3 Summary......Page 40
2.1 Nim syntax......Page 42
2.1.2 Indentation......Page 43
2.2.1 Basic types......Page 45
2.2.2 Defining variables and other storage......Page 50
2.2.3 Procedure definitions......Page 53
2.3.1 Arrays......Page 59
2.3.2 Sequences......Page 61
2.3.3 Sets......Page 62
2.4 Control flow......Page 63
2.5 Exception handling......Page 67
2.6.1 Objects......Page 69
2.6.2 Tuples......Page 70
2.6.3 Enums......Page 71
2.7 Summary......Page 73
Part 2 Nim in practice......Page 75
3 Writing a chat application......Page 77
3.1.1 What will the finished application look like?......Page 78
3.2 Starting the project......Page 81
3.3.1 Retrieving command-line parameters supplied by the user......Page 83
3.3.2 Reading data from the standard input stream......Page 86
3.3.3 Using spawn to avoid blocking input/output......Page 88
3.4 Implementing the protocol......Page 90
3.4.1 Modules......Page 91
3.4.2 Parsing JSON......Page 92
3.4.3 Generating JSON......Page 98
3.5 Transferring data using sockets......Page 99
3.5.1 What is a socket?......Page 102
3.5.2 Asynchronous input/output......Page 103
3.5.3 Transferring data asynchronously......Page 111
3.6 Summary......Page 120
4 A tour through the standard library......Page 121
4.1 A closer look at modules......Page 123
4.1.1 Namespacing......Page 125
4.2.1 Pure modules......Page 127
4.2.4 Online documentation......Page 128
4.3 The core modules......Page 130
4.4 Data structures and algorithms......Page 131
4.4.1 The tables module......Page 132
4.4.2 The sets module......Page 134
4.4.3 The algorithms......Page 135
4.5 Interfacing with the operating system......Page 137
4.5.1 Working with the filesystem......Page 138
4.5.2 Executing an external process......Page 140
4.6.1 Parsing command-line arguments......Page 142
4.7 Networking and the internet......Page 146
4.8 Summary......Page 147
5 Package management......Page 148
5.1 The Nim package manager......Page 149
5.2 Installing Nimble......Page 150
5.4 What is a Nimble package?......Page 151
5.5.1 Using the install command......Page 155
5.5.2 How does the install command work?......Page 156
5.6.1 Choosing a name......Page 159
5.6.2 A Nimble package’s directory layout......Page 160
5.6.3 Writing the .nimble file and sorting out dependencies......Page 161
5.7 Publishing Nimble packages......Page 165
5.8.2 Storing different versions of a single package......Page 167
5.9 Summary......Page 168
6 Parallelism......Page 170
6.1 Concurrency vs. parallelism......Page 171
6.2.1 The threads module and GC safety......Page 173
6.2.2 Using thread pools......Page 176
6.3 Parsing data......Page 179
6.3.1 Understanding the Wikipedia page-counts format......Page 180
6.3.2 Parsing the Wikipedia page-counts format......Page 181
6.3.3 Processing each line of a file efficiently......Page 184
6.4.2 Parallelizing sequential_counts......Page 188
6.4.3 Type definitions and the parse procedure......Page 189
6.4.4 The parseChunk procedure......Page 190
6.4.5 The parallel readPageCounts procedure......Page 191
6.4.6 The execution time of parallel_counts......Page 192
6.5 Dealing with race conditions......Page 193
6.5.1 Using guards and locks to prevent race conditions......Page 194
6.5.2 Using channels so threads can send and receive messages......Page 196
6.6 Summary......Page 199
7 Building a Twitter clone......Page 200
7.1 Architecture of a web application......Page 201
7.1.1 Routing in microframeworks......Page 203
7.1.2 The architecture of Tweeter......Page 205
7.2 Starting the project......Page 206
7.3 Storing data in a database......Page 209
7.3.1 Setting up the types......Page 210
7.3.2 Setting up the database......Page 212
7.3.3 Storing and retrieving data......Page 214
7.3.4 Testing the database......Page 218
7.4 Developing the web application’s view......Page 220
7.4.1 Developing the user view......Page 224
7.4.2 Developing the general view......Page 227
7.5 Developing the controller......Page 230
7.5.1 Implementing the /login route......Page 232
7.5.2 Extending the / route......Page 234
7.5.3 Implementing the /createMessage route......Page 235
7.5.4 Implementing the user route......Page 236
7.5.5 Adding the Follow button......Page 237
7.5.6 Implementing the /follow route......Page 238
7.6.2 Setting up a reverse proxy......Page 239
7.7 Summary......Page 241
Part 3 Advanced concepts......Page 243
8 Interfacing with other languages......Page 245
8.1 Nim’s foreign function interface......Page 246
8.1.1 Static vs. dynamic linking......Page 247
8.1.2 Wrapping C procedures......Page 248
8.1.4 Wrapping C types......Page 251
8.2 Wrapping an external C library......Page 254
8.2.2 Creating a wrapper for the SDL library......Page 255
8.2.3 Dynamic linking......Page 256
8.2.4 Wrapping the types......Page 257
8.2.5 Wrapping the procedures......Page 258
8.2.6 Using the SDL wrapper......Page 260
8.3 The JavaScript backend......Page 262
8.3.1 Wrapping the canvas element......Page 263
8.3.2 Using the Canvas wrapper......Page 266
8.4 Summary......Page 268
9 Metaprogramming......Page 269
9.1 Generics......Page 270
9.1.1 Generic procedures......Page 271
9.1.3 Constraining generics......Page 272
9.1.4 Concepts......Page 273
9.2 Templates......Page 274
9.2.1 Passing a code block to a template......Page 276
9.2.2 Parameter substitution in templates......Page 277
9.2.3 Template hygiene......Page 279
9.3 Macros......Page 280
9.3.1 Compile-time function execution......Page 281
9.3.2 Abstract syntax trees......Page 282
9.3.3 Macro definition......Page 285
9.3.4 Arguments in macros......Page 286
9.4 Creating a configuration DSL......Page 287
9.4.1 Starting the configurator project......Page 288
9.4.2 Generating the object type......Page 290
9.4.3 Generating the constructor procedure......Page 294
9.4.4 Generating the load procedure......Page 295
9.5 Summary......Page 298
A.1 Real-time communication......Page 300
A.3 Other communication methods......Page 301
B.1.1 Getting up-to-date installation info......Page 302
B.1.2 Building from source......Page 303
B.3 Testing your new development environment......Page 307
B.4.3 Could not load DLL......Page 309
A......Page 311
C......Page 312
D......Page 313
E......Page 314
I......Page 315
L......Page 316
N......Page 317
P......Page 318
R......Page 319
S......Page 320
U......Page 321
Y......Page 322