Enum KclValue

pub enum KclValue {
    Uuid {
        value: Uuid,
        meta: Vec<Metadata>,
    },
    Bool {
        value: bool,
        meta: Vec<Metadata>,
    },
    Number {
        value: f64,
        meta: Vec<Metadata>,
    },
    Int {
        value: i64,
        meta: Vec<Metadata>,
    },
    String {
        value: String,
        meta: Vec<Metadata>,
    },
    Array {
        value: Vec<KclValue>,
        meta: Vec<Metadata>,
    },
    Object {
        value: HashMap<String, KclValue>,
        meta: Vec<Metadata>,
    },
    TagIdentifier(Box<TagIdentifier>),
    TagDeclarator(Box<Node<TagDeclarator>>),
    Plane(Box<Plane>),
    Face(Box<Face>),
    Sketch {
        value: Box<Sketch>,
    },
    Sketches {
        value: Vec<Box<Sketch>>,
    },
    Solid(Box<Solid>),
    Solids {
        value: Vec<Box<Solid>>,
    },
    ImportedGeometry(ImportedGeometry),
    Function {
        func: Option<fn(s: Vec<Arg>, memory: ProgramMemory, expression: Box<Node<FunctionExpression>>, metadata: Vec<Metadata>, exec_state: &ExecState, ctx: ExecutorContext) -> Pin<Box<dyn Future<Output = Result<Option<KclValue>, KclError>> + Send>>>,
        expression: Box<Node<FunctionExpression>>,
        memory: Box<ProgramMemory>,
        meta: Vec<Metadata>,
    },
    KclNone {
        value: KclNone,
        meta: Vec<Metadata>,
    },
}

Any KCL value.

Variants

Uuid

Fields

value: Uuid

meta: Vec<Metadata>

Bool

Fields

value: bool

meta: Vec<Metadata>

Number

Fields

value: f64

meta: Vec<Metadata>

Int

Fields

value: i64

meta: Vec<Metadata>

String

Fields

value: String

meta: Vec<Metadata>

Array

Fields

value: Vec<KclValue>

meta: Vec<Metadata>

Object

Fields

value: HashMap<String, KclValue>

meta: Vec<Metadata>

TagIdentifier(Box<TagIdentifier>)

TagDeclarator(Box<Node<TagDeclarator>>)

Plane(Box<Plane>)

Face(Box<Face>)

Sketch

Fields

value: Box<Sketch>

Sketches

Fields

value: Vec<Box<Sketch>>

Solid(Box<Solid>)

Solids

Fields

value: Vec<Box<Solid>>

ImportedGeometry(ImportedGeometry)

Function

Fields

func: Option<fn(s: Vec<Arg>, memory: ProgramMemory, expression: Box<Node<FunctionExpression>>, metadata: Vec<Metadata>, exec_state: &ExecState, ctx: ExecutorContext) -> Pin<Box<dyn Future<Output = Result<Option<KclValue>, KclError>> + Send>>>

Adam Chalmers speculation: Reference to a KCL stdlib function (written in Rust). Some if the KCL value is an alias of a stdlib function, None if it’s a KCL function written/declared in KCL.

expression: Box<Node<FunctionExpression>>

memory: Box<ProgramMemory>

meta: Vec<Metadata>

KclNone

Fields

value: KclNone

meta: Vec<Metadata>

Implementations

impl KclValue

pub const fn from_number(f: f64, meta: Vec<Metadata>) -> Self

Put the number into a KCL value.

pub fn from_point2d(p: [f64; 2], meta: Vec<Metadata>) -> Self

Put the point into a KCL value.

pub fn as_int(&self) -> Option<i64>

pub fn as_object(&self) -> Option<&HashMap<String, KclValue>>

pub fn into_object(self) -> Option<HashMap<String, KclValue>>

pub fn as_str(&self) -> Option<&str>

pub fn as_array(&self) -> Option<&[KclValue]>

pub fn as_point2d(&self) -> Option<[f64; 2]>

pub fn as_uuid(&self) -> Option<Uuid>

pub fn as_plane(&self) -> Option<&Plane>

pub fn as_solid(&self) -> Option<&Solid>

pub fn as_f64(&self) -> Option<f64>

pub fn as_bool(&self) -> Option<bool>

pub fn get_u32(&self, source_ranges: Vec<SourceRange>) -> Result<u32, KclError>

If this value fits in a u32, return it.

pub fn get_function(&self) -> Option<FnAsArg<'_>>

If this value is of type function, return it.

pub fn get_tag_identifier(&self) -> Result<TagIdentifier, KclError>

Get a tag identifier from a memory item.

pub fn get_tag_declarator(&self) -> Result<Node<TagDeclarator>, KclError>

Get a tag declarator from a memory item.

pub fn get_tag_declarator_opt( &self, ) -> Result<Option<Node<TagDeclarator>>, KclError>

Get an optional tag from a memory item.

pub fn get_bool(&self) -> Result<bool, KclError>

If this KCL value is a bool, retrieve it.

pub async fn call_fn( &self, args: Vec<Arg>, exec_state: &mut ExecState, ctx: ExecutorContext, ) -> Result<Option<KclValue>, KclError>

If this memory item is a function, call it with the given arguments, return its val as Ok. If it’s not a function, return Err.

pub async fn call_fn_kw( &self, args: Args, exec_state: &mut ExecState, ctx: ExecutorContext, callsite: SourceRange, ) -> Result<Option<KclValue>, KclError>

If this is a function, call it by applying keyword arguments. If it’s not a function, returns an error.

Trait Implementations

impl Clone for KclValue

fn clone(&self) -> KclValue

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for KclValue

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for KclValue

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&Box<Node<Literal>>> for KclValue

fn from(literal: &Box<Node<Literal>>) -> Self

Converts to this type from the input type.

impl From<&Box<Node<TagDeclarator>>> for KclValue

fn from(tag: &Box<Node<TagDeclarator>>) -> Self

Converts to this type from the input type.

impl From<&KclValue> for Vec<SourceRange>

fn from(item: &KclValue) -> Self

Converts to this type from the input type.

impl From<KclValue> for Vec<SourceRange>

fn from(item: KclValue) -> Self

Converts to this type from the input type.

impl From<Vec<Box<Sketch>>> for KclValue

fn from(sg: Vec<Box<Sketch>>) -> Self

Converts to this type from the input type.

impl From<Vec<Box<Solid>>> for KclValue

fn from(eg: Vec<Box<Solid>>) -> Self

Converts to this type from the input type.

impl JsonSchema for KclValue

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(gen: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl PartialEq for KclValue

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Serialize for KclValue

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TS for KclValue

const DOCS: Option<&'static str> = _

JSDoc comment to describe this type in TypeScript - when TS is derived, docs are automatically read from your doc comments or #[doc = ".."] attributes

type WithoutGenerics = KclValue

If this type does not have generic parameters, then WithoutGenerics should just be Self. If the type does have generic parameters, then all generic parameters must be replaced with a dummy type, e.g ts_rs::Dummy or (). The only requirement for these dummy types is that EXPORT_TO must be None.

fn ident() -> String

Identifier of this type, excluding generic parameters.

fn name() -> String

Name of this type in TypeScript, including generic parameters

fn decl_concrete() -> String

Declaration of this type using the supplied generic arguments. The resulting TypeScript definition will not be generic. For that, see TS::decl(). If this type is not generic, then this function is equivalent to TS::decl().

fn decl() -> String

Declaration of this type, e.g. type User = { user_id: number, ... }. This function will panic if the type has no declaration.

fn inline() -> String

Formats this types definition in TypeScript, e.g { user_id: number }. This function will panic if the type cannot be inlined.

fn inline_flattened() -> String

Flatten a type declaration.
This function will panic if the type cannot be flattened.

fn visit_generics(v: &mut impl TypeVisitor)

where Self: 'static,

Iterates over all type parameters of this type.

fn output_path() -> Option<&'static Path>

Returns the output path to where T should be exported.
The returned path does not include the base directory from TS_RS_EXPORT_DIR.

fn visit_dependencies(v: &mut impl TypeVisitor)

where Self: 'static,

Iterates over all dependency of this type.

fn dependencies() -> Vec<Dependency>

where Self: 'static,

Resolves all dependencies of this type recursively.

fn export() -> Result<(), ExportError>

where Self: 'static,

Manually export this type to the filesystem. To export this type together with all of its dependencies, use TS::export_all.

fn export_all() -> Result<(), ExportError>

where Self: 'static,

Manually export this type to the filesystem, together with all of its dependencies.
To export only this type, without its dependencies, use TS::export.

fn export_all_to(out_dir: impl AsRef<Path>) -> Result<(), ExportError>

where Self: 'static,

Manually export this type into the given directory, together with all of its dependencies.
To export only this type, without its dependencies, use TS::export.

fn export_to_string() -> Result<String, ExportError>

where Self: 'static,

Manually generate bindings for this type, returning a String.
This function does not format the output, even if the format feature is enabled.

fn default_output_path() -> Option<PathBuf>

Returns the output path to where T should be exported.

impl StructuralPartialEq for KclValue