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

Follow me on Twitter and LinkedIn for more information

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

About Author

COMENTARIOS

ETIQUETAS

ESTE ARTÍCULO FUE PRESENTADO EN

Related Stories

Toque para ganar: Telegram puede incorporar a los próximos 10 mil millones de usuarios de criptomonedas antes de Solana

Crecimiento de las criptomonedas: creación de perfiles de usuarios eficaces

¿Quieres ganar un concurso de redacción de HackerNoon? Esto es lo que recomiendan los ganadores del concurso #crypto-api

Liberando el poder de la IA. Una revisión sistemática de técnicas de vanguardia: resumen e introducción

Toque para ganar: Telegram puede incorporar a los próximos 10 mil millones de usuarios de criptomonedas antes de Solana

Crecimiento de las criptomonedas: creación de perfiles de usuarios eficaces

¿Quieres ganar un concurso de redacción de HackerNoon? Esto es lo que recomiendan los ganadores del concurso #crypto-api

Liberando el poder de la IA. Una revisión sistemática de técnicas de vanguardia: resumen e introducción

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps