Guides

These guides take a small project from source to a working result. Each assumes that you have installed i, can run a project with i.toml, and have read the tour. Use the tour for language concepts; use a guide when you have a task to finish.

• CLI builds and tests a command with arguments, options, help, and logging; it assumes functions and branches, services and errors, and a checkout containing std/.
• Files writes, reads, and removes a file and handles a missing path; it assumes values and data, services and errors, and permission to write in the project directory.
• HTTP service serves JSON over a local socket and tests the same handler without networking; it assumes services and errors, concurrency, std/, and curl.
• Testing adds unit tests, generated cases, and a fake service to a project; it assumes functions and branches, services and errors, and std/.
• Packaging builds a native executable or Wasm module and explains dependency integrity; it assumes packages and a working compiler.
• JS and WASI interop runs a built module in a WASI runtime and loads a host module from JavaScript; it assumes packaging, the repository checkout, Node.js with the required Wasm features, and Wasmtime for the Wasmtime command.

Examples that use std show a path dependency on the checkout. Keep the example project beside std/, or change the path in its manifest. i/… modules come with the compiler.

See alsoCopy Anchor Link

Read the package file, §2.6 for project configuration. Start with CLI, or choose the task you need above.