Десериализовать файл с помощью serde_json во время компиляции

Это просто, но приводит к некоторым потенциальным проблемам. Во-первых, нам нужно кое-что разобраться: хотим ли мы загрузить дерево объектов из файла или проанализировать его во время выполнения?

В 99% случаев людям достаточно синтаксического анализа static ref при загрузке, поэтому я дам вам это решение; В конце я укажу вам на «другую» версию, но она требует много дополнительной работы и зависит от предметной области.

Макрос (потому что это должен быть макрос), который вы ищете для включения файла во время компиляции, находится в стандартной библиотеке: _ 2_. Как следует из названия, он берет ваш файл во время компиляции и генерирует из него &'static str для использования. После этого вы можете делать с ним все, что захотите (например, анализировать).

Оттуда легко использовать lazy_static! для создания static ref для наш JSON Value (или что бы вы там ни выбрали) для каждой части программы. В вашем случае, например, это могло бы выглядеть так:

const GAME_JSON: &str = include_str!("my/file.json");

#[derive(Serialize, Deserialize, Debug)]
struct Game {
    name: String,
}

lazy_static! {
    static ref GAMES: Vec<Game> = serde_json::from_str(&GAME_JSON).unwrap();
}

При этом нужно помнить о двух вещах:

1. Это значительно приведет к увеличению размера вашего файла, поскольку &str никоим образом не сжимается. Рассмотрим gzip
2. Вам нужно будет беспокоиться об обычных проблемах, связанных с многопоточным доступом к одному и тому же static ref, но, поскольку он не изменяемый, вам действительно нужно беспокоиться только о его части.

Другой способ требует динамической генерации ваших объектов во время компиляции с использованием процедурного макроса. Как уже говорилось, я бы не рекомендовал его, если у вас действительно нет действительно высоких начальных затрат при синтаксическом анализе этого JSON; большинство людей этого не сделает, и в последний раз у меня это было, когда я имел дело с глубоко вложенными файлами JSON размером в несколько ГБ.

Крейты, на которые вы хотите обратить внимание, - это proc_macro2 и syn для генерации кода; остальное очень похоже на то, как вы бы написали обычный метод.

Когда вы десериализуете что-то во время выполнения, вы, по сути, строите некоторое представление в памяти программы из другого представления на диске. Но во время компиляции еще нет понятия «программная память» - где эти данные тоже будут десериализоваться?

Однако то, чего вы пытаетесь достичь, на самом деле возможно. Основная идея такая: чтобы создать что-то в памяти программы, вы должны написать код, который будет создавать данные. Что, если вы можете автоматически сгенерировать код на основе сериализованных данных? Это то, что делает uneval crate (отказ от ответственности: я автор, поэтому вам рекомендуется просмотреть источник, чтобы узнать, сможете ли вы сделать лучше).

Чтобы использовать этот подход, вам нужно создать build.rs примерно со следующим содержанием:

// somehow include the Games struct with its Serialize and Deserialize implementations
fn main() {
    let games: Games = serde_json::from_str(include_str!("data/games.json")).unwrap();
    uneval::to_out_dir(games, "games.rs");
}

И в вашем коде инициализации у вас будет следующее:

let data: Games = include!(concat!(env!("OUT_DIR"), "/games.rs"));

Обратите внимание, однако, что это может быть довольно сложно сделать с точки зрения эргономики, поскольку необходимые определения структур теперь должны совместно использоваться build.rs и самим ящиком, как я упоминал в комментарии. Было бы немного проще, если бы вы разделили свой ящик на две части, сохранив определения структур (и только их) в одном ящике, а логику, которая их использует, - в другом. Есть и другие способы - с помощью include! обмана или использования того факта, что сценарий сборки является обычным двоичным файлом Rust и может включать в себя также другие модули, - но это еще больше усложнит ситуацию.