experiment: graphql

feature/feature.go

@@ -0,0 +1,16 @@
+// Package feature implements feature flags for all the packages in the clair
+// module.
+//
+// Any features referenced here should be considered experimental: that is,
+// there's no guarantee around APIs, configuration, usability, forward
+// compatibility, backwards compatibility, stability, etc.
+package feature
+
+// Environment variables currently examined for feature flags.
+//
+// These are subject to removal, addition, or reinterpretation at any time.
+const (
+	// GraphQLFlag being set in the environment toggles on registering a
+	// GraphQL endpoint at "/matcher/api/v1/graphql".
+	GraphQLFlag = `CLAIR_FEATURE_GRAPHQL`
+)

feature/graphql.go

@@ -0,0 +1,10 @@
+package feature
+
+import "os"
+
+// GraphQL is true if the relevant feature flag was set in the environment.
+var GraphQL bool
+
+func init() {
+	_, GraphQL = os.LookupEnv(GraphQLFlag)
+}

go.mod

@@ -3,6 +3,7 @@ module github.com/quay/clair/v4
 go 1.15
 
 require (
+	github.com/99designs/gqlgen v0.13.0
 	github.com/docker/docker v1.13.1 // indirect
 	github.com/go-stomp/stomp v2.0.6+incompatible
 	github.com/golang/mock v1.5.0 // indirect
@@ -24,6 +25,7 @@ require (
 	github.com/tomnomnom/linkheader v0.0.0-20180905144013-02ca5825eb80
 	github.com/ugorji/go/codec v1.2.4
 	github.com/urfave/cli/v2 v2.3.0
+	github.com/vektah/gqlparser/v2 v2.1.0
 	go.opentelemetry.io/contrib/instrumentation/net/http/httptrace/otelhttptrace v0.16.0
 	go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.16.0
 	go.opentelemetry.io/otel v0.16.0

graphql/gqlgen.yml

@@ -0,0 +1,60 @@
+# Where are all the schema files located? globs are supported eg  src/**/*.graphqls
+schema:
+  - graph/*.graphqls
+
+# Where should the generated server code go?
+exec:
+  filename: graph/generated/generated.go
+  package: generated
+
+# Uncomment to enable federation
+# federation:
+#   filename: graph/generated/federation.go
+#   package: generated
+
+# Where should any generated models go?
+model:
+  filename: graph/model/models_gen.go
+  package: model
+
+# Where should the resolver implementations go?
+resolver:
+  layout: follow-schema
+  dir: graph
+  package: graph
+
+# Optional: turn on use `gqlgen:"fieldName"` tags in your models
+# struct_tag: json
+
+# Optional: turn on to use []Thing instead of []*Thing
+omit_slice_element_pointers: true
+
+# Optional: set to speed up generation time by not performing a final validation pass.
+# skip_validation: true
+
+# gqlgen will search for any type names in the schema in these go packages
+# if they match it will use them, otherwise it will generate them.
+autobind:
+  - "github.com/quay/clair/v4/graphql/graph/model"
+
+# This section declares type mapping between the GraphQL and go type systems
+#
+# The first line in each type will be used as defaults for resolver arguments and
+# modelgen, the others will be allowed when binding to fields. Configure them to
+# your liking
+models:
+  ID:
+    model:
+      - github.com/99designs/gqlgen/graphql.ID
+      - github.com/99designs/gqlgen/graphql.Int
+      - github.com/99designs/gqlgen/graphql.Int64
+      - github.com/99designs/gqlgen/graphql.Int32
+  Int:
+    model:
+      - github.com/99designs/gqlgen/graphql.Int
+      - github.com/99designs/gqlgen/graphql.Int64
+      - github.com/99designs/gqlgen/graphql.Int32
+  Digest:
+    model: github.com/quay/clair/v4/graphql/graph/model.Digest
+  JSONObject:
+    model: github.com/quay/clair/v4/graphql/graph/model.JSONObject