use heck::{ToLowerCamelCase, ToPascalCase, ToSnakeCase};
use std::collections::{HashMap, HashSet};
pub struct FieldResolver {
aliases: HashMap<String, String>,
optional_fields: HashSet<String>,
result_fields: HashSet<String>,
array_fields: HashSet<String>,
}
#[derive(Debug, Clone)]
enum PathSegment {
Field(String),
ArrayField(String),
MapAccess { field: String, key: String },
Length,
}
impl FieldResolver {
pub fn new(
fields: &HashMap<String, String>,
optional: &HashSet<String>,
result_fields: &HashSet<String>,
array_fields: &HashSet<String>,
) -> Self {
Self {
aliases: fields.clone(),
optional_fields: optional.clone(),
result_fields: result_fields.clone(),
array_fields: array_fields.clone(),
}
}
pub fn resolve<'a>(&'a self, fixture_field: &'a str) -> &'a str {
self.aliases
.get(fixture_field)
.map(String::as_str)
.unwrap_or(fixture_field)
}
pub fn is_optional(&self, field: &str) -> bool {
if self.optional_fields.contains(field) {
return true;
}
let normalized = field.replace("[].", ".");
if normalized != field && self.optional_fields.contains(normalized.as_str()) {
return true;
}
for af in &self.array_fields {
if let Some(rest) = field.strip_prefix(af.as_str()) {
if let Some(rest) = rest.strip_prefix('.') {
let with_bracket = format!("{af}[].{rest}");
if self.optional_fields.contains(with_bracket.as_str()) {
return true;
}
}
}
}
false
}
pub fn has_alias(&self, fixture_field: &str) -> bool {
self.aliases.contains_key(fixture_field)
}
pub fn is_valid_for_result(&self, fixture_field: &str) -> bool {
if self.result_fields.is_empty() {
return true;
}
let resolved = self.resolve(fixture_field);
let first_segment = resolved.split('.').next().unwrap_or(resolved);
let first_segment = first_segment.split('[').next().unwrap_or(first_segment);
self.result_fields.contains(first_segment)
}
pub fn is_array(&self, field: &str) -> bool {
self.array_fields.contains(field)
}
pub fn has_map_access(&self, fixture_field: &str) -> bool {
let resolved = self.resolve(fixture_field);
let segments = parse_path(resolved);
segments.iter().any(|s| matches!(s, PathSegment::MapAccess { .. }))
}
pub fn accessor(&self, fixture_field: &str, language: &str, result_var: &str) -> String {
let resolved = self.resolve(fixture_field);
let segments = parse_path(resolved);
let segments = self.inject_array_indexing(segments);
match language {
"java" => render_java_with_optionals(&segments, result_var, &self.optional_fields),
"rust" => render_rust_with_optionals(&segments, result_var, &self.optional_fields),
"csharp" => render_csharp_with_optionals(&segments, result_var, &self.optional_fields),
_ => render_accessor(&segments, language, result_var),
}
}
fn inject_array_indexing(&self, segments: Vec<PathSegment>) -> Vec<PathSegment> {
if self.array_fields.is_empty() {
return segments;
}
let len = segments.len();
let mut result = Vec::with_capacity(len);
let mut path_so_far = String::new();
for i in 0..len {
let seg = &segments[i];
match seg {
PathSegment::Field(f) => {
if !path_so_far.is_empty() {
path_so_far.push('.');
}
path_so_far.push_str(f);
let next_is_length = i + 1 < len && matches!(segments[i + 1], PathSegment::Length);
if i + 1 < len && self.array_fields.contains(&path_so_far) && !next_is_length {
result.push(PathSegment::ArrayField(f.clone()));
} else {
result.push(seg.clone());
}
}
_ => {
result.push(seg.clone());
}
}
}
result
}
pub fn rust_unwrap_binding(&self, fixture_field: &str, result_var: &str) -> Option<(String, String)> {
let resolved = self.resolve(fixture_field);
if !self.is_optional(resolved) {
return None;
}
let segments = parse_path(resolved);
let segments = self.inject_array_indexing(segments);
let local_var = resolved.replace(['.', '['], "_").replace(']', "");
let accessor = render_accessor(&segments, "rust", result_var);
let has_map_access = segments.iter().any(|s| matches!(s, PathSegment::MapAccess { .. }));
let binding = if has_map_access {
format!("let {local_var} = {accessor}.unwrap_or(\"\");")
} else {
format!("let {local_var} = {accessor}.as_deref().unwrap_or(\"\");")
};
Some((binding, local_var))
}
}
fn parse_path(path: &str) -> Vec<PathSegment> {
let mut segments = Vec::new();
for part in path.split('.') {
if part == "length" || part == "count" || part == "size" {
segments.push(PathSegment::Length);
} else if let Some(bracket_pos) = part.find('[') {
let field = part[..bracket_pos].to_string();
let key = part[bracket_pos + 1..].trim_end_matches(']').to_string();
if key.is_empty() {
segments.push(PathSegment::ArrayField(field));
} else {
segments.push(PathSegment::MapAccess { field, key });
}
} else {
segments.push(PathSegment::Field(part.to_string()));
}
}
segments
}
fn render_accessor(segments: &[PathSegment], language: &str, result_var: &str) -> String {
match language {
"rust" => render_rust(segments, result_var),
"python" => render_dot_access(segments, result_var, "python"),
"typescript" | "node" => render_typescript(segments, result_var),
"wasm" => render_wasm(segments, result_var),
"go" => render_go(segments, result_var),
"java" => render_java(segments, result_var),
"csharp" => render_pascal_dot(segments, result_var),
"ruby" => render_dot_access(segments, result_var, "ruby"),
"php" => render_php(segments, result_var),
"elixir" => render_dot_access(segments, result_var, "elixir"),
"r" => render_r(segments, result_var),
"c" => render_c(segments, result_var),
_ => render_dot_access(segments, result_var, language),
}
}
fn render_rust(segments: &[PathSegment], result_var: &str) -> String {
let mut out = result_var.to_string();
for seg in segments {
match seg {
PathSegment::Field(f) => {
out.push('.');
out.push_str(&f.to_snake_case());
}
PathSegment::ArrayField(f) => {
out.push('.');
out.push_str(&f.to_snake_case());
out.push_str("[0]");
}
PathSegment::MapAccess { field, key } => {
out.push('.');
out.push_str(&field.to_snake_case());
out.push_str(&format!(".get(\"{key}\").map(|s| s.as_str())"));
}
PathSegment::Length => {
out.push_str(".len()");
}
}
}
out
}
fn render_dot_access(segments: &[PathSegment], result_var: &str, language: &str) -> String {
let mut out = result_var.to_string();
for seg in segments {
match seg {
PathSegment::Field(f) => {
out.push('.');
out.push_str(f);
}
PathSegment::ArrayField(f) => {
out.push('.');
out.push_str(f);
out.push_str("[0]");
}
PathSegment::MapAccess { field, key } => {
out.push('.');
out.push_str(field);
if language == "elixir" {
out.push_str(&format!("[\"{key}\"]"));
} else {
out.push_str(&format!(".get(\"{key}\")"));
}
}
PathSegment::Length => match language {
"ruby" => out.push_str(".length"),
"elixir" => {
let current = std::mem::take(&mut out);
out = format!("length({current})");
}
_ => {
let current = std::mem::take(&mut out);
out = format!("len({current})");
}
},
}
}
out
}
fn render_typescript(segments: &[PathSegment], result_var: &str) -> String {
let mut out = result_var.to_string();
for seg in segments {
match seg {
PathSegment::Field(f) => {
out.push('.');
out.push_str(&f.to_lower_camel_case());
}
PathSegment::ArrayField(f) => {
out.push('.');
out.push_str(&f.to_lower_camel_case());
out.push_str("[0]");
}
PathSegment::MapAccess { field, key } => {
out.push('.');
out.push_str(&field.to_lower_camel_case());
out.push_str(&format!("[\"{key}\"]"));
}
PathSegment::Length => {
out.push_str(".length");
}
}
}
out
}
fn render_wasm(segments: &[PathSegment], result_var: &str) -> String {
let mut out = result_var.to_string();
for seg in segments {
match seg {
PathSegment::Field(f) => {
out.push('.');
out.push_str(&f.to_lower_camel_case());
}
PathSegment::ArrayField(f) => {
out.push('.');
out.push_str(&f.to_lower_camel_case());
out.push_str("[0]");
}
PathSegment::MapAccess { field, key } => {
out.push('.');
out.push_str(&field.to_lower_camel_case());
out.push_str(&format!(".get(\"{key}\")"));
}
PathSegment::Length => {
out.push_str(".length");
}
}
}
out
}
fn render_go(segments: &[PathSegment], result_var: &str) -> String {
let mut out = result_var.to_string();
for seg in segments {
match seg {
PathSegment::Field(f) => {
out.push('.');
out.push_str(&f.to_pascal_case());
}
PathSegment::ArrayField(f) => {
out.push('.');
out.push_str(&f.to_pascal_case());
out.push_str("[0]");
}
PathSegment::MapAccess { field, key } => {
out.push('.');
out.push_str(&field.to_pascal_case());
out.push_str(&format!("[\"{key}\"]"));
}
PathSegment::Length => {
let current = std::mem::take(&mut out);
out = format!("len({current})");
}
}
}
out
}
fn render_java(segments: &[PathSegment], result_var: &str) -> String {
let mut out = result_var.to_string();
for seg in segments {
match seg {
PathSegment::Field(f) => {
out.push('.');
out.push_str(&f.to_lower_camel_case());
out.push_str("()");
}
PathSegment::ArrayField(f) => {
out.push('.');
out.push_str(&f.to_lower_camel_case());
out.push_str("().getFirst()");
}
PathSegment::MapAccess { field, key } => {
out.push('.');
out.push_str(&field.to_lower_camel_case());
out.push_str(&format!("().get(\"{key}\")"));
}
PathSegment::Length => {
out.push_str(".size()");
}
}
}
out
}
fn render_java_with_optionals(segments: &[PathSegment], result_var: &str, optional_fields: &HashSet<String>) -> String {
let mut out = result_var.to_string();
let mut path_so_far = String::new();
for (i, seg) in segments.iter().enumerate() {
let is_leaf = i == segments.len() - 1;
match seg {
PathSegment::Field(f) => {
if !path_so_far.is_empty() {
path_so_far.push('.');
}
path_so_far.push_str(f);
out.push('.');
out.push_str(&f.to_lower_camel_case());
out.push_str("()");
if !is_leaf && optional_fields.contains(&path_so_far) {
out.push_str(".orElseThrow()");
}
}
PathSegment::ArrayField(f) => {
if !path_so_far.is_empty() {
path_so_far.push('.');
}
path_so_far.push_str(f);
out.push('.');
out.push_str(&f.to_lower_camel_case());
out.push_str("().getFirst()");
}
PathSegment::MapAccess { field, key } => {
if !path_so_far.is_empty() {
path_so_far.push('.');
}
path_so_far.push_str(field);
out.push('.');
out.push_str(&field.to_lower_camel_case());
out.push_str(&format!("().get(\"{key}\")"));
}
PathSegment::Length => {
out.push_str(".size()");
}
}
}
out
}
fn render_rust_with_optionals(segments: &[PathSegment], result_var: &str, optional_fields: &HashSet<String>) -> String {
let mut out = result_var.to_string();
let mut path_so_far = String::new();
for (i, seg) in segments.iter().enumerate() {
let is_leaf = i == segments.len() - 1;
match seg {
PathSegment::Field(f) => {
if !path_so_far.is_empty() {
path_so_far.push('.');
}
path_so_far.push_str(f);
out.push('.');
out.push_str(&f.to_snake_case());
if !is_leaf && optional_fields.contains(&path_so_far) {
out.push_str(".as_ref().unwrap()");
}
}
PathSegment::ArrayField(f) => {
if !path_so_far.is_empty() {
path_so_far.push('.');
}
path_so_far.push_str(f);
out.push('.');
out.push_str(&f.to_snake_case());
out.push_str("[0]");
}
PathSegment::MapAccess { field, key } => {
if !path_so_far.is_empty() {
path_so_far.push('.');
}
path_so_far.push_str(field);
out.push('.');
out.push_str(&field.to_snake_case());
out.push_str(&format!(".get(\"{key}\").map(|s| s.as_str())"));
}
PathSegment::Length => {
out.push_str(".len()");
}
}
}
out
}
fn render_pascal_dot(segments: &[PathSegment], result_var: &str) -> String {
let mut out = result_var.to_string();
for seg in segments {
match seg {
PathSegment::Field(f) => {
out.push('.');
out.push_str(&f.to_pascal_case());
}
PathSegment::ArrayField(f) => {
out.push('.');
out.push_str(&f.to_pascal_case());
out.push_str("[0]");
}
PathSegment::MapAccess { field, key } => {
out.push('.');
out.push_str(&field.to_pascal_case());
out.push_str(&format!("[\"{key}\"]"));
}
PathSegment::Length => {
out.push_str(".Count");
}
}
}
out
}
fn render_csharp_with_optionals(
segments: &[PathSegment],
result_var: &str,
optional_fields: &HashSet<String>,
) -> String {
let mut out = result_var.to_string();
let mut path_so_far = String::new();
for (i, seg) in segments.iter().enumerate() {
let is_leaf = i == segments.len() - 1;
match seg {
PathSegment::Field(f) => {
if !path_so_far.is_empty() {
path_so_far.push('.');
}
path_so_far.push_str(f);
out.push('.');
out.push_str(&f.to_pascal_case());
if !is_leaf && optional_fields.contains(&path_so_far) {
out.push('!');
}
}
PathSegment::ArrayField(f) => {
if !path_so_far.is_empty() {
path_so_far.push('.');
}
path_so_far.push_str(f);
out.push('.');
out.push_str(&f.to_pascal_case());
out.push_str("[0]");
}
PathSegment::MapAccess { field, key } => {
if !path_so_far.is_empty() {
path_so_far.push('.');
}
path_so_far.push_str(field);
out.push('.');
out.push_str(&field.to_pascal_case());
out.push_str(&format!("[\"{key}\"]"));
}
PathSegment::Length => {
out.push_str(".Count");
}
}
}
out
}
fn render_php(segments: &[PathSegment], result_var: &str) -> String {
let mut out = result_var.to_string();
for seg in segments {
match seg {
PathSegment::Field(f) => {
out.push_str("->");
out.push_str(f);
}
PathSegment::ArrayField(f) => {
out.push_str("->");
out.push_str(f);
out.push_str("[0]");
}
PathSegment::MapAccess { field, key } => {
out.push_str("->");
out.push_str(field);
out.push_str(&format!("[\"{key}\"]"));
}
PathSegment::Length => {
let current = std::mem::take(&mut out);
out = format!("count({current})");
}
}
}
out
}
fn render_r(segments: &[PathSegment], result_var: &str) -> String {
let mut out = result_var.to_string();
for seg in segments {
match seg {
PathSegment::Field(f) => {
out.push('$');
out.push_str(f);
}
PathSegment::ArrayField(f) => {
out.push('$');
out.push_str(f);
out.push_str("[[1]]");
}
PathSegment::MapAccess { field, key } => {
out.push('$');
out.push_str(field);
out.push_str(&format!("[[\"{key}\"]]"));
}
PathSegment::Length => {
let current = std::mem::take(&mut out);
out = format!("length({current})");
}
}
}
out
}
fn render_c(segments: &[PathSegment], result_var: &str) -> String {
let mut parts = Vec::new();
let mut trailing_length = false;
for seg in segments {
match seg {
PathSegment::Field(f) | PathSegment::ArrayField(f) => parts.push(f.to_snake_case()),
PathSegment::MapAccess { field, key } => {
parts.push(field.to_snake_case());
parts.push(key.clone());
}
PathSegment::Length => {
trailing_length = true;
}
}
}
let suffix = parts.join("_");
if trailing_length {
format!("result_{suffix}_count({result_var})")
} else {
format!("result_{suffix}({result_var})")
}
}
#[cfg(test)]
mod tests {
use super::*;
fn make_resolver() -> FieldResolver {
let mut fields = HashMap::new();
fields.insert("title".to_string(), "metadata.document.title".to_string());
fields.insert("tags".to_string(), "metadata.tags[name]".to_string());
fields.insert("og".to_string(), "metadata.document.open_graph".to_string());
fields.insert("twitter".to_string(), "metadata.document.twitter_card".to_string());
fields.insert("canonical".to_string(), "metadata.document.canonical_url".to_string());
fields.insert("og_tag".to_string(), "metadata.open_graph_tags[og_title]".to_string());
let mut optional = HashSet::new();
optional.insert("metadata.document.title".to_string());
FieldResolver::new(&fields, &optional, &HashSet::new(), &HashSet::new())
}
fn make_resolver_with_doc_optional() -> FieldResolver {
let mut fields = HashMap::new();
fields.insert("title".to_string(), "metadata.document.title".to_string());
fields.insert("tags".to_string(), "metadata.tags[name]".to_string());
let mut optional = HashSet::new();
optional.insert("document".to_string());
optional.insert("metadata.document.title".to_string());
optional.insert("metadata.document".to_string());
FieldResolver::new(&fields, &optional, &HashSet::new(), &HashSet::new())
}
#[test]
fn test_resolve_alias() {
let r = make_resolver();
assert_eq!(r.resolve("title"), "metadata.document.title");
}
#[test]
fn test_resolve_passthrough() {
let r = make_resolver();
assert_eq!(r.resolve("content"), "content");
}
#[test]
fn test_is_optional() {
let r = make_resolver();
assert!(r.is_optional("metadata.document.title"));
assert!(!r.is_optional("content"));
}
#[test]
fn test_accessor_rust_struct() {
let r = make_resolver();
assert_eq!(r.accessor("title", "rust", "result"), "result.metadata.document.title");
}
#[test]
fn test_accessor_rust_map() {
let r = make_resolver();
assert_eq!(
r.accessor("tags", "rust", "result"),
"result.metadata.tags.get(\"name\").map(|s| s.as_str())"
);
}
#[test]
fn test_accessor_python() {
let r = make_resolver();
assert_eq!(
r.accessor("title", "python", "result"),
"result.metadata.document.title"
);
}
#[test]
fn test_accessor_go() {
let r = make_resolver();
assert_eq!(r.accessor("title", "go", "result"), "result.Metadata.Document.Title");
}
#[test]
fn test_accessor_typescript() {
let r = make_resolver();
assert_eq!(
r.accessor("title", "typescript", "result"),
"result.metadata.document.title"
);
}
#[test]
fn test_accessor_typescript_snake_to_camel() {
let r = make_resolver();
assert_eq!(
r.accessor("og", "typescript", "result"),
"result.metadata.document.openGraph"
);
assert_eq!(
r.accessor("twitter", "typescript", "result"),
"result.metadata.document.twitterCard"
);
assert_eq!(
r.accessor("canonical", "typescript", "result"),
"result.metadata.document.canonicalUrl"
);
}
#[test]
fn test_accessor_typescript_map_snake_to_camel() {
let r = make_resolver();
assert_eq!(
r.accessor("og_tag", "typescript", "result"),
"result.metadata.openGraphTags[\"og_title\"]"
);
}
#[test]
fn test_accessor_node_alias() {
let r = make_resolver();
assert_eq!(r.accessor("og", "node", "result"), "result.metadata.document.openGraph");
}
#[test]
fn test_accessor_wasm_camel_case() {
let r = make_resolver();
assert_eq!(r.accessor("og", "wasm", "result"), "result.metadata.document.openGraph");
assert_eq!(
r.accessor("twitter", "wasm", "result"),
"result.metadata.document.twitterCard"
);
assert_eq!(
r.accessor("canonical", "wasm", "result"),
"result.metadata.document.canonicalUrl"
);
}
#[test]
fn test_accessor_wasm_map_access() {
let r = make_resolver();
assert_eq!(
r.accessor("og_tag", "wasm", "result"),
"result.metadata.openGraphTags.get(\"og_title\")"
);
}
#[test]
fn test_accessor_java() {
let r = make_resolver();
assert_eq!(
r.accessor("title", "java", "result"),
"result.metadata().document().title()"
);
}
#[test]
fn test_accessor_csharp() {
let r = make_resolver();
assert_eq!(
r.accessor("title", "csharp", "result"),
"result.Metadata.Document.Title"
);
}
#[test]
fn test_accessor_php() {
let r = make_resolver();
assert_eq!(
r.accessor("title", "php", "$result"),
"$result->metadata->document->title"
);
}
#[test]
fn test_accessor_r() {
let r = make_resolver();
assert_eq!(r.accessor("title", "r", "result"), "result$metadata$document$title");
}
#[test]
fn test_accessor_c() {
let r = make_resolver();
assert_eq!(
r.accessor("title", "c", "result"),
"result_metadata_document_title(result)"
);
}
#[test]
fn test_rust_unwrap_binding() {
let r = make_resolver();
let (binding, var) = r.rust_unwrap_binding("title", "result").unwrap();
assert_eq!(var, "metadata_document_title");
assert!(binding.contains("as_deref().unwrap_or(\"\")"));
}
#[test]
fn test_rust_unwrap_binding_non_optional() {
let r = make_resolver();
assert!(r.rust_unwrap_binding("content", "result").is_none());
}
#[test]
fn test_direct_field_no_alias() {
let r = make_resolver();
assert_eq!(r.accessor("content", "rust", "result"), "result.content");
assert_eq!(r.accessor("content", "go", "result"), "result.Content");
}
#[test]
fn test_accessor_rust_with_optionals() {
let r = make_resolver_with_doc_optional();
assert_eq!(
r.accessor("title", "rust", "result"),
"result.metadata.document.as_ref().unwrap().title"
);
}
#[test]
fn test_accessor_csharp_with_optionals() {
let r = make_resolver_with_doc_optional();
assert_eq!(
r.accessor("title", "csharp", "result"),
"result.Metadata.Document!.Title"
);
}
#[test]
fn test_accessor_rust_non_optional_field() {
let r = make_resolver();
assert_eq!(r.accessor("content", "rust", "result"), "result.content");
}
#[test]
fn test_accessor_csharp_non_optional_field() {
let r = make_resolver();
assert_eq!(r.accessor("content", "csharp", "result"), "result.Content");
}
}