config

package module
v1.6.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jan 12, 2024 License: MIT Imports: 14 Imported by: 3

README

sdk-gen-config

Documentation

Index

Constants

View Source 
const (
	Version = v2

	GithubWritePermission = "write"

	// Constants to be used as keys in the config files
	Languages            = "languages"
	Mode                 = "mode"
	GithubAccessToken    = "github_access_token"
	SpeakeasyApiKey      = "speakeasy_api_key"
	SpeakeasyServerURL   = "speakeasy_server_url"
	OpenAPIDocAuthHeader = "openapi_doc_auth_header"
	OpenAPIDocAuthToken  = "openapi_doc_auth_token"
	OpenAPIDocs          = "openapi_docs"
)

Variables

View Source 
var ErrFailedUpgrade = errors.New("failed to upgrade config")
View Source 
var ErrNotFound = errors.New("could not find gen.yaml")

Functions

func GetConfigChecksum added in v1.5.0 

func GetConfigChecksum(dir string, opts ...Option) (string, error)

func GetTemplateVersion added in v1.6.1 

func GetTemplateVersion(dir, target string, opts ...Option) (string, error)

func SaveConfig added in v1.5.0 

func SaveConfig(dir string, cfg *Configuration, opts ...Option) error

func SaveLockFile added in v1.5.0 

func SaveLockFile(dir string, lockFile *LockFile, opts ...Option) error

Types

type Config 

type Config struct {
	Config   *Configuration
	LockFile *LockFile
}

func Load 

func Load(dir string, opts ...Option) (*Config, error)

type Configuration added in v1.5.0 

type Configuration struct {
	ConfigVersion string                    `yaml:"configVersion"`
	Generation    Generation                `yaml:"generation"`
	Languages     map[string]LanguageConfig `yaml:",inline"`
	New           map[string]bool           `yaml:"-"`
}

func GetDefaultConfig 

func GetDefaultConfig(newSDK bool, getLangDefaultFunc GetLanguageDefaultFunc, langs map[string]bool) (*Configuration, error)

func (*Configuration) GetGenerationFieldsMap added in v1.5.0 

func (c *Configuration) GetGenerationFieldsMap() (map[string]any, error)

type DevContainers added in v0.8.2 

type DevContainers struct {
	Enabled bool `yaml:"enabled"`
	// This can be a local path or a remote URL
	SchemaPath           string         `yaml:"schemaPath"`
	AdditionalProperties map[string]any `yaml:",inline"` // Captures any additional properties that are not explicitly defined for backwards/forwards compatibility
}

type Fixes added in v1.4.0 

type Fixes struct {
	NameResolutionDec2023 bool           `yaml:"nameResolutionDec2023"`
	AdditionalProperties  map[string]any `yaml:",inline"` // Captures any additional properties that are not explicitly defined for backwards/forwards compatibility
}

type Force added in v0.4.2 

type Force struct {
	Description string `yaml:"description"`
	Type        string `yaml:"type"`
	Default     bool   `yaml:"default"`
}

type GenerateOn added in v0.4.2 

type GenerateOn struct {
	WorkflowDispatch WorkflowDispatch `yaml:"workflow_dispatch"`
	Schedule         []Schedule       `yaml:"schedule,omitempty"`
}

type GenerateWorkflow added in v0.4.2 

type GenerateWorkflow struct {
	Name        string      `yaml:"name"`
	Permissions Permissions `yaml:"permissions"`
	On          GenerateOn  `yaml:"on"`
	Jobs        Jobs        `yaml:"jobs"`
}

type Generation 

type Generation struct {
	DevContainers               *DevContainers `yaml:"devContainers,omitempty"`
	BaseServerURL               string         `yaml:"baseServerUrl,omitempty"`
	SDKClassName                string         `yaml:"sdkClassName,omitempty"`
	MaintainOpenAPIOrder        bool           `yaml:"maintainOpenAPIOrder,omitempty"`
	UsageSnippets               *UsageSnippets `yaml:"usageSnippets,omitempty"`
	UseClassNamesForArrayFields bool           `yaml:"useClassNamesForArrayFields,omitempty"`
	Fixes                       *Fixes         `yaml:"fixes,omitempty"`

	AdditionalProperties map[string]any `yaml:",inline"` // Captures any additional properties that are not explicitly defined for backwards/forwards compatibility
}

type GetLanguageDefaultFunc 

type GetLanguageDefaultFunc func(string, bool) (*LanguageConfig, error)

type Inputs added in v0.4.2 

type Inputs struct {
	Force Force `yaml:"force"`
}

type Job added in v0.4.2 

type Job struct {
	Uses    string            `yaml:"uses"`
	With    map[string]any    `yaml:"with"`
	Secrets map[string]string `yaml:"secrets"`
}

type Jobs added in v0.4.2 

type Jobs struct {
	Generate Job `yaml:"generate,omitempty"`
	Publish  Job `yaml:"publish,omitempty"`
}

type LanguageConfig 

type LanguageConfig struct {
	Version string         `yaml:"version"`
	Cfg     map[string]any `yaml:",inline"`
}

type LockFile added in v1.5.0 

type LockFile struct {
	LockVersion          string                       `yaml:"lockVersion"`
	ID                   string                       `yaml:"id"`
	Management           Management                   `yaml:"management"`
	Features             map[string]map[string]string `yaml:"features,omitempty"`
	GeneratedFiles       []string                     `yaml:"generatedFiles,omitempty"`
	AdditionalProperties map[string]any               `yaml:",inline"` // Captures any additional properties that are not explicitly defined for backwards/forwards compatibility
}

func NewLockFile added in v1.5.0 

func NewLockFile() *LockFile

type Management 

type Management struct {
	DocChecksum          string         `yaml:"docChecksum,omitempty"`
	DocVersion           string         `yaml:"docVersion,omitempty"`
	SpeakeasyVersion     string         `yaml:"speakeasyVersion,omitempty"`
	GenerationVersion    string         `yaml:"generationVersion,omitempty"`
	ReleaseVersion       string         `yaml:"releaseVersion,omitempty"`
	ConfigChecksum       string         `yaml:"configChecksum,omitempty"`
	RepoURL              string         `yaml:"repoURL,omitempty"`
	RepoSubDirectory     string         `yaml:"repoSubDirectory,omitempty"`
	InstallationURL      string         `yaml:"installationURL,omitempty"`
	Published            bool           `yaml:"published,omitempty"`
	AdditionalProperties map[string]any `yaml:",inline"` // Captures any additional properties that are not explicitly defined for backwards/forwards compatibility
}

type Option 

type Option func(*options)

func WithFileSystemFuncs 

func WithFileSystemFuncs(rf ReadFileFunc, wf WriteFileFunc) Option

func WithLanguageDefaultFunc 

func WithLanguageDefaultFunc(f GetLanguageDefaultFunc) Option

func WithLanguages added in v0.0.4 

func WithLanguages(langs ...string) Option

func WithTransformerFunc added in v0.8.4 

func WithTransformerFunc(f TransformerFunc) Option

func WithUpgradeFunc added in v0.0.2 

func WithUpgradeFunc(f UpgradeFunc) Option

type OptionalPropertyRenderingOption added in v1.2.0 

type OptionalPropertyRenderingOption string
const (
	OptionalPropertyRenderingOptionAlways      OptionalPropertyRenderingOption = "always"
	OptionalPropertyRenderingOptionNever       OptionalPropertyRenderingOption = "never"
	OptionalPropertyRenderingOptionWithExample OptionalPropertyRenderingOption = "withExample"
)

type Permissions added in v0.4.2 

type Permissions struct {
	Checks       string `yaml:"checks"`
	Contents     string `yaml:"contents,omitempty"`
	PullRequests string `yaml:"pull-requests,omitempty"`
	Statuses     string `yaml:"statuses"`
}

type PublishOn added in v0.4.2 

type PublishOn struct {
	Push Push `yaml:"push"`
}

type PublishWorkflow added in v0.4.2 

type PublishWorkflow struct {
	Name string    `yaml:"name"`
	On   PublishOn `yaml:"on"`
	Jobs Jobs      `yaml:"jobs"`
}

type Push added in v0.4.2 

type Push struct {
	Branches []string `yaml:"branches"`
	Paths    []string `yaml:"paths"`
}

type ReadFileFunc 

type ReadFileFunc func(filename string) ([]byte, error)

type SDKGenConfigField added in v1.0.0 

type SDKGenConfigField struct {
	Name                  string  `yaml:"name" json:"name"`
	Required              bool    `yaml:"required" json:"required"`
	RequiredForPublishing *bool   `yaml:"requiredForPublishing,omitempty" json:"required_for_publishing,omitempty"`
	DefaultValue          *any    `yaml:"defaultValue,omitempty" json:"default_value,omitempty"`
	Description           *string `yaml:"description,omitempty" json:"description,omitempty"`
	Language              *string `yaml:"language,omitempty" json:"language,omitempty"`
	SecretName            *string `yaml:"secretName,omitempty" json:"secret_name,omitempty"`
	ValidationRegex       *string `yaml:"validationRegex,omitempty" json:"validation_regex,omitempty"`
	ValidationMessage     *string `yaml:"validationMessage,omitempty" json:"validation_message,omitempty"`
	TestValue             *any    `yaml:"testValue,omitempty" json:"test_value,omitempty"`
}

func GetGenerationDefaults added in v1.0.0 

func GetGenerationDefaults(newSDK bool) []SDKGenConfigField

type Schedule added in v0.4.2 

type Schedule struct {
	Cron string `yaml:"cron"`
}

type TransformerFunc added in v0.8.4 

type TransformerFunc func(*Config) (*Config, error)

type UpgradeFunc 

type UpgradeFunc func(target, template, oldVersion, newVersion string, cfg map[string]any) (map[string]any, error)

type UsageSnippets added in v1.2.0 

type UsageSnippets struct {
	OptionalPropertyRendering OptionalPropertyRenderingOption `yaml:"optionalPropertyRendering"`
	AdditionalProperties      map[string]any                  `yaml:",inline"` // Captures any additional properties that are not explicitly defined for backwards/forwards compatibility
}

type WorkflowDispatch added in v0.4.2 

type WorkflowDispatch struct {
	Inputs Inputs `yaml:"inputs"`
}

type WriteFileFunc 

type WriteFileFunc func(filename string, data []byte, perm os.FileMode) error

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.