Skip to content

Latest commit

 

History

History
133 lines (103 loc) · 6.07 KB

CHANGELOG.md

File metadata and controls

133 lines (103 loc) · 6.07 KB
Raw

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased - ReleaseDate

0.4.3 - 2024-01-18

Added

  • Add VisType::FlameGraph variant to indicate that a frame should be visualised using the flame graph panel introduced here.
  • Add overrideable DataQueryError::status method which must return a DataQueryStatus. This can be used by datasource implementations to provide more detail about how an error should be handled.
  • Add arrow-array support for Field (#111 by @kerryeon)

Changed

  • Change the plugin_context field of various structs to be non-optional, matching the Go SDK.
  • Plugins will only spawn shutdown handlers when compiled in debug mode. When compiled in release mode the shutdown handler attribute will do nothing.
  • Bump arrow2 dependency to 0.18.0
  • Bump http dependency to 1.0
  • Bump syn dependency to 2.0
  • Bump prost dependency to 0.12.3
  • Bump tonic dependency to 0.10.2

0.4.2 - 2022-09-19

0.4.1 - 2022-09-19

[0.4.0] - 2022-09-19

Changed

  • The DataService trait has a new associated type, Query, which corresponds to the type of the query sent from the frontend component of the plugin (the TQuery type parameter of the frontend DatasourceApi implementation). The backend SDK will attempt to deserialize the JSON into this struct, and it will be accessible on the query property of each query in QueryDataRequest.queries. Note that QueryDataRequest is also now generic over this type. Within the DataService trait, it is simplest to use Self::Query to refer to the new type. To retain the old behaviour, set Query = serde_json::Value in DataService.
  • Add headers field containing the allow-listed fields sent along with the request to CheckHealthRequest (see the Go SDK PR for more details)
  • Add type_ field containing the plugin type to DataSourceInstanceSettings. This is equal to the plugin_id field on PluginContext. See the Go SDK PR for justification.
  • Add impl of backend::IntoHttpResponse for http::Response<Vec<u8>>.
  • Remove unused lifetime on IntoOptField blanket impl.
  • Derive Eq (as well as just PartialEq) for various structs across the crate.
  • Bump arrow2 dependency to 0.14.0
  • Bump prost to 0.11.0 and remove prost-build dependency, preferring checked-in generated code. This should speed up build times and remove the dependency on protoc since we no longer need to compile proto definitions.
  • Bump tonic to 0.8.0 and remove tonic-build dependency.
  • Bump serde_with dependency to 2.0.0
  • Use cargo-release to automate release process

0.3.0 - 2022-04-14

Added

  • Added various new constructors for SubscribeStreamResponse, PublishStreamResponse and CheckHealthResponse, reducing the reliance of knowing what the arguments should be.

Deprecated

  • The CheckHealthResponse::new, SubscribeStreamResponse::new and PublishStreamResponse::new methods have been deprecated in favour of their new, more direct constructors.

Changed

  • Dependency bumps:
    • prost 0.9.0 -> 0.10.0
    • tonic 0.6.0 -> 0.7.0
    • tonic-health 0.5.0 -> 0.6.0
  • InitialData::from_json now only takes the desired JSON Value by reference rather than by value.

0.2.0 - 2022-03-15

Added

  • Bump arrow2 dependency to 0.10.0, and re-export it as grafana_plugin_sdk::arrow2
  • Added new data field to SubscribeStreamRequest and SubscribeStreamResponse, matching the latest release of the protobuf descriptors.
  • More types now impl FieldType and IntoFieldType:
    • bool
    • SystemTime
    • chrono::Date
    • chrono::NaiveDate
    • chrono::NaiveDateTime
  • The FieldType and IntoFieldType traits are now public. These are useful when writing generic functions to convert iterators, vecs, slices or arrays into Fields.

Changed

  • Mark the various Request and Response structs in the backend part of the SDK as #[non_exhaustive] since changes to those structs are largely outside of our control; the protobuf descriptors may add additional fields, and this allows us to include them without breaking our API. Some Response types now have new constructors which should be used.
  • Most of the exported types in the data part of the SDK are also now non-exhaustive, for the same reason as above. These types now either have separate constructors or Default impls which can be used to create them.
  • Derive Clone for various backend structs:
    • AppInstanceSettings
    • DataSourceInstanceSettings
    • PluginContext
    • Role (is also now Copy)
    • TimeRange
    • User
  • Change the Iter associated type of backend::DataService to Stream, and update the return type of query_data accordingly. This allows each inner query to be handled asynchronously and concurrently in a simple way.
  • The live::Error type is now an enum and provides more detail on failures.
  • The path field of SubscribeStreamRequest, RunStreamRequest and PublishStreamRequest are now live::Path types rather than arbitrary strings.

0.1.0 - 2021-12-08

Added

  • Initial release of the SDK