Una de las cosas que ha sido criticada por los novatos en Rust es el mecanismo de inclusión de archivos. Hace aproximadamente 2 días, dediqué alrededor de 5 horas a cómo se suponía que debía incluir un archivo al que se hacía referencia en el fondo de un árbol de directorios. Los documentos no ayudaron, ya que eran estructuras simples. Aquí le mostraré cómo puede incluir su código en diferentes partes de la aplicación, incluso cuando la estructura es compleja, y le ahorrará horas en cómo hacer esta tarea supuestamente trivial. Me referiré a rasgos, módulos, enumeraciones, funciones, estructuras como "recursos" en general. También me gustaría compartir con ustedes un video de ya que este fue el recurso que me enseñó cómo incluir correctamente los recursos. TensorProgramming "Rust 2018 - Módulos, cajas externas, submódulos, rutas y modificadores de visibilidad" de TensorProgramming - https://www.youtube.com/watch?v=U8uhW9bFm-8 Puede encontrar un repositorio de ejemplo aquí: https://github.com/superjose/rust-include-files-example No existe tal cosa como un "archivo" cuando hace referencia a su recurso. Rust no ve los archivos como archivos, pero los ve como módulos y los archivos dentro de las carpetas como submódulos. Por lo tanto, no puede simplemente hacer referencia a ellos directamente con una importación simple o un espacio de nombres perforado al estilo de JavaScript o C# y usarlos de inmediato. Necesitas crear un árbol de (Llamados barriles en el mundo JS) que exponen estos módulos a los externos y (consulte los puntos a continuación) les permiten ser descubiertos y consumidos. pub mod file_name Cómo incluir un módulo (archivo) Supongamos que tenemos la siguiente estructura (puede obtener esto del ). repositorio Y le gustaría incluir varias funciones de módulos dispersos dentro del directorio en nuestro expediente: /src/house main.rs house; welcome_home; crate::house::diner; house::bathroom::sink::wash_face; house::kitchen::prepare::food_preparation::prepare_food; () { user = ; building::lobby::arrive_lobby(); welcome_home::run(user); house::bathroom::shower::take_shower(house::bathroom::shower::ShowerTemperature::Cold); wash_face(); house::bathroom::toilet::use_toilet(); prepare_food(); diner::eat(); } building { lobby { ( ) () { ( ); } } } mod // Please, do not use hyphens as this is proven to have an // inconsistent behavior. // https://github.com/rust-lang/book/issues/1709 // https://rust-lang.github.io/rfcs/0940-hyphens-considered-harmful.html // https://stackoverflow.com/a/57535534/1057052 #[path = ] "./welcome-home.rs" mod // Includes the function directly // When using crate, you use the root directory to include everything. use use use fn main let "Jose" // https://doc.rust-lang.org/reference/visibility-and-privacy.html /** * From the docs (Link above) * * By default, everything in Rust is private, with two exceptions: * Associated items in a pub Trait are public by default; Enum * variants in a pub enum are also public by default. When an * item is declared as pub, it can be thought of as being accessible * to the outside world. */ mod pub mod pub in crate fn arrive_lobby println! "You have arrived to the lobby" Para incluir un archivo junto al archivo main.rs, simplemente especifique y el nombre del archivo (sin la extensión .rs). Por ejemplo: modo . En este caso, welcome_home no coincide con el nombre del archivo ( - esto fue para mostrar que es posible, no que deba hacerse , por lo tanto, podemos ayudar al compilador de Rust a identificarlo proporcionando una directiva #path. Entonces podemos hacer referencia en nuestro código para llamar a la función de ejecución directamente. mod welcome_home welcome-home.rs Evite el uso de guiones al nombrar todo; ) welcome_home::run() Para usar un mod que existe dentro del archivo, simplemente puede escribir su nombre como espacio de nombres y profundizar hasta el recurso que está buscando. Comprenda que si el módulo no es público, no podrá acceder a él dentro de su archivo. Consulte para obtener más información. Si desea incluir el función. Como está en el mismo archivo, solo puede y el módulo es visible. la referencia de visibilidad y privacidad de Rust arrive_lobby building::lobby::arrive_lobby Puede usar un recurso directamente especificándolo con el palabra clave. Esto significa que no necesita escribir usar la función, pero simplemente . use house::bathroom:sink::wash_face() wash_face() En caso de que se encuentra en primero cree un archivo house.rs en el directorio de nivel raíz o un archivo mod.rs en /src/house/mod.rs. Dentro especifica los nombres de las carpetas que se incluyen dentro de /src/house: . Crear un presentar en y dentro especifica los módulos (nombres de archivo sin la extensión .rs) dentro : Nota la modificador ya que esto es lo que da visibilidad fuera del archivo especificado. Luego inclúyalos en el código a través de . wash_face house::bathroom::sink::wash_face pub mod bathroom bathroom.rs /src/house/bathroom.rs /src/house/bathroom pub mod sink; pub mod shower; pub mod toilet; pub use house::bathroom::sink::wash_face Después , si escribes , le está diciendo al compilador que comience a buscar desde el directorio raíz. use crate Si hace referencia a un recurso a través de un mod y ese recurso está profundamente anidado, solo especifica el primer nivel del módulo y luego lo desglosa. Por ejemplo: en caso de función y enumeración, solo especifiqué , y luego desglosé los espacios de nombres con los dos puntos dobles (::) hasta que llegué. house::bathroom::shower::take_shower(house::bathroom::shower::ShowerTemperature::Cold) mod house Incluir archivos o módulos de otra carpeta, directorio o submódulo Esta es quizás la forma más complicada y antinatural para que todas las personas nuevas en Rust hagan referencia a módulos en otros archivos. los función es un ejemplo de una función profundamente anidada. Os animo a ver el para entender mejor cómo funciona todo. wash_face repositorio Rust debe con el nombre del directorio al que desea acceder y colocarlo junto al directorio al que desea acceder. sigue una convención: crear un archivo Luego, deberá exponer cada uno de los archivos dentro del directorio que desea que el compilador haga accesible: Ejemplo: Me gustaría acceder a los contenidos de , , y dentro de carpeta. shower.rs sink.rs toilet.rs /src/house/bathroom Primero, tendría que crear un archivo que haría visible o barril y archivos Dentro especificaría el nombre de cada uno de los archivos como módulos públicos: /src/house/bathroom.rs shower.rs, sink.rs toilet.rs shower; sink; toilet; // Contents of /src/house/bathroom.rs pub mod pub mod pub mod Entonces, necesitaría exponer esto archivo de la directorio. Para eso, necesitaría crear un archivo, que exportaría el archivo que acabo de definir ahora. bathroom.rs /src/house /src/house.rs bathroom.rs bathroom; diner; kitchen; // Contents of /src/house/mod.rs or /src/house.rs pub mod pub mod pub mod Como puedes ver hace archivo visible. Tenga en cuenta la convención: pub mod bathroom bathroom.rs pub mod file_name_without_rs_extension Debe hacer esto que desee que un módulo (archivo) sea visible para el módulo externo (directorio/carpeta). cada vez : vería en el repositorio y en la imagen de arriba que hay archivos; En versiones anteriores a Rust 2018, la única forma de que Rust descubriera estos directorios era que especificaran dentro del directorio. Nota mod.rs mod.rs Esto se volvió problemático porque si quería especificar un archivo con el mismo nombre del directorio, el compilador se confundiría. Es por eso que a partir de Rust 2018 (Busque la línea que dice en tus expediente). edition = "2018" cargo.toml En este ejemplo es lo mismo que Puede crear cualquiera de esos archivos y funcionaría. /src/house/mod.rs /src/house.rs Incluyendo otros módulos hermanos (archivos) dentro de submódulos Para incluir archivos hermanos dentro de submódulos, como /src/house/ dentro de puede acceder a lasagna.rs usando el palabra clave en su declaraciones. main_dish/lasagna.rs diner/mod.rs self use dessert; main_dish; self::main_dish::lasagna; () { lasagna::eat_lasagna(); candy = dessert::candy::Candy::new_chocolate( ); dessert::candy::eat_dessert(candy); } pub mod pub mod use // use super::diner::main_dish::lasagna; pub fn eat let 10 Por ejemplo, el código a continuación se usa para navegar relativamente a la ubicación del módulo actual y luego profundizarlo en el . main_dish::lasagna También puedes usar y eso comenzará desde el módulo principal. super Algunas cosas que debes saber: Prefiere guión bajo (caso de serpiente) sobre guiones. Estos últimos tienden a crear problemas . (1) (2) Para exponer módulos oxidados (archivos) dentro de un directorio (carpeta), debe crear una carpeta con el nombre del directorio y exportar en forma de para permitir que el compilador use el archivo. pub mod file_name_inside_folder Referencias Rust 2018: módulos, cajas externas, submódulos, rutas y modificadores de visibilidad de TensorProgramming: https://www.youtube.com/watch?v=U8uhW9bFm-8 (el mejor recurso que explica cómo incluir todo) Incluidas cajas con debate entre guiones y guiones bajos: https://github.com/rust-lang/cargo/issues/2775 https://doc.rust-lang.org/reference/visibility-and-privacy.html https://github.com/rust-lang/book/issues/1709 https://stackoverflow.com/questions/57535061/how-to-use-another-file-in-rust-module-with-hyphens-in-it- https://users.rust-lang.org/t/how-to-call-a-function-in-other-file-but-the-same-crate/15214- https://stackoverflow.com/a/26390046/1057052 https://stackoverflow.com/questions/45519176/how-do-i-use-or-import-a-local-rust-file https://stackoverflow.com/questions/26224947/how-do-i-do-a-basic-import-include-of-a-function-from-one-module-to-other-in-r

Super

YouTube

2022 - HackerNoon Contributor of the Year - Performance

2022 - HackerNoon Contributor of the Year - Typescript

Nominated for 2022 - HackerNoon Contributor of the Year - Typescript

Nominated for 2022 - HackerNoon Contributor of the Year - Performance

Este audio es producido en el idioma original de la historia!

Incluir archivos y directorios profundos en Rust

Demasiado Largo; Para Leer

Companies Mentioned

@josejaviasilis

HISTORIAS RELACIONADAS