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
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
|
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="">
<meta name="author" content="Loïc Hoguin based on a design from (Soft10) Pol Cámara">
<title>Nine Nines: Articles</title>
<link href='https://fonts.googleapis.com/css?family=Open+Sans:400,700,400italic' rel='stylesheet' type='text/css'>
<link href="/css/99s.css?r=7" rel="stylesheet">
<link rel="shortcut icon" href="/img/ico/favicon.ico">
<link rel="apple-touch-icon-precomposed" sizes="114x114" href="/img/ico/apple-touch-icon-114.png">
<link rel="apple-touch-icon-precomposed" sizes="72x72" href="/img/ico/apple-touch-icon-72.png">
<link rel="apple-touch-icon-precomposed" href="/img/ico/apple-touch-icon-57.png">
<link rel="alternate" type="application/rss+xml" href="https://ninenines.eu/articles/index.xml" title="Nine Nines" />
</head>
<body class="">
<header id="page-head">
<div id="topbar" class="container">
<div class="row">
<div class="span2">
<h1 id="logo"><a href="/" title="99s">99s</a></h1>
</div>
<div class="span10">
<div id="side-header">
<nav>
<ul>
<li class="active"><a title="Hear my thoughts" href="/articles">Articles</a></li>
<li><a title="Watch my talks" href="/talks">Talks</a></li>
<li><a title="Read the docs" href="/docs">Documentation</a></li>
<li><a title="Request my services" href="/services">Consulting & Training</a></li>
</ul>
</nav>
<ul id="social">
<li>
<a href="https://github.com/ninenines" title="Check my Github repositories"><img src="/img/ico_github.png" data-hover="/img/ico_github_alt.png" alt="Github"></a>
</li>
<li>
<a title="Contact me" href="mailto:[email protected]"><img src="/img/ico_mail.png" data-hover="/img/ico_mail_alt.png"></a>
</li>
</ul>
</div>
</div>
</div>
</div>
</header>
<div id="contents" class="two_col">
<div class="container">
<div class="row">
<div class="span9 maincol">
<h1 class="lined-header"><span>Articles</span></h1>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/ranch-1.7.0/">Ranch 1.7</a></h2>
<p class="date">
<span class="year">2018</span>
<span class="day-month">14 Nov</span>
</p>
</header>
<p>Ranch 1.7.0 has been released!
This release adds built-in support for the PROXY protocol.
The PROXY protocol is a simple and efficient way for proxies to transmit information about the client.
While a third-party library already existed, it was not entirely compatible with the Ranch interface, in particular when socket active mode was involved. This new implementation fixes that and supports the full protocol with as little overhead as possible compared to normal operations: just one extra function call.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/ranch-1.7.0/">Read More</a>
</p>
</article>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/cowboy-2.5.0/">Cowboy 2.5</a></h2>
<p class="date">
<span class="year">2018</span>
<span class="day-month">03 Oct</span>
</p>
</header>
<p>Cowboy 2.5.0 has been released!
Cowboy 2.5 focused on making the test suites pass. It is now possible to get all the Cowboy tests to pass successfully, at least on Linux and on the more recent Erlang/OTP versions.
HTTP/1.1 has been improved with a fix for the TCP reset problem and the ability to stream a response body without using chunked transfer-encoding.
Two functions have been added: cowboy_req:stream_events/3 encodes and streams one or more text/event-stream events, and cowboy_req:read_and_match_urlencoded_body/2,3 reads, parses and matches application/x-www-form-urlencoded request bodies.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/cowboy-2.5.0/">Read More</a>
</p>
</article>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/gun-1.3.0/">Gun 1.3</a></h2>
<p class="date">
<span class="year">2018</span>
<span class="day-month">01 Oct</span>
</p>
</header>
<p>Gun 1.3.0 has been released!
Gun is an HTTP/1.1, HTTP/2 and Websocket client for Erlang/OTP.
This release improves the CONNECT support introduced in the previous version and adds built-in Websocket protocol negotiation.
A complete list of changes can be found in the migration guide: Migrating from Gun 1.2 to 1.3.
You can donate to this project via GitHub Sponsors. These funds are used to pay for additional servers for testing. And healthy food.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/gun-1.3.0/">Read More</a>
</p>
</article>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/gun-1.2.0/">Gun 1.2</a></h2>
<p class="date">
<span class="year">2018</span>
<span class="day-month">17 Sep</span>
</p>
</header>
<p>Gun 1.2.0 has been released!
Gun is an HTTP/1.1, HTTP/2 and Websocket client for Erlang/OTP.
Gun now supports issuing CONNECT requests to HTTP proxies in order to establish tunnels to origin servers. Gun can establish tunnels over one or more proxies as necessary.
All existing protocols can be used inside the tunnel, including HTTP/1.1, HTTP/2 and Websocket over both TCP and TLS connections.
Note that it is currently not possible to tunnel a TLS connection via an HTTPS proxy due to limitations in the current version of Erlang/OTP.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/gun-1.2.0/">Read More</a>
</p>
</article>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/ranch-1.6.0/">Ranch 1.6</a></h2>
<p class="date">
<span class="year">2018</span>
<span class="day-month">01 Aug</span>
</p>
</header>
<p>Ranch 1.6.0 has been released!
This release sees the introduction of a suspend/resume mechanism for the listeners which makes the listener close the listening socket and stop accepting new connections. Existing connections continue uninterrupted.
This can be used to update the socket options of the listener, or to implement a graceful shutdown. To that end a function has also been added which allows waiting until connections reach a certain number.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/ranch-1.6.0/">Read More</a>
</p>
</article>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/gun-1.0.0/">Gun 1.0</a></h2>
<p class="date">
<span class="year">2018</span>
<span class="day-month">27 Jul</span>
</p>
</header>
<p>Gun 1.0.0 has been released!
Gun is an HTTP/1.1, HTTP/2 and Websocket client for Erlang/OTP.
Gun provides an asynchronous interface and will keep the connection open to the server, reconnecting as necessary.
Gun has existed for many years as the test client for Cowboy and is now mature enough to receive a proper version. Gun is battle tested by customers and other users but is not the most well tested client there is.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/gun-1.0.0/">Read More</a>
</p>
</article>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/asciideck/">Asciideck: Asciidoc for Erlang</a></h2>
<p class="date">
<span class="year">2018</span>
<span class="day-month">13 Jun</span>
</p>
</header>
<p>Asciideck is a new project I have been working on in my spare time that implements an Asciidoc parser and translation of Asciidoc documents into various output formats.
The Asciideck parser returns an AST for the document. That AST can be further manipulated should it be necessary: for example you may need to rewrite some relative links if you are not keeping the same file directory structure as the original Asciidoc documents.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/asciideck/">Read More</a>
</p>
</article>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/gun-1.0.0-rc.1/">Gun 1.0 release candidate 1</a></h2>
<p class="date">
<span class="year">2018</span>
<span class="day-month">04 Jun</span>
</p>
</header>
<p>Gun 1.0.0-rc.1 has been released!
Gun is an HTTP/1.1, HTTP/2 and Websocket client for Erlang/OTP.
Gun provides an asynchronous interface and will keep the connection open to the server, reconnecting as necessary.
Gun has existed for many years as the test client for Cowboy and is now mature enough to receive a proper version. Gun is battle tested by customers and other users but is not the most well tested client there is.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/gun-1.0.0-rc.1/">Read More</a>
</p>
</article>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/cowboy-2.4.0/">Cowboy 2.4</a></h2>
<p class="date">
<span class="year">2018</span>
<span class="day-month">02 May</span>
</p>
</header>
<p>Cowboy 2.4.0 has been released!
Numerous HTTP/2 options have been added to control the HTTP/2 SETTINGS and general behavior of HTTP/2 connections. The options for initial window sizes, maximum frame sizes or compression table sizes might be of interest for optimizing the performance of HTTP/2 connections.
Experimental support for Websocket over HTTP/2 was added. Note that browsers do not currently support it. The only browser with partial support is Google Chrome 67 (dev build) started with a specific flag.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/cowboy-2.4.0/">Read More</a>
</p>
</article>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/cowboy-2.3.0/">Cowboy 2.3</a></h2>
<p class="date">
<span class="year">2018</span>
<span class="day-month">04 Apr</span>
</p>
</header>
<p>Cowboy 2.3.0 has been released!
This release focused on adding support for the functions from the sys module for introspecting Cowboy processes.
Many bugs have also been fixed. A more complete list of changes can be found in the migration guide: Migrating from Cowboy 2.2 to 2.3.
You can donate to this project via GitHub Sponsors because I need to eat snacks when I write code. Thanks in advance!
As usual, feedback is appreciated, and issues should be reported by opening a ticket.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/cowboy-2.3.0/">Read More</a>
</p>
</article>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/cowboy-2.2.0/">Cowboy 2.2</a></h2>
<p class="date">
<span class="year">2017</span>
<span class="day-month">13 Dec</span>
</p>
</header>
<p>Cowboy 2.2.0 has been released!
This release focused on adding features required for writing gRPC servers and on completing test suites for the core HTTP RFCs.
The cowboy_req:stream_trailers/2 function has been added. It terminates the streamed response by adding some trailer field values. This feature is required for gRPC. The max_skip_body_length option was added. It controls how much of the request body we are willing to skip to get to the next request for HTTP/1.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/cowboy-2.2.0/">Read More</a>
</p>
</article>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/cowboy-2.1.0/">Cowboy 2.1</a></h2>
<p class="date">
<span class="year">2017</span>
<span class="day-month">09 Nov</span>
</p>
</header>
<p>Cowboy 2.1.0 has been released!
This release focused on adding features that were temporarily removed during the 2.0 release process:
The client TLS certificate can now be obtained. The 100 Continue response is now sent automatically again when necessary. NEW: It is now possible to send informational responses (1XX) directly from user code via the cowboy_req:inform/2,3 functions. NEW: cowboy_rest handlers can now switch to any other type of handler from almost any callback.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/cowboy-2.1.0/">Read More</a>
</p>
</article>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/cowboy-2.0.0/">Cowboy 2.0</a></h2>
<p class="date">
<span class="year">2017</span>
<span class="day-month">04 Oct</span>
</p>
</header>
<p>Cowboy 2.0.0 has been released!
This is the new stable version of Cowboy. There are no new releases planned for the 1.x version of Cowboy.
The highlights from the release are:
HTTP/2 support! Websocket compression! Much simpler, cleaner interface. No more weird errors just because you discard the Req object. A new low-level interface that receives all events from every set of request and response. This replaces the awkward hooks from 1.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/cowboy-2.0.0/">Read More</a>
</p>
</article>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/cowboy-2.0.0-rc.2/">Cowboy 2.0 release candidate 2</a></h2>
<p class="date">
<span class="year">2017</span>
<span class="day-month">23 Aug</span>
</p>
</header>
<p>Cowboy 2.0.0-rc.2 has been released!
This is the new recommended version of Cowboy. Its API should not change before release. While you probably should not use it in production yet, many do successfully. Use at your own risk.
This new version contains fixes for the following issues:
HTTP/2 server push was using the wrong header compression context. HTTP/2 flow control could end up queueing data in the wrong order when resuming the sending of data.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/cowboy-2.0.0-rc.2/">Read More</a>
</p>
</article>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/cowboy-2.0.0-rc.1/">Cowboy 2.0 release candidate 1</a></h2>
<p class="date">
<span class="year">2017</span>
<span class="day-month">24 Jul</span>
</p>
</header>
<p>Cowboy 2.0.0-rc.1 has been released!
This is the new recommended version of Cowboy. Its API should not change before release. While you probably should not use it in production yet, many do successfully. Use at your own risk.
The plan is to have a new RC version every couple weeks until the summer ends or later if there are still blocking issues open. Only issues that can't be fixed without making breaking changes to the interface may block the release.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/cowboy-2.0.0-rc.1/">Read More</a>
</p>
</article>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/the-elephant-in-the-room/">The elephant in the room</a></h2>
<p class="date">
<span class="year">2017</span>
<span class="day-month">26 Mar</span>
</p>
</header>
<p>Have you ever tried telling someone why they should use Erlang? You boast the smaller code size, the auto healing mechanisms, the distribution and they seem really excited. They wonder why they never heard about Erlang before. And then you show them what the code looks like. All excitement goes away. The smiles disappear. Their face starts becoming really serious.
You lost them. You know you lost them. They comment on the syntax, or perhaps you do, already admitting defeat.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/the-elephant-in-the-room/">Read More</a>
</p>
</article>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/dont-let-it-crash/">Don't let it crash</a></h2>
<p class="date">
<span class="year">2017</span>
<span class="day-month">22 Jan</span>
</p>
</header>
<p>We have a specific mindset when writing Erlang programs. We focus on the normal execution of the program and don't handle most of the errors that may occur. We sometimes call this normal execution the happy path.
The general pattern behind writing only for the happy path, letting the VM catch errors (writing them to a log for future consumption) and then having a supervisor restart the processes that failed from a clean state, has a name.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/dont-let-it-crash/">Read More</a>
</p>
</article>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/cowboy-2.0.0-pre.4/">Cowboy 2.0 pre-release 4</a></h2>
<p class="date">
<span class="year">2017</span>
<span class="day-month">03 Jan</span>
</p>
</header>
<p>Cowboy 2.0.0-pre.4 has been released!
This is the new recommended version of Cowboy. While I would not recommend putting it in production just yet, I do recommend you start writing new applications with this Cowboy version.
The most significant changes in the pre-release are:
A new architecture: there now is one process per connection and one process per request. This was done because HTTP/2 allows running requests concurrently. Stream handlers.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/cowboy-2.0.0-pre.4/">Read More</a>
</p>
</article>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/ranch-1.3/">Ranch 1.3</a></h2>
<p class="date">
<span class="year">2016</span>
<span class="day-month">28 Nov</span>
</p>
</header>
<p>Ranch 1.3.0 has been released!
This release fixes a number of long standing issues and adds a small number of features:
The ssl application has been added to the list of dependencies. If you don't need it, you can remove it automatically when fetching Ranch or when building the release. If you do need it, you will no longer have issues shutting down a node because of Ranch.
The ranch:info/0 and ranch:procs/2 can be used to retrieve information about Ranch's state.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/ranch-1.3/">Read More</a>
</p>
</article>
<article class="blog_item">
<header>
<h2><a href="https://ninenines.eu/articles/ml-archives/">Mailing list archived</a></h2>
<p class="date">
<span class="year">2016</span>
<span class="day-month">29 Aug</span>
</p>
</header>
<p>The old mailing list archives have been added to the site, mainly for referencing purposes.
The mailing list has been shut down and all personal information has been deleted.
If you need help with a project, consider either opening a ticket on that project's issues tracker or going through the community channels (erlang-questions, #ninenines or #erlang on Freenode).
Prefer tickets; often when people have issues it highlights an underlying problem in the project or its documentation.</p>
<p style="text-align:right">
<a class="read_more" href="https://ninenines.eu/articles/ml-archives/">Read More</a>
</p>
</article>
<nav class="pagination" role="pagination">
<a href="/articles/"><i class="fa fa-angle-double-left"></i></a>
<span>2 / 3</span>
<a href="/articles/page/3/"><i class="fa fa-angle-double-right"></i></a>
</nav>
</div>
</div>
</div>
</div>
<footer>
<div class="container">
<div class="row">
<div class="span6">
<p id="scroll-top"><a href="#">↑ Scroll to top</a></p>
<nav>
<ul>
<li><a href="mailto:[email protected]" title="Contact us">Contact us</a></li><li><a href="https://github.com/ninenines/ninenines.github.io" title="Github repository">Contribute to this site</a></li>
</ul>
</nav>
</div>
<div class="span6 credits">
<p><img src="/img/footer_logo.png"></p>
<p>Copyright © Loïc Hoguin 2012-2018</p>
</div>
</div>
</div>
</footer>
<script src="/js/custom.js"></script>
</body>
</html>
|
