sdboyer

{
  "name": "Dashboard",
  "maturity": "experimental",
  "description": "A Grafana dashboard.",
  "lineage": {
    "schemas": [
      {
        "version": [
          0,
          0

sdboyer

sdboyer

import "github.com/grafana/thema"

thema.#Lineage
name: "trivial-two"
schemas: [{
    version: [0, 0]
    schema: {
        firstfield: string
    }
},

sdboyer

// Copyright 2023 Grafana Labs
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,

sdboyer

// Copyright 2023 Grafana Labs
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,

sdboyer

// Copyright 2023 Grafana Labs
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software

sdboyer

node1: string @cuetsy(kind="type")
node2: string | *int @cuetsy(kind="type")
node3: *"foo" | "bar" | "baz" @cuetsy(kind="enum", memberNames="Foo|Bar|Baz")
node4: node3 | node2
node5: {
	inner: string
	n3: node3
} @cuetsy(kind="interface")

// Each other file in this gist corresponds to taking a field under ref here

sdboyer

# THIS FILE IS GENERATED. EDITING IS FUTILE.
#
# Generated by:
#     kinds/gen.go
# Using jennies:
#     YamlCRDJenny
#
# Run 'make gen-cue' from repository root to regenerate.

kind: CustomResourceDefinition

sdboyer

Personas

• Grafana user - clickin dem boxes in dat browser
• Plugin developer - someone writing a particular Grafana plugin, whether that plugin happens to be in core or external
• Core developer - someone working on any subsystem in Grafana core other than the kind framework itself, frontend or backend
• Kind framework developer - someone working on the kind framework - basically, what’s under pkg/kindsys

Things

• Kind Category Schema - a meta-schema specifying how a particular category of kind and its contained schemas must be declared

sdboyer

type Generator[T any] interface {
	// dear go generics why do you have to suck so much (union not allowed because interfaces contain methods) 
	OneToOne[T] | OneToMany[T] | ManyToOne[T] | ManyToMany[T]
}

// Takes one T and makes one file
//
// replaces KindGenStep
type OneToOne[T any] interface {
	// Name returns the name of the generator. For use in error output.