acs 0.1.0

Description:

acs 0.1.0

NOTE: NOT FOR PRODUCTION USE
Please note these scripts are intended to allow experimentation with
Azure Container Service. They are not intended for production use.
A set of convenience scripts for creating and testing ACS
clusters. These scripts can also be helpful in working out how to use
the REST API interfaces for managing applicaitons on an ACS cluster.
# Usage
See the [documentation](http://rgardler.github.io/acs-cli).
# Development
## Prerequisites



Python 3

apt-get install python




[PIP](https://pip.pypa.io/en/stable/installing/)
Azure CLI installed and configured to access the test subscription
* install Node and NPM
* sudo npm install azure-cli -g


## Preparing
To install all libraries and development dependencies:
` sudo pip install -e . sudo pip install -e .[test] `
## General Use
You can use acs –help for basic help, or see the
[documentation](http://rgardler.github.com/acs-cli).
# Developing
## Adding a command
To add a top level command representing a new feature follow the
these steps (in this example the new command is called Foo:


Add the command foo and its description to the “Commands” section of the docstring for acs/cli.py
Copy acs/commands/command.tmpl to acs/commands/foo.py
* Add the subcommands and options to the docstring of the foo.py file
* Implement each command in a method using the same name as the command
Add foo.py import to acs/commands/__init__.py
Copy tests/command/test_command.tmpl to test/command/test_foo.py
* Implement the tests
Run the tests with python setup.py test and iterate as necessary
Install the package with python setup.py install


## Adding a subcommand
Subcommands are applied to commands, to add a subcommand do the following:


Add the subcommand to the docstring of the relevant command class (e.g. foo.bar)
Add a method with the same name as the subcommand
Add a test
Run the tests with python setup.py test and iterate as necessary
Install the package with python setup.py install


## Testing
Run tests using [py.test:](http://pytest.org/latest) and [coverage](https://pypi.python.org/pypi/pytest-cov):
` python setup.py test `
Note, by default this does not run the slow tests (like creating the
cluster and installing features. You must therefore first have run the full suite of tests at least once. You can do this with:
` py.test --runslow `
## Releasing
Cut a release and publish to the [Python Package
Index](https://pypi.python.org/pypi) install install
[twine](http://pypi.python.org/pypi/twine. and then run:
` python setup.py sdist bdist_wheel twine upload dist/* `
This will build both a surce tarball and a wheel build, which will run
on all platforms.
### Updating Documentation
To build and pucblish the documentsation:
` cd docs make gh-pages cd .. `