This repository contains publicly availble Source Modules and their documentation.
Try out Source Academy here.
See the Source Modules wiki for more details.
Check out the Source Modules generated API documentation here.
- Decouple Source modules from the frontend and backend of Source Academy, as well as the implementation of Source language, enhancing the flexibility of Source modules.
- Optionally render interactive user interfaces for students to use with Source Academy to enhance their learning experience.
- Allow ease of collaboration and promotes contribution to the modules ecosystem without a steep learning curve.
| Term | Description |
|---|---|
| Module | A set of one bundle with the same name and some/no tabs. |
| Bundle | The suite of functions that are provided by the module. |
| Tab | A user interface used by the module. |
The following set of instructions explain how to clone and set up a copy of the Source Modules code repository on your local development machine. Following the steps below will create a modules directory in your local development machine and install the necessary dependencies of the project.
You will need to have a stable version of NodeJS on your local development machine. We recommend using the latest LTS version. You can use nvm (macOS/Linux) or nvm-windows to switch Node versions between different projects.
You will also need to have a package manager for your project. We recommend using a stable version of Yarn as the repository pipelines are using the Yarn package manager as well. To install the Yarn package manager through NPM, you can run the following command.
npm install -g yarn
Clone the repository on your local development machine and navigate to it using your favourite command line or shell tool.
git clone https://github.com/source-academy/modules.git
cd modules
Install all the dependencies of the project into node_modules in the root folder of your project directory.
yarn install
The following set of instructions explain how to transpile and serve the Source Modules from your local development machine's code repository. Following the steps below will transpile all the modules in your project directory into JavaScript files located in the build folder. Thereafter, you will serve all the contents of the build folder in a server on your local development machine.
To transpile the Source modules' files from src into JavaScript files in build, run the following command.
yarn run build
To start the server that serves all the contents of the build folder in the root directory of the project, run the following command. By default, running this command serves the contents of the build folder on http://localhost:8022.
yarn run serve
The following set of instructions explain how to use a local copy of the Source Academy frontend with a local copy of the Source Modules code repository. Following the steps below will configure the environment of the Source Academy frontend to use your locally served Source modules instead of the publicly available ones. Doing this will allow you to develop and modify modules without affecting the currently publicly available ones.
You will need to already have a local instance of Source Academy frontend set up. If you do not, you can follow the instructions here to setup an instance of Source Academy frontend on your local development machine.
Ensure that the environment variable REACT_APP_MODULE_BACKEND_URL in the .env file of the Source Academy frontend is configured to the URL of the Source Modules' server that you are trying to retrieve Source modules from. At the same time, make sure that the server providing the Source modules is running. By default, the local server started by running yarn run serve is on http://localhost:8022. The publicly available Source modules is currently located at https://github.com/source-academy/modules.
Upon starting the local instance of Source Academy frontend, the Source Academy playground will be connected to the Source Modules code repository.
The following set of instructions explain how to use a local copy of the Source language implementation with a local copy of the Source Modules code repository and Source Academy frontend. Following the steps below will allow you to work on your local js-slang code repository and use it with the Source Modules project and Source Academy frontend.
You will need to already have a local instance of the Source implementations set up. If you do not, you can follow the instructions here to setup an instance of the Source implementations on your local development machine.
Follow the instructions highlighted here to build and link your local instance of Source implementations with your local instance of the Source Academy frontend.
Follow the instructions to setup the Source Modules code repository with Source Academy frontend highlighted in the above section as per normal to use your local js-slang with your local cadet-frontend and Source Modules code repository.
Please refer to the Source Modules Development Guide located in the Source Modules Wiki here for more information regarding how to create your own Source Module including its own bundle and tab.
All JavaScript programs in this repository are licensed under the Apache License 2.0.