Update cookbooks and add wordpress cookbook

cookbooks/tar/README.md

@@ -0,0 +1,101 @@
+*This cookbook is no longer actively maintained and is up for adoption. If you
+would like to take over development, go to https://supermarket.chef.io/cookbooks/tar,
+click the "Adopt me!" button, and you could be the new maintainer of this cookbook!*
+
+DESCRIPTION
+===========
+
+Installs tar and two resources for managing remote tar files.
+`tar_package` handles remote source package compilation.
+`tar_extract` handles retrieving remote tar files and extracting
+them locally.
+
+LICENSE AND AUTHOR
+==================
+
+Author:: Nathan L Smith (<nathan@cramerdev.com>)
+Author:: George Miranda (<gmiranda@opscode.com>)
+Author:: Mark Van de Vyver (<mark@@taqtiqa.com>)
+
+Copyright 2011, Cramer Development, Inc.
+Copyright 2011, Opscode, Inc.
+Copyright 2013, TAQTIQA LLC.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+Resources/Providers
+===================
+
+A `tar_package` LWRP provides an easy way to download remote files and compile and install them.  This only works for the most basic Autoconf programs that can do `./configure && make && make install`.
+
+A `tar_extract` LWRP provides an easy way to download remote tar files and extract them to a local directory.
+
+# Actions
+
+`tar_package`
+- :install: Installs the package
+
+`tar_extract`
+- :extract: Extracts the tar file from a url
+- :extract_local: Extracts the tar file from a local file path
+
+# Attribute Parameters
+
+`tar_package`
+- source: name attribute. The source remote URL.
+- prefix: Directory to be used as the `--prefix` configure flag.
+- source\_directory: Directory to which source files are download.
+- creates: A file this command creates - if the file exists, the command will not be run.
+- configure\_flags: Array of additional flags to be passed to `./configure`.
+- archive\_name: Specify a different name for the downloaded archive. Use it if the directory name inside the tar file is different than the name defined in the URL.
+Additionally, `tar_package` supports most `remote_file` [attributes](https://docs.chef.io/chef/resources.html#remote-file).
+
+`tar_extract`
+- source: name attribute. The source remote URL.
+- target\_dir: Directory to extract into, e.g. tar xzf -C (target_dir)
+- download\_dir: Directory to which tarball is downloaded (defaults to chef cache which requires root `group` and `user`).
+- creates: A file this command creates - if the file exists, the command will not be run.
+- compress_char: Flag for compression type, such as `z` for `gzip`.  `man tar` for options.
+- tar\_flags: Array of additional flags to be passed to tar xzf command.
+- group: Group name or group ID to extract the archive under. If set to non-root group, point to a `download_dir` the group has permission to access.
+- user: User name or user ID to extract the archive under. If set to non-root user, point to a `download_dir` the user has permission to access.
+Additionally, `tar_extract` supports most `remote_file` [attributes](https://docs.chef.io/chef/resources.html#remote-file).
+
+# Example
+
+    tar_package 'http://pgfoundry.org/frs/download.php/1446/pgpool-3.4.1.tar.gz' do
+      prefix '/usr/local'
+      creates '/usr/local/bin/pgpool'
+    end
+
+This will download, compile, and install the package from the given URL and install it into /usr/local.
+
+    tar_extract 'http://dev.mycoderepo.com/artifacts/mycode-1.2.3.tar.gz' do
+      target_dir '/opt/myapp/mycode'
+      creates '/opt/myapp/mycode/lib'
+      tar_flags [ '-P', '--strip-components 1' ]
+    end
+
+This will download the tarball to cache, extract the contents to /opt/myapp/mycode, use the file '/opt/myapp/mycode/lib' to determine idempotency, and pass both '-P' and '--strip-components 1' flags to the tar xzf command.
+
+    tar_extract '/tmp/mycode-1.2.3.tar.gz' do
+      action :extract_local
+      target_dir '/opt/myapp/mycode'
+      creates '/opt/myapp/mycode/lib'
+    end
+
+This will extract the contents of /tmp/mycode-1.2.3.tar.gz to /opt/myapp/mycode and use the file '/opt/myapp/mycode/lib' to determine idempotency.
+
+# ChefSpec Matchers
+
+ChefSpec matchers are defined for tar_package and tar_extract.