Mumbler 开源项目安装与使用指南

Mumbler 开源项目安装与使用指南

mumbler My experimental programming language using Truffle 项目地址: https://gitcode.com/gh_mirrors/mu/mumbler

项目概述

Mumbler 是一个实验性的编程语言，它利用了 Truffle 框架，旨在探索在 JVM 上使用 Graal JIT 编译器的可能性。此项目灵感来自 Scheme，但其特性和内置函数远比 Scheme 简单。

项目目录结构及介绍

Mumbler 的项目结构大致如下：

• lang: 包含核心语言实现的代码。
• test: 测试脚本存放目录，用于测试不同的语言特性。
• benchmark: 性能测试脚本和相关数据。
• .gitignore: 忽略不需要提交到版本控制的文件列表。
• LICENSE: 使用的许可证信息，遵循 GPL-3.0 许可。
• README.org: 原始的项目说明文档（非 Markdown 格式）。
• org/README.md: 可能是项目组织结构或额外说明的 Markdown 文档，但未在引用中明确指出具体用途。

项目的启动文件介绍

Mumbler 的运行依赖于特殊版本的 JVM，特别是 GraalVM，并且最低要求版本为 19.3 或更高。启动 Mumbler 的主要入口点是在构建后的 bin 目录下，具体命令示例如下：

JAVA_HOME=<graal-vm-dir> $[MUMBLER_REPO]/lang/build/install/mumbler/bin/mumbler

这里，<graal-vm-dir> 需要替换为你 GraalVM 的实际路径，而 $[MUMBLER_REPO] 表示项目克隆后的根目录。

项目的配置文件介绍

Mumbler 本身并不强调外部配置文件的概念，其运行和配置主要通过环境变量和命令行参数来完成：

• 环境变量:
  • JAVA_HOME: 指向 GraalVM 的目录，以确保使用该JVM获取性能优势。
  • MUMBLER_HOME: 指向 Gradle 构建并安装 Mumbler 的路径，通常位于 $[MUMBLER_REPO]/lang/build/install/mumbler，用于直接访问二进制文件和资源。

虽然没有传统意义上的配置文件，但是这些环境变量设置对于正确运行 Mumbler 至关重要。此外，通过 Gradle 构建系统，可以使用命令行参数进一步调整编译和运行时的行为，比如禁用尾递归优化等。

结论

使用 Mumbler 涉及下载项目源码、配置必要的环境（尤其是 GraalVM），以及通过 Gradle 进行构建和启动。虽然配置不是通过传统的配置文件进行，而是依赖于环境变量和命令行参数，但这保证了项目的轻量级和灵活性。理解并适当设置这些环境变量，对于成功运行和测试 Mumbler 至关重要。

mumbler My experimental programming language using Truffle 项目地址: https://gitcode.com/gh_mirrors/mu/mumbler