h$<6      !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~None #$-./89>?2=  servant-docsCustomise how an =! is converted into documentation. servant-docs~ ["foo"] "GET" /foo:defEndpoint & path <>~ ["foo"] & method .~ HTTP.methodPost "POST" /fooE servant-docsRender a path as a -delimited stringF servant-docsAn A) whose path is `"/"` and whose method is GETHere's how you can modify it: defEndpoint"GET" /defEndpoint & path <>~ ["foo"] "GET" /foo:defEndpoint & path <>~ ["foo"] & method .~ HTTP.methodPost "POST" /fooG servant-docs An empty =H servant-docsThere should be at most one  per API endpoint. So here we are keeping the first occurrence.I servant-docsDefault documentation options.J servant-docsCombine two Responses, we can't make a monoid because merging Status breaks the laws.As such, we invent a non-commutative, left associative operation J; to mush two together taking the status from the very left.K servant-docs4Default response: status code 200, no response body. Can be tweaked with four lenses. defResponseResponse {_respStatus = 200, _respTypes = [], _respBody = [], _respHeaders = []}defResponse & respStatus .~ 204Response {_respStatus = 204, _respTypes = [], _respBody = [], _respHeaders = []}L servant-docsCombine two Actions, we can't make a monoid as merging Response breaks the laws.As such, we invent a non-commutative, left associative operation L= to mush two together taking the response from the very left.M servant-docsDefault  . Has no  , no query , expects no request body () and the typical response is K.Tweakable with lenses. defActionAction {_authInfo = [], _captures = [], _headers = [], _params = [], _fragment = Nothing, _notes = [], _mxParams = [], _rqtypes = [], _rqbody = [], _response = Response {_respStatus = 200, _respTypes = [], _respBody = [], _respHeaders = []}}&defAction & response.respStatus .~ 201Action {_authInfo = [], _captures = [], _headers = [], _params = [], _fragment = Nothing, _notes = [], _mxParams = [], _rqtypes = [], _rqbody = [], _response = Response {_respStatus = 201, _respTypes = [], _respBody = [], _respHeaders = []}}N servant-docs8Create an API that's comprised of a single endpoint. = is a (, so combine multiple endpoints with  or .O  servant-docsDefault API generation options.%All content types are shown for both  and ;  is set to  (i.e. un-grouped). servant-docs Capture "greetid" Text :> Delete)) $ defAction & headers <>~ ["unicorns"] & notes <>~ [ DocNote "Title" ["This is some text"] , DocNote "Second section" ["And some more"] ] servant-docsGenerate documentation given some extra introductions (in the form of DocInfo9) and some extra endpoint documentation (in the form of !.The extra introductions will be prepended to the top of the documentation, before the specific endpoint documentation. The extra endpoint documentation will be "unioned" with the automatically generated endpoint documentation.You are expected to build up the ExtraInfo with the Monoid instance and .-If you only want to add an introduction, use . servant-docs2Generate the docs for a given API that implements ) with with any number of introduction(s) servant-docs2Sample input or output (if there is at least one). servant-docs No samples. servant-docs"Single sample without description. servant-docsSamples without documentation. servant-docs,Default sample Generic-based inputs/outputs. servant-docsSynthesise a sample value of a type, encoded in the specified media types. servant-docsSynthesise a list of sample values of a particular type, encoded in the specified media types. servant-docs;Generate documentation in Markdown format for the given =.This is equivalent to  O.  servant-docs;Generate documentation in Markdown format for the given = using the specified options.5These options allow you to customise aspects such as:Choose how many content-types for each request body example are shown with .Choose how many content-types for each response body example are shown with .For example, to only show the first content-type of each example:  markdownWith (O &    &    ) myAPI  servant-docs"TODO: this instance is incomplete. servant-docs=TODO: mention the endpoint is streaming, its framing strategyAlso there are no samples.$TODO: AcceptFraming for content-type servant-docsThe generated docs for  are empty. servant-docsThe generated docs for a  b just appends the docs for a with the docs for b. servant-docs "books" :>  "isbn" Text will appear as books:isbn in the docs. servant-docs "books" :>  "isbn" Text will appear as books:isbn in the docs.   !"#$&%'(*)+,.-/0213487659:<;=>@?ABDCEFGHIJKLMNO~ABDCEF=>@?G9:<;348765/021H+,.-'(*)#$&%!" IJK  LMNO~None  ./>5} servant-docsReplace all JSON content types with PrettyJSON. Kind-polymorphic so it can operate on kinds * and [*]. servant-docsPrettyJSON content type. servant-docs&Prettify generated JSON documentation. docs ( ( ::  MyAPI)) None5 !"#$%&'()*+,-.3456789:;<=AFGIKMNO~O!" IAF=G'()*~9:;<345678#$%&+,-.KMN       !!""#$%%&'(()*++,-../0123345667899:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~*servant-docs-0.11.8-GZ2W0Bz0Rym5oCTLVgq6S2Servant.Docs.InternalServant.Docs.Internal.Pretty Servant.DocsRenderingOptions_requestExamples_responseExamples _notesHeadingShowContentTypesAllContentTypesFirstContentTypeAction _authInfo _captures_headers_params _fragment_notes _mxParams_rqtypes_rqbody _responseResponse _respStatus _respTypes _respBody _respHeaders ParamKindNormalListFlag DocOptions _maxSamples ExtraInfoDocNote _noteTitle _noteBodyDocAuthentication _authIntro_authDataRequiredDocIntro _introTitle _introBody DocFragment _fragSymbol _fragDesc DocQueryParam _paramName _paramValues _paramDesc _paramKind DocCapture _capSymbol_capDescAPI _apiIntros _apiEndpointsEndpoint_path_methodshowPath defEndpointemptyAPIcombineFragmentdefaultDocOptionscombineResponse defResponse combineAction defActionsingledefRenderingOptions$fHashableEndpoint$fShowEndpoint $fOrdDocIntro$fMonoidExtraInfo$fSemigroupExtraInfo $fMonoidAPI$fSemigroupAPI$fShowRenderingOptions$fEqShowContentTypes$fOrdShowContentTypes$fShowShowContentTypes$fReadShowContentTypes$fBoundedShowContentTypes$fEnumShowContentTypes$fEqAPI $fShowAPI $fEqAction $fOrdAction $fShowAction $fEqResponse $fOrdResponse$fShowResponse$fEqDocQueryParam$fOrdDocQueryParam$fShowDocQueryParam $fEqParamKind$fOrdParamKind$fShowParamKind$fShowDocOptions $fEqDocNote $fOrdDocNote $fShowDocNote$fEqDocAuthentication$fOrdDocAuthentication$fShowDocAuthentication $fEqDocIntro$fShowDocIntro$fEqDocFragment$fOrdDocFragment$fShowDocFragment$fEqDocCapture$fOrdDocCapture$fShowDocCapture $fEqEndpoint $fOrdEndpoint$fGenericEndpointauthDataRequired authIntro maxSamples apiEndpoints apiIntrosmethodpathcapDesc capSymbol paramDesc paramKind paramName paramValuesfragDesc fragSymbol introBody introTitlenoteBody noteTitlerespBody respHeaders respStatus respTypesauthInfocapturesfragmentheadersmxParamsnotesparamsresponserqbodyrqtypes ToFragment toFragment ToAuthInfo toAuthInfo ToCapture toCaptureToParamtoParamAllHeaderSamplesallHeaderToSample GToSample gtoSamplesToSample toSamplesHasDocsdocsFor notesHeadingrequestExamplesresponseExamplesdocsdocsWithOptions extraInfodocsWithdocsWithIntrostoSample noSamples singleSamplesamplesdefaultSamplessampleByteStringsampleByteStringsmarkdown markdownWith$fHasDocsTYPEWithNamedContext$fHasDocsTYPE:>$fHasDocsTYPE:>0$fHasDocsTYPE:>1$fHasDocsTYPE:>2$fHasDocsTYPE:>3$fHasDocsTYPE:>4$fHasDocsTYPE:>5$fHasDocsTYPE:>6$fHasDocsTYPERaw$fHasDocsTYPE:>7$fHasDocsTYPEStream$fHasDocsTYPENoContentVerb$fHasDocsTYPEEmptyAPI$fHasDocsTYPE:<|>$fGToSamplekM1$fGToSamplek:+:$fGToSamplek:*:$fGToSamplekV1$fGToSamplekU1$fToSampleDual$fToSampleLast$fToSampleFirst$fToSampleProduct $fToSampleSum $fToSampleAny $fToSampleAll$fToSampleZipList$fToSampleConst$fToSampleNonEmpty $fToSample[]$fToSampleEither$fToSampleMaybe$fToSample(,,,,,,)$fToSample(,,,,,)$fToSample(,,,,)$fToSample(,,,)$fToSample(,,) $fToSample(,)$fToSampleOrdering$fToSampleBool$fToSampleNoContent$fHasDocsTYPE:>8$fHasDocsTYPEVerb$fGToSamplekK1$fHasDocsTYPEVerb0$fAllHeaderSamples[]:$fAllHeaderSamples[][]$fHasDocsTYPE:>9$fHasDocsTYPE:>10$fHasDocsTYPE:>11$fHasDocsTYPE:>12$fHasDocsTYPE:>13$fHasDocsTYPE:>14$fHasDocsTYPE:>15Pretty PrettyJSONpretty$fMimeRenderTYPEPrettyJSONa$fAcceptTYPEPrettyJSON(http-types-0.12.3-LMMV4F9OuE2BJ0myUSAImxNetwork.HTTP.Types.MethodMethodghc-prim GHC.TypesIntbytestring-0.10.10.0Data.ByteString.Lazy.Internal ByteStringbaseGHC.Real/%servant-0.18.2-80drE78NifXC7j6gzxhw1KServant.API.FragmentFragmentGHC.BaseMonoidmappend<> GHC.MaybeNothing text-1.2.3.2Data.Text.InternalText"lens-4.19.2-2vEmLnNyc2RGyOpS48h1FFControl.Lens.Setter.~Servant.API.EmptyEmptyAPIServant.API.Alternative:<|>Servant.API.Capture CaptureAllCapture Data.ProxyProxy