{"id":21526921,"url":"https://github.com/lambdaclass/austral.rs","last_synced_at":"2025-04-09T23:34:17.821Z","repository":{"id":214502969,"uuid":"734763656","full_name":"lambdaclass/austral.rs","owner":"lambdaclass","description":"An implementation of the Austral language compiler in Rust","archived":false,"fork":false,"pushed_at":"2024-04-25T21:51:02.000Z","size":133,"stargazers_count":14,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-04-25T23:45:10.763Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lambdaclass.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2023-12-22T14:50:47.000Z","updated_at":"2024-04-25T21:51:06.000Z","dependencies_parsed_at":"2024-04-25T23:42:31.926Z","dependency_job_id":null,"html_url":"https://github.com/lambdaclass/austral.rs","commit_stats":null,"previous_names":["lambdaclass/austral.rs"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lambdaclass%2Faustral.rs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lambdaclass%2Faustral.rs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lambdaclass%2Faustral.rs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lambdaclass%2Faustral.rs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lambdaclass","download_url":"https://codeload.github.com/lambdaclass/austral.rs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226116398,"owners_count":17575929,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-24T01:47:13.864Z","updated_at":"2024-11-24T01:47:14.494Z","avatar_url":"https://github.com/lambdaclass.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# austral\nAn implementation of the Austral language compiler in Rust.\nAustral is a new systems programming language. It uses linear types to provide memory safety and capability-secure code.\n\n## Requisites\n- LLVM 17 with MLIR support.\n\n## Building\n\nFirst make sure you have a working installation of LLVM with MLIR support. If you are using a Mac\nyou can run:\n```bash\nbrew install llvm@17\n```\nIt will install all the required dependencies.\nTo compile the project you need to first export some environment variables.\nLook at the [env-macos.sh script](env-macos.sh) to see what is needed. Then if you are in using Mac:\n```bash\nsource env-macos.sh\n```\nAfter that, `cargo build --all` should work.\n\n## Running the CLI\n\nRun:\n\nTo compile an Austral file:\n\n```bash\ncd bin/austral_bin\ncargo r -- \u003cmodule_file\u003e\n```\n\n```bash\ncd bin/austral_bin\ncargo r -- ../../programs/examples/hello_world.aum\n./a.out\n# prints Hello world!\n```\n\nYou can also print the parsed AST and get the MLIR and LLVM representation of the program.\n\nTo see all the available options run:\n```bash\ncargo r -- --help\n```\n\n## Status\n- [x] Lexer\n- [x] Parser\n- [ ] Compilation Passes\n- [ ] Type checker\n- [x] Code generation of simple programs\n- [ ] Full code generation\n\n## Docs\n\n[OCaml code analysis](docs/ocaml_code_analysis.md)\n\n## Resources\n- https://austral-lang.org/\n- https://borretti.me/article/introducing-austral\n- https://borretti.me/article/type-systems-memory-safety\n- https://borretti.me/article/how-capabilities-work-austral\n- https://borretti.me/article/design-austral-compiler\n- https://borretti.me/article/how-australs-linear-type-checker-works\n- https://borretti.me/article/linear-types-exceptions\n- https://borretti.me/article/linear-types-safety\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flambdaclass%2Faustral.rs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flambdaclass%2Faustral.rs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flambdaclass%2Faustral.rs/lists"}