Before you get started, there are a few dependencies that you will need to make sure you have installed before contributing toToyNet.
Getting Started with ToyNet Frontend Development
toynet-react is ToyNet's frontend service and is written in React using Typescript. To get started with local development make sure that you have the correct dependencies installed as listed above.
If you are not a not a member on Project Reclass' GitHub organization, you will first need to fork the toynet-react repository.
To fork the repository, you will need to go to the repo and click the "fork" button in the top right. You will use this new repository to make pull requests against the main Project Reclass repository.
Update the proxy field of the package.json to be https://toynet.projectreclass.org
If using something like gitpod set export DANGEROUSLY_DISABLE_HOST_CHECK=true before running npm start
Start the development server with npm run start
This will start up the development server. This server includes hot reloading so any changes made to the application will cause a re-build and will refresh your browser.
Additional Scripts
There are several npm scripts that can be used in your development that can be ran with npm run [script]
"start": "", // starts the development server
"start:dev": "", // starts the dev server and docker services
"build": "", // builds the project
"check-types": "", // runs the typescript compiler to check TS types
"style:check": "", // runs the linter
"style:fix": "", //
"start:docker:dev": "", // runs docker-compose -f docker-compose.dev.yml up --build
"test": "", // runs the unit testing suite
"test:cy": "" // runs in the integration test suite
Getting Started with ToyNet Backend Development
toynet-flask is ToyNet's backend service and is written in Python. To get started with local development make sure that you have the correct dependencies installed as listed above.
From there, make sure to build the toynet docker image from toynet_mininet and tag it with the same tag you use in the below environment variable for TOYNET_IMAGE_TAG. First you will need to download mininet. You can do this by initializing the submodule.
cd toynet_mininet
$ git submodule update --init --recursive
You will then need to build the image. The default way, which will work with the Makefile here, is to go into the toynet_mininet submodule and run:
$ make test-image
if you want a test image. If you want a production image then run:
$ make prod-image
also in the toynet_mininet directory.
Note: See the toynet_mininet README for more information on building and developing toynet_mininet.
Run the service
Make sure that, if you are testing anything related to sessions or network emulation, that you build the appropriate image (dev or prod) in toynet-mininet.
The following tutorial applies to Linux / MacOS development environments. Visit Windows documentation here.
# populate environment variables for testing
$ source instances/env-dev
# Populate environment variables for production
$ source instances/env-prod
# creates instance/toynet.sqlite
$ flask init-db
Initialized the database.
$ flask run
* Serving Flask app "flasksrc" (lazy loading)
* Environment: development
* Debug mode: on
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
* Restarting with stat
* Debugger is active!
* Debugger PIN: 220-725-712
Go to: http://127.0.0.1:5000/
Makefile
The Makefile facilitates common workflows, run make help for detailed instructions. You can use it to run everything in Docker containers, as opposed to running Flask locally as described above.
Swagger API Documentation
Visit swagger documentation to generate living documentation about available API endpoints alongside your flask instance.
Test the Service
Visit testing documentation to learn how to unit test, run manual tests in development, and query SQLite files.
