Swagger paths are permutted.

[phadej]

as _swaggerPaths is a HashMap, not only the order is different from what is declared (e.g. in servant API type), it's arbitrary. For machine reading, it's ok; but swagger-ui suffer from this:

I could work on this, if we agree on solution. Either we could change HashMap FilePath PathItem to Vector (FilePath, PathItem), maybe wrapped in newtype.

EDIT; That won't be easy to fix, as the paths is an object in JSON representation, yet that could be worked around in >=aeson-0.10 by using toEncoding (so one can specify an order of output!)

[fizruk]

Maybe something like this?

-- | A @'HashMap'@ with an explicit ordering of the keys.
data OrdHashMap k v = OrdHashMap
  { ordHashMapKeys :: Vector k     -- ^ Explicit ordering of the keys.
  , ordHashMapMap  :: HashMap k v  -- ^ The mapping.
  }

Also, we can replace all/most of the HashMaps used in the data model.
For instance, this ordering might also be useful for Schema's properties.

[phadej]

I'll take on this tomorrow/on the weekend.

[fizruk]

Closed by #56.