Struct pgrx_sql_entity_graph::ToSqlConfigEntity

pub struct ToSqlConfigEntity {
    pub enabled: bool,
    pub callback: Option<fn(_: &SqlGraphEntity, _: &PgrxSql) -> Result<String, Box<dyn Error + Send + Sync + 'static>>>,
    pub content: Option<&'static str>,
}

Represents configuration options for tuning the SQL generator.

When an item that can be rendered to SQL has these options at hand, they should be respected. If an item does not have them, then it is not expected that the SQL generation for those items can be modified.

The default configuration has enabled set to true, and callback to None, which indicates that the default SQL generation behavior will be used. These are intended to be mutually exclusive options, so callback should only be set if generation is enabled.

When enabled is false, no SQL is generated for the item being configured.

When callback has a value, the corresponding ToSql implementation should invoke the callback instead of performing their default behavior.

Fields

enabled: bool

callback: Option<fn(_: &SqlGraphEntity, _: &PgrxSql) -> Result<String, Box<dyn Error + Send + Sync + 'static>>>

content: Option<&'static str>

Implementations

impl ToSqlConfigEntity

pub fn to_sql( &self, entity: &SqlGraphEntity, context: &PgrxSql ) -> Option<Result<String>>

Given a SqlGraphEntity, this function converts it to SQL based on the current configuration.

If the config overrides the default behavior (i.e. using the ToSql trait), then Some(eyre::Result) is returned. If the config does not override the default behavior, then None is returned. This can be used to dispatch SQL generation in a single line, e.g.:

config.to_sql(entity, context).unwrap_or_else(|| entity.to_sql(context))?

Trait Implementations

impl Clone for ToSqlConfigEntity

fn clone(&self) -> ToSqlConfigEntity

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ToSqlConfigEntity

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ToSqlConfigEntity

fn default() -> ToSqlConfigEntity

Returns the “default value” for a type.

impl Hash for ToSqlConfigEntity

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for ToSqlConfigEntity

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq for ToSqlConfigEntity

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for ToSqlConfigEntity

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for ToSqlConfigEntity