git.delta.rocks / jrsonnet / refs/commits / 773438d8aef3

difftreelog

source

crates/jrsonnet-stdlib/src/lib.rs10.6 KiBsourcehistory
1use std::{2	cell::{Ref, RefCell, RefMut},3	collections::HashMap,4	rc::Rc,5};67use jrsonnet_evaluator::{8	error::{ErrorKind::*, Result},9	function::{CallLocation, FuncVal, TlaArg},10	tb,11	trace::PathResolver,12	ContextBuilder, IStr, ObjValue, ObjValueBuilder, State, Thunk, Val,13};14use jrsonnet_gcmodule::Trace;15use jrsonnet_parser::Source;1617mod expr;18mod types;19pub use types::*;20mod arrays;21pub use arrays::*;22mod math;23pub use math::*;24mod operator;25pub use operator::*;26mod sort;27pub use sort::*;28mod hash;29pub use hash::*;30mod encoding;31pub use encoding::*;32mod objects;33pub use objects::*;34mod manifest;35pub use manifest::*;36mod parse;37pub use parse::*;38mod strings;39pub use strings::*;40mod misc;41pub use misc::*;42mod sets;43pub use sets::*;44mod compat;45pub use compat::*;4647pub fn stdlib_uncached(settings: Rc<RefCell<Settings>>) -> ObjValue {48	let mut builder = ObjValueBuilder::new();4950	let expr = expr::stdlib_expr();51	let eval = jrsonnet_evaluator::evaluate(ContextBuilder::dangerous_empty_state().build(), &expr)52		.expect("stdlib.jsonnet should have no errors")53		.as_obj()54		.expect("stdlib.jsonnet should evaluate to object");5556	builder.with_super(eval);5758	for (name, builtin) in [59		// Types60		("type", builtin_type::INST),61		("isString", builtin_is_string::INST),62		("isNumber", builtin_is_number::INST),63		("isBoolean", builtin_is_boolean::INST),64		("isObject", builtin_is_object::INST),65		("isArray", builtin_is_array::INST),66		("isFunction", builtin_is_function::INST),67		// Arrays68		("makeArray", builtin_make_array::INST),69		("repeat", builtin_repeat::INST),70		("slice", builtin_slice::INST),71		("map", builtin_map::INST),72		("flatMap", builtin_flatmap::INST),73		("filter", builtin_filter::INST),74		("foldl", builtin_foldl::INST),75		("foldr", builtin_foldr::INST),76		("range", builtin_range::INST),77		("join", builtin_join::INST),78		("reverse", builtin_reverse::INST),79		("any", builtin_any::INST),80		("all", builtin_all::INST),81		("member", builtin_member::INST),82		("contains", builtin_contains::INST),83		("count", builtin_count::INST),84		("avg", builtin_avg::INST),85		("removeAt", builtin_remove_at::INST),86		("remove", builtin_remove::INST),87		// Math88		("abs", builtin_abs::INST),89		("sign", builtin_sign::INST),90		("max", builtin_max::INST),91		("min", builtin_min::INST),92		("sum", builtin_sum::INST),93		("modulo", builtin_modulo::INST),94		("floor", builtin_floor::INST),95		("ceil", builtin_ceil::INST),96		("log", builtin_log::INST),97		("pow", builtin_pow::INST),98		("sqrt", builtin_sqrt::INST),99		("sin", builtin_sin::INST),100		("cos", builtin_cos::INST),101		("tan", builtin_tan::INST),102		("asin", builtin_asin::INST),103		("acos", builtin_acos::INST),104		("atan", builtin_atan::INST),105		("exp", builtin_exp::INST),106		("mantissa", builtin_mantissa::INST),107		("exponent", builtin_exponent::INST),108		("round", builtin_round::INST),109		("isEven", builtin_is_even::INST),110		("isOdd", builtin_is_odd::INST),111		("isInteger", builtin_is_integer::INST),112		("isDecimal", builtin_is_decimal::INST),113		// Operator114		("mod", builtin_mod::INST),115		("primitiveEquals", builtin_primitive_equals::INST),116		("equals", builtin_equals::INST),117		("xor", builtin_xor::INST),118		("xnor", builtin_xnor::INST),119		("format", builtin_format::INST),120		// Sort121		("sort", builtin_sort::INST),122		("uniq", builtin_uniq::INST),123		("set", builtin_set::INST),124		("minArray", builtin_min_array::INST),125		("maxArray", builtin_max_array::INST),126		// Hash127		("md5", builtin_md5::INST),128		("sha1", builtin_sha1::INST),129		("sha256", builtin_sha256::INST),130		("sha512", builtin_sha512::INST),131		("sha3", builtin_sha3::INST),132		// Encoding133		("encodeUTF8", builtin_encode_utf8::INST),134		("decodeUTF8", builtin_decode_utf8::INST),135		("base64", builtin_base64::INST),136		("base64Decode", builtin_base64_decode::INST),137		("base64DecodeBytes", builtin_base64_decode_bytes::INST),138		// Objects139		("objectFieldsEx", builtin_object_fields_ex::INST),140		("objectValues", builtin_object_values::INST),141		("objectValuesAll", builtin_object_values_all::INST),142		("objectKeysValues", builtin_object_keys_values::INST),143		("objectKeysValuesAll", builtin_object_keys_values_all::INST),144		("objectHasEx", builtin_object_has_ex::INST),145		("objectRemoveKey", builtin_object_remove_key::INST),146		// Manifest147		("escapeStringJson", builtin_escape_string_json::INST),148		("manifestJsonEx", builtin_manifest_json_ex::INST),149		("manifestYamlDoc", builtin_manifest_yaml_doc::INST),150		("manifestTomlEx", builtin_manifest_toml_ex::INST),151		// Parsing152		("parseJson", builtin_parse_json::INST),153		("parseYaml", builtin_parse_yaml::INST),154		// Strings155		("codepoint", builtin_codepoint::INST),156		("substr", builtin_substr::INST),157		("char", builtin_char::INST),158		("strReplace", builtin_str_replace::INST),159		("isEmpty", builtin_is_empty::INST),160		("equalsIgnoreCase", builtin_equals_ignore_case::INST),161		("splitLimit", builtin_splitlimit::INST),162		("asciiUpper", builtin_ascii_upper::INST),163		("asciiLower", builtin_ascii_lower::INST),164		("findSubstr", builtin_find_substr::INST),165		("parseInt", builtin_parse_int::INST),166		#[cfg(feature = "exp-bigint")]167		("bigint", builtin_bigint::INST),168		("parseOctal", builtin_parse_octal::INST),169		("parseHex", builtin_parse_hex::INST),170		// Misc171		("length", builtin_length::INST),172		("startsWith", builtin_starts_with::INST),173		("endsWith", builtin_ends_with::INST),174		// Sets175		("setMember", builtin_set_member::INST),176		("setInter", builtin_set_inter::INST),177		("setDiff", builtin_set_diff::INST),178		// Compat179		("__compare", builtin___compare::INST),180	]181	.iter()182	.cloned()183	{184		builder.method(name, builtin);185	}186187	builder.method(188		"extVar",189		builtin_ext_var {190			settings: settings.clone(),191		},192	);193	builder.method(194		"native",195		builtin_native {196			settings: settings.clone(),197		},198	);199	builder.method("trace", builtin_trace { settings });200201	builder.method("id", FuncVal::Id);202203	builder.build()204}205206pub trait TracePrinter {207	fn print_trace(&self, loc: CallLocation, value: IStr);208}209210pub struct StdTracePrinter {211	resolver: PathResolver,212}213impl StdTracePrinter {214	pub fn new(resolver: PathResolver) -> Self {215		Self { resolver }216	}217}218impl TracePrinter for StdTracePrinter {219	fn print_trace(&self, loc: CallLocation, value: IStr) {220		eprint!("TRACE:");221		if let Some(loc) = loc.0 {222			let locs = loc.0.map_source_locations(&[loc.1]);223			eprint!(224				" {}:{}",225				match loc.0.source_path().path() {226					Some(p) => self.resolver.resolve(p),227					None => loc.0.source_path().to_string(),228				},229				locs[0].line230			);231		}232		eprintln!(" {value}");233	}234}235236pub struct Settings {237	/// Used for `std.extVar`238	pub ext_vars: HashMap<IStr, TlaArg>,239	/// Used for `std.native`240	pub ext_natives: HashMap<IStr, FuncVal>,241	/// Used for `std.trace`242	pub trace_printer: Box<dyn TracePrinter>,243	/// Used for `std.thisFile`244	pub path_resolver: PathResolver,245}246247fn extvar_source(name: &str, code: impl Into<IStr>) -> Source {248	let source_name = format!("<extvar:{name}>");249	Source::new_virtual(source_name.into(), code.into())250}251252#[derive(Trace, Clone)]253pub struct ContextInitializer {254	/// When we don't need to support legacy-this-file, we can reuse same context for all files255	#[cfg(not(feature = "legacy-this-file"))]256	context: jrsonnet_evaluator::Context,257	/// For `populate`258	#[cfg(not(feature = "legacy-this-file"))]259	stdlib_thunk: Thunk<Val>,260	/// Otherwise, we can only keep first stdlib layer, and then stack thisFile on top of it261	#[cfg(feature = "legacy-this-file")]262	stdlib_obj: ObjValue,263	settings: Rc<RefCell<Settings>>,264}265impl ContextInitializer {266	pub fn new(_s: State, resolver: PathResolver) -> Self {267		let settings = Settings {268			ext_vars: Default::default(),269			ext_natives: Default::default(),270			trace_printer: Box::new(StdTracePrinter::new(resolver.clone())),271			path_resolver: resolver,272		};273		let settings = Rc::new(RefCell::new(settings));274		let stdlib_obj = stdlib_uncached(settings.clone());275		#[cfg(not(feature = "legacy-this-file"))]276		let stdlib_thunk = Thunk::evaluated(Val::Obj(stdlib_obj));277		Self {278			#[cfg(not(feature = "legacy-this-file"))]279			context: {280				let mut context = ContextBuilder::with_capacity(_s, 1);281				context.bind("std", stdlib_thunk.clone());282				context.build()283			},284			#[cfg(not(feature = "legacy-this-file"))]285			stdlib_thunk,286			#[cfg(feature = "legacy-this-file")]287			stdlib_obj,288			settings,289		}290	}291	pub fn settings(&self) -> Ref<Settings> {292		self.settings.borrow()293	}294	pub fn settings_mut(&self) -> RefMut<Settings> {295		self.settings.borrow_mut()296	}297	pub fn add_ext_var(&self, name: IStr, value: Val) {298		self.settings_mut()299			.ext_vars300			.insert(name, TlaArg::Val(value));301	}302	pub fn add_ext_str(&self, name: IStr, value: IStr) {303		self.settings_mut()304			.ext_vars305			.insert(name, TlaArg::String(value));306	}307	pub fn add_ext_code(&self, name: &str, code: impl Into<IStr>) -> Result<()> {308		let code = code.into();309		let source = extvar_source(name, code.clone());310		let parsed = jrsonnet_parser::parse(311			&code,312			&jrsonnet_parser::ParserSettings {313				source: source.clone(),314			},315		)316		.map_err(|e| ImportSyntaxError {317			path: source,318			error: Box::new(e),319		})?;320		// self.data_mut().volatile_files.insert(source_name, code);321		self.settings_mut()322			.ext_vars323			.insert(name.into(), TlaArg::Code(parsed));324		Ok(())325	}326	pub fn add_native(&self, name: impl Into<IStr>, cb: impl Into<FuncVal>) {327		self.settings_mut()328			.ext_natives329			.insert(name.into(), cb.into());330	}331}332impl jrsonnet_evaluator::ContextInitializer for ContextInitializer {333	fn reserve_vars(&self) -> usize {334		1335	}336	#[cfg(not(feature = "legacy-this-file"))]337	fn initialize(&self, _s: State, _source: Source) -> jrsonnet_evaluator::Context {338		self.context.clone()339	}340	#[cfg(not(feature = "legacy-this-file"))]341	fn populate(&self, _for_file: Source, builder: &mut ContextBuilder) {342		builder.bind("std", self.stdlib_thunk.clone());343	}344	#[cfg(feature = "legacy-this-file")]345	fn populate(&self, source: Source, builder: &mut ContextBuilder) {346		use jrsonnet_evaluator::val::StrValue;347348		let mut std = ObjValueBuilder::new();349		std.with_super(self.stdlib_obj.clone());350		std.field("thisFile".into())351			.hide()352			.value(Val::string(353				match source.source_path().path() {354					Some(p) => self.settings().path_resolver.resolve(p).into(),355					None => source.source_path().to_string().into(),356				},357			))358			.expect("this object builder is empty");359		let stdlib_with_this_file = std.build();360361		builder.bind(362			"std".into(),363			Thunk::evaluated(Val::Obj(stdlib_with_this_file)),364		);365	}366	fn as_any(&self) -> &dyn std::any::Any {367		self368	}369}370371pub trait StateExt {372	/// This method was previously implemented in jrsonnet-evaluator itself373	fn with_stdlib(&self);374}375376impl StateExt for State {377	fn with_stdlib(&self) {378		let initializer = ContextInitializer::new(self.clone(), PathResolver::new_cwd_fallback());379		self.settings_mut().context_initializer = tb!(initializer)380	}381}