deprec-core 3.1.1 → 3.1.2

data/CHANGELOG

@@ -0,0 +1,7 @@
+deprec-core changelog
+=====================
+
+= 3.1.2  (Jul 17, 2011)
+
+* Extracted the guts of deprec into this gem
+

data/lib/deprec-core/canonical.rb

@@ -0,0 +1,68 @@
+# Copyright 2006-2008 by Mike Bailey. All rights reserved.
+# canonical.rb
+#
+# Running deprec:web:stop will be the same as running deprec:apache:stop or 
+# deprec:nginx:stop depending what you have chosen.
+#
+# generic namespaces are linked up to chosen applications at runtime but these
+# stubs are so they'll be included in the output of "cap -T"
+#
+Capistrano::Configuration.instance(:must_exist).load do 
+  
+  %w(ruby).each do |package|
+    namespace "deprec:#{package}" do
+      
+      desc "Install #{package.capitalize}"
+      task :install do 
+      end
+      
+    end
+  end
+  
+  %w(web app db).each do |server|
+    namespace "deprec:#{server}" do
+      
+      desc "Install #{server.capitalize} server"
+      task :install, :roles => server do 
+      end
+      
+      desc "Generate config file(s) for #{server} server from template(s)"
+      task :config_gen do
+      end
+      
+      desc "Deploy configuration files(s) for #{server} server"
+      task :config, :roles => server do
+      end
+      
+      desc "Start #{server} server"
+      task :start, :roles => server do
+      end
+      
+      desc "Stop #{server} server"
+      task :stop, :roles => server do
+      end
+      
+      desc "Stop #{server} server"
+      task :restart, :roles => server do
+      end
+      
+      desc "Enable startup script for #{server} server"
+      task :activate, :roles => server do
+      end  
+      
+      desc "Disable startup script for #{server} server"
+      task :deactivate, :roles => server do
+      end
+      
+      desc "Backup data for #{server} server"
+      task :backup, :roles => server do
+      end
+      
+      desc "Restore data for #{server} server from backup"
+      task :restore, :roles => server do
+      end
+      
+    end
+  end
+  
+end

data/lib/deprec-core/capistrano_extensions.rb

@@ -13,6 +13,9 @@ module Deprec2
     ENV['ROLES'] = old_roles.to_s unless ENV['HOSTS']
   end
 
+  def rake_remote(task_name)
+      run "cd #{current_path} && RAILS_ENV=#{rails_env} #{rake} #{task_name}"
+  end
   
   # Temporarily ignore ROLES and HOSTS
   def ignoring_roles_and_hosts

data/lib/deprec-core/deprec.rb

@@ -0,0 +1,184 @@
+# Copyright 2006-2011 by Mike Bailey. All rights reserved.
+Capistrano::Configuration.instance(:must_exist).load do 
+
+  # Connect deprec:db to deprec:mysql, deprec:web to deprec:apache, etc
+  on :load, 'deprec:connect_canonical_tasks' 
+
+  # Set the value if not already set
+  # This method is accessible to all recipe files
+  # Defined and used by capistrano/deploy tasks
+  def _cset(name, *args, &block)
+    unless exists?(name)
+      set(name, *args, &block)
+    end
+  end
+
+  # deprecated
+  alias :default :_cset
+
+  _cset :rake, 'rake'
+  
+  # Deprec checks here for local versions of config templates before it's own
+  _cset :local_template_dir, File.join('config','templates')
+  
+  # The following two Constants contain details of the configuration 
+  # files used by each service. They're used when generating config
+  # files from templates and when configs files are pushed out to servers.
+  #
+  # They are populated by the recipe file for each service
+  #
+  SYSTEM_CONFIG_FILES  = {} # e.g. httpd.conf
+  PROJECT_CONFIG_FILES = {} # e.g. projectname-httpd-vhost.conf
+  
+  # For each service, the details of the file to download and options
+  # to configure, build and install the service
+  SRC_PACKAGES = {} unless defined?(SRC_PACKAGES)
+
+  # deprec defines some generic recipes for common services
+  # including ruby interpreter, web, app and database servers
+  #
+  # They default to my current favourites which you can over ride
+  #  
+  # Service options
+  CHOICES_RUBY_VM   = [:mri, :ree]
+  CHOICES_WEBSERVER = [:apache, :none] # :nginx not recipes out of date
+  CHOICES_APPSERVER = [:passenger, :none] # any colour you like guys
+  CHOICES_DATABASE  = [:mysql, :postgresql, :sqlite, :none]
+  # 
+  # Service defaults
+  _cset :ruby_vm_type,    :mri
+  _cset :web_server_type, :apache
+  _cset :app_server_type, :passenger
+  _cset :db_server_type,  :mysql
+
+  # Prompt user for missing values if not supplied
+  _cset(:application) do
+    Capistrano::CLI.ui.ask "Enter name of project(no spaces)" do |q|
+      q.validate = /^[0-9a-z_]*$/
+    end
+  end 
+
+  _cset(:domain) do
+    Capistrano::CLI.ui.ask "Enter domain name for project" do |q|
+      q.validate = /^[0-9a-z_\.]*$/
+    end
+  end
+
+  _cset(:repository) do
+    Capistrano::CLI.ui.ask "Enter repository URL for project" do |q|
+      # q.validate = //
+    end
+  end
+
+  _cset :backup_dir, '/var/backups'  
+
+  # XXX rails deploy stuff
+  _cset :apps_root,    '/srv'  # parent dir for apps
+  _cset(:deploy_to)    { File.join(apps_root, application) } # dir for current app
+  _cset(:current_path) { File.join(deploy_to, "current") }
+  _cset(:shared_path)  { File.join(deploy_to, "shared") }
+
+  # XXX more rails deploy stuff?
+
+  _cset :user, ENV['USER']         # user who is deploying
+  _cset :group, 'deploy'           # deployment group
+  _cset(:group_src) { group }      # group ownership for src dir
+  _cset :src_dir, '/usr/local/src' # 3rd party src on servers lives here
+  _cset(:web_server_aliases) { domain.match(/^www/) ? [] : ["www.#{domain}"] }    
+
+  # It can be useful to know the user running this command
+  # even when USER is set to someone else. Sorry windows!
+  _cset :current_user, `whoami`.chomp
+
+  namespace :deprec do
+    
+    task :connect_canonical_tasks do      
+      # link application specific recipes into canonical task names
+      # e.g. deprec:web:restart => deprec:nginx:restart 
+      
+      
+      namespaces_to_connect = { :web => :web_server_type,
+                                :app => :app_server_type,
+                                :db  => :db_server_type,
+                                :ruby => :ruby_vm_type
+                              }
+      metaclass = class << self; self; end # XXX unnecessary?
+      namespaces_to_connect.each do |server, choice|
+        server_type = send(choice).to_sym
+        if server_type != :none
+          metaclass.send(:define_method, server) { namespaces[server] } # XXX unnecessary?
+          namespaces[server] = deprec.send(server_type)          
+        end
+      end
+    end
+
+    task :dump do
+      require 'yaml'
+      y variables
+    end
+    
+    task :setup_src_dir do
+      deprec2.groupadd(group_src)
+      deprec2.add_user_to_group(user, group_src)
+      deprec2.create_src_dir
+    end
+    
+    # Download all packages used by deprec to your local host.
+    # You can then push them to /usr/local/src on target hosts
+    # to save time and bandwidth rather than repeatedly downloading
+    # from the distribution sites.
+    task :update_src do
+      SRC_PACKAGES.each{|key, src_package| 
+        current_dir = Dir.pwd
+        system "cd src/ && test -f #{src_package[:filename]} || wget --quiet --timestamping #{src_package[:url]}"
+        system "cd #{current_dir}"
+      }
+    end
+    
+    # todo
+    #
+    # Copy files from src/ to /usr/local/src/ on remote hosts
+    task :push_src do
+      SRC_PACKAGES.each do |key, src_package| 
+        deprec2.set_package_defaults(src_package)
+        file = File.join('src', src_package[:filename])
+        if File.exists?(file)
+          std.su_put(File.read(file), "#{src_dir}/#{src_package[:filename]}", '/tmp/')
+        end
+      end
+    end
+    
+    task :list_src do
+      # XXX ugly line - look away
+      max_key_size = SRC_PACKAGES.keys.max{|a,b| a.to_s.size <=> b.to_s.size}.to_s.size
+      SRC_PACKAGES.each{|key, src_package| 
+        deprec2.set_package_defaults(src_package)
+        puts "#{key}#{' '*(max_key_size+1-key.to_s.size)}: #{src_package[:url]}"
+      }
+    end
+    
+    task :find_src do
+      # XXX ugly line - look away
+      max_key_size = SRC_PACKAGES.keys.max{|a,b| a.to_s.size <=> b.to_s.size}.to_s.size
+      SRC_PACKAGES.each{|key, src_package| 
+        deprec2.set_package_defaults(src_package)
+        puts "#{key}#{' '*(max_key_size+1-key.to_s.size)}: #{src_package[:url]}"
+        puts `find . -name #{src_package[:filename]}`
+        puts
+      }
+    end
+    
+    task :recover_src do
+      # XXX ugly line - look away
+      max_key_size = SRC_PACKAGES.keys.max{|a,b| a.to_s.size <=> b.to_s.size}.to_s.size
+      SRC_PACKAGES.each{|key, src_package| 
+        puts "#{key}#{' '*(max_key_size+1-key.to_s.size)}: #{src_package[:url]}"
+        file = `find . -name #{src_package[:filename]}`.split[0]
+        `cp #{file} src/` if file
+        puts
+      }
+    end
+     
+  end
+  
+end

data/lib/deprec-core/deprecated.rb

@@ -0,0 +1,71 @@
+# Copyright 2006-2008 by Mike Bailey. All rights reserved.
+Capistrano::Configuration.instance(:must_exist).load do 
+  
+  # deprecated tasks from deprec1
+  # we're now using namespaces and some different naming conventions
+  
+  # XXX use deprecated function to generate these dynamically
+  
+  deprec2_isnt_backwards_compatible = <<-EOF
+    
+You've installed deprec2 but seem to be using a deprec1 command.
+
+You have two options:
+
+- install deprec-1.9.x and continue using deprec1
+
+  Instructions are available at http://www.deprec.org/
+
+- use deprec2
+
+EOF
+
+  cap2_warning = <<-EOF
+  
+You're using Capistrano 2 but using a deprecated cap1 command.
+
+EOF
+  
+  task :setup_admin_account do
+    puts deprec2_isnt_backwards_compatible  
+    puts "  Replace 'cap setup_admin_account' with 'cap deprec:users:add'"
+    puts
+  end
+  
+  task :change_root_password do
+    puts deprec2_isnt_backwards_compatible  
+    puts "  Replace 'cap change_root_password' with 'cap deprec:users:passwd'"
+    puts
+  end
+  
+  task :setup_ssh_keys do
+    puts deprec2_isnt_backwards_compatible  
+    puts "  Replace 'cap setup_ssh_keys' with 'cap deprec:ssh:setup_keys'"
+    puts
+  end
+  
+  task :install_rails_stack do
+    puts deprec2_isnt_backwards_compatible  
+    puts "  Replace 'cap install_rails_stack' with 'cap deprec:rails:install_rails_stack'"
+    puts
+  end
+  
+  task :setup do
+    puts deprec2_isnt_backwards_compatible  
+    puts "  Replace 'cap setup' with 'cap deploy:setup'"
+    puts
+  end
+  
+  task :restart_apache do
+    puts deprec2_isnt_backwards_compatible  
+    puts "  Replace 'cap restart_apache' with 'cap deprec:apache:restart'"
+    puts
+  end
+  
+  task :show_tasks do
+    puts deprec2_isnt_backwards_compatible  
+    puts "  Replace 'cap show-tasks' with 'cap -T'"
+    puts
+  end
+  
+end

data/lib/deprec-core/version.rb

@@ -1,5 +1,5 @@
 module Deprec
   module Core
-    VERSION = "3.1.1"
+    VERSION = "3.1.2"
   end
 end

data/lib/deprec-core.rb

@@ -3,12 +3,9 @@ require "deprec-core/version"
 if defined?(Capistrano)
   require "#{File.dirname(__FILE__)}/deprec-core/capistrano_extensions"
   require "#{File.dirname(__FILE__)}/vmbuilder_plugins/all"
+  require "#{File.dirname(__FILE__)}/deprec-core/canonical"
+  require "#{File.dirname(__FILE__)}/deprec-core/deprec"
+  require "#{File.dirname(__FILE__)}/deprec-core/deprecated"
 elsif defined?(rake)
   # pass
 end
-
-module Deprec
-  module Core
-    # Your code goes here...
-  end
-end

metadata

@@ -2,7 +2,7 @@
 name: deprec-core
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 3.1.1
+  version: 3.1.2
 platform: ruby
 authors: 
 - Mike Bailey
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-07-15 00:00:00 Z
+date: 2011-07-16 00:00:00 Z
 dependencies: []
 
 description: deprec-core was extracted from the popular deprec gem to make it easier for people to publish Capistrano and Rake task gems
@@ -24,12 +24,16 @@ extra_rdoc_files: []
 
 files: 
 - .gitignore
+- CHANGELOG
 - Gemfile
 - README.md
 - Rakefile
 - deprec-core.gemspec
 - lib/deprec-core.rb
+- lib/deprec-core/canonical.rb
 - lib/deprec-core/capistrano_extensions.rb
+- lib/deprec-core/deprec.rb
+- lib/deprec-core/deprecated.rb
 - lib/deprec-core/version.rb
 - lib/vmbuilder_plugins/all.rb
 - lib/vmbuilder_plugins/apt.rb