A Renderer is a class for converting ExpectationsA verifiable assertion about data., Validation ResultsGenerated when data is Validated against an Expectation or Expectation Suite., etc. into Data DocsHuman readable documentation generated from Great Expectations metadata detailing Expectations, Validation Results, etc. or other output such as email notifications or Slack messages.
Every Expectation has its own Renderer(s) that allows that Expectation to be expressed in a human-readable format in Data Docs. From an architectural/contributor standpoint, Expectations are rendered into an intermediate canonical format and then from there turned into docs and other output (think of it more of a rendering pipeline). Likewise, Renderers can be used to send Slack messages and email alerts. Renderers for these purposes are already available in Great Expectations, but you can create custom ones and use them by specifying them in the ActionA Python class with a run method that takes a Validation Result and does something with it that sends the message after ValidationThe act of applying an Expectation Suite to a Batch..
Relationship to other objects
The most common use of Renderers is to render Expectations and Validation Results into output for Data Docs. Renderers can also be used to send Slack messages and email alerts. Great Expectations makes these Renderers available by default. If you create a Custom ExpectationAn extension of the `Expectation` class, developed outside of the Great Expectations library., you may also want to create a custom Renderer for it.
Creating Custom Expectations, including their custom Renderers, is a process that falls outside the Great Expectations Validation workflow.
Great Expectations will use a Renderer behind the scenes if you build Data Docs to view your Expectations.
If you want to send Slack, email, or other alerts after a Checkpoint runs you will do so by specifying a Renderer in an Action in the Checkpoint's
action_list. Renderers will also be used behind the scenes if you update your Data Docs through a Checkpoint Action, or if you rebuild your Data Docs outside the Validation process.
When looking for Renderers with Expectations, you will find them specified as part of the Python class defining the Expectation. With alerts and messaging, however, you will specify the Renderer to use in an Action's configuration. To do this, you will specify a
class_name indicating the Renderer's Python class under the
renderer key (found nested under the
action key) in an Action entry in a Checkpoint's
If you need instructions on how to configure the renderer portion of an Action to send a message or alert, please see the relevant guide: