parse-dev
v0.0.5-6.4
Published
A Parse Cloud local dev environment
Downloads
5
Readme
parse-develop
Develop your parse powered webapps locally
##Installation
Install globally for availabilty system wide
#####With npm
npm install parse-develop -g
#####From source:
clone the repo in your favorite place:
git clone git://github.com/flovilmart/parse-develop.git
cd parse-develop
npm install -g
That will install the local parse environment wrapper in the parse-develop directory
##Prepare your environment:
export PARSE_JAVASCRIPT_KEY="myJSKey...." export PARSE_MASTER_KEY="mymasterKey...."
###Limitations: As you know, Parse provide hooks (beforeSave, afterSave, beforeDelete, afterDelete) and define functions.
Those functions have to be uploaded to the Parse servers using parse deploy
or parse develop
.
Updating those functions locally without publishing your code to parse have no effect!
##How to use
From your parse cloud app folder,
instead of running parse develop [app name]
, your can now run parse-develop [app name]
or parsedev [app name]
app name is optional
Happy parsing!
##Supported parse-provided cloud modules
- applinks
- mailgun
- mandrill
- sendgrid
- stripe
- parse-image
- twilio
##Custom Configuration
Overriding the default configuration is at your own risks and may render your installation unstable, please use with care!
It is possible to change the behavior of forever monitor through a rc file (we use the rc module).
The appname for rc is parsedev
Visit RC Standards for more informations
All parameters of forever-monitor are available for configuration but some are automatically overriden (otherwise the whole app doesn't work)
The parameters from forever-monitor that can't be changed are:
options, env, sourceDir, watchDirectory
Even if watchDirectory
can't be overriden, you can disable watch
by setting watch=false
If you set debug=1
, that will override the command parameter to node --debug
, it has the same effect as command="node --debug"
The default options for are:
{
// Forever monitor options
max: 1,
command: "node",
spawnWith: {
customFds: [-1, -1, -1], // that forever spawns.
setsid: false
},
watch:true,
minUptime: 1000,
spinSleepTime: 500,
// expressjs port
port: 3000
}
##Change Log
#####0.0.50 Adds support for all Parse Cloud modules provided by parse
Base modules
- express (custom version)
- ejs
- moment
- buffer
- http
- jade
- underscore
Custom Cloud modules
- applinks
- mailgun
- mandrill
- sendgrid
- stripe
- parse-image
- twilio
Removes necessity to pass a port to app.listen
Removes necessity to add your public cloud directory
#####0.0.32
Adds mailgun and mandrill cloud modules
#####0.0.31
Adds applinks-metatag module for AppLinks
Use require for synchronous configuration reading
#####0.0.30
Changes to forever-monitor (recommended behavior) Adds parsedev command (for simplicity sake) Adds configuration for forever-monitor with rc (appname is parsedev)
#####0.0.20 Add Windows Support!
Fixes crazy restart loops when addr in use
Improves overall performance
#####0.0.15 Removes dependency on parse
Adds dependency on parse-cloud-additions
Improves path handling for non *NIX machines
#####0.0.13 Adds prefer global directive
Removes unused code
#####0.0.12 Reverts parse-stripe dependency to full git url
Adds which as a dependency for forever full path
#####0.0.11 Set the DEBUG environment variable to start the process node --debug so you can use node-inspector or any other debugger!
Displays the PID upon launch
#####0.0.10 Improves forever restarting craziness
Adds sanity check of the configuration file before starting forever
Improves reliability
!! Don't seem to be able to find the views when launched outside of the parse folder
#####0.0.9: Adds npm for all parse-* modules instead of git
Moves stripe-node fork to flovilmart/parse-stripe
#####0.0.8: Adds npm for parse-image instead of git
#####0.0.5: Changes for NPM to parse-develop
#####0.0.4: Adds support for parse-image
#####0.0.2:
Ability to install system wide
#####0.0.1:
Proof of concept