{-# LANGUAGE TupleSections #-}
module Ecluse.Core.Registry.PyPI.Route.Internal (
pypiRouter,
pypiRoutes,
pypiRouteSpecs,
distributionPath,
PyPICap (..),
takeProject,
artifactCoordinate,
) where
import Data.List.NonEmpty qualified as NE
import Data.Text qualified as T
import Network.HTTP.Types (
Method,
ResponseHeaders,
Status,
status200,
status304,
status401,
status403,
status404,
status405,
status406,
status500,
status502,
status503,
)
import Ecluse.Core.Package (PackageName)
import Ecluse.Core.Registry.PyPI.Project (FileCoordinate (fcVersion), canonicalName, fileCoordinate, isCanonicalName, projectName)
import Ecluse.Core.Registry.PyPI.Wire (simpleIndexMediaType)
import Ecluse.Core.Server.Context (
MountRouter,
ResponseAction (AnswerRefusal, RunPipeline),
RouteAction (RouteAction),
)
import Ecluse.Core.Server.Contract (
BodySchema (SchemaDocumented, SchemaText),
PassthroughBody (PassthroughBytes, PassthroughEmpty, PassthroughStream),
PassthroughResponse,
ResponseContract,
ResponseValue,
chooseContract,
emptyContract,
mediaContract,
optionalBodyContract,
passthroughContract,
passthroughResponse,
responseValue,
)
import Ecluse.Core.Server.Path (Filename, mkFilename)
import Ecluse.Core.Server.Pipeline.Packument (PackumentReplies (packumentNotAcceptable), packumentAction)
import Ecluse.Core.Server.Pipeline.Packument.Response (MetadataResponse, metadataReplies)
import Ecluse.Core.Server.Pipeline.Publish (PublishReplies (..), servePublish)
import Ecluse.Core.Server.Pipeline.Sidecar (sidecarAction)
import Ecluse.Core.Server.Pipeline.Tarball (tarballAction)
import Ecluse.Core.Server.Pipeline.Tarball.Types (TarballReplies (..))
import Ecluse.Core.Server.Response (HelpMessage, Refusal, mkRefusal, refusalHelpBytes)
import Ecluse.Core.Server.Response.Summary (detailedRejections)
import Ecluse.Core.Server.Route (
Capture (Capture),
MediaNegotiation (AcceptsAnything, AcceptsOnly),
MethodMatch (MethodPost, MethodRead),
PatternSeg (SegCap, SegCapSuffix, SegLit),
Route (Route),
RouteName (RouteName),
renderRoute,
routerOf,
safeSegment,
)
import Ecluse.Core.Server.RouteDescription (RouteSpec, catchAllSpecs, specsOf, unsupportedPathParam)
import Ecluse.Core.Version (Version)
pypiRouter :: MountRouter
pypiRouter :: MountRouter
pypiRouter = RouteAction -> [Route PyPICap] -> MountRouter
forall v. RouteAction -> [Route v] -> MountRouter
routerOf RouteAction
pypiNotFound [Route PyPICap]
pypiRoutes
pypiNotFound :: RouteAction
pypiNotFound :: RouteAction
pypiNotFound = ResponseContract (ResponseValue (Maybe LByteString))
-> ResponseAction (ResponseValue (Maybe LByteString))
-> RouteAction
forall response.
ResponseContract response -> ResponseAction response -> RouteAction
RouteAction ResponseContract (ResponseValue (Maybe LByteString))
unsupportedContract ((Maybe HelpMessage -> ResponseValue (Maybe LByteString))
-> ResponseAction (ResponseValue (Maybe LByteString))
forall response.
(Maybe HelpMessage -> response) -> ResponseAction response
AnswerRefusal (Text
-> ResponseHeaders
-> Maybe HelpMessage
-> ResponseValue (Maybe LByteString)
declaredRefusal Text
"no route claims this path" []))
pypiRoutes :: [Route PyPICap]
pypiRoutes :: [Route PyPICap]
pypiRoutes =
[ Route PyPICap
artifactRoute
, Route PyPICap
simpleIndexRoute
, Route PyPICap
sidecarRoute
, Route PyPICap
uploadRoute
]
sidecarRoute :: Route PyPICap
sidecarRoute :: Route PyPICap
sidecarRoute =
RouteName
-> MethodMatch
-> MediaNegotiation PassthroughResponse
-> [PatternSeg PyPICap]
-> (ByteString
-> [PyPICap] -> Maybe (ResponseAction PassthroughResponse))
-> Text
-> Text
-> Maybe RequestSpec
-> ResponseContract PassthroughResponse
-> Route PyPICap
forall v response.
RouteName
-> MethodMatch
-> MediaNegotiation response
-> [PatternSeg v]
-> (ByteString -> [v] -> Maybe (ResponseAction response))
-> Text
-> Text
-> Maybe RequestSpec
-> ResponseContract response
-> Route v
Route
(Text -> RouteName
RouteName Text
"coreMetadata")
MethodMatch
MethodRead
MediaNegotiation PassthroughResponse
forall response. MediaNegotiation response
AcceptsAnything
[Text -> PatternSeg PyPICap
forall v. Text -> PatternSeg v
SegLit Text
"simple", Capture PyPICap -> PatternSeg PyPICap
forall v. Capture v -> PatternSeg v
SegCap Capture PyPICap
capProject, Capture PyPICap -> Text -> PatternSeg PyPICap
forall v. Capture v -> Text -> PatternSeg v
SegCapSuffix Capture PyPICap
capFile Text
".metadata"]
ByteString
-> [PyPICap] -> Maybe (ResponseAction PassthroughResponse)
buildSidecar
Text
"Stream a distribution's Core Metadata companion"
Text
"Relays an advertised companion after checking the parent file's origin and integrity. The resolver verifies the advertised companion digest."
Maybe RequestSpec
forall a. Maybe a
Nothing
ResponseContract PassthroughResponse
pypiArtifactContract
artifactRoute :: Route PyPICap
artifactRoute :: Route PyPICap
artifactRoute =
RouteName
-> MethodMatch
-> MediaNegotiation PassthroughResponse
-> [PatternSeg PyPICap]
-> (ByteString
-> [PyPICap] -> Maybe (ResponseAction PassthroughResponse))
-> Text
-> Text
-> Maybe RequestSpec
-> ResponseContract PassthroughResponse
-> Route PyPICap
forall v response.
RouteName
-> MethodMatch
-> MediaNegotiation response
-> [PatternSeg v]
-> (ByteString -> [v] -> Maybe (ResponseAction response))
-> Text
-> Text
-> Maybe RequestSpec
-> ResponseContract response
-> Route v
Route
(Text -> RouteName
RouteName Text
"distribution")
MethodMatch
MethodRead
MediaNegotiation PassthroughResponse
forall response. MediaNegotiation response
AcceptsAnything
[Text -> PatternSeg PyPICap
forall v. Text -> PatternSeg v
SegLit Text
"simple", Capture PyPICap -> PatternSeg PyPICap
forall v. Capture v -> PatternSeg v
SegCap Capture PyPICap
capProject, Capture PyPICap -> PatternSeg PyPICap
forall v. Capture v -> PatternSeg v
SegCap Capture PyPICap
capFile]
ByteString
-> [PyPICap] -> Maybe (ResponseAction PassthroughResponse)
buildArtifact
Text
"Stream a distribution file (wheel or sdist)"
Text
"The file's bytes are streamed verbatim with bounded memory, so the client verifies them \
\against the `sha256` the served index advertised. `/simple/{project}/{file}` is the one \
\spelling every rewritten file URL agrees with. Upstream statuses, headers, and media \
\types are relayed transparently; a locally generated refusal is a bare status."
Maybe RequestSpec
forall a. Maybe a
Nothing
ResponseContract PassthroughResponse
pypiArtifactContract
simpleIndexRoute :: Route PyPICap
simpleIndexRoute :: Route PyPICap
simpleIndexRoute =
RouteName
-> MethodMatch
-> MediaNegotiation PyPIIndexResponse
-> [PatternSeg PyPICap]
-> (ByteString
-> [PyPICap] -> Maybe (ResponseAction PyPIIndexResponse))
-> Text
-> Text
-> Maybe RequestSpec
-> ResponseContract PyPIIndexResponse
-> Route PyPICap
forall v response.
RouteName
-> MethodMatch
-> MediaNegotiation response
-> [PatternSeg v]
-> (ByteString -> [v] -> Maybe (ResponseAction response))
-> Text
-> Text
-> Maybe RequestSpec
-> ResponseContract response
-> Route v
Route
(Text -> RouteName
RouteName Text
"simpleIndex")
MethodMatch
MethodRead
(NonEmpty ByteString
-> (Maybe HelpMessage -> PyPIIndexResponse)
-> MediaNegotiation PyPIIndexResponse
forall response.
NonEmpty ByteString
-> (Maybe HelpMessage -> response) -> MediaNegotiation response
AcceptsOnly (ByteString
simpleIndexMediaType ByteString -> [ByteString] -> NonEmpty ByteString
forall a. a -> [a] -> NonEmpty a
:| []) (ResponseHeaders -> Maybe HelpMessage -> PyPIIndexResponse
notAcceptable []))
[Text -> PatternSeg PyPICap
forall v. Text -> PatternSeg v
SegLit Text
"simple", Capture PyPICap -> PatternSeg PyPICap
forall v. Capture v -> PatternSeg v
SegCap Capture PyPICap
capProject]
ByteString -> [PyPICap] -> Maybe (ResponseAction PyPIIndexResponse)
buildIndex
Text
"Fetch a project's Simple index"
Text
"Returns Écluse's merged-and-filtered PEP 691 JSON index: files merged across upstreams \
\and gated, each file URL rewritten to resolve back through this proxy. \
\`/simple/{project}/` and `/simple/{project}` both match, because the router strips a \
\trailing empty segment. A non-canonical (non-PEP-503) project name matches no route and \
\takes the `404`, with no redirect. A client that requires HTML and admits no JSON gets \
\`406`: Écluse serves the JSON form alone. The index is gzipped for a client whose \
\`Accept-Encoding` prefers gzip, unless `server.metadataGzip` is off."
Maybe RequestSpec
forall a. Maybe a
Nothing
ResponseContract PyPIIndexResponse
pypiIndexContract
uploadRoute :: Route PyPICap
uploadRoute :: Route PyPICap
uploadRoute =
RouteName
-> MethodMatch
-> MediaNegotiation PassthroughResponse
-> [PatternSeg PyPICap]
-> (ByteString
-> [PyPICap] -> Maybe (ResponseAction PassthroughResponse))
-> Text
-> Text
-> Maybe RequestSpec
-> ResponseContract PassthroughResponse
-> Route PyPICap
forall v response.
RouteName
-> MethodMatch
-> MediaNegotiation response
-> [PatternSeg v]
-> (ByteString -> [v] -> Maybe (ResponseAction response))
-> Text
-> Text
-> Maybe RequestSpec
-> ResponseContract response
-> Route v
Route
(Text -> RouteName
RouteName Text
"upload")
MethodMatch
MethodPost
MediaNegotiation PassthroughResponse
forall response. MediaNegotiation response
AcceptsAnything
[Text -> PatternSeg PyPICap
forall v. Text -> PatternSeg v
SegLit Text
"legacy"]
ByteString
-> [PyPICap] -> Maybe (ResponseAction PassthroughResponse)
buildUpload
Text
"Upload a first-party distribution"
Text
"Relays a bounded multipart upload after authentication and first-party name validation. \
\Only `:action=file_upload` is relayed: another action answers `501`, and a missing or repeated one answers `400`. \
\The `content` part's file name must name the declared project at the declared `version`, or the upload answers `400`."
Maybe RequestSpec
forall a. Maybe a
Nothing
ResponseContract PassthroughResponse
pypiUploadContract
simpleIndexSchema :: Text
simpleIndexSchema :: Text
simpleIndexSchema = Text
"PyPISimpleIndex"
type PyPIIndexResponse = MetadataResponse (Maybe LByteString)
pypiIndexContract :: ResponseContract PyPIIndexResponse
pypiIndexContract :: ResponseContract PyPIIndexResponse
pypiIndexContract =
ResponseContract (ResponseValue LByteString)
-> ResponseContract
(ResponseChoice
(ResponseValue ())
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseValue (Maybe LByteString)))))))))
-> ResponseContract PyPIIndexResponse
forall a b.
ResponseContract a
-> ResponseContract b -> ResponseContract (ResponseChoice a b)
chooseContract
(Status
-> Text
-> BodySchema
-> ResponseContract (ResponseValue LByteString)
mediaContract Status
status200 Text
"The filtered Simple index." (ByteString -> Text -> BodySchema
SchemaDocumented ByteString
simpleIndexMediaType Text
simpleIndexSchema))
( ResponseContract (ResponseValue ())
-> ResponseContract
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseValue (Maybe LByteString))))))))
-> ResponseContract
(ResponseChoice
(ResponseValue ())
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseValue (Maybe LByteString)))))))))
forall a b.
ResponseContract a
-> ResponseContract b -> ResponseContract (ResponseChoice a b)
chooseContract
(Status -> Text -> ResponseContract (ResponseValue ())
emptyContract Status
status304 Text
"The client's validator matched the assembled index.")
( ResponseContract (ResponseValue (Maybe LByteString))
-> ResponseContract
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseValue (Maybe LByteString)))))))
-> ResponseContract
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseValue (Maybe LByteString))))))))
forall a b.
ResponseContract a
-> ResponseContract b -> ResponseContract (ResponseChoice a b)
chooseContract
(Status
-> Text -> ResponseContract (ResponseValue (Maybe LByteString))
refusalContract Status
status401 Text
"Edge authentication failed.")
( ResponseContract (ResponseValue (Maybe LByteString))
-> ResponseContract
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseValue (Maybe LByteString))))))
-> ResponseContract
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseValue (Maybe LByteString)))))))
forall a b.
ResponseContract a
-> ResponseContract b -> ResponseContract (ResponseChoice a b)
chooseContract
(Status
-> Text -> ResponseContract (ResponseValue (Maybe LByteString))
refusalContract Status
status403 Text
"Private access was refused.")
( ResponseContract (ResponseValue (Maybe LByteString))
-> ResponseContract
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseValue (Maybe LByteString)))))
-> ResponseContract
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseValue (Maybe LByteString))))))
forall a b.
ResponseContract a
-> ResponseContract b -> ResponseContract (ResponseChoice a b)
chooseContract
(Status
-> Text -> ResponseContract (ResponseValue (Maybe LByteString))
refusalContract Status
status404 Text
"A project no configured upstream has, a first-party project the private upstream does not have, which is never fetched from the public upstream, a project whose upstreams list no release, or a project with no release that passed policy and admission.")
( ResponseContract (ResponseValue (Maybe LByteString))
-> ResponseContract
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseValue (Maybe LByteString))))
-> ResponseContract
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseValue (Maybe LByteString)))))
forall a b.
ResponseContract a
-> ResponseContract b -> ResponseContract (ResponseChoice a b)
chooseContract
(Status
-> Text -> ResponseContract (ResponseValue (Maybe LByteString))
refusalContract Status
status406 Text
"The request admits no representation this index serves: only the PEP 691 JSON form exists, in gzip or identity coding.")
( ResponseContract (ResponseValue (Maybe LByteString))
-> ResponseContract
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseValue (Maybe LByteString)))
-> ResponseContract
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseValue (Maybe LByteString))))
forall a b.
ResponseContract a
-> ResponseContract b -> ResponseContract (ResponseChoice a b)
chooseContract
(Status
-> Text -> ResponseContract (ResponseValue (Maybe LByteString))
refusalContract Status
status500 Text
"A permanent or internal inability to decide.")
( ResponseContract (ResponseValue (Maybe LByteString))
-> ResponseContract (ResponseValue (Maybe LByteString))
-> ResponseContract
(ResponseChoice
(ResponseValue (Maybe LByteString))
(ResponseValue (Maybe LByteString)))
forall a b.
ResponseContract a
-> ResponseContract b -> ResponseContract (ResponseChoice a b)
chooseContract
(Status
-> Text -> ResponseContract (ResponseValue (Maybe LByteString))
refusalContract Status
status502 Text
"An upstream reply was invalid or unusable, such as an index for a different project or one whose every file entry is malformed.")
(Status
-> Text -> ResponseContract (ResponseValue (Maybe LByteString))
refusalContract Status
status503 Text
"A transient upstream or advisory condition; retry (see `Retry-After`).")
)
)
)
)
)
)
)
refusalContract :: Status -> Text -> ResponseContract (ResponseValue (Maybe LByteString))
refusalContract :: Status
-> Text -> ResponseContract (ResponseValue (Maybe LByteString))
refusalContract Status
status Text
description =
Status
-> Text
-> BodySchema
-> ResponseContract (ResponseValue (Maybe LByteString))
optionalBodyContract Status
status (Text
description Text -> Text -> Text
forall a. Semigroup a => a -> a -> a
<> Text
" The body is empty unless `server.helpMessage` is configured.") (ByteString -> BodySchema
SchemaText ByteString
"text/plain")
pypiIndexReplies :: PackumentReplies PyPIIndexResponse
pypiIndexReplies :: PackumentReplies PyPIIndexResponse
pypiIndexReplies = ([ServeDecision] -> Text)
-> (Refusal -> Maybe LByteString)
-> PackumentReplies PyPIIndexResponse
forall refusal.
([ServeDecision] -> Text)
-> (Refusal -> refusal)
-> PackumentReplies (MetadataResponse refusal)
metadataReplies [ServeDecision] -> Text
detailedRejections Refusal -> Maybe LByteString
refusalHelpBytes
notAcceptable :: ResponseHeaders -> Maybe HelpMessage -> PyPIIndexResponse
notAcceptable :: ResponseHeaders -> Maybe HelpMessage -> PyPIIndexResponse
notAcceptable ResponseHeaders
headers Maybe HelpMessage
help =
PackumentReplies PyPIIndexResponse
-> ResponseHeaders -> Refusal -> PyPIIndexResponse
forall response.
PackumentReplies response -> ResponseHeaders -> Refusal -> response
packumentNotAcceptable PackumentReplies PyPIIndexResponse
pypiIndexReplies ResponseHeaders
headers (Maybe HelpMessage -> Text -> Refusal
mkRefusal Maybe HelpMessage
help Text
"no representation this index serves is acceptable")
pypiArtifactContract :: ResponseContract PassthroughResponse
pypiArtifactContract :: ResponseContract PassthroughResponse
pypiArtifactContract =
Text -> ResponseContract PassthroughResponse
passthroughContract
Text
"An upstream-controlled distribution response is relayed transparently. Local authentication, policy, availability, and internal failures answer a bare status under their own code. A private upstream reply that was invalid or unusable answers a local `502`."
pypiArtifactReplies :: TarballReplies PassthroughResponse
pypiArtifactReplies :: TarballReplies PassthroughResponse
pypiArtifactReplies =
TarballReplies
{ tarballError :: Status -> ResponseHeaders -> Refusal -> PassthroughResponse
tarballError = \Status
status ResponseHeaders
headers Refusal
refusal -> Status -> ResponseHeaders -> PassthroughBody -> PassthroughResponse
passthroughResponse Status
status ResponseHeaders
headers (Refusal -> PassthroughBody
artifactRefusalBody Refusal
refusal)
, tarballPrivateRefused :: Int -> ResponseHeaders -> Refusal -> PassthroughResponse
tarballPrivateRefused = \Int
_ -> TarballReplies PassthroughResponse
-> Status -> ResponseHeaders -> Refusal -> PassthroughResponse
forall response.
TarballReplies response
-> Status -> ResponseHeaders -> Refusal -> response
tarballError TarballReplies PassthroughResponse
pypiArtifactReplies Status
status403
, tarballStream :: Status -> ResponseHeaders -> StreamingBody -> PassthroughResponse
tarballStream = \Status
status ResponseHeaders
headers StreamingBody
body -> Status -> ResponseHeaders -> PassthroughBody -> PassthroughResponse
passthroughResponse Status
status ResponseHeaders
headers (StreamingBody -> PassthroughBody
PassthroughStream StreamingBody
body)
, tarballEmpty :: Status -> ResponseHeaders -> PassthroughResponse
tarballEmpty = \Status
status ResponseHeaders
headers -> Status -> ResponseHeaders -> PassthroughBody -> PassthroughResponse
passthroughResponse Status
status ResponseHeaders
headers PassthroughBody
PassthroughEmpty
}
pypiUploadContract :: ResponseContract PassthroughResponse
pypiUploadContract :: ResponseContract PassthroughResponse
pypiUploadContract = Text -> ResponseContract PassthroughResponse
passthroughContract Text
"The publication target's status and raw bytes, or a local publication refusal, including the `501` for an action other than `file_upload`."
pypiPublishReplies :: PublishReplies PassthroughResponse
pypiPublishReplies :: PublishReplies PassthroughResponse
pypiPublishReplies =
PublishReplies
{ publishAllowedMethods :: ByteString
publishAllowedMethods = ByteString
"POST"
, publishDisabledReply :: ResponseHeaders -> Maybe HelpMessage -> PassthroughResponse
publishDisabledReply = \ResponseHeaders
headers Maybe HelpMessage
help -> Status -> ResponseHeaders -> PassthroughBody -> PassthroughResponse
passthroughResponse Status
status405 ((HeaderName
"Content-Type", ByteString
"text/plain") Header -> ResponseHeaders -> ResponseHeaders
forall a. a -> [a] -> [a]
: ResponseHeaders
headers) (Refusal -> PassthroughBody
artifactRefusalBody (Maybe HelpMessage -> Text -> Refusal
mkRefusal Maybe HelpMessage
help Text
"publishing is not enabled on this mount"))
, publishRelayed :: Status -> ResponseHeaders -> LByteString -> PassthroughResponse
publishRelayed = \Status
status ResponseHeaders
headers LByteString
body -> Status -> ResponseHeaders -> PassthroughBody -> PassthroughResponse
passthroughResponse Status
status ((HeaderName
"Content-Type", ByteString
"text/plain") Header -> ResponseHeaders -> ResponseHeaders
forall a. a -> [a] -> [a]
: ResponseHeaders
headers) (LByteString -> PassthroughBody
PassthroughBytes LByteString
body)
, publishError :: Status -> ResponseHeaders -> Text -> PassthroughResponse
publishError = \Status
status ResponseHeaders
headers Text
message -> Status -> ResponseHeaders -> PassthroughBody -> PassthroughResponse
passthroughResponse Status
status ((HeaderName
"Content-Type", ByteString
"text/plain") Header -> ResponseHeaders -> ResponseHeaders
forall a. a -> [a] -> [a]
: ResponseHeaders
headers) (LByteString -> PassthroughBody
PassthroughBytes (ByteString -> LByteString
forall l s. LazyStrict l s => s -> l
fromStrict (Text -> ByteString
forall a b. ConvertUtf8 a b => a -> b
encodeUtf8 Text
message)))
}
buildUpload :: Method -> [PyPICap] -> Maybe (ResponseAction PassthroughResponse)
buildUpload :: ByteString
-> [PyPICap] -> Maybe (ResponseAction PassthroughResponse)
buildUpload ByteString
_ = \case
[] -> ResponseAction PassthroughResponse
-> Maybe (ResponseAction PassthroughResponse)
forall a. a -> Maybe a
Just (PassthroughResponse
-> (Request
-> (PassthroughResponse -> IO ResponseReceived)
-> Handler ResponseReceived)
-> ResponseAction PassthroughResponse
forall response.
response
-> (Request
-> (response -> IO ResponseReceived) -> Handler ResponseReceived)
-> ResponseAction response
RunPipeline (PublishReplies PassthroughResponse
-> Status -> ResponseHeaders -> Text -> PassthroughResponse
forall response.
PublishReplies response
-> Status -> ResponseHeaders -> Text -> response
publishError PublishReplies PassthroughResponse
pypiPublishReplies Status
status500 [] Text
"internal server error") (PublishReplies PassthroughResponse
-> Maybe PackageName
-> Request
-> (PassthroughResponse -> IO ResponseReceived)
-> Handler ResponseReceived
forall response.
PublishReplies response
-> Maybe PackageName
-> Request
-> (response -> IO ResponseReceived)
-> Handler ResponseReceived
servePublish PublishReplies PassthroughResponse
pypiPublishReplies Maybe PackageName
forall a. Maybe a
Nothing))
[PyPICap]
_ -> Maybe (ResponseAction PassthroughResponse)
forall a. Maybe a
Nothing
unsupportedContract :: ResponseContract (ResponseValue (Maybe LByteString))
unsupportedContract :: ResponseContract (ResponseValue (Maybe LByteString))
unsupportedContract = Status
-> Text -> ResponseContract (ResponseValue (Maybe LByteString))
refusalContract Status
status404 Text
"Unrecognised path; deny by default."
helpBody :: ResponseHeaders -> Refusal -> ResponseValue (Maybe LByteString)
helpBody :: ResponseHeaders -> Refusal -> ResponseValue (Maybe LByteString)
helpBody ResponseHeaders
headers Refusal
refusal = ResponseHeaders
-> Maybe LByteString -> ResponseValue (Maybe LByteString)
forall a. ResponseHeaders -> a -> ResponseValue a
responseValue ResponseHeaders
headers (Refusal -> Maybe LByteString
refusalHelpBytes Refusal
refusal)
declaredRefusal :: Text -> ResponseHeaders -> Maybe HelpMessage -> ResponseValue (Maybe LByteString)
declaredRefusal :: Text
-> ResponseHeaders
-> Maybe HelpMessage
-> ResponseValue (Maybe LByteString)
declaredRefusal Text
reason ResponseHeaders
headers Maybe HelpMessage
help = ResponseHeaders -> Refusal -> ResponseValue (Maybe LByteString)
helpBody ResponseHeaders
headers (Maybe HelpMessage -> Text -> Refusal
mkRefusal Maybe HelpMessage
help Text
reason)
artifactRefusalBody :: Refusal -> PassthroughBody
artifactRefusalBody :: Refusal -> PassthroughBody
artifactRefusalBody Refusal
refusal = PassthroughBody
-> (LByteString -> PassthroughBody)
-> Maybe LByteString
-> PassthroughBody
forall b a. b -> (a -> b) -> Maybe a -> b
maybe PassthroughBody
PassthroughEmpty LByteString -> PassthroughBody
PassthroughBytes (Refusal -> Maybe LByteString
refusalHelpBytes Refusal
refusal)
buildIndex :: Method -> [PyPICap] -> Maybe (ResponseAction PyPIIndexResponse)
buildIndex :: ByteString -> [PyPICap] -> Maybe (ResponseAction PyPIIndexResponse)
buildIndex ByteString
method = \case
[PyPIProject PackageName
name] -> ResponseAction PyPIIndexResponse
-> Maybe (ResponseAction PyPIIndexResponse)
forall a. a -> Maybe a
Just (PackumentReplies PyPIIndexResponse
-> ByteString -> PackageName -> ResponseAction PyPIIndexResponse
forall response.
PackumentReplies response
-> ByteString -> PackageName -> ResponseAction response
packumentAction PackumentReplies PyPIIndexResponse
pypiIndexReplies ByteString
method PackageName
name)
[PyPICap]
_ -> Maybe (ResponseAction PyPIIndexResponse)
forall a. Maybe a
Nothing
buildArtifact :: Method -> [PyPICap] -> Maybe (ResponseAction PassthroughResponse)
buildArtifact :: ByteString
-> [PyPICap] -> Maybe (ResponseAction PassthroughResponse)
buildArtifact ByteString
method = \case
[PyPIProject PackageName
name, PyPIFile Text
file] -> do
(version, filename) <- PackageName -> Text -> Maybe (Version, Filename)
artifactCoordinate PackageName
name Text
file
pure (tarballAction pypiArtifactReplies method name version filename)
[PyPICap]
_ -> Maybe (ResponseAction PassthroughResponse)
forall a. Maybe a
Nothing
buildSidecar :: Method -> [PyPICap] -> Maybe (ResponseAction PassthroughResponse)
buildSidecar :: ByteString
-> [PyPICap] -> Maybe (ResponseAction PassthroughResponse)
buildSidecar ByteString
method = \case
[PyPIProject PackageName
name, PyPIFile Text
file] -> do
(version, filename) <- PackageName -> Text -> Maybe (Version, Filename)
artifactCoordinate PackageName
name Text
file
pure (sidecarAction pypiArtifactReplies method name version filename)
[PyPICap]
_ -> Maybe (ResponseAction PassthroughResponse)
forall a. Maybe a
Nothing
data PyPICap
= PyPIProject PackageName
| PyPIFile Text
renderCapture :: PyPICap -> [Text]
renderCapture :: PyPICap -> [Text]
renderCapture = \case
PyPIProject PackageName
name -> [PackageName -> Text
canonicalName PackageName
name]
PyPIFile Text
file -> [Text
file]
capProject :: Capture PyPICap
capProject :: Capture PyPICap
capProject =
Text
-> Text
-> ([Text] -> Maybe (PyPICap, [Text]))
-> (PyPICap -> [Text])
-> Capture PyPICap
forall v.
Text
-> Text
-> ([Text] -> Maybe (v, [Text]))
-> (v -> [Text])
-> Capture v
Capture
Text
"project"
Text
"The project name in PEP 503 canonical form, e.g. `zope-interface`."
(((PackageName, [Text]) -> (PyPICap, [Text]))
-> Maybe (PackageName, [Text]) -> Maybe (PyPICap, [Text])
forall a b. (a -> b) -> Maybe a -> Maybe b
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
fmap ((PackageName -> PyPICap)
-> (PackageName, [Text]) -> (PyPICap, [Text])
forall a b c. (a -> b) -> (a, c) -> (b, c)
forall (p :: * -> * -> *) a b c.
Bifunctor p =>
(a -> b) -> p a c -> p b c
first PackageName -> PyPICap
PyPIProject) (Maybe (PackageName, [Text]) -> Maybe (PyPICap, [Text]))
-> ([Text] -> Maybe (PackageName, [Text]))
-> [Text]
-> Maybe (PyPICap, [Text])
forall b c a. (b -> c) -> (a -> b) -> a -> c
. [Text] -> Maybe (PackageName, [Text])
takeProject)
PyPICap -> [Text]
renderCapture
capFile :: Capture PyPICap
capFile :: Capture PyPICap
capFile =
Text
-> Text
-> ([Text] -> Maybe (PyPICap, [Text]))
-> (PyPICap -> [Text])
-> Capture PyPICap
forall v.
Text
-> Text
-> ([Text] -> Maybe (v, [Text]))
-> (v -> [Text])
-> Capture v
Capture
Text
"file"
Text
"The distribution file's on-the-wire name, e.g. `requests-2.34.2-py3-none-any.whl`."
((Text -> PyPICap) -> [Text] -> Maybe (PyPICap, [Text])
forall v. (Text -> v) -> [Text] -> Maybe (v, [Text])
safeSegment Text -> PyPICap
PyPIFile)
PyPICap -> [Text]
renderCapture
takeProject :: [Text] -> Maybe (PackageName, [Text])
takeProject :: [Text] -> Maybe (PackageName, [Text])
takeProject = \case
Text
seg : [Text]
rest | Text -> Bool
isCanonicalName Text
seg -> (,[Text]
rest) (PackageName -> (PackageName, [Text]))
-> Maybe PackageName -> Maybe (PackageName, [Text])
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
<$> Either ParseError PackageName -> Maybe PackageName
forall l r. Either l r -> Maybe r
rightToMaybe (Text -> Either ParseError PackageName
projectName Text
seg)
[Text]
_ -> Maybe (PackageName, [Text])
forall a. Maybe a
Nothing
artifactCoordinate :: PackageName -> Text -> Maybe (Version, Filename)
artifactCoordinate :: PackageName -> Text -> Maybe (Version, Filename)
artifactCoordinate PackageName
name Text
file = do
coordinate <- PackageName -> Text -> Maybe FileCoordinate
fileCoordinate PackageName
name Text
file
(fcVersion coordinate,) <$> mkFilename file
distributionPath :: PackageName -> Text -> Maybe Text
distributionPath :: PackageName -> Text -> Maybe Text
distributionPath PackageName
name Text
file = Text -> [Text] -> Text
T.intercalate Text
"/" ([Text] -> Text) -> Maybe [Text] -> Maybe Text
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
<$> Route PyPICap -> [PyPICap] -> Maybe [Text]
forall v. Route v -> [v] -> Maybe [Text]
renderRoute Route PyPICap
artifactRoute [PackageName -> PyPICap
PyPIProject PackageName
name, Text -> PyPICap
PyPIFile Text
file]
pypiRouteSpecs :: NonEmpty RouteSpec
pypiRouteSpecs :: NonEmpty RouteSpec
pypiRouteSpecs =
ResponseContract (ResponseValue (Maybe LByteString))
-> ParamSpec -> NonEmpty RouteSpec
forall r. ResponseContract r -> ParamSpec -> NonEmpty RouteSpec
catchAllSpecs ResponseContract (ResponseValue (Maybe LByteString))
unsupportedContract ParamSpec
unsupportedPathParam
NonEmpty RouteSpec -> [RouteSpec] -> NonEmpty RouteSpec
forall a. NonEmpty a -> [a] -> NonEmpty a
`NE.appendList` (Route PyPICap -> [RouteSpec]) -> [Route PyPICap] -> [RouteSpec]
forall (t :: * -> *) a b. Foldable t => (a -> [b]) -> t a -> [b]
concatMap Route PyPICap -> [RouteSpec]
forall v. Route v -> [RouteSpec]
specsOf [Route PyPICap]
pypiRoutes