cachivache 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6e68c84fc309762c64ddf571c3f53d6e274b9140
-  data.tar.gz: a88c0c0a348c71891bbd17d3628d44a728394c8f
+  metadata.gz: 3456d3dbf0a1cf2a9874b946d3d6e562d3409e07
+  data.tar.gz: b0f24200f939d7ea555d585253bb0191c991e8c6
 SHA512:
-  metadata.gz: dab8a7e369843262583de50fda7e30a469cc3c4cdfa7bc4d7e75e41916ddcbdb27395a6c6410a52428a745c13632d979cc4e53364c3a01ebcb44bd628c321e8e
-  data.tar.gz: a772bce3e35172d195786f28e60b7420ceeee4b04637905601fbd4b1823152567e8297f46b0b385185d2286d3bf70a5b8e8daa9abff6929e56ed5d13eb8b2baf
+  metadata.gz: 7955d555c94b1fec28a43fdc07b2debcb332a7bcae846ca111a6722c2392263f0758d46b915bab209e7f3f720adaa88143dc53ba2fa8756e20d9939d8a455b81
+  data.tar.gz: 007eb2d44a849c97d2209174c017a00695cb78e6c82abda2363a4524d5d23e15460831802fd60fe72bc1f1510e257abc1c5ef41c8fe6f349217502966073d33c

data/README.md

@@ -91,7 +91,7 @@ stuff :'php-json-spec' => dependencies do
    }
 end
 
-configure PhpJsonSpec do
+configure :PhpJsonSpec do
    let(:project_folder)     { Cachivache.src_folder }
 end
 ```
@@ -260,7 +260,7 @@ stuff :'do-stuff' do
    }
 end
 
-configure DoStuff do
+configure :DoStuff do
    let(:some_folder)    { '/home/vagrant/some-folder' }
 end
 ```
@@ -314,6 +314,10 @@ To debug the provision do
 
 Not a single test was written this day :(
 
+## Roadmap
+
+- v1.0.0: Make a custom Vagrant provisioner plugin
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/cabeza-de-termo/cachivache.

data/bin/template/lib/rake-helper.rb

@@ -32,21 +32,9 @@ end
 ######################################
 
 def stuff(task_definition, *args, &block)
-	task_name = fully_qualified_name_of(task_definition)
-
-	Rake::Task[task_name].clear if Rake::Task.task_defined?(task_name)
-
 	task(task_definition, *args, &block)
 end
 
-def fully_qualified_name_of(task_definition)
-	task_name = (task_definition.is_a? Hash) ? task_definition.keys.first : task_definition
-	namespace = Rake.application.current_scope.path
-
-	return task_name if namespace.empty?
-	(namespace.to_s + ':' + task_name.to_s).to_sym
-end
-
 def execute_shell_command(command)
 	sh command
 end
@@ -61,7 +49,5 @@ ShellContext.set_current( ShellExec.new(self) )
 ######################################
 
 all_rb_files_in Cachivache.cachivache_folder do |file|
-	Stuff::Configuration.creating_undefined_subclasses do
-		require file
-	end
+	require file
 end

data/bin/template/lib/stuff-api-behaviour.rb

@@ -97,6 +97,17 @@ module Stuff
 			shell_context.raise_validation_error(message)
 		end
 
+		# Example:
+		#
+		# configure :Something do
+		# 	let(:bla)		{ '123' }
+		# 	let(:ble)		{ 'abc' }
+		# end
+		def configure(class_name, &block)
+			Stuff::Configuration.ensure_subclass_exists(class_name)
+			Stuff::Configuration.class_named(class_name).instance_eval(&block)
+		end
+
 		protected
 
 		def during_shell_buffer(&block)

data/bin/template/lib/stuff-configuration.rb

@@ -1,13 +1,3 @@
-# Example:
-#
-# configure Something do
-# 	let(:bla)		{ '123' }
-# 	let(:ble)		{ 'abc' }
-# end
-def configure(klass, &block)
-	klass.instance_eval(&block)
-end
-
 module Stuff
 	class Configuration
 		# Class methods
@@ -33,17 +23,6 @@ module Stuff
 				variables[name].call
 			end	
 
-			def creating_undefined_subclasses(&block)
-				begin
-					block.call
-				rescue NameError => e
-					raise e unless is_class_name e.name
-
-					define_subclass(e.name)
-				    retry
-				end
-			end
-
 			protected
 
 			def method_missing(name, *more_args, &block)
@@ -52,8 +31,20 @@ module Stuff
 				super(name, *more_args, &block)
 			end
 
-			def is_class_name(const)
-				const[0] == const[0].upcase
+			public
+
+			def class_named(class_name)
+				Object.const_get(class_name)
+			end
+
+			def ensure_subclass_exists(class_name)
+				define_subclass(class_name) unless is_class_defined?(class_name)
+			end
+
+			protected
+
+			def is_class_defined?(name)
+				Object.const_defined?(name)
 			end
 
 			def define_subclass(name)
@@ -61,4 +52,4 @@ module Stuff
 			end
 		end
 	end
-end
+end

data/bin/template/stuff/stuff_sample.rb

@@ -37,6 +37,6 @@ stuff :'php-json-spec' => dependencies do
    remind_to "You can check the reports in the #{StuffSample.project_folder}/ouput folder"
 end
 
-configure StuffSample do
+configure :StuffSample do
    let(:project_folder)     { Cachivache.src_folder }
 end

data/lib/cachivache/init-command.rb

@@ -23,6 +23,7 @@ module Cachivache
 
 			FileUtils.mkdir destination
 			FileUtils.copy_entry template_folder, destination
+			FileUtils.cp readme_file, destination
 		end
 
 		def clone_stuff_library_submodule()
@@ -33,6 +34,10 @@ module Cachivache
 			'https://github.com/cabeza-de-termo/stuff-library'
 		end
 
+		def readme_file()
+			gem_folder + '../README.md'
+		end
+
 		def raise_folder_exist_error()
 			raise_error "A folder 'cachivache' already exists."
 		end

data/lib/cachivache/version.rb

@@ -1,3 +1,3 @@
 module Cachivache
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cachivache
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Martin Rubi
@@ -83,7 +83,6 @@ files:
 - bin/setup
 - bin/template/.gitignore
 - bin/template/Gemfile
-- bin/template/README.md
 - bin/template/Rakefile
 - bin/template/Vagrantfile
 - bin/template/cachivache.rb

data/bin/template/README.md

@@ -1,324 +0,0 @@
-# CabezaDeTermo::Cachivache
-
-## Installation
-
-- `gem install cachivache`
-
-## Description
-
-Cachivache is a provisioner for Vagrant machines with Ubuntu images.
-
-You can provision a Vagrant VM using shell scripts, or more sophisticated tools like [Puppet](https://puppetlabs.com/), [Chef](https://www.chef.io/chef/), [salt](https://docs.saltstack.com/en/latest/), [Ansible](http://www.ansible.com/) and by the time you are reading this probably a few more.
-
-If you are a developer, most of the time you just want to quickly provision you Vagrant with some bash script that installs some services and libraries, replace some parameter files in your application and probably run a few custom bash commands and that's pretty much it.
-The good thing about provisioning with bash scripts is that it is fast and very easy to implement (just google how to install something and toss the bash script into the provision script and that's it).
-On the other hand, the problems with shell provisions are that
-
-- bash is unreadable. That's not a problem most of the times, but when the a task becomes a little more complex than c&p the apt-get instructions to install something, it becomes one (even some super simple tasks like replacing parameters in a file)
-
-- it's very difficult to factorize and reuse
-
-- even if you factorize it into little bash scripts, you can't easyly declare dependencies between these scripts
-
-The provisioning tools like Puppet and Chef resolve these problems, and a lot more. Actually, they resolve so much more problems that is overkill to only use them to provision a Vagrant machine for developing.
-All of these tools define their own DSL and high level concepts and metaphors, they require you configure them, you must search for the correct recipes to install what you want, etc.
-These tools are a must to manage the provisioning of different environments, but for a single developer machine they are way too much.
-
-Cachivache is a middle ground between bash scripts and these tools.
-Instead of reinventing the wheel with a brand new DSL and new metaphors, Cachivache uses a wheel that we have had for ages: [Rake](https://github.com/ruby/rake).
-
-## Usage
-
-Once you installed the `cachivache` gem, setup cachivache for your project:
-
-- Go to the root of your project
-- `cachivache init`
-- `cd cachivache`
-
-write some stuffs in your `stuff` folder and set what stuff to install and your git email and user:
-
-- `cachivache config`
-
-and that's it, you can now start Vagrant with:
-
-- `vagrant up`
-- `vagrant ssh`
-- `cd src`
-
-and you have your project running in a Vagrant machine.
-
-If you want to commit from Vagrant, add the `:'projects-setup'` as a dependency of your project in the stuff you created, it will set your git credentials.
-
-The idea behind Cachivache is to put little bash scripts in Rake tasks, and then run those tasks from within the Vagrant VM. As the Ubuntu images already come with a Ruby installation, there's not much to do at all.
-
-So, Cachivache has very few concepts:
-
-- Bash scripts, which you put in Rake tasks
-
-- Rake tasks (also called stuffs in this framework), that can depend on other Rake tasks
-
-- Ruby string interpolation, which allows you to easily parametrize stuff in the bash scripts
-
-- And the secret ingredient: stuff
-
-What is stuff? Stuff is a folder with .rb files. That's it. Cachivache believes in giving power to the people, so instead of defining how, where and when you must organize your scripts, it will let you organize things in any way you want in a couple of folders: `stuff-library` and `stuff`. No recipes, playbooks, roles, bags, configurations, minions, masters, slaves, facts, etc. Just put stuff in a folder.
-[`stuff-library`](https://github.com/cabeza-de-termo/stuff-library) folder holds some existing stuff you can use to install things, and in `stuff` you can toss your own stuff for your project.
-
-## So, what does a stuff look like?
-
-Well, here's an example stuff that setups all the necessary things to work on a php library:
-
-```ruby
-dependencies = [
-   :'projects-setup',
-   :graphviz,
-   :xdebug,
-   :'php-cli',
-   :composer,
-]
-
-stuff :'php-json-spec' => dependencies do
-   shell %{
-      cd #{PhpJsonSpec.project_folder}
-
-      composer install
-
-      # Run the test coverage report
-      php vendor/bin/phpunit -c phpunit-with-coverage.xml
-
-      # Generate the documentation
-      php vendor/bin/phpdoc         
-   }
-end
-
-configure PhpJsonSpec do
-   let(:project_folder)     { Cachivache.src_folder }
-end
-```
-## How do I tell Cachivache what to install?
-
-Edit the file `cachivache.rb` and define the stuffs to install in the section
-
-```ruby
-   ####################################
-   # Define what stuff to install
-   ####################################
-
-   let(:stuff_to_install) {
-      [
-         'ruby-json-spec',
-         'some-other-stuff',
-         'a-namespace:and-another-one:more-stuff',
-         'mysql-server', # You can install any stuff as long as it is defined
-      ]
-   }
-```
-
-Note that if you set the dependencies of each stuff correctly, you will only have to tell Cachivache to install the top most stuff, and Rake will do the rest for you. Thanks Rake! 
-
-## What other awesome features has Cachivache?
-
-As I said before, all the work is done by Rake, so pretty much none.
-
-There is some sintactic sugar you can use to perform some common task though. But please note that using any of these shorcuts is not mandatory at all, you can just stick to plain old shell scripts.
-
-If you haven't see any ruby code before, here are some tips to use in Cachivache stuffs:
-
-### You can define strings in several ways:
-
-```ruby
-stuff :'do-stuff' do
-   shell %Q{
-      echo "stuff"
-   }
-end
-
-# or
-
-stuff :'do-stuff' do
-   shell %Q[
-      echo "stuff"
-   ]
-end
-
-# or
-
-stuff :'do-stuff' do
-   shell %(
-      echo "stuff"
-   )
-end
-
-# or in a single line
-
-stuff :'do-stuff' do
-   shell %Q{echo "stuff"}
-end
-
-# or with ""
-
-stuff :'do-stuff' do
-   shell "echo \"stuff\""
-end
-```
-
-You see in the last example that if we define strings using "" we need to scape internals \", so the simpliest is to use `%Q{}`.
-
-### You can call as many `sh` blocks within a task as you like. You can also :invoke and :execute other tasks:
-
-```ruby
-stuff :'do-stuff' do
-   shell %Q{
-      echo "stuff"
-   }
-
-   invoke 'install-apache'
-
-   shell %Q{
-      echo "even more stuff"
-   }
-
-   execute 'restart-apache'
-
-   shell! %Q{
-      echo "You would normally not need to use :shell! (note the exclamation mark) but you can"
-   }
-end
-```
-
-The difference between :invoke and :execute is that :execute will perform the task every time it's called, whilst :invoke will only run the task once during the provision. So, to install and configure stuff use :invoke, but to turn things on and off use :execute.
-Or if your tasks are idempotent, always use :execute to make things simplier. It's up to you.
-
-### Instead of using bash `if ! ...; then; .... fi`, you can use these Cachivache helpers:
-
-```ruby
-stuff :'do-stuff' do
-   shell_unless file_exists: '/bla.conf' do
-      shell %Q{
-         ls -la
-         rm -rf bla
-      }
-   end
-end
-```
-
-```ruby
-stuff :'do-stuff' do
-   shell_unless folder_exists: '/bla' do
-      shell %Q{
-         ls -la
-         rm -rf bla
-      }
-   end
-end
-```
-
-```ruby
-stuff :'do-stuff' do
-   shell_unless file: '/bla', contains: 'some regex' do
-      shell %Q{
-         ls -la
-         rm -rf bla
-      }
-   end
-end
-```
-
-```ruby
-stuff :'do-stuff' do
-   shell_unless command: 'java -version', contains: 'java 1.8' do
-      shell %Q{
-         ls -la
-         rm -rf bla
-      }
-   end
-end
-```
-
-- To append and replace text in a file, you can use this Cachivache helper:
-
-```ruby
-stuff :'do-stuff' do
-   in_file "/etc/bla.conf" do
-      shell replace pattern: "%user%", with: "admin"
-
-      shell append "[cachivache]"
-      shell append "path='/bla'"
-      shell append :new_line
-   end
-end
-```
-
-### You can use variables instead of hardcoding values in the scripts:
-
-```ruby
-stuff :'do-stuff' do
-   shell %Q{
-      mkdir #{DoStuff.some_folder}
-
-      mkdir #{SomethingDefinedElsewhereWorksToo.some_folder}
-   }
-end
-
-configure DoStuff do
-   let(:some_folder)    { '/home/vagrant/some-folder' }
-end
-```
-
-### If you want to remind the user of something after the provision is done, in any task use :remind_to
-
-```ruby
-stuff :'do-stuff' do
-   shell %Q{
-      ls -la
-   }
-
-   remind_to "Please don't forget to add '#{Cachivache.vagrant_ip_address} cachivache.com' to your /etc/hosts file"
-end
-```
-## What if I want to use my own [`stuff-library`](https://github.com/cabeza-de-termo/stuff-library)?
-
-No prob! Go to your `cachivache` folder and:
-
-- `cachivache add-stuff-library git@github.com:someuser/my-very-own-stuff-library.git`
-
-Cachivache will load any .rb file in the cachivache folder, so your library stuff will be loaded too.
-
-To update some stuff library from git do:
-
-- `cachivache update-stuff-libraries my-very-own-stuff-library`
-
-To update all the stuff libraries do:
-
-- `cachivache update-stuff-libraries`
-
-To remove a stuff library do:
-
-- `cachivache remove-stuff-libraries stuff-library`
-
-## Debugging
-
-During the building of the stuff, it's useful to be able to see what the provision 
-what would do instead of running it.
-
-To debug the provision do
-
-- Go to the root of your project
-- `cd cachivache`
-- `vagrant ssh`
-- `cd src/cachivache` (now you are in Vagrant)
-- `bundle install`
-- `rake explain` will output the complete shell script without running it
-- `rake some-stuff` will execute only some-stuff and its dependencies
-
-## Running the tests
-
-Not a single test was written this day :(
-
-## Contributing
-
-Bug reports and pull requests are welcome on GitHub at https://github.com/cabeza-de-termo/cachivache.
-
-## License
-
-The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).