version: "1.0.1" name: cairo-modules-files description: Explain how Cairo modules are split across files and folders, and how mod declarations map to files; use when a request involves organizing modules into multiple files in Cairo.
Cairo Modules in Files
Overview
Explain how module declarations map to files and folders in a Cairo package.
Quick Use
- Read
references/modules-files.md before answering. - Show the relationship between
mod declarations and file names. - Remind that
use does not load modules; only mod does.
Response Checklist
- Declare a module with
mod name; in the parent file. - Place the module body in
name.cairo or name/mod.cairo. - Declare submodules in the module file and place them in
name/submodule.cairo.
Example Requests
- "Where should I put
mod hosting;?" - "How do I split a module into multiple files?"
- "Why doesn't
use load my module?"
Cairo by Example