starton v0.0.2
starton
What is it?
Barely anything at all... Just a tiny node script that expects git repos to conform to a convention. It does almost nothing but shell out to Github to clone a repo, and try to run scripts it expects to be in that repo.
Why do this?
¯\_(ツ)\_/¯
Partially to use commander
... partially because every job I've
ever been at has had an issue where every project is a little different to
get started and READMEs are sub-par or poorly maintained... I've had pretty
good success with sticking steps to get projects up and running in bash scripts.
They're easy to use without knowing much about the project and serve
as documentation for how setting up a project works.
Installation
npm install -g starton
Usage
starton makes assumptions about your project.
- That it's hosted on Github
- It has the following scripts in the root directory:
- configure - this should do things like copy configuration file templates replacing dummy values with values that will make the thing run
- build - this should do things like install dependencies and anything else required to run the project
- run - should run the project
- test - should run tests
If any of those scripts don't make sense for your project just leave an empty file by that name as a no-op.
If you have those things taken care of you can use starton as follows:
Starting a brand new project
Command: start
This command will:
1. Clone down the github project into your current working directory
2. Run the configure
script
3. Run the build
script
Example:
starton start niftyn8/starton
Configure a project
Command: configure
This should get run in the root directory of your project.
Example:
starton configure
Build a project
Command: build
This should get run in the root directory of your project.
Example:
starton build
Run a project
Command: run
This should get run in the root directory of your project.
Example:
starton run
Test a project
Command test
This should get run in the root directory of your project.
starton test
Get help
You can always run starton --help
to get some helpful output.
Contributing
- Fork it ( https://github.com/niftyn8/starton/fork )
- Create your feature branch (git checkout -b my-new-feature)
- Commit your changes (git commit -am 'Add some feature')
- Push to the branch (git push origin my-new-feature)
- Create a new Pull Request