🎬 The source for www.pointfree.co, a video series on functional programming and the Swift programming language.
This repo contains the full source code for the Point-Free website, a video series exploring advanced programming topics in Swift. The codebase is split into 3 pieces:
PointFree
: This is the core application, and is responsible for routing requests, loading data and rendering HTML and CSS.Styleguide
: This library contains functions and data types for creating a consistent style across the entire website.Server
: This is the actual executable server. It uses NIO to handle the low-level server responsibilities, and hands everything else over to the PointFree
package.Interested in a video tour of the code base?
The repo contains an extensive test suite and some playgrounds to explore. To get things running:
Open up a terminal window and grab the code:
git clone https://github.com/pointfreeco/pointfreeco.git
cd pointfreeco
Make sure cmark
is installed. You can install it with Homebrew:
brew install cmark # or your preferred installation method
Make sure Postgres is installed and running. It's our database of choice. You can install it with Homebrew:
brew install postgres # or your preferred installation method
brew services start postgresql # or your preferred launch method
make db
(If you use Postgres.app, EnterpriseDB, or another installation method, please follow some additional instructions in the CPostgreSQL README.)
With the project open in Xcode, you can:
Server
targethttp://localhost:8080
PointFree
targetThere're a lot of fun things to explore in this repo. For example:
We develop web pages in playgrounds for a continuous feedback loop. This is made possible by the fact that the entire server stack is composed of pure functions with side-effects pushed to the boundaries of the application. It allows us to load up any request in isolation, including POST
requests, all without ever worrying about doing a side-effect.
We use snapshot testing to capture full data structures in order to verify their correctness. Not only do we do this in the traditional way of taking screenshots of web pages at various break points (e.g. on iPhone and desktop), but we can also snapshot any entire request-to-response lifecycle (e.g. the POST
to a signup page does the correct redirect).
▿ Step
ResponseEnded
▿ Request
POST http://localhost:8080/launch-signup
[email protected]
▿ Response
Status 302 FOUND
Location: /?success=true
Like the color theme we use in our episodes? Run make colortheme
to install locally!
Point-Free uses a bunch of interesting open-source software:
Explore more of our open-source on the Point-Free organization.
Brandon gave a talk about most of the core ideas that went into this project at Swift Summit 2017.
Then check out Point-Free!
The content of this project itself is licensed under the CC BY-NC-SA 4.0 license, and the underlying source code used to format and display that content is licensed under the MIT license.