Mach VS Code Extension
Official editor support for the Mach programming language.
About Mach
Mach is a statically typed, compiled systems language with explicit control over data layout and resource management. The language emphasizes:
- Explicit control - No implicit heap allocation, lifetime management, or type coercion
- Predictable semantics - Well-defined types and compile-time error checking
- C interoperability - Data layout and calling conventions align with the platform C ABI
- Minimal core - Small, orthogonal feature set that composes well
For the complete language specification, see the doc/language/ directory in the mach repository (grammar.md is the authoritative syntax reference).
Features
- Syntax highlighting kept in sync with the current compiler keywords, intrinsics, and operators
- Support for current Mach syntax including:
- Records (
rec) and unions (uni)
- Generic types and functions with
[T] bracket syntax
- Method definitions using
Type.method syntax
- Comptime directives and
$if/$or chains, $-intrinsics ($size_of, $assert, ...), and $mach.* reads
- Value (
::) and bit-reinterpret (:~) casts, address-of (?) / dereference (@) operators
- Inline assembly blocks (
asm <isa> { ... })
- Variadic functions (
...)
- Line comments with
# including toggle/comment actions
- Bracket, brace, and quote auto-closing/surrounding pairs aligned with the Mach parser
Getting Started
- Install the extension from the Marketplace or install a packaged
.vsix in VS Code
- Open a
.mach source file - syntax highlighting and comment toggling work out-of-the-box
- Pair with the
mach compiler from the mach repository
Contributing
- Report syntax gaps or highlighting bugs in the mach-vscode repository
- For language design issues, see the main mach repository
- When publishing, remember to bump the version in
package.json and run:
npx @vscode/vsce publish
The Mach language is under active development; changes may occur as the language evolves toward self-hosting.
| |
