https://github.com/deluan/grails.sh

Bash script for selecting and calling the correct Grails version when you have more than one version installed
https://github.com/deluan/grails.sh

Last synced: 3 months ago
JSON representation

Bash script for selecting and calling the correct Grails version when you have more than one version installed

• Host: GitHub
• URL: https://github.com/deluan/grails.sh
• Owner: deluan
• Created: 2010-07-13T23:59:19.000Z (over 14 years ago)
• Default Branch: master
• Last Pushed: 2015-12-30T09:12:28.000Z (about 9 years ago)
• Last Synced: 2024-05-01T18:51:07.028Z (9 months ago)
• Language: Shell
• Homepage:
• Size: 14.6 KB
• Stars: 28
• Watchers: 4
• Forks: 8
• Open Issues: 4
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
Prerequisites

-------------

* All your Grails versions must be installed under the same base directory. Ex:

        /opt/grails-1.0.3

        /opt/grails-1.1.1

        /opt/grails-2.1.0.RC1

* `GRAILS_HOME` environment variable must be set and point to your "default" Grails installation

* cURL and unzip (If you want it to automatically pull missing versions)

* This script was tested on Mac OS X (Lion), but should work fine on Linux and Windows (with cygwin)

Installation

------------

* Download the script: http://github.com/deluan/grails.sh/raw/master/grails

* Include the folder where it is installed in your `PATH`. 

* Exclude `$GRAILS_HOME/bin` from your `PATH`

Usage

-----

Using the script is as transparent as possible:

* If you invoke it from a project folder, it will detect the version used by the project and call the correct grails

	* If the required version does not exist locally, the script will attempt to download the version specified from grails amazon mirror

* If you invoke it from any other folder that does not contain a Grails project, it will call the "default" Grails installation

* If you want to call a specific Grails version (i.e. when doing an upgrade) you can specify the version you want in the first parameter. 

	* If the version you specified does not exist locally, it will also attempt to download the version specified. Ex:

 

        $ grails 2.2.3 upgrade

* It tries to determine the command to run based on its name, so you can create symlinks for it to use the `grails-debug` command, or use it with Griffon. It should also work with any other tool that uses the same installation structure than Grails (like Groovy, Gradle)