Use references for JSON metadata.

This commit is contained in:
Stephen Chung 2022-08-14 14:20:37 +08:00
parent 9813f657bb
commit f7d910fa55
4 changed files with 28 additions and 58 deletions

View File

@ -60,7 +60,7 @@ unicode-xid-ident = ["unicode-xid"] # allow Unicode Standard Annex #31 for ident
metadata = ["serde", "serde_json", "rhai_codegen/metadata", "smartstring/serde"] # enable exporting functions metadata metadata = ["serde", "serde_json", "rhai_codegen/metadata", "smartstring/serde"] # enable exporting functions metadata
internals = [] # expose internal data structures internals = [] # expose internal data structures
debugging = ["internals"] # enable debugging debugging = ["internals"] # enable debugging
serde = ["dep:serde", "smartstring/serde"] # implement serde for rhai types serde = ["dep:serde", "smartstring/serde", "smallvec/serde"] # implement serde for rhai types
# compiling for no-std # compiling for no-std
no_std = ["no-std-compat", "num-traits/libm", "core-error", "libm", "ahash/compile-time-rng"] no_std = ["no-std-compat", "num-traits/libm", "core-error", "libm", "ahash/compile-time-rng"]

View File

@ -6,6 +6,8 @@ use std::prelude::v1::*;
/// A type representing the access mode of a function. /// A type representing the access mode of a function.
#[derive(Debug, Clone, Copy, Eq, PartialEq, Ord, PartialOrd, Hash)] #[derive(Debug, Clone, Copy, Eq, PartialEq, Ord, PartialOrd, Hash)]
#[cfg_attr(feature = "metadata", derive(serde::Serialize))]
#[cfg_attr(feature = "metadata", serde(rename_all = "camelCase"))]
#[non_exhaustive] #[non_exhaustive]
pub enum FnAccess { pub enum FnAccess {
/// Private function. /// Private function.

View File

@ -22,6 +22,8 @@ use std::{
/// A type representing the namespace of a function. /// A type representing the namespace of a function.
#[derive(Debug, Clone, Copy, Eq, PartialEq, Ord, PartialOrd, Hash)] #[derive(Debug, Clone, Copy, Eq, PartialEq, Ord, PartialOrd, Hash)]
#[cfg_attr(feature = "metadata", derive(serde::Serialize))]
#[cfg_attr(feature = "metadata", serde(rename_all = "camelCase"))]
#[non_exhaustive] #[non_exhaustive]
pub enum FnNamespace { pub enum FnNamespace {
/// Module namespace only. /// Module namespace only.

View File

@ -2,54 +2,20 @@
#![cfg(feature = "metadata")] #![cfg(feature = "metadata")]
use crate::module::{calc_native_fn_hash, FuncInfo}; use crate::module::{calc_native_fn_hash, FuncInfo};
use crate::{calc_fn_hash, Engine, SmartString, AST}; use crate::{calc_fn_hash, Engine, FnAccess, FnNamespace, SmartString, StaticVec, AST};
use serde::{Deserialize, Serialize}; use serde::Serialize;
#[cfg(feature = "no_std")] #[cfg(feature = "no_std")]
use std::prelude::v1::*; use std::prelude::v1::*;
use std::{borrow::Cow, cmp::Ordering, collections::BTreeMap}; use std::{borrow::Cow, cmp::Ordering, collections::BTreeMap};
#[derive(Debug, Clone, Copy, Eq, PartialEq, Hash, Serialize, Deserialize)] #[derive(Debug, Clone, Copy, Eq, PartialEq, Hash, Serialize)]
#[serde(rename_all = "camelCase")] #[serde(rename_all = "camelCase")]
enum FnType { enum FnType {
Script, Script,
Native, Native,
} }
#[cfg(not(feature = "no_module"))] #[derive(Debug, Clone, Eq, PartialEq, Ord, PartialOrd, Hash, Serialize)]
#[derive(Debug, Clone, Copy, Eq, PartialEq, Hash, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
enum FnNamespace {
Global,
Internal,
}
#[cfg(not(feature = "no_module"))]
impl From<crate::FnNamespace> for FnNamespace {
fn from(value: crate::FnNamespace) -> Self {
match value {
crate::FnNamespace::Global => Self::Global,
crate::FnNamespace::Internal => Self::Internal,
}
}
}
#[derive(Debug, Clone, Copy, Eq, PartialEq, Hash, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
enum FnAccess {
Public,
Private,
}
impl From<crate::FnAccess> for FnAccess {
fn from(value: crate::FnAccess) -> Self {
match value {
crate::FnAccess::Public => Self::Public,
crate::FnAccess::Private => Self::Private,
}
}
}
#[derive(Debug, Clone, Eq, PartialEq, Ord, PartialOrd, Hash, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")] #[serde(rename_all = "camelCase")]
struct FnParam<'a> { struct FnParam<'a> {
#[serde(skip_serializing_if = "Option::is_none")] #[serde(skip_serializing_if = "Option::is_none")]
@ -58,7 +24,7 @@ struct FnParam<'a> {
pub typ: Option<Cow<'a, str>>, pub typ: Option<Cow<'a, str>>,
} }
#[derive(Debug, Clone, Eq, PartialEq, Hash, Serialize, Deserialize)] #[derive(Debug, Clone, Eq, PartialEq, Hash, Serialize)]
#[serde(rename_all = "camelCase")] #[serde(rename_all = "camelCase")]
struct FnMetadata<'a> { struct FnMetadata<'a> {
pub base_hash: u64, pub base_hash: u64,
@ -66,20 +32,20 @@ struct FnMetadata<'a> {
#[cfg(not(feature = "no_module"))] #[cfg(not(feature = "no_module"))]
pub namespace: FnNamespace, pub namespace: FnNamespace,
pub access: FnAccess, pub access: FnAccess,
pub name: String, pub name: &'a str,
#[serde(rename = "type")] #[serde(rename = "type")]
pub typ: FnType, pub typ: FnType,
pub num_params: usize, pub num_params: usize,
#[serde(default, skip_serializing_if = "Vec::is_empty")] #[serde(default, skip_serializing_if = "StaticVec::is_empty")]
pub params: Vec<FnParam<'a>>, pub params: StaticVec<FnParam<'a>>,
// No idea why the following is needed otherwise serde comes back with a lifetime error // No idea why the following is needed otherwise serde comes back with a lifetime error
#[serde(default, skip_serializing_if = "Option::is_none")] #[serde(default, skip_serializing_if = "Option::is_none")]
pub _dummy: Option<&'a str>, pub _dummy: Option<&'a str>,
#[serde(default, skip_serializing_if = "String::is_empty")] #[serde(default, skip_serializing_if = "str::is_empty")]
pub return_type: String, pub return_type: Cow<'a, str>,
pub signature: String, pub signature: SmartString,
#[serde(default, skip_serializing_if = "Vec::is_empty")] #[serde(default, skip_serializing_if = "StaticVec::is_empty")]
pub doc_comments: Vec<&'a str>, pub doc_comments: StaticVec<&'a str>,
} }
impl PartialOrd for FnMetadata<'_> { impl PartialOrd for FnMetadata<'_> {
@ -115,7 +81,7 @@ impl<'a> From<&'a FuncInfo> for FnMetadata<'a> {
#[cfg(not(feature = "no_module"))] #[cfg(not(feature = "no_module"))]
namespace: info.metadata.namespace.into(), namespace: info.metadata.namespace.into(),
access: info.metadata.access.into(), access: info.metadata.access.into(),
name: info.metadata.name.to_string(), name: &info.metadata.name,
typ, typ,
num_params: info.metadata.params, num_params: info.metadata.params,
params: info params: info
@ -133,8 +99,8 @@ impl<'a> From<&'a FuncInfo> for FnMetadata<'a> {
}) })
.collect(), .collect(),
_dummy: None, _dummy: None,
return_type: FuncInfo::format_type(&info.metadata.return_type, true).into_owned(), return_type: FuncInfo::format_type(&info.metadata.return_type, true),
signature: info.gen_signature(), signature: info.gen_signature().into(),
doc_comments: if info.func.is_script() { doc_comments: if info.func.is_script() {
#[cfg(feature = "no_function")] #[cfg(feature = "no_function")]
unreachable!("script-defined functions should not exist under no_function"); unreachable!("script-defined functions should not exist under no_function");
@ -158,12 +124,12 @@ impl<'a> From<&'a FuncInfo> for FnMetadata<'a> {
#[serde(rename_all = "camelCase")] #[serde(rename_all = "camelCase")]
struct ModuleMetadata<'a> { struct ModuleMetadata<'a> {
#[cfg(feature = "metadata")] #[cfg(feature = "metadata")]
#[serde(skip_serializing_if = "SmartString::is_empty")] #[serde(skip_serializing_if = "str::is_empty")]
pub doc: SmartString, pub doc: &'a str,
#[serde(skip_serializing_if = "BTreeMap::is_empty")] #[serde(skip_serializing_if = "BTreeMap::is_empty")]
pub modules: BTreeMap<&'a str, Self>, pub modules: BTreeMap<&'a str, Self>,
#[serde(skip_serializing_if = "Vec::is_empty")] #[serde(skip_serializing_if = "StaticVec::is_empty")]
pub functions: Vec<FnMetadata<'a>>, pub functions: StaticVec<FnMetadata<'a>>,
} }
impl ModuleMetadata<'_> { impl ModuleMetadata<'_> {
@ -171,16 +137,16 @@ impl ModuleMetadata<'_> {
pub fn new() -> Self { pub fn new() -> Self {
Self { Self {
#[cfg(feature = "metadata")] #[cfg(feature = "metadata")]
doc: SmartString::new_const(), doc: "",
modules: BTreeMap::new(), modules: BTreeMap::new(),
functions: Vec::new(), functions: StaticVec::new_const(),
} }
} }
} }
impl<'a> From<&'a crate::Module> for ModuleMetadata<'a> { impl<'a> From<&'a crate::Module> for ModuleMetadata<'a> {
fn from(module: &'a crate::Module) -> Self { fn from(module: &'a crate::Module) -> Self {
let mut functions: Vec<_> = module.iter_fn().map(Into::into).collect(); let mut functions: StaticVec<_> = module.iter_fn().map(Into::into).collect();
functions.sort(); functions.sort();
Self { Self {