Class: ElasticGraph::SchemaDefinition::RakeTasks

Inherits:
Rake::TaskLib
  • Object
show all
Defined in:
lib/elastic_graph/schema_definition/rake_tasks.rb

Overview

Note:

Local::RakeTasks wraps this and provides additional functionality. Most users will not need to interact with this class directly.

Defines rake tasks for managing artifacts generated from a schema definition.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(index_document_sizes:, path_to_schema:, schema_artifacts_directory:, schema_element_name_form:, schema_element_name_overrides: {}, derived_type_name_formats: {}, type_name_overrides: {}, enum_value_overrides_by_type: {}, extension_modules: [], enforce_json_schema_version: true, output: $stdout) ⇒ RakeTasks

Returns a new instance of RakeTasks.

Examples:

Minimal setup with defaults

ElasticGraph::SchemaDefinition::RakeTasks.new(
  index_document_sizes: false,
  path_to_schema: "config/schema.rb",
  schema_artifacts_directory: "config/schema/artifacts",
  schema_element_name_form: :camelCase
)

Spell out the full names of the ‘gt`/`gte`/`lt`/`lte` filter operators

ElasticGraph::SchemaDefinition::RakeTasks.new(
  index_document_sizes: false,
  path_to_schema: "config/schema.rb",
  schema_artifacts_directory: "config/schema/artifacts",
  schema_element_name_form: :camelCase,
  schema_element_name_overrides: {
    gt: "greaterThan",
    gte: "greaterThanOrEqualTo",
    lt: "lessThan",
    lte: "lessThanOrEqualTo"
  }
)

Change the ‘AggregatedValues` type suffix to `Metrics`

ElasticGraph::SchemaDefinition::RakeTasks.new(
  index_document_sizes: false,
  path_to_schema: "config/schema.rb",
  schema_artifacts_directory: "config/schema/artifacts",
  schema_element_name_form: :camelCase,
  derived_type_name_formats: {AggregatedValues: "Metrics"}
)

Rename ‘JsonSafeLong` to `BigInt`

ElasticGraph::SchemaDefinition::RakeTasks.new(
  index_document_sizes: false,
  path_to_schema: "config/schema.rb",
  schema_artifacts_directory: "config/schema/artifacts",
  schema_element_name_form: :camelCase,
  type_name_overrides: {JsonSafeLong: "BigInt"}
)

Shorten the names of the ‘DayOfWeek` enum values

ElasticGraph::SchemaDefinition::RakeTasks.new(
  index_document_sizes: false,
  path_to_schema: "config/schema.rb",
  schema_artifacts_directory: "config/schema/artifacts",
  schema_element_name_form: :camelCase,
  enum_value_overrides_by_type: {
    DayOfWeek: {
      MONDAY: "MON",
      TUESDAY: "TUE",
      WEDNESDAY: "WED",
      THURSDAY: "THU",
      FRIDAY: "FRI",
      SATURDAY: "SAT",
      SUNDAY: "SUN"
    }
  }
)

Parameters:

  • index_document_sizes (Boolean) —

    When enabled, ElasticGraph will configure the index mappings so that the datastore indexes a ‘_size` field in each document. ElasticGraph itself does not do anything with this field, but it will be available for your use in any direct queries (e.g. via Kibana). Important note: this requires the [mapper-size plugin](www.elastic.co/guide/en/elasticsearch/plugins/8.15/mapper-size.html) to be installed on your datastore cluster. You are responsible for ensuring that is installed if you enable this feature. If you enable this and the plugin is not installed, you will get errors!

  • path_to_schema (String, Pathname) —

    path to the main (or only) schema definition file

  • schema_artifacts_directory (String, Pathname) —

    Directory to dump the schema artifacts in

  • schema_element_name_form (:camelCase, :snake_case) —

    the form of names for schema elements (fields, arguments, directives) generated by ElasticGraph.

  • schema_element_name_overrides (Hash<Symbol, String>) (defaults to: {}) —

    overrides for specific names of schema elements (fields, arguments, directives) generated by ElasticGraph. For example, to rename the ‘gt` filter field to `greaterThan`, pass `“greaterThan”`.

  • derived_type_name_formats (Hash<Symbol, String>) (defaults to: {}) —

    overrides for the naming formats used by ElasticGraph for derived GraphQL type names. For example, to use ‘Metrics` instead of `AggregatedValues` as the suffix for the generated types supporting getting aggregated metrid values, pass `“%{baseMetrics”}`. See SchemaElements::TypeNamer::DEFAULT_FORMATS for the available formats.

  • type_name_overrides (Hash<Symbol, String>) (defaults to: {}) —

    overrides for the names of specific GraphQL types. For example, to rename the ‘DateTime` scalar to `Timestamp`, pass `“Timestamp`.

  • enum_value_overrides_by_type (Hash<Symbol, Hash<Symbol, String>>) (defaults to: {}) —

    overrides for the names of specific enum values for specific enum types. For example, to rename the ‘DayOfWeek.MONDAY` enum to `DayOfWeek.MON`, pass `{MONDAY: “MON”}`.

  • extension_modules (Array<Module>) (defaults to: []) —

    List of Ruby modules to extend onto the ‘SchemaDefinition::API` instance. Designed to support ElasticGraph extension gems (such as `elasticgraph-apollo`).

  • enforce_json_schema_version (Boolean) (defaults to: true) —

    Whether or not to enforce the requirement that the JSON schema version is incremented every time dumping the JSON schemas results in a changed artifact. Generally speaking, you will want this to be ‘true` for any ElasticGraph application that is in production as the versioning of JSON schemas is what supports safe schema evolution as it allows ElasticGraph to identify which version of the JSON schema the publishing system was operating on when it published an event. It can be useful to set it to `false` before your application is in production, as you do not want to be forced to bump the version after every single schema change while you are building an initial prototype.

  • output (IO) (defaults to: $stdout) —

    used for printing task output



110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
 
# File 'lib/elastic_graph/schema_definition/rake_tasks.rb', line 110

def initialize(
  index_document_sizes:,
  path_to_schema:,
  schema_artifacts_directory:,
  schema_element_name_form:,
  schema_element_name_overrides: {},
  derived_type_name_formats: {},
  type_name_overrides: {},
  enum_value_overrides_by_type: {},
  extension_modules: [],
  enforce_json_schema_version: true,
  output: $stdout
)
  @schema_element_names = SchemaArtifacts::RuntimeMetadata::SchemaElementNames.new(
    form: schema_element_name_form,
    overrides: schema_element_name_overrides
  )

  @derived_type_name_formats = derived_type_name_formats
  @type_name_overrides = type_name_overrides
  @enum_value_overrides_by_type = enum_value_overrides_by_type
  @index_document_sizes = index_document_sizes
  @path_to_schema = path_to_schema
  @schema_artifacts_directory = schema_artifacts_directory
  @enforce_json_schema_version = enforce_json_schema_version
  @extension_modules = extension_modules
  @output = output

  define_tasks
end

Instance Attribute Details

#output ⇒ Object (readonly) 



20
21
22
 
# File 'lib/elastic_graph/schema_definition/rake_tasks.rb', line 20

def output
  @output
end