splootcode 的安装和配置教程

1. 项目基础介绍和主要编程语言

splootcode 是一个旨在降低编程入门难度的编码环境。它提供了一个无限制的 Python 实现方式，并使用键盘和自动完成功能来实现快速、简单的代码编辑。splootcode 能够提供连续的运行时反馈，无需逐步调试器，帮助用户避免语法错误和其他常见编程错误。该项目的主要编程语言是 TypeScript 和 Python。

2. 项目使用的关键技术和框架

splootcode 利用 Pyodide（将 CPython 编译为 WebAssembly 的技术）在浏览器中运行 Python。这使得用户可以在浏览器中直接编写和运行 Python 代码，无需安装额外的运行环境。项目还使用了以下技术和框架：

• Vite：作为构建工具，用于快速开发和构建前端项目。
• React：用于构建用户界面。
• Jest：用于进行单元测试。
• yarn：作为依赖管理工具。

3. 项目安装和配置的准备工作及详细安装步骤

准备工作

在开始安装 splootcode 之前，请确保您的系统中已安装以下工具：

• Python
• nodejs
• yarn

安装步骤

1. 克隆项目仓库：

   打开命令行工具，执行以下命令以克隆项目仓库：

   git clone https://github.com/SplootCode/splootcode.git
   cd splootcode
   

2. 安装依赖：

   在项目根目录下，执行以下命令安装项目依赖：

   yarn install
   

3. 生成类型信息：

   为了生成内置变量和函数的类型信息，执行以下命令（需要 Python 3.8 或更高版本）：

   yarn generate-types
   

4. 构建项目：

   构建项目的 Yarn 工作空间包：

   yarn build:packages
   

5. 启动开发服务器：

   在一个终端窗口中，启动主编辑器的开发服务器：

   yarn start
   

   在另一个终端窗口中，启动运行时 iframe 的服务器：

   yarn start-frame
   

6. 访问应用：

   打开浏览器，访问 http://localhost:3000。运行时 iframe 将自动加载，并通过 postMessage 与主编辑器通信。

注意： 必须在浏览器地址栏中输入 localhost 而不是 127.0.0.1 来打开主应用，否则运行时 iframe 将不断重载。

以上步骤完成后，您应该能够看到 splootcode 的编辑环境，并开始编写和运行 Python 代码。