Struct cedar_policy_core::parser::ASTNode

pub struct ASTNode<N> {
    pub node: N,
    pub info: SourceInfo,
}

Metadata for our syntax trees

Fields

node: N

Main data represented

info: SourceInfo

additional information

Implementations

impl ASTNode<Option<Policies>>

pub fn with_generated_policyids( &self ) -> Option<impl Iterator<Item = (PolicyID, &ASTNode<Option<Policy>>)>>

Iterate over the Policy nodes in this cst::Policies, with corresponding generated PolicyIDs

pub fn to_policyset(&self, errs: &mut ParseErrors) -> Option<PolicySet>

convert cst::Policies to ast::PolicySet

impl ASTNode<Option<Policy>>

pub fn to_policy_or_template( &self, id: PolicyID, errs: &mut ParseErrors ) -> Option<Either<StaticPolicy, Template>>

Convert cst::Policy to an AST InlinePolicy or Template

pub fn to_policy( &self, id: PolicyID, errs: &mut ParseErrors ) -> Option<StaticPolicy>

Convert cst::Policy to an AST InlinePolicy. (Will fail if the CST is for a template)

pub fn to_policy_template( &self, id: PolicyID, errs: &mut ParseErrors ) -> Option<Template>

Convert cst::Policy to ast::Template. Works for inline policies as well, which will become templates with 0 slots

impl ASTNode<Option<Annotation>>

pub fn to_kv_pair(&self, errs: &mut ParseErrors) -> Option<(Id, SmolStr)>

Get the (k, v) pair for the annotation. Critically, this checks validity for the strings and does unescaping

impl ASTNode<Option<Ident>>

pub fn to_valid_ident(&self, errs: &mut ParseErrors) -> Option<Id>

Convert cst::Ident to ast::Id. Fails for reserved or invalid identifiers

impl ASTNode<Option<Expr>>

pub fn to_expr(&self, errs: &mut ParseErrors) -> Option<Expr>

convert cst::Expr to ast::Expr

impl ASTNode<Option<Primary>>

pub fn to_string_literal(&self, errs: &mut ParseErrors) -> Option<SmolStr>

convert cst::Primary representing a string literal to a SmolStr. Fails (and adds to errs) if the Primary wasn’t a string literal.

impl ASTNode<Option<Ref>>

pub fn to_ref(&self, errs: &mut ParseErrors) -> Option<EntityUID>

convert cst::Ref to ast::EntityUID

impl<N> ASTNode<N>

pub fn new(node: N, left: usize, right: usize) -> Self

Create a new Node from main data

pub fn from_source(info: impl Into<SourceInfo>, node: N) -> Self

Create a new Node from main data

pub fn map<M>(self, f: impl FnOnce(N) -> M) -> ASTNode<M>

Transform the inner value while retaining the attached source info.

pub fn as_ref(&self) -> ASTNode<&N>

Converts from &ASTNode<N> to ASTNode<&N>.

pub fn as_mut(&mut self) -> ASTNode<&mut N>

Converts from &mut ASTNode<N> to ASTNode<&mut N>.

pub fn into_inner(self) -> (N, SourceInfo)

Consume the ASTNode, yielding the node and attached source info.

impl<N: Clone> ASTNode<&N>

pub fn cloned(self) -> ASTNode<N>

Converts a ASTNode<&N> to a ASTNode<N> by cloning the inner value.

impl<N: Copy> ASTNode<&N>

pub fn copied(self) -> ASTNode<N>

Converts a ASTNode<&N> to a ASTNode<N> by copying the inner value.

impl<N> ASTNode<Option<N>>

Convenience methods on ASTNode<Option<N>>

pub fn as_inner_pair(&self) -> (&SourceInfo, Option<&N>)

Similar to .as_inner(), but also gives access to the SourceInfo

pub fn as_inner(&self) -> Option<&N>

Get the inner data as &N, if it exists

pub fn collapse(&self) -> Option<ASTNode<&N>>

None if the node is empty, otherwise a node without the Option

pub fn apply<F, R>(&self, f: F) -> Option<R>

where F: FnOnce(&N, &SourceInfo) -> Option<R>,

Apply the function f to the main data and source info. Returns None if no main data or if f returns None.

pub fn into_apply<F, R>(self, f: F) -> Option<R>

where F: FnOnce(N, SourceInfo) -> Option<R>,

Apply the function f to the main data and source info, consuming them. Returns None if no main data or if f returns None.

Trait Implementations

impl<N: Clone> Clone for ASTNode<N>

fn clone(&self) -> ASTNode<N>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<N: Debug> Debug for ASTNode<N>

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

Formats the value using the given formatter.

impl<'de, N> Deserialize<'de> for ASTNode<N>

where N: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<N: Diagnostic> Diagnostic for ASTNode<N>

fn code<'a>(&'a self) -> Option<Box<dyn Display + 'a>>

Unique diagnostic code that can be used to look up more information about this Diagnostic. Ideally also globally unique, and documented in the toplevel crate’s documentation for easy searching. Rust path format (foo::bar::baz) is recommended, but more classic codes like E0123 or enums will work just fine.

fn severity(&self) -> Option<Severity>

Diagnostic severity. This may be used by ReportHandlers to change the display format of this diagnostic.

fn help<'a>(&'a self) -> Option<Box<dyn Display + 'a>>

Additional help text related to this Diagnostic. Do you have any advice for the poor soul who’s just run into this issue?

fn url<'a>(&'a self) -> Option<Box<dyn Display + 'a>>

URL to visit for a more detailed explanation/help about this Diagnostic.

fn source_code(&self) -> Option<&dyn SourceCode>

Source code to apply this Diagnostic’s Diagnostic::labels to.

fn labels(&self) -> Option<Box<dyn Iterator<Item = LabeledSpan> + '_>>

Labels to apply to this Diagnostic’s Diagnostic::source_code

fn related<'a>( &'a self ) -> Option<Box<dyn Iterator<Item = &'a dyn Diagnostic> + 'a>>

Additional related Diagnostics.

fn diagnostic_source(&self) -> Option<&dyn Diagnostic>

The cause of the error.

impl<N: Display> Display for ASTNode<N>

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

Formats the value using the given formatter.

impl<N: Error> Error for ASTNode<N>

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type based access to context intended for error reports.

impl<N: Hash> Hash for ASTNode<N>

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

ignores metadata

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<N: PartialEq> PartialEq for ASTNode<N>

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

ignores metadata

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<N> Serialize for ASTNode<N>

where N: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<N: Eq> Eq for ASTNode<N>