git.iko.soy/typeable/derive-api-th
on master help sign in
5 files changed+126−70
since splitsnapshots
unifiedsplit
README.md+1−1 default.nix+34 derive-api-th.cabal+36−33 shell.nix+1 src/Derive/API/TH.hs+54−36
README.md+1−1
@@ -1,4 +1,4 @@
11# derive-api-th
22
33Derive JSON and Openapi3 instances using TH.
4−It is convenient to derive together and drastically reduce compile time comparing with generic-base instance generation.
4+It is convenient to derive together and drastically reduce compile time comparing with generic-based instance generation.
default.nixnew file+34
@@ -0,0 +1,34 @@
1+{ reflex-platform ? ((import <nixpkgs> {}).fetchFromGitHub {
2+ owner = "reflex-frp";
3+ repo = "reflex-platform";
4+ rev = "a4664e3b99f1b89a77ac759501b6bd85e18eac95";
5+ sha256 = "1pjzjhj966rs16f4b80ir9v8d7g7q2aa0i0zs30fny3x0xk1b4ah";
6+ })
7+}:
8+(import reflex-platform { config.allowBroken = true; }).project ({ pkgs, ... }:{
9+ useWarp = true;
10+ withHoogle = false;
11+
12+ packages = {
13+ derive-api-th = ../derive-api-th;
14+ };
15+
16+ tools = _: [
17+ (pkgs.haskell.lib.dontCheck pkgs.haskellPackages.cabal-cargs)
18+ pkgs.inotify-tools
19+ ];
20+
21+ shellToolOverrides = ghc: super: {
22+ closure-compiler = null;
23+ haskell-ide-engine = null;
24+ hdevtools = null;
25+ hlint = null;
26+ stylish-haskell = null;
27+ hoogle = null;
28+ };
29+
30+ shells = {
31+ ghc = ["derive-api-th"];
32+ ghcjs = ["derive-api-th"];
33+ };
34+})
derive-api-th.cabal+36−33
@@ -1,44 +1,47 @@
1−cabal-version: 1.12
1+cabal-version: 1.12
2+name: derive-api-th
3+version: 0.1.0.0
4+description:
5+ Please see the README on GitHub at <https://github.com/typeable/derive-api-th#readme>
26
3−name: derive-api-th
4−version: 0.1.0.0
5−description: Please see the README on GitHub at <https://github.com/typeable/derive-api-th#readme>
6−homepage: https://github.com/typeable/derive-api-th#readme
7−bug-reports: https://github.com/typeable/derive-api-th/issues
8−author: Typeable
9−maintainer: dima@typeable.io
10−copyright: 2022 Typeable LLC
11−license: BSD3
12−license-file: LICENSE
13−build-type: Simple
14−extra-source-files:
15− README.md
7+homepage: https://github.com/typeable/derive-api-th#readme
8+bug-reports: https://github.com/typeable/derive-api-th/issues
9+author: Typeable
10+maintainer: dima@typeable.io
11+copyright: 2022 Typeable LLC
12+license: BSD3
13+license-file: LICENSE
14+build-type: Simple
15+extra-source-files: README.md
1616
1717source-repository head
18− type: git
18+ type: git
1919 location: https://github.com/typeable/derive-api-th
2020
2121library
22− exposed-modules:
23− Derive.API.TH
24− other-modules:
25− Paths_derive_api_th
26− hs-source-dirs:
27− src
22+ exposed-modules: Derive.API.TH
23+ other-modules: Paths_derive_api_th
24+ hs-source-dirs: src
2825 build-depends:
29− base >=4.7 && <5
30− , aeson
26+ aeson
27+ , base >=4.7 && <5
28+ , containers
3129 , template-haskell
3230 , th-abstraction
33− , generic-arbitrary
34− , QuickCheck
35− if !impl(ghcjs)
31+
32+ if !(impl(ghcjs) || arch(javascript) || arch(wasm32))
3633 build-depends:
37− openapi3
38− default-language: Haskell2010
34+ generic-arbitrary >=1.0
35+ , openapi3
36+ , QuickCheck
37+
38+ cpp-options: -DBACKEND
39+
40+ default-language: Haskell2010
3941 default-extensions:
40− DuplicateRecordFields
41− , NamedFieldPuns
42− , RecordWildCards
43− , StandaloneDeriving
44− , TemplateHaskell
42+ BlockArguments
43+ DuplicateRecordFields
44+ NamedFieldPuns
45+ RecordWildCards
46+ StandaloneDeriving
47+ TemplateHaskell
shell.nixnew file+1
@@ -0,0 +1 @@
1+(import ./default.nix { }).shells.ghcjs
src/Derive/API/TH.hs+54−36
@@ -10,14 +10,14 @@ module Derive.API.TH
1010 , derivingOptionsToJsonOptions
1111 , deriveApiInstances
1212 , deriveApiAndArbitraryInstances
13−#ifndef ghcjs_HOST_OS
13+#ifdef BACKEND
1414 , derivingOptionsToSchemaOptions
1515 , deriveToParamSchema
1616 , deriveToSchema
17+ , deriveArbitrary
1718#endif
1819 , deriveApiFromJSON
1920 , deriveApiToJSON
20− , deriveArbitrary
2121 , generateParseJSON
2222 ) where
2323
@@ -25,22 +25,22 @@ import Control.Monad
2525import Data.Aeson.TH as A
2626import Data.Aeson.Types
2727import Data.List
28+import Data.Map as M
2829import Data.Maybe
29−-- import Data.Traversable
3030import Data.Typeable
3131import Language.Haskell.TH
3232import Language.Haskell.TH.Datatype
3333import Language.Haskell.TH.Syntax
34−import Test.QuickCheck
35−import Test.QuickCheck.Arbitrary.Generic
3634
37−#ifndef ghcjs_HOST_OS
35+#ifdef BACKEND
3836import Data.OpenApi hiding (prefix)
37+import Test.QuickCheck
38+import Test.QuickCheck.Arbitrary.Generic
3939#endif
4040
4141-- | derive JSON and openapi3 (ToSchema) instances
4242deriveApiInstances :: DerivingOptions -> Name -> Q [Dec]
43−#ifndef ghcjs_HOST_OS
43+#ifdef BACKEND
4444deriveApiInstances opts tname = liftM2 (<>)
4545 (deriveJSON (derivingOptionsToJsonOptions opts) tname)
4646 (deriveToSchema opts tname)
@@ -51,7 +51,7 @@ deriveApiInstances opts tname =
5151
5252-- | derive JSON and openapi3 (ToSchema) and Arbitrary instances
5353deriveApiAndArbitraryInstances :: DerivingOptions -> Name -> Q [Dec]
54−#ifndef ghcjs_HOST_OS
54+#ifdef BACKEND
5555deriveApiAndArbitraryInstances opts tname = liftM2 (<>)
5656 (deriveApiInstances opts tname)
5757 (deriveArbitrary tname)
@@ -60,13 +60,29 @@ deriveApiAndArbitraryInstances opts tname =
6060 deriveApiInstances opts tname
6161#endif
6262
63−-- We can't directly 'lift' Options into TH, so have to use this
63+#if MIN_VERSION_containers(0,6,6)
64+#elif MIN_VERSION_template_haskell(2,17,0)
65+instance (Lift k, Lift a) => Lift (Map k a) where
66+ liftTyped x = unsafeCodeCoerce (lift x)
67+ lift m = [|M.fromList (M.toList m)|]
68+#elif MIN_VERSION_template_haskell(2,16,0)
69+instance (Lift k, Lift a) => Lift (Map k a) where
70+ liftTyped x = unsafeTExpCoerce (lift x)
71+ lift m = [|M.fromList (M.toList m)|]
72+#else
73+instance (Lift k, Lift a) => Lift (Map k a) where
74+ lift m = [|M.fromList (M.toList m)|]
75+#endif
76+-- We can't directly 'lift' Options into TH (there is no instance for function),
77+-- so we use this type.
6478data DerivingOptions = DerivingOptions
6579 { prefix :: Maybe String
6680 -- ^ Optional prefix to strip from constructors and field labels
6781 , snake :: Bool
6882 -- ^ Whether to snake constructors and field labels
6983 -- Applied after stripping prefix
84+ , convertMap :: M.Map String String
85+ -- ^ convert names (constructors and fields) before snake and strip prefix
7086 , unwrapUnaryRecords :: Bool
7187 , omitNothingFields :: Bool
7288 , sumEncoding :: SumEncoding
@@ -78,34 +94,41 @@ defaultDerivingOptions :: DerivingOptions
7894defaultDerivingOptions = DerivingOptions
7995 { prefix = Nothing
8096 , snake = True
97+ , convertMap = mempty
8198 , unwrapUnaryRecords = False
8299 , omitNothingFields = False
83100 , sumEncoding = defaultTaggedObject }
84101
85102derivingOptionsToJsonOptions :: DerivingOptions -> Options
86103derivingOptionsToJsonOptions DerivingOptions{..} = defaultOptions
87− { fieldLabelModifier = snaked . stripped
88− , constructorTagModifier = snaked . stripped
104+ { fieldLabelModifier = snaked . stripped . convert
105+ , constructorTagModifier = snaked . stripped . convert
89106 , sumEncoding
90107 , omitNothingFields
91108 , unwrapUnaryRecords }
92109 where
110+ convert s = fromMaybe s $ M.lookup s convertMap
93111 snaked = if snake then camelTo2 '_' else id
94112 stripped = maybe id stripPrefix' prefix
95113
96−#ifndef ghcjs_HOST_OS
114+#ifdef BACKEND
115+datatypeVarsTypes :: DatatypeInfo -> [Type]
116+#if MIN_VERSION_th_abstraction(0,3,0)
117+datatypeVarsTypes = fmap (VarT . tvName) . datatypeVars
118+#else
119+datatypeVarsTypes = datatypeVars
120+#endif
121+
97122derivingOptionsToSchemaOptions :: DerivingOptions -> SchemaOptions
98123derivingOptionsToSchemaOptions = fromAesonOptions . derivingOptionsToJsonOptions
99124
100125deriveToParamSchema :: DerivingOptions -> Name -> Q [Dec]
101126deriveToParamSchema opts tname = do
102− let
103− body = AppE (VarE 'genericToParamSchema) <$>
104− appE (pure $ VarE 'derivingOptionsToSchemaOptions) (lift opts)
105− pure <$> instanceD
106− (pure [])
107− (pure $ ConT ''ToParamSchema `AppT` ConT tname)
108− [ funD 'toParamSchema $ pure $ clause [] (normalB body) [] ]
127+ body <- AppE (VarE 'genericToParamSchema)
128+ . AppE (VarE 'derivingOptionsToSchemaOptions) <$> lift opts
129+ pure [InstanceD Nothing []
130+ (ConT ''ToParamSchema `AppT` ConT tname)
131+ [FunD 'toParamSchema [Clause [] (NormalB body) []] ]]
109132
110133deriveToSchema :: DerivingOptions -> Name -> Q [Dec]
111134deriveToSchema opts tname = do
@@ -114,25 +137,21 @@ deriveToSchema opts tname = do
114137 context = do
115138 var <- datatypeVarsTypes tinfo
116139 [ConT ''Typeable `AppT` var, ConT ''ToSchema `AppT` var]
117− body = AppE (VarE 'genericDeclareNamedSchema) <$>
118− appE (pure $ VarE 'derivingOptionsToSchemaOptions) (lift opts)
119− pure <$> instanceD
120− (pure context)
121− (pure $ ConT ''ToSchema `AppT` datatypeType tinfo)
122− [ funD 'declareNamedSchema $ pure $ clause [] (normalB body) [] ]
123−
124−datatypeVarsTypes :: DatatypeInfo -> [Type]
125−#if MIN_VERSION_th_abstraction(0,3,0)
126−datatypeVarsTypes = fmap (VarT . tvName) . datatypeVars
127−#else
128−datatypeVarsTypes = datatypeVars
129−#endif
140+ body <- AppE (VarE 'genericDeclareNamedSchema)
141+ . AppE (VarE 'derivingOptionsToSchemaOptions) <$> lift opts
142+ pure [InstanceD Nothing context
143+ (ConT ''ToSchema `AppT` datatypeType tinfo)
144+ [ FunD 'declareNamedSchema [Clause [] (NormalB body) []] ]]
130145
131146deriveArbitrary :: Name -> Q [Dec]
132−deriveArbitrary t = do
147+deriveArbitrary t = do
133148 tinfo <- reifyDatatype t
134− let ctx = AppT (ConT ''Arbitrary) <$> datatypeVarsTypes tinfo
135− pure [InstanceD Nothing ctx (ConT ''Arbitrary `AppT` datatypeType tinfo)
149+ let
150+ typ = datatypeType tinfo
151+ ctx = datatypeVarsTypes tinfo >>= \tv ->
152+ [ ConT ''Arbitrary `AppT` tv
153+ , ConT ''Arg `AppT` typ `AppT` tv ]
154+ pure [InstanceD Nothing ctx (ConT ''Arbitrary `AppT` typ)
136155 [ FunD 'arbitrary [Clause [] (NormalB $ VarE 'genericArbitrary) []]
137156 , FunD 'shrink [Clause [] (NormalB $ VarE 'genericShrink) []] ] ]
138157#endif
@@ -148,4 +167,3 @@ generateParseJSON = mkParseJSON . derivingOptionsToJsonOptions
148167
149168stripPrefix' :: String -> String -> String
150169stripPrefix' pfx = fromMaybe <*> stripPrefix pfx
151−