Skip to content
🤖 Create starter code for all different environments
Ruby Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


radon is part of the periodic collection of apps. If you install periodic-cli, radon should come with it:

$ gem install periodic-cli

Or install just the gem:

$ gem install radon


The basic usage is as follows: radon [environment] {ProjectName}.

A full list of supported environments can be found by running radon --list-env


Here is radon generating a gradle project called MyGradleProject

$ radon gradle MyGradleProject
Creating project under /mnt/c/Users/Carter/Desktop/projects/MyGradleProject
  create MyGradleProject
  create MyGradleProject/.gradle/
  create MyGradleProject/.gradle/4.5/
  create MyGradleProject/.gradle/4.5/fileChanges/
  create MyGradleProject/.gradle/4.5/fileChanges/last-build.bin
  create MyGradleProject/.gradle/4.5/fileHashes/
  create MyGradleProject/.gradle/4.5/fileHashes/fileHashes.bin
  create MyGradleProject/.gradle/4.5/fileHashes/fileHashes.lock
  create MyGradleProject/.gradle/4.5/taskHistory/
  create MyGradleProject/.gradle/4.5/taskHistory/taskHistory.bin
  create MyGradleProject/.gradle/4.5/taskHistory/taskHistory.lock
  create MyGradleProject/.gradle/buildOutputCleanup/
  create MyGradleProject/.gradle/buildOutputCleanup/buildOutputCleanup.lock
  create MyGradleProject/.gradle/buildOutputCleanup/
  create MyGradleProject/.gradle/buildOutputCleanup/outputFiles.bin
  create MyGradleProject/build.gradle
  create MyGradleProject/gradle/
  create MyGradleProject/gradle/wrapper/
  create MyGradleProject/gradle/wrapper/gradle-wrapper.jar
  create MyGradleProject/gradle/wrapper/
  create MyGradleProject/gradlew
  create MyGradleProject/gradlew.bat
  create MyGradleProject/settings.gradle
  create MyGradleProject/src/
  create MyGradleProject/src/main/
  create MyGradleProject/src/main/java/
  create MyGradleProject/src/main/test/
Done! Your project is set up in /mnt/c/Users/Carter/Desktop/projects/MyGradleProject.

Supported Environments

As of v0.1.7, the current supported environments are:

  • Gradle
  • Java
  • Maven
  • Python
  • C
  • Ruby
  • Crystal
  • Go (simple)
  • Website


Adding an environment

If you want to add an environment to radon, here are the steps:

  1. Create the standard directory structure of that environment. This is usually found on the environment's website or just through convention.
  2. Zip all the files into one file (zip -r .)
  3. Save the zip data as base64 (cat | base64 -w 0 > env.b64)
  4. Put both the base64 data and the zip file in radon's /data folder.
  5. Add the function(s) in extract.rb to extract the zip file to the target (See here)
  6. Add the environments to @@all in environments.rb
  7. Open a pull request

If the environment requires a project name (eg. ruby class name or file-names) you can put these token identifiers to be replaced during project creation:

Identifier Meaning
{{NAME}} The dash-seperated project name (eg. my-cool-project)
{{CAPSNAME}} The capitalized project name (eg. MyCoolProject)
{{EMAIL}} The email of the user
{{GHNAME}} The GitHub username of the user


Bug reports and pull requests are welcome on GitHub at This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.


The gem is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the Radon project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.

You can’t perform that action at this time.