theme-juice 0.17.1 → 0.18.0

data/lib/theme-juice.rb

@@ -20,6 +20,7 @@ require "theme-juice/config"
 require "theme-juice/task"
 require "theme-juice/tasks/entry"
 require "theme-juice/tasks/vm_box"
+require "theme-juice/tasks/init_confirm"
 require "theme-juice/tasks/create_confirm"
 require "theme-juice/tasks/delete_confirm"
 require "theme-juice/tasks/location"
@@ -37,6 +38,7 @@ require "theme-juice/tasks/landrush"
 require "theme-juice/tasks/synced_folder"
 require "theme-juice/tasks/dns"
 require "theme-juice/tasks/wp_cli"
+require "theme-juice/tasks/init_success"
 require "theme-juice/tasks/create_success"
 require "theme-juice/tasks/delete_success"
 require "theme-juice/tasks/vm_provision"
@@ -49,6 +51,7 @@ require "theme-juice/tasks/settings"
 require "theme-juice/tasks/load"
 require "theme-juice/tasks/invoke"
 require "theme-juice/command"
+require "theme-juice/commands/init"
 require "theme-juice/commands/create"
 require "theme-juice/commands/delete"
 require "theme-juice/commands/deploy"

data/lib/theme-juice/cli.rb

@@ -13,6 +13,7 @@ module ThemeJuice
       @project = Project
       @util    = Util.new
       @list    = Tasks::List
+      @init    = Commands::Init
       @create  = Commands::Create
       @delete  = Commands::Delete
       @deploy  = Commands::Deploy
@@ -44,7 +45,7 @@ module ThemeJuice
     map %w[man doc docs]           => :help
     map %w[--version -v]           => :version
     map %w[mk new]                 => :create
-    map %w[up init]                => :setup
+    map %w[up]                     => :init
     map %w[rm remove trash]        => :delete
     map %w[ls projects apps sites] => :list
     map %w[server remote]          => :deploy
@@ -91,6 +92,15 @@ module ThemeJuice
       @io.say @version, :color => :green
     end
 
+    desc "init", "Initialize the VM"
+    def init
+      @io.say "Initializing the VM...", {
+        :color => [:black, :on_green, :bold],
+        :row   => true
+      }
+      @init.new(options).execute
+    end
+
     desc "create", "Create new project"
     method_option :name,         :type => :string,  :aliases => "-n", :default => nil, :desc => ""
     method_option :location,     :type => :string,  :aliases => "-l", :default => nil, :desc => ""

data/lib/theme-juice/commands/init.rb

@@ -0,0 +1,24 @@
+# encoding: UTF-8
+
+module ThemeJuice
+  module Commands
+    class Init < Command
+
+      def initialize(opts = {})
+        super
+
+        runner do |tasks|
+          tasks << Tasks::InitConfirm.new
+          tasks << Tasks::VMBox.new
+          tasks << Tasks::VMPlugins.new
+          tasks << Tasks::VMLocation.new
+          tasks << Tasks::VMCustomfile.new
+          tasks << Tasks::Landrush.new
+          tasks << Tasks::ForwardPorts.new
+          tasks << Tasks::VMProvision.new
+          tasks << Tasks::InitSuccess.new
+        end
+      end
+    end
+  end
+end

data/lib/theme-juice/man/tj

@@ -1,7 +1,7 @@
-.\" generated with Ronn/v0.7.3
-.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.\" generated with Ronn/v0.7.0
+.\" http://github.com/rtomayko/ronn/tree/0.7.0
 .
-.TH "TJ" "1" "September 2015" "" "Theme Juice Manual"
+.TH "TJ" "1" "December 2015" "" "Theme Juice Manual"
 .
 .SH "NAME"
 \fBtj\fR \- WordPress development made easy
@@ -9,26 +9,23 @@
 .SH "SYNOPSIS"
 \fBtj\fR [\fIcommand\fR] [\-\-flag=\fIarg\fR] [\-\-flag]
 .
-.SH "DESCRIPTION"
-Theme Juice (tj(1)) is a command line utility that allows you to generate, manage and deploy new local WordPress development applications in seconds using vagrant(1), utilizing an apache(7) fork of vvv(7) called vvv\-apache(7) as the virtual machine\.
-.
 .SH "GLOBAL OPTIONS"
 .
 .TP
 \fB\-\-vm\-box\fR=\fIrepository\fR
-Force vagrant(1) box for use as VM
+Force vagrant(1) box for use as VM*
 .
 .TP
 \fB\-\-vm\-path\fR=\fIpath\fR
-Force path to VM
+Force path to VM*
 .
 .TP
 \fB\-\-vm\-ip\fR=\fIip\fR
-Force IP address of VM
+Force IP address of VM*
 .
 .TP
 \fB\-\-vm\-prefix\fR=\fIstring\fR
-Force directory prefix for project in VM
+Force directory prefix for project in VM*
 .
 .TP
 \fB\-\-yolo\fR
@@ -48,15 +45,15 @@ Prints all output without color
 .
 .TP
 \fB\-\-no\-animations\fR
-Prints all output without animations
+Prints all output without animations**
 .
 .TP
 \fB\-\-no\-landrush\fR
-Disable the landrush(1) gem for managing DNS
+Disable the landrush(1) gem for managing DNS*
 .
 .TP
 \fB\-\-no\-port\-forward\fR, \fB\-\-no\-port\-forwarding\fR
-Disable automatic port forwarding
+Disable automatic port forwarding*
 .
 .TP
 \fB\-\-verbose\fR
@@ -76,18 +73,28 @@ Run a command without actually doing anything
 .
 .TP
 \fB\-\-nginx\fR, \fB\-\-no\-apache\fR
-Create \fBconf\fR files for nginx(7) instead of apache(7)
+Create \fBconf\fR files for nginx(7) instead of apache(7)*
+.
+.P
+\fB*\fR Flag is only applicable on first create(1) before the VM has been created, unless an new (unused) \fBvm\-path\fR is specified\.
+.
+.P
+\fB**\fR Coming soon (possibly)
 .
 .SH "PRIMARY COMMANDS"
 Run \fBtj help\fR [\fIcommand\fR] to view an individual command\'s man page\.
 .
 .TP
+init(1), \fBup\fR
+Initialize the VM
+.
+.TP
 create(1), \fBnew\fR, \fBmk\fR
-Create a new project
+Create a new project (also runs init(1) if VM is uninitialized)
 .
 .TP
-setup(1), \fBup\fR, \fBinit\fR
-Setup an existing project
+setup(1)
+Setup an existing project (alias for create(1) \fB\-\-bare\fR)
 .
 .TP
 delete(1), \fBrm\fR, \fBremove\fR, \fBtrash\fR
@@ -95,7 +102,7 @@ Delete a project
 .
 .TP
 deploy(1), \fBserver\fR, \fBremote\fR
-Deploy a project
+Deploy and manage a project
 .
 .SH "SECONDARY COMMANDS"
 .
@@ -112,7 +119,7 @@ List all projects
 Manage development environment via vagrant(1)\. Commands are proxied to your Vagrant installation so that they can be run from any directory\.
 .
 .SH "CONFIG COMMANDS"
-These run the corresponding command from your project\'s config file\. They accept any number of arguments, since the behavior and handling of input is defined within the config file itself\. Below are the commands defined within the Theme Juice starter template\.
+These run the corresponding command from your project\'s config file\. They accept any number of arguments, since the behavior and handling of input is defined within the config file itself\. Below are the commands defined within the \fITheme Juice starter template\fR\.
 .
 .TP
 \fBinstall\fR=[\fIarg\fR[,\fIarg\fR]\.\.\.]
@@ -147,7 +154,7 @@ Backup project
 Manage and run project tests
 .
 .SH "CONFIG FILE"
-A YAML Juicefile(5) configuration can be used to store commonly\-used build scripts, similar to npm(1) scripts\. Each command block sequence can be mapped to an individual project\'s build tool, allowing a streamlined set of commands to be used across multiple projects that utilize different tools\.
+A YAML Juicefile(5) configuration can be used to store commonly\-used build scripts (and deploy(1) info), similar to npm(1) scripts\. Each command block sequence can be mapped to an individual project\'s build tool, allowing a streamlined set of commands to be used across multiple projects that utilize different tools\. Below are descriptions for the default commands within the \fITheme Juice starter template\'s\fR \fBJuicefile\fR\.
 .
 .TP
 \fBcommands\fR
@@ -203,7 +210,7 @@ When naming your configuration file, use the recommended \fBJuicefile\fR, or \fB
 \fB/^(((\e\.)?(tj)|((J|j)uicefile))(\e\.y(a)?ml)?$)/\fR
 .
 .SH "ENVIRONMENT"
-All of the global options have a corresponding \fBENV\fR variable that can be set to permanently use the specified value each time tj(1) is run\. This is useful if you\'re using an alternate vagrant(1) box, or if you need to disable certain features due to limited support e\.g\. on Windows\.
+All of the global options have a corresponding \fBENV\fR variable that can be set to permanently use the specified value each time tj(1) is run\. This is useful if you\'re using an alternate vagrant(1) box, or if you need to disable certain features due to limited support i\.e\. on Windows\.
 .
 .TP
 \fBTJ_VM_BOX\fR=\fIrepository\fR

data/lib/theme-juice/man/tj-create

@@ -1,7 +1,7 @@
-.\" generated with Ronn/v0.7.3
-.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.\" generated with Ronn/v0.7.0
+.\" http://github.com/rtomayko/ronn/tree/0.7.0
 .
-.TH "TJ\-CREATE" "1" "August 2015" "" "Theme Juice Manual"
+.TH "TJ\-CREATE" "1" "December 2015" "" "Theme Juice Manual"
 .
 .SH "NAME"
 \fBtj\-create\fR \- Create a new project
@@ -10,7 +10,41 @@
 \fBtj create\fR [\-\-flag=\fIarg\fR] [\-\-flag]
 .
 .SH "DESCRIPTION"
-Creates a new project\. It will lead you through a series of prompts to set up required project information, such as name, location, template, database info, etc\. Using the specified information, it will run the installation process and set up a local development environment, if one hasn\'t already been set up\. It will sync your local project location with the project location within the VM\.
+Creates a new project\. It will lead you through a series of prompts to set up required project information, such as name, location, template, database info, etc\. Using the specified information, it will run the installation process below\.
+.
+.IP "1." 4
+\fBtj\fR will execute init(1) if the VM is uninitialized
+.
+.IP "2." 4
+\fBtj\fR will clone the selected starter template
+.
+.IP "3." 4
+\fBtj\fR will run the starter template\'s Juicefile(1) \fBinstall\fR command
+.
+.IP "4." 4
+.
+.IP "\(bu" 4
+\fBCustomfile\fR containing DNS and synced folder settings
+.
+.IP "\(bu" 4
+\fBinit\-custom\.sql\fR containing database setup
+.
+.IP "\(bu" 4
+\fBproject\.conf\fR containing server settings
+.
+.IP "\(bu" 4
+\fBwp\-cli\.local\.yml\fR containing VM paths
+.
+.IP "" 0
+
+.
+.IP "5." 4
+\fBtj\fR will provision the VM to put the new configuration into effect
+.
+.IP "" 0
+.
+.P
+If you\'ve never used \fBtj\fR before (meaning, this is your first create(1)), then that last step might take awhile\. After that\'s done, you should be able to access your new project at the specified url\. It\'s that easy!
 .
 .SH "GLOBAL OPTIONS"
 .

data/lib/theme-juice/man/tj-create.txt

@@ -12,9 +12,34 @@ DESCRIPTION
        Creates	a new project. It will lead you through a series of prompts to
        set up required project information, such as name, location,  template,
        database  info,	etc.  Using the specified information, it will run the
-       installation process and set up a local development environment, if one
-       hasn't  already	been  set up. It will sync your local project location
-       with the project location within the VM.
+       installation process below.
+
+       1.  tj will execute init(1) if the VM is uninitialized
+
+       2.  tj will clone the selected starter template
+
+       3.  tj will run the starter template's Juicefile(1) install command
+
+       4.
+
+       o   Customfile containing DNS and synced folder settings
+
+       o   init-custom.sql containing database setup
+
+       o   project.conf containing server settings
+
+       o   wp-cli.local.yml containing VM paths
+
+
+
+
+       5.  tj will provision the VM to put the new configuration into effect
+
+
+
+       If you've never used tj before (meaning, this is your first create(1)),
+       then that last step might take awhile. After that's done, you should be
+       able to access your new project at the specified url. It's that easy!
 
 GLOBAL OPTIONS
        -n, --name=string
@@ -56,4 +81,4 @@ GLOBAL OPTIONS
 
 
 
-				  August 2015			  TJ-CREATE(1)
+				 December 2015			  TJ-CREATE(1)

data/lib/theme-juice/man/tj-delete

@@ -1,7 +1,7 @@
-.\" generated with Ronn/v0.7.3
-.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.\" generated with Ronn/v0.7.0
+.\" http://github.com/rtomayko/ronn/tree/0.7.0
 .
-.TH "TJ\-DELETE" "1" "August 2015" "" "Theme Juice Manual"
+.TH "TJ\-DELETE" "1" "December 2015" "" "Theme Juice Manual"
 .
 .SH "NAME"
 \fBtj\-delete\fR \- Delete a project
@@ -10,10 +10,10 @@
 \fBtj delete\fR [\-\-flag=\fIarg\fR] [\-\-flag]
 .
 .SH "DESCRIPTION"
-Removes a project from your development environment\. You will go through a series of prompts to delete a project\. This will only remove files that were generated by tj(1) i\.e\. the database setup, DNS setup, and other project configuration files\.
+Removes a project from your development environment\. You will go through a series of prompts to delete a project\. This will only remove files that were generated by tj(1) e\.g\. the database setup, DNS setup, and other project configuration files\.
 .
 .P
-It will not touch your local folders that were synced to the VM\.
+\fIIt will not touch your local folders that were synced to the VM\fR\.
 .
 .SH "GLOBAL OPTIONS"
 .

data/lib/theme-juice/man/tj-delete.txt

@@ -11,7 +11,7 @@ SYNOPSIS
 DESCRIPTION
        Removes	a  project  from  your	development  environment.  You will go
        through a series of prompts to delete a project. This will only	remove
-       files  that were generated by tj(1) i.e. the database setup, DNS setup,
+       files  that were generated by tj(1) e.g. the database setup, DNS setup,
        and other project configuration files.
 
        It will not touch your local folders that were synced to the VM.
@@ -32,4 +32,4 @@ GLOBAL OPTIONS
 
 
 
-				  August 2015			  TJ-DELETE(1)
+				 December 2015			  TJ-DELETE(1)

data/lib/theme-juice/man/tj-deploy

@@ -1,7 +1,7 @@
-.\" generated with Ronn/v0.7.3
-.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.\" generated with Ronn/v0.7.0
+.\" http://github.com/rtomayko/ronn/tree/0.7.0
 .
-.TH "TJ\-DEPLOY" "1" "November 2015" "" "Theme Juice Manual"
+.TH "TJ\-DEPLOY" "1" "December 2015" "" "Theme Juice Manual"
 .
 .SH "NAME"
 \fBtj\-deploy\fR \- Deploy a project
@@ -22,15 +22,12 @@ Create a \fBdeploy\fR user on the \fBstage\fR server
 Create SSH keys for the new \fBdeploy\fR user
 .
 .IP "3." 4
-Create a deployment key for the \fBstage\fR server to clone your repository
+Confirm the \fBdeploy\fR user owns the deploy path
 .
 .IP "4." 4
-Confirm the \fBdeploy\fR user owns the deploy path
+Run \fBtj deploy <stage> setup\fR to setup the required directories
 .
 .IP "5." 4
-Run \fBtj deploy <stage> setup\fR to setup the initial shared and releases directories
-.
-.IP "6." 4
 Deploy!
 .
 .IP "" 0
@@ -39,7 +36,7 @@ Deploy!
 .
 .TP
 \fB\-\-archive\fR, \fB\-\-tar\fR, \fB\-\-gzip\fR, \fB\-\-zip\fR
-Archive directories when performing file transfers with tar(1)
+Archive directories with tar(1) when performing file transfers
 .
 .SH "PRIMARY COMMANDS"
 If no command is passed, the default task to be executed is \fBdeploy\fR

data/lib/theme-juice/man/tj-deploy.txt

@@ -19,21 +19,17 @@ SETUP
 
        2.  Create SSH keys for the new deploy user
 
-       3.  Create a deployment key for the stage server to clone your  reposi-
-	   tory
+       3.  Confirm the deploy user owns the deploy path
 
-       4.  Confirm the deploy user owns the deploy path
+       4.  Run tj deploy <stage> setup to setup the required directories
 
-       5.  Run	tj  deploy  <stage>  setup  to	setup  the  initial shared and
-	   releases directories
-
-       6.  Deploy!
+       5.  Deploy!
 
 
 
 GLOBAL OPTIONS
        --archive, --tar, --gzip, --zip
-	      Archive directories when performing file transfers with tar(1)
+	      Archive directories with tar(1) when performing file transfers
 
 PRIMARY COMMANDS
        If no command is passed, the default task to be executed is deploy
@@ -181,4 +177,4 @@ CONFIG FILE
 
 
 
-				 November 2015			  TJ-DEPLOY(1)
+				 December 2015			  TJ-DEPLOY(1)

data/lib/theme-juice/man/tj-setup

@@ -1,7 +1,7 @@
-.\" generated with Ronn/v0.7.3
-.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.\" generated with Ronn/v0.7.0
+.\" http://github.com/rtomayko/ronn/tree/0.7.0
 .
-.TH "TJ\-SETUP" "1" "July 2015" "" "Theme Juice Manual"
+.TH "TJ\-SETUP" "1" "December 2015" "" "Theme Juice Manual"
 .
 .SH "NAME"
 \fBtj\-setup\fR \- Setup an existing project

data/lib/theme-juice/man/tj-setup.txt

@@ -47,4 +47,4 @@ GLOBAL OPTIONS
 
 
 
-				   July 2015			   TJ-SETUP(1)
+				 December 2015			   TJ-SETUP(1)

data/lib/theme-juice/man/tj.txt

@@ -8,26 +8,20 @@ NAME
 SYNOPSIS
        tj [command] [--flag=arg] [--flag]
 
-DESCRIPTION
-       Theme Juice (tj(1)) is a command line utility that allows you to gener-
-       ate, manage and deploy new local WordPress development applications  in
-       seconds	using vagrant(1), utilizing an apache(7) fork of vvv(7) called
-       vvv-apache(7) as the virtual machine.
-
 GLOBAL OPTIONS
        --vm-box=repository
-	      Force vagrant(1) box for use as VM
+	      Force vagrant(1) box for use as VM*
 
        --vm-path=path
-	      Force path to VM
+	      Force path to VM*
 
        --vm-ip=ip
-	      Force IP address of VM
+	      Force IP address of VM*
 
        --vm-prefix=string
-	      Force directory prefix for project in VM
+	      Force directory prefix for project in VM*
 
-       --yolo Say yes to anything and everything, and maybe  even  get	a  few
+       --yolo Say  yes	to  anything  and everything, and maybe even get a few
 	      surprises
 
        --boring
@@ -40,13 +34,13 @@ GLOBAL OPTIONS
 	      Prints all output without color
 
        --no-animations
-	      Prints all output without animations
+	      Prints all output without animations**
 
        --no-landrush
-	      Disable the landrush(1) gem for managing DNS
+	      Disable the landrush(1) gem for managing DNS*
 
        --no-port-forward, --no-port-forwarding
-	      Disable automatic port forwarding
+	      Disable automatic port forwarding*
 
        --verbose
 	      Prints out additional logging information
@@ -61,22 +55,30 @@ GLOBAL OPTIONS
 	      Run a command without actually doing anything
 
        --nginx, --no-apache
-	      Create conf files for nginx(7) instead of apache(7)
+	      Create conf files for nginx(7) instead of apache(7)*
+
+       * Flag is only applicable on first create(1) before  the  VM  has  been
+       created, unless an new (unused) vm-path is specified.
+
+       ** Coming soon (possibly)
 
 PRIMARY COMMANDS
        Run tj help [command] to view an individual command's man page.
 
+       init(1), up
+	      Initialize the VM
+
        create(1), new, mk
-	      Create a new project
+	      Create a new project (also runs init(1) if VM is uninitialized)
 
-       setup(1), up, init
-	      Setup an existing project
+       setup(1)
+	      Setup an existing project (alias for create(1) --bare)
 
        delete(1), rm, remove, trash
 	      Delete a project
 
        deploy(1), server, remote
-	      Deploy a project
+	      Deploy and manage a project
 
 SECONDARY COMMANDS
        version, --version, -v
@@ -122,10 +124,11 @@ CONFIG COMMANDS
 
 CONFIG FILE
        A YAML Juicefile(5) configuration can be used  to  store  commonly-used
-       build  scripts,	similar to npm(1) scripts. Each command block sequence
-       can be mapped to an individual project's build tool, allowing a stream-
-       lined  set of commands to be used across multiple projects that utilize
-       different tools.
+       build  scripts  (and  deploy(1)	info), similar to npm(1) scripts. Each
+       command block sequence can be mapped to an individual  project's  build
+       tool, allowing a streamlined set of commands to be used across multiple
+       projects that utilize different tools. Below are descriptions  for  the
+       default commands within the Theme Juice starter template's Juicefile.
 
        commands
 	      Collection of various command block sequences
@@ -154,7 +157,7 @@ CONFIG FILE
        commands.test
 	      Command used to manage and run project tests
 
-       Placeholder arguments can be used within any command block sequence  to
+       Placeholder  arguments can be used within any command block sequence to
        allow splat or indexed arguments to be passed to the corresponding com-
        mand when executed.
 
@@ -164,8 +167,8 @@ CONFIG FILE
        %argN%, %argumentN%
 	      Where n is the argument index e.g. cmd %arg1% | cmd %arg2%
 
-       When naming your configuration file, use the recommended Juicefile,  or
-       .tj.yaml  naming convention. The raw filename regex matcher is below if
+       When  naming your configuration file, use the recommended Juicefile, or
+       .tj.yaml naming convention. The raw filename regex matcher is below  if
        you want to be a little different.
 
        /^(((\.)?(tj)|((J|j)uicefile))(\.y(a)?ml)?$)/
@@ -173,8 +176,8 @@ CONFIG FILE
 ENVIRONMENT
        All of the global options have a corresponding ENV variable that can be
        set to permanently use the specified value each time tj(1) is run. This
-       is useful if you're using an alternate vagrant(1) box, or if  you  need
-       to disable certain features due to limited support e.g. on Windows.
+       is  useful  if you're using an alternate vagrant(1) box, or if you need
+       to disable certain features due to limited support i.e. on Windows.
 
        TJ_VM_BOX=repository
 	      Force vagrant(1) box for use as VM
@@ -189,7 +192,7 @@ ENVIRONMENT
 	      Force directory prefix for project in VM
 
        TJ_YOLO=bool
-	      Say  yes	to  anything  and everything, and maybe even get a few
+	      Say yes to anything and everything, and maybe  even  get	a  few
 	      surprises
 
        TJ_BORING=bool
@@ -228,4 +231,4 @@ ENVIRONMENT
 
 
 
-				September 2015				 TJ(1)
+				 December 2015				 TJ(1)