Skip to content

baozi-technology/ranch-under-the-hood

Repository files navigation

Ranch: what’s under the hood?

This document is a summary of my analysis of Ranch 2.0.0-rc.1 source code, performed in August 2019. It has been done purely in an old-school way, cloning the project from github and going through it manually.

By helping understand the intricacy of a well-established but somewhat small Erlang library, the reader can:

  • improve its Erlang proficiency

  • be able to help maintaining Ranch

  • be able to reuse Ranch codebase or get inspired by it for other projects

Warning
This analysis has been performed while I just started learning Erlang, right after going through Learn You Some Erlang For Great Good. If you find any errors, a pull-request or a new GitHub issue is welcome! ;)

Where can I read it?

Build it locally or go through the .adoc from GitHub.

A taste of what’s coming…​

Ranch Source 6

Contribute

This code analysis is not comprehensive. I happily accept any pull-request that aim to add new contents or correct any issues. As for myself, I am not planning on adding new content for now but I am actively looking for people proof-reading the guide and pointing out gotchas to be fixed in the parts currently covered.

Thanks

drawio logo 50px

Draw.io is the diagram application that allows us making cool schemas easily.

asciidoctor logo outline color

Asciidoctor is the plain text documentation syntax and processor we’re using.

apple touch icon 57

Nine Nines is the company behind Ranch. Thanks to all the Ranch contributors for making this software!

License and disclaimer

This work is distributed under the same license as Ranch itself, ISC License.

Ranch was originally built by Loïc Hoguin, which kindly encouraged me to publish this code analysis.
I am not related to Nine Nines.
Donate if you wish to support Ranch.

About

Ranch: what's under the hood?

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published