tfw 0.1.10 → 0.1.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 564a30312f85719c7709db1a07e4acf5b74e1c03849c0f0f7398cb38784e77cc
-  data.tar.gz: 2954fcfc65533e10ddcbd31025aaa3a08881989762735071f1c436aa3606eb50
+  metadata.gz: 0db3357d383025ad106278eba178bf1055488261573a5a0428f4e99718d39e0e
+  data.tar.gz: 8d9c8bae4f4e2ac13d9f75c056c4ff8ae146eeb112b572457fb441f68c886155
 SHA512:
-  metadata.gz: 0de1ff45b8df4470729d0b10a0e7a6ca09194e2e5af6f396cd9fd6808cf1e22077f22849aa8ebec6fd552905dbf157b5b90dfa6d739e309f73d38dea10c7b50d
-  data.tar.gz: adb59b8a1613d64813d7cdcbe58e21febc89688853c4f826f818954dc75e0bc4c18bde42c6ef220f5f7ea103ee6918d6a27ed4af0f1215f2356d4736e5630552
+  metadata.gz: 82eea2e76375be89fd1f740090c54ea48699ee208b2d9b4050d1c4dadf8487a4afc372efa8f45c9a6ee459318a71d21ea23e269eac593aaae57b05b6b1e0827d
+  data.tar.gz: cfb2dbc06fcf90e9e42c9e390f398292d8e33a3eda1ea57bed271404a652dd8c67689b9fdc52a7aaf488f016e9e41cf116837cdb3f99aeacda6434664ff8926b

data/README.md

@@ -1,43 +1,69 @@
-# Tfw
+# TFW - Terraform Wrapper
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/tfw`. To experiment with that code, run `bin/console` for an interactive prompt.
+Terraform Wrapper writes terraform configuration using TFDSL (Terraform DSL for Ruby) and invokes the terraform binary. 
 
-TODO: Delete this and the text above, and describe your gem
+## Motivation (Short Version)
+
+Terraform is an excellent tool, but it lacks funcionalities like Loops and Conditionals, actually since version 0.12+ it has loops as meta-arguments which is a hacky implementation in my humble opinion. 
+
+For years I was templating terraform configuration with ERB / Jinja, that's reasonable way to avoid repetition in terraform but it's not very flexible nor reusable. 
+
+The solution was writing a tool which mimics terraform usage but writes configuration in plain Ruby. 
 
-## Installation
 
-Add this line to your application's Gemfile:
+## Usage:
 
+1. let's create a file called `foo.rb`
 ```ruby
-gem 'tfw'
+resource 'local_file', 'foo' do 
+  content 'foo'
+  filename '/tmp/foo.txt'
+end
 ```
 
-And then execute:
+2. Just like in terrraform, run init and apply
+```
+$ tfw init && tfw apply
+... <omitted output>
+An execution plan has been generated and is shown below.
+Resource actions are indicated with the following symbols:
+  + create
 
-    $ bundle
+Terraform will perform the following actions:
 
-Or install it yourself as:
+  # local_file.foo will be created
+  + resource "local_file" "foo" {
+      + content              = "foo"
+      + directory_permission = "0777"
+      + file_permission      = "0777"
+      + filename             = "/tmp/foo.txt"
+      + id                   = (known after apply)
+    }
 
-    $ gem install tfw
+Plan: 1 to add, 0 to change, 0 to destroy.
 
-## Usage
+Do you want to perform these actions?
+  Terraform will perform the actions described above.
+  Only 'yes' will be accepted to approve.
 
-TODO: Write usage instructions here
+  Enter a value: yes
 
-## Development
+local_file.foo: Creating...
+local_file.foo: Creation complete after 0s [id=0beec7b5ea3f0fdbc95d0dd47f3c5bc275da8a33]
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+Apply complete! Resources: 1 added, 0 changed, 0 destroyed.
+```
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+## How it works
 
-## Contributing
+TFW will create a subdirectory called `.tfw`, and it will create a file called `.tfw/stack.tf` which is the dynamically generated terraform file, and will invoke terrafom in that directory. 
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/tfw. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 
-## License
+## Installation
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 
-## Code of Conduct
+TFW is just a ruby gem and can easily be installed as below: 
 
-Everyone interacting in the Tfw project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/tfw/blob/master/CODE_OF_CONDUCT.md).
+```bash
+gem install tfw
+```

data/lib/tfw.rb

@@ -101,7 +101,7 @@ module TFW
   def configure_methods_using_stack(stack)
     silent_block do
       # This will trigger warnings as we are redefining methods
-      %w[provider variable locals tfmodule datsource resource output terraform].each do |name|
+      %w[provider variable locals tfmodule datasource resource output terraform].each do |name|
         TOPLEVEL_BINDING.eval('self').define_singleton_method name do |*args, &block|
           stack.method(name).call(*args, &block)
         end

data/lib/tfw/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TFW
-  VERSION = '0.1.10'
+  VERSION = '0.1.11'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tfw
 version: !ruby/object:Gem::Version
-  version: 0.1.10
+  version: 0.1.11
 platform: ruby
 authors:
 - Tiago Lopo
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-03-02 00:00:00.000000000 Z
+date: 2020-04-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tfdsl