New guide for `purescript-routing-duplex`, a bidirectional route parsing library

thomashoneyman · November 20, 2018, 4:29am

@natefaubion has written an awesome library for parsing / printing routing data types. No more boilerplate printing functions and no more letting your parser get out of sync with the routes you write as strings. However, it’s tough to get started without a tutorial and some usage examples. Fortunately, there’s a brand new guide for the library available on master:

As a note, there are other approaches to the same problem. I’m not well-versed enough to comment on them, but I’m at least aware of @paluh’s purescript-boomboom:

Finally, for an example of this library in use, you can see the Data.Route module from halogen-realworld. As a side note – nothing reveals the number of imports in even a small module in PureScript quite like a 20-line preview with no actual code:

github.com

thomashoneyman/purescript-halogen-realworld/blob/master/src/Data/Route.purs

-- | We can represent valid locations in our application with a simple sum type. This will cause
-- | any invalid routes to fail at compile-time.
-- |
-- | But since the browser represents locations with strings, we'll also need a way to write our
-- | `Route` type to a string and parse strings into valid `Route` values. It's tedious and error-
-- | prone to maintain separate printing and parsing functions which can fall out of sync with
-- | another, and even worse to write them manually. Fortunately, the `routing-duplex` library will
-- | help us write a bi-directional codec which solves both problems.
-- |
-- | For more information about the library and to read the tutorial, see:
-- | https://github.com/natefaubion/purescript-routing-duplex/tree/v0.2.0
module Conduit.Data.Route where

import Prelude hiding ((/))

import Data.Either (note)
import Data.Generic.Rep (class Generic)
import Data.Generic.Rep.Show (genericShow)
import Conduit.Data.Username (Username)
import Conduit.Data.Username as Username

This file has been truncated. show original