<commit_before># cfn-sphere
A CLI tool intended to simplify AWS CloudFormation handling.

## Features
- a "stack of stacks" model to group multiple cfn stacks
- cross referencing parameters between stacks
- automatic stack dependency resolution including circular dependency detection
- write cfn templates in YAML or JSON

## HowTo
### Build

Install:

* python >= 2.6
* virtualenv
* pybuilder

Execute:

	   source my-virtualenv/bin/activate
	   pyb



### Install

ToDo<commit_msg>add simple getting started guide<commit_after># cfn-sphere
A CLI tool intended to simplify AWS CloudFormation handling.

## Features
- a "stack of stacks" model to group multiple cfn stacks
- cross referencing parameters between stacks
- automatic stack dependency resolution including circular dependency detection
- write cfn templates in YAML or JSON

## HowTo
### Build

Install:

* python >= 2.6
* virtualenv
* pybuilder

Execute:

	   source my-virtualenv/bin/activate
	   pyb


### Install

ToDo


### Getting Started Guide

#### 1. Create Application Description
Create a YAML file containing a region and some stacks in myapp-test.yml f.e.:

	region: eu-west-1
	stacks:
  		test2-vpc:
    		template: vpc.yml
  		test2-stack:
    		template: app.yml
    		parameters:
      			vpcID: "ref::test2-vpc.id"
      			
#### 2. Write your CloudFormation templates
Write your templates and configure them in your myapp-test.yml.

#### 3. Sync it
A simple command synchronizes your definition with reality!

	cf sync myapp-test.yml
{'fraction_non_alphanumeric': 0.0758575197889182, 'fraction_numerical': 0.007255936675461741, 'mean_word_length': 3.596969696969697, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 5, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5334597', 'n_tokens_mistral': 477, 'n_tokens_neox': 433, 'n_words': 173}