Ещё один блог о разработке программного обеспечения. Zola 2024-12-13T00:00:00+00:00 https://bshn.rs/ru/categories/architecture/atom.xml 2024-12-13T00:00:00+00:00 2024-12-13T00:00:00+00:00 Nikita Bishonen https://bshn.rs/ru/blog/2024-12-13-rust-micro-structure/ <p>Привет! Сегодня я делюсь своими мыслями об удобной мне структуре проекта при разработке микросервисов на расте. Это первый пост из возможной серии “Микросервисы на Расте”. Если я смогу её закончить, то оформлю целую книгу, так что если вы заметили неточность или у вас есть своим мысли по теме поста - буду рад если вы поделитесь ими со мной. Начну этот пост с небольшой ликвидации безграмотности. Если вы уверены в своих знаниях системы пакетов и модулей в Rust, то смело прыгайте к <a href="https://bshn.rs/ru/blog/2024-12-13-rust-micro-structure/#%D1%81%D0%BE%D0%B2%D0%BC">сути</a>.</p> <h2 id="pakety-kreity-i-moduli-v-rast"><a class="zola-anchor" href="#pakety-kreity-i-moduli-v-rast" aria-label="Anchor link for: pakety-kreity-i-moduli-v-rast"><i class="icon"></i></a> Пакеты, крейты и модули в Раст</h2> <blockquote> <p>Если вы не знакомы с Раст, то рекомендую перед дальнейшим прочтением изучить первоисточник - главу <a rel="external" href="https://doc.rust-lang.org/book/ch07-00-managing-growing-projects-with-packages-crates-and-modules.html">Managing Growing Projects with Packages, Crates and Modules</a> в официальной документации Раст. Далее я излагаю свой персказ, который может оказаться неточным или неполным.</p> </blockquote> <p>Итак, в Раст проектах мы имеем:</p> <ul> <li>Пакет содержащий: <ul> <li><code>Cargo(.toml | .lock)</code></li> <li>Один или множество крейтов, каждый из которых имеет: <ul> <li>Корень крейта - <code>src/(lib.rs | main.rs | bin/*.rs)</code></li> <li>Модули <ul> <li>встроенные - <code>mod _name_ { _body }</code></li> <li>отдельными файлами - <code>mod _name_;</code> + <code>src/(_name_.rs | _name_/mod.rs)</code> Получается такая матрёшка или сказка о Кощее Бессмертном - Игла (модуль) в яйце, яйцо (крейт) в курице, курица (пакет) в сундуке (проекте).</li> </ul> </li> </ul> </li> </ul> </li> </ul> <p><img src="/images/2024_12_13_rust_micro_structure_01.png" alt="Пакеты в Раст" loading="lazy" decoding="async" /></p> <p>Давайте же разбираться какие есть правила доступа к модулям.</p> <ol> <li>Модули могут быть частными (скрытыми) и публичными. <ol> <li>По-умолчанию модули частные.</li> </ol> </li> <li>Сущности внутри модуля тоже могут быть частными и публичными. <ol> <li>По-умолчанию сущности частные.</li> </ol> </li> <li>А далее начинаются интересные взаимодействия и комбинации, которые предлагаю рассмотреть на примере кода.</li> </ol> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#C6D0F5, #565869); background-color: light-dark(#303446, #FAFBFC);"><code data-lang="rust"><span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);">mod</span><span style="color: light-dark(#EF9F76, #565869);"> parent</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> mod</span><span style="color: light-dark(#EF9F76, #565869);"> children_private</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> struct</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;"> Private</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> pub</span><span style="color: light-dark(#CA9EE6, #F767BB);"> struct</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;"> Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);"> }</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> pub</span><span style="color: light-dark(#CA9EE6, #F767BB);"> mod</span><span style="color: light-dark(#EF9F76, #565869);"> children_public</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> struct</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;"> Private</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> pub</span><span style="color: light-dark(#CA9EE6, #F767BB);"> struct</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;"> Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> mod</span><span style="color: light-dark(#EF9F76, #565869);"> grandchildren</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> struct</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;"> Private</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> pub</span><span style="color: light-dark(#CA9EE6, #F767BB);"> struct</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;"> Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);"> }</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);"> }</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);">}</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);">mod</span><span style="color: light-dark(#EF9F76, #565869);"> neighbour</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);">}</span></span></code></pre> <p>Визуально сама структура выглядит следующим образом:</p> <p><img src="/images/2024_12_13_rust_micro_structure_02.png" alt="Структура" loading="lazy" decoding="async" /></p> <p>На этом примере хочу показать вам возможные связи между модулями и сущностями (в данном примере мы ограничиваемся пустыми структурами). Разобьём это на несколько ситуацией, различать их мы будем по вызывающей стороне.</p> <h3 id=""><a class="zola-anchor" href="#" aria-label="Anchor link for: "><i class="icon"></i></a> Что может родительский модуль?</h3> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#C6D0F5, #565869); background-color: light-dark(#303446, #FAFBFC);"><code data-lang="rust"><span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);">fn</span><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;"> test_visibility</span><span style="color: light-dark(#949CBB, #ADB1C2);">(</span><span style="color: light-dark(#949CBB, #ADB1C2);">)</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> children_private::Private; // Fails due to privacy of struct</span></span> <span class="giallo-l"><span style="color: light-dark(#E5C890, #565869);"> children_private</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> children_public::Private; // Fails due to privacy of struct</span></span> <span class="giallo-l"><span style="color: light-dark(#E5C890, #565869);"> children_public</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> children_public::grandchildren::Private; // Fails due to privacy of module.</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> children_public::grandchildren::Public; // Fails due to privacy of module.</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);">}</span></span></code></pre> <p>Выше я привожу кусочек теста для родительского модуля, как мы видим, доступ имеется к обоим (частному и публичному) дочерним модулям, но только к публичным структурам. Доступа же к частным “внукам” и их публичным структурам не имеется. Визуально это выглядит следующим образом:</p> <p><img src="/images/2024_12_13_rust_micro_structure_03.png" alt="Родительский" loading="lazy" decoding="async" /></p> <h3 id="-1"><a class="zola-anchor" href="#-1" aria-label="Anchor link for: -1"><i class="icon"></i></a> Что может дочерний модуль?</h3> <p>Для этого мы сделаем дополнение и добавим в родительский модуль две структуры, по аналогии с дочерними.</p> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#C6D0F5, #565869); background-color: light-dark(#303446, #FAFBFC);"><code data-lang="rust"><span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">///</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> Test visibility of super model and another sub-models of module one level above.</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);">fn</span><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;"> test_visibility</span><span style="color: light-dark(#949CBB, #ADB1C2);">(</span><span style="color: light-dark(#949CBB, #ADB1C2);">)</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Private</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> super::children_private::Private; // Fails due to privacy of struct</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #565869);">children_private</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> self::grandchildren::Private; // Fails due to privacy of struct</span></span> <span class="giallo-l"><span style="color: light-dark(#E78284, #2DAE58);"> self</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #565869);">grandchildren</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);">}</span></span></code></pre> <p><img src="/images/2024_12_13_rust_micro_structure_04.png" alt="Дочерний" loading="lazy" decoding="async" /></p> <p>Как мы можем видеть, щупальца нашего детятки раскинулись достаточно широко и лишь частные структуры соседних и дочерних модулей им недоступны. А вот частные структуры родительского модуля вполне в зоне досягаемости.</p> <h3 id="-2"><a class="zola-anchor" href="#-2" aria-label="Anchor link for: -2"><i class="icon"></i></a> Что может правнук(чка)?</h3> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#C6D0F5, #565869); background-color: light-dark(#303446, #FAFBFC);"><code data-lang="rust"><span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">///</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> Test visibility of super model and another sub-models of module two levels above.</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);">fn</span><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;"> test_visibility</span><span style="color: light-dark(#949CBB, #ADB1C2);">(</span><span style="color: light-dark(#949CBB, #ADB1C2);">)</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Private</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> super::super::children_private::Private; // Fails due to privacy of struct</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#CA9EE6, #F767BB);">super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #565869);">children_private</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#CA9EE6, #F767BB);">super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Private</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#CA9EE6, #F767BB);">super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);">}</span></span></code></pre> <p><img src="/images/2024_12_13_rust_micro_structure_05.png" alt="Правнук" loading="lazy" decoding="async" /></p> <p>Для правнука ситуация схожая, решил показать её для лучшего понимания многоуровневой работы этого механизма в Раст.</p> <h3 id="-3"><a class="zola-anchor" href="#-3" aria-label="Anchor link for: -3"><i class="icon"></i></a> Что может сосед?</h3> <blockquote> <p>К сожалению я только на этом этапе заметил что все диаграммы до включают соседа в модуль родителя, на самом деле он конечно находится рядом, а не внутри родителя. Диаграмма ниже содержит корректное расположение этого модуля.</p> </blockquote> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#C6D0F5, #565869); background-color: light-dark(#303446, #FAFBFC);"><code data-lang="rust"><span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">///</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> Test visibilit of sub-modules inside another module on the same level.</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);">fn</span><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;"> test_visibility</span><span style="color: light-dark(#949CBB, #ADB1C2);">(</span><span style="color: light-dark(#949CBB, #ADB1C2);">)</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> crate</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #565869);">parent</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> crate::parent::Private; // Fails due to privacy of struct</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> crate::parent::children_private::Private; // Fails due to privacy of module</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> crate::parent::children_private::Public; // Fails due to privacy of module</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> crate::parent::children_public::Private; // Fails due to privacy of struct</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> crate</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #565869);">parent</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #565869);">children_public</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> crate::parent::children_public::grandchildren::Private; // Fails due to privacy of a module</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> crate::parent::children_public::grandchildren::Public; // Fails due to privacy of a module</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);">}</span></span></code></pre> <p><img src="/images/2024_12_13_rust_micro_structure_06.png" alt="Соседский" loading="lazy" decoding="async" /></p> <p>У соседа всё достаточно скучно - только публичные сущности и пути к ним являются доступными. При этом стоит заметить что модуль родителя не является публичным, при этом сосед всё равно его видит 👀</p> <h2 id="совм"><a class="zola-anchor" href="#совм" aria-label="Anchor link for: совм"><i class="icon"></i></a> СОВМ</h2> <p>Или Структура на Основе Видимости Модулей. Идеей является то, что в Расте мы имеем уже определённые правила доступа (подробнее о которых я рассказал выше) к сущностям модулей в зависимости от их взаимоотношений (кем вызывающий модуль приходится вызываемому).</p> <blockquote> <p>Я решил что и структура проекта должна быть изложена исходя из этих особенностей языка Раст, чтобы быть более идиоматичной. Идея новая и по мере её обкатывания, я буду обновлять этот пост.</p> </blockquote> <p>Чтобы получить идиоматичную структуру проекта, мы должны располагать модули на основании того, кто и что должен видеть. Является ли эта часть кода чем-то используемым во всём сервисе? Выносим её как можно выше. Является ли другая часть кода специфичной? Выделяем её в отдельную ветвь или прячем поглубже. Суть в том что модули не должны быть декомпозированы согласно бизнес доменам (по-крайней мере это не должно быть основой деления). Ведь в случае микросервисной архитектуры это должны быть не модули, а другие сервисы (ну или другие пакеты раста для монолитных приложений). Таким образом мы стремимся к заветному золотому соотношению <a rel="external" href="https://en.wikipedia.org/wiki/Larry_Constantine#Structured_design">loose coupling and high cohesion</a>.</p> <h3 id="-4"><a class="zola-anchor" href="#-4" aria-label="Anchor link for: -4"><i class="icon"></i></a> TL;DR</h3> <p>Как же я вижу использование этого подхода в написании микросервисов? Предлагаю не тратить ещё больше вашего времени на чтение моих мыслей, а посмотреть на шаблон:</p> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#C6D0F5, #565869); background-color: light-dark(#303446, #FAFBFC);"><code data-lang="rust"><span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">//</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">! This is the base service crate. Better to make it a library, so functionality regarding how</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">//</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">! exactly to run it will be stored separately inside one main.rs or different bins.</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);">mod</span><span style="color: light-dark(#EF9F76, #565869);"> interfaces</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">!</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> mod</span><span style="color: light-dark(#EF9F76, #565869);"> graphql</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">!</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);"> }</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> mod</span><span style="color: light-dark(#EF9F76, #565869);"> http</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">!</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);"> }</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> mod</span><span style="color: light-dark(#EF9F76, #565869);"> grpc</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">!</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);"> }</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);">}</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);">mod</span><span style="color: light-dark(#EF9F76, #565869);"> core</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">!</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> mod</span><span style="color: light-dark(#EF9F76, #565869);"> api</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">!</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);"> }</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> mod</span><span style="color: light-dark(#EF9F76, #565869);"> config</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">!</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);"> }</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);">}</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);">mod</span><span style="color: light-dark(#EF9F76, #565869);"> resources</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">!</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> mod</span><span style="color: light-dark(#EF9F76, #565869);"> db</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">!</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);"> }</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> mod</span><span style="color: light-dark(#EF9F76, #565869);"> kafka</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">!</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);"> }</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> mod</span><span style="color: light-dark(#EF9F76, #565869);"> third_party_integration</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">!</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);"> }</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);">}</span></span></code></pre> <p>Вы можете создать новый пакет, в котором будет два крейта:</p> <ul> <li>main отвечает лишь за запуск приложения</li> <li>lib хранит структуру и используется в main, tests (интеграционных) и в дополнительных “бинах” если потребуется</li> </ul> <h3 id="-5"><a class="zola-anchor" href="#-5" aria-label="Anchor link for: -5"><i class="icon"></i></a> Реальный пример</h3> <p>В этом примере изменены некоторые названия, но это реальная структура одного из нескольких сервисов. Собственно их написание и послужило толчком к выведению некоторой общей теории относительно структурирования микросервисов на расте.</p> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#C6D0F5, #565869); background-color: light-dark(#303446, #FAFBFC);"><code data-lang="shellscript"><span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">src</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">├──</span><span style="color: light-dark(#A6D189, #CF9C00);"> bin</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">│  </span><span style="color: light-dark(#A6D189, #CF9C00);"> └──</span><span style="color: light-dark(#A6D189, #CF9C00);"> events_processor.rs</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">├──</span><span style="color: light-dark(#A6D189, #CF9C00);"> core</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">│  </span><span style="color: light-dark(#A6D189, #CF9C00);"> ├──</span><span style="color: light-dark(#A6D189, #CF9C00);"> api.rs</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">│  </span><span style="color: light-dark(#A6D189, #CF9C00);"> ├──</span><span style="color: light-dark(#A6D189, #CF9C00);"> configuration.rs</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">│  </span><span style="color: light-dark(#A6D189, #CF9C00);"> └──</span><span style="color: light-dark(#A6D189, #CF9C00);"> mod.rs</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">├──</span><span style="color: light-dark(#A6D189, #CF9C00);"> interfaces</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">│  </span><span style="color: light-dark(#A6D189, #CF9C00);"> ├──</span><span style="color: light-dark(#A6D189, #CF9C00);"> graphql</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">│  </span><span style="color: light-dark(#A6D189, #CF9C00);"> │  </span><span style="color: light-dark(#A6D189, #CF9C00);"> ├──</span><span style="color: light-dark(#A6D189, #CF9C00);"> mod.rs</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">│  </span><span style="color: light-dark(#A6D189, #CF9C00);"> │  </span><span style="color: light-dark(#A6D189, #CF9C00);"> ├──</span><span style="color: light-dark(#A6D189, #CF9C00);"> mutations.rs</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">│  </span><span style="color: light-dark(#A6D189, #CF9C00);"> │  </span><span style="color: light-dark(#A6D189, #CF9C00);"> ├──</span><span style="color: light-dark(#A6D189, #CF9C00);"> queries.rs</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">│  </span><span style="color: light-dark(#A6D189, #CF9C00);"> │  </span><span style="color: light-dark(#A6D189, #CF9C00);"> └──</span><span style="color: light-dark(#A6D189, #CF9C00);"> subscriptions.rs</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">│  </span><span style="color: light-dark(#A6D189, #CF9C00);"> └──</span><span style="color: light-dark(#A6D189, #CF9C00);"> mod.rs</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">├──</span><span style="color: light-dark(#A6D189, #CF9C00);"> lib.rs</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">├──</span><span style="color: light-dark(#A6D189, #CF9C00);"> main.rs</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">└──</span><span style="color: light-dark(#A6D189, #CF9C00);"> resources</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;"> ├──</span><span style="color: light-dark(#A6D189, #CF9C00);"> node_proxy.rs</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;"> ├──</span><span style="color: light-dark(#A6D189, #CF9C00);"> indexer_proxy.rs</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;"> ├──</span><span style="color: light-dark(#A6D189, #CF9C00);"> db.rs</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;"> ├──</span><span style="color: light-dark(#A6D189, #CF9C00);"> mod.rs</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;"> ├──</span><span style="color: light-dark(#A6D189, #CF9C00);"> reservoir_proxy.rs</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;"> └──</span><span style="color: light-dark(#A6D189, #CF9C00);"> real_time_data_ws.rs</span></span></code></pre><h3 id="-6"><a class="zola-anchor" href="#-6" aria-label="Anchor link for: -6"><i class="icon"></i></a> Мой опыт</h3> <p>Могу сказать что эту структуру я нахожу удобной, поскольку она совмещает в себе преимущества старых добрых - трёхслойных архитектур и, применимых к микросервисам, гексогональных архитектур. Мы разделяем наше приложение на три ветви:</p> <ol> <li><code>Ресурсы</code>, сюда попадает всё, что находится вне нашего сервиса и к чему мы являемся потребителями. Базы данных, другие сервисы, брокеры сообщений (частично). Всё где мы инициируем общение и где мы знаем о собеседнике больше, чем он о нас. (Раньше я называл эту часть <code>clients</code>, но имя ресурсы мне сейчас кажется более подходящим). Основная задача ресурсов - справиться со спецификой взаимодействия с этими ресурсами. Здесь могут лежать реализации типажей кодирования и декодирования наших типов данных под определённую базу данных, также сюда пишем “прокси”, которые трансформируют схему других сервисов в ту, которой оперируем мы внутри сервиса.</li> <li><code>Интерфейсы</code>, сюда складываем всё, что является входными точками для запросов к нашему сервису. HTTP/gRPC API, GraphQL, даже брокеры сообщений, если это часть обработки входящих запросов, всё идёт сюда. Также как и ресурсы, здесь мы стараемся отсечь всю специфику связанную с конкретным механизмом взаимодействия клиентов с нами, как с сервером (поэтому раньше я называл эту часть <code>servers</code>). Например все десериализации запросов и сериализации ответов, должны быть реализованы тут. Дальше мы должны работать с “чистыми” типами.</li> <li><code>Ядро</code>, это самое “чистое” и “важное” место нашего сервиса. Здесь реализуется основная бизнес-логика. Здесь мы оперируем не пришедшим по сети JSON, а его статически типизированным и проверенным представлением. Из ядра мы можем вызывать ресурсы, но желательно ничего не знать об интерфейсах. Однако мы не должны иметь доступа к низкоуровневым концептам ресурсов. Только к публичному API.</li> </ol> <p>Как же тут помогает расположение модулей? Мы видим что все три ветки являются соседями друг-другу, значит могут знать лишь публичные вещи, а частности являются безопасными для изменения (например смена базы данных или поддержка REST бок о бок с gRPC). Внутри же ветвей мы идём от общего к частному и также разделяем независимые части на ветви. <code>graphql</code> состоит из независимых <code>queries</code>, <code>mutations</code>, <code>subscriptions</code>, но общую схему составляет в корневом модуле:</p> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#C6D0F5, #565869); background-color: light-dark(#303446, #FAFBFC);"><code data-lang="rust"><span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">//</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;">! graphql/mod.rs</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);">pub</span><span style="color: light-dark(#CA9EE6, #F767BB);"> async</span><span style="color: light-dark(#CA9EE6, #F767BB);"> fn</span><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;"> schema</span><span style="color: light-dark(#949CBB, #ADB1C2);">(</span><span style="color: light-dark(#949CBB, #ADB1C2);">)</span><span style="color: light-dark(#81C8BE, #ADB1C2);"> -&gt;</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;"> Result</span><span style="color: light-dark(#99D1DB, #ADB1C2);">&lt;</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Schema</span><span style="color: light-dark(#99D1DB, #ADB1C2);">&lt;</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Query</span><span style="color: light-dark(#949CBB, #ADB1C2);">,</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;"> Mutation</span><span style="color: light-dark(#949CBB, #ADB1C2);">,</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;"> Subscription</span><span style="color: light-dark(#99D1DB, #ADB1C2);">&gt;</span><span style="color: light-dark(#99D1DB, #ADB1C2);">&gt;</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> let</span><span> configuration</span><span style="color: light-dark(#81C8BE, #ADB1C2);"> =</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;"> Configuration</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">from_env</span><span style="color: light-dark(#949CBB, #ADB1C2);">(</span><span style="color: light-dark(#949CBB, #ADB1C2);">)</span><span style="color: light-dark(#81C8BE, #ADB1C2);">?</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> let</span><span> pool</span><span style="color: light-dark(#81C8BE, #ADB1C2);"> =</span><span style="color: light-dark(#E5C890, #565869);"> database</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">connect</span><span style="color: light-dark(#949CBB, #ADB1C2);">(</span><span style="color: light-dark(#81C8BE, #ADB1C2);">&amp;</span><span>configuration</span><span style="color: light-dark(#81C8BE, #ADB1C2);">.</span><span style="color: light-dark(#8CAAEE, #565869);">database</span><span style="color: light-dark(#949CBB, #ADB1C2);">)</span><span style="color: light-dark(#81C8BE, #ADB1C2);">.</span><span style="color: light-dark(#CA9EE6, #F767BB);">await</span><span style="color: light-dark(#81C8BE, #ADB1C2);">?</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> let</span><span> producer</span><span style="color: light-dark(#81C8BE, #ADB1C2);"> =</span><span style="color: light-dark(#E5C890, #565869);"> kafka</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">build_producer</span><span style="color: light-dark(#949CBB, #ADB1C2);">(</span><span style="color: light-dark(#81C8BE, #ADB1C2);">&amp;</span><span>configuration</span><span style="color: light-dark(#81C8BE, #ADB1C2);">.</span><span style="color: light-dark(#8CAAEE, #565869);">kafka</span><span style="color: light-dark(#949CBB, #ADB1C2);">)</span><span style="color: light-dark(#81C8BE, #ADB1C2);">?</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#E5C890, #565869);font-style: italic;"> Ok</span><span style="color: light-dark(#949CBB, #ADB1C2);">(</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Schema</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">build</span><span style="color: light-dark(#949CBB, #ADB1C2);">(</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Query</span><span style="color: light-dark(#949CBB, #ADB1C2);">,</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;"> Mutation</span><span style="color: light-dark(#949CBB, #ADB1C2);">,</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;"> Subscription</span><span style="color: light-dark(#949CBB, #ADB1C2);">)</span></span> <span class="giallo-l"><span style="color: light-dark(#81C8BE, #ADB1C2);"> .</span><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">enable_federation</span><span style="color: light-dark(#949CBB, #ADB1C2);">(</span><span style="color: light-dark(#949CBB, #ADB1C2);">)</span></span> <span class="giallo-l"><span style="color: light-dark(#81C8BE, #ADB1C2);"> .</span><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;">enable_subscription_in_federation</span><span style="color: light-dark(#949CBB, #ADB1C2);">(</span><span style="color: light-dark(#949CBB, #ADB1C2);">)</span></span> <span class="giallo-l"><span style="color: light-dark(#81C8BE, #ADB1C2);">...</span></span></code></pre> <p>При этом каждый под-модуль будет вызывать публичные “чистые” методы из <code>core/api.rs</code>. <code>api.rs</code> же в моём примере содержит общие типы в корне (как частные, так и публичные), полный доступ к которым имеют его подмодули <code>api::queries</code> и <code>api::commands</code>, но частные типы и реализации самого модуля <code>api</code> недоступны никому, кроме его подмодулей.</p> <h2 id="-7"><a class="zola-anchor" href="#-7" aria-label="Anchor link for: -7"><i class="icon"></i></a> Дополнительные материалы</h2> <p>Если вам интересно “поиграть” с примером из данной статьи, то вот полный код проекта из главы про модули:</p> <pre class="giallo" style="color-scheme: light dark; color: light-dark(#C6D0F5, #565869); background-color: light-dark(#303446, #FAFBFC);"><code data-lang="rust"><span class="giallo-l"><span style="color: light-dark(#E5C890, #ADB1C2);font-style: italic;">#</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;">!</span><span style="color: light-dark(#949CBB, #ADB1C2);">[</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;">allow</span><span style="color: light-dark(#949CBB, #ADB1C2);">(</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;">clippy</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;">all</span><span style="color: light-dark(#949CBB, #ADB1C2);">,</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;"> dead_code</span><span style="color: light-dark(#949CBB, #ADB1C2);">,</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;"> path_statements</span><span style="color: light-dark(#949CBB, #ADB1C2);">)</span><span style="color: light-dark(#949CBB, #ADB1C2);">]</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);">fn</span><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;"> main</span><span style="color: light-dark(#949CBB, #ADB1C2);">(</span><span style="color: light-dark(#949CBB, #ADB1C2);">)</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;"> println!</span><span style="color: light-dark(#949CBB, #ADB1C2);">(</span><span style="color: light-dark(#A6D189, #ADB1C2);">&quot;</span><span style="color: light-dark(#A6D189, #CF9C00);">Hello, modules privacy!</span><span style="color: light-dark(#A6D189, #ADB1C2);">&quot;</span><span style="color: light-dark(#949CBB, #ADB1C2);">)</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);">}</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);">mod</span><span style="color: light-dark(#EF9F76, #565869);"> parent</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> struct</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;"> Private</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> pub</span><span style="color: light-dark(#CA9EE6, #F767BB);"> struct</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;"> Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> mod</span><span style="color: light-dark(#EF9F76, #565869);"> children_private</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> struct</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;"> Private</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> pub</span><span style="color: light-dark(#CA9EE6, #F767BB);"> struct</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;"> Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);"> }</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> pub</span><span style="color: light-dark(#CA9EE6, #F767BB);"> mod</span><span style="color: light-dark(#EF9F76, #565869);"> children_public</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> struct</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;"> Private</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> pub</span><span style="color: light-dark(#CA9EE6, #F767BB);"> struct</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;"> Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> mod</span><span style="color: light-dark(#EF9F76, #565869);"> grandchildren</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> struct</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;"> Private</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> pub</span><span style="color: light-dark(#CA9EE6, #F767BB);"> struct</span><span style="color: light-dark(#E5C890, #565869);font-style: italic;"> Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> ///</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> Test visibility of super model and another sub-models of module two levels above.</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> fn</span><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;"> test_visibility</span><span style="color: light-dark(#949CBB, #ADB1C2);">(</span><span style="color: light-dark(#949CBB, #ADB1C2);">)</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Private</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> super::super::children_private::Private; // Fails due to privacy of struct</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#CA9EE6, #F767BB);">super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #565869);">children_private</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#CA9EE6, #F767BB);">super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Private</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#CA9EE6, #F767BB);">super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);"> }</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);"> }</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> ///</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> Test visibility of super model and another sub-models of module one level above.</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> fn</span><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;"> test_visibility</span><span style="color: light-dark(#949CBB, #ADB1C2);">(</span><span style="color: light-dark(#949CBB, #ADB1C2);">)</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Private</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> super::children_private::Private; // Fails due to privacy of struct</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> super</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #565869);">children_private</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> self::grandchildren::Private; // Fails due to privacy of struct</span></span> <span class="giallo-l"><span style="color: light-dark(#E78284, #2DAE58);"> self</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #565869);">grandchildren</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);"> }</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);"> }</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> ///</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> Test visibility of sub-modules inside current module.</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> fn</span><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;"> test_visibility</span><span style="color: light-dark(#949CBB, #ADB1C2);">(</span><span style="color: light-dark(#949CBB, #ADB1C2);">)</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> children_private::Private; // Fails due to privacy of struct</span></span> <span class="giallo-l"><span style="color: light-dark(#E5C890, #565869);"> children_private</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> children_public::Private; // Fails due to privacy of struct</span></span> <span class="giallo-l"><span style="color: light-dark(#E5C890, #565869);"> children_public</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> children_public::grandchildren::Private; // Fails due to privacy of module.</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> children_public::grandchildren::Public; // Fails due to privacy of module.</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);"> }</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);">}</span></span> <span class="giallo-l"></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);">mod</span><span style="color: light-dark(#EF9F76, #565869);"> neighbour</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> ///</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> Test visibilit of sub-modules inside another module on the same level.</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> fn</span><span style="color: light-dark(#8CAAEE, #09A1ED);font-style: italic;"> test_visibility</span><span style="color: light-dark(#949CBB, #ADB1C2);">(</span><span style="color: light-dark(#949CBB, #ADB1C2);">)</span><span style="color: light-dark(#949CBB, #ADB1C2);"> {</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> crate</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #565869);">parent</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> crate::parent::Private; // Fails due to privacy of struct</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> crate::parent::children_private::Private; // Fails due to privacy of module</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> crate::parent::children_private::Public; // Fails due to privacy of module</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> crate::parent::children_public::Private; // Fails due to privacy of struct</span></span> <span class="giallo-l"><span style="color: light-dark(#CA9EE6, #F767BB);"> crate</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #565869);">parent</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #565869);">children_public</span><span style="color: light-dark(#81C8BE, #ADB1C2);">::</span><span style="color: light-dark(#E5C890, #13BBB7);font-style: italic;">Public</span><span style="color: light-dark(#949CBB, #ADB1C2);">;</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> crate::parent::children_public::grandchildren::Private; // Fails due to privacy of a module</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> //</span><span style="color: light-dark(#949CBB, #ADB1C2);font-style: italic;"> crate::parent::children_public::grandchildren::Public; // Fails due to privacy of a module</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);"> }</span></span> <span class="giallo-l"><span style="color: light-dark(#949CBB, #ADB1C2);">}</span></span></code></pre>