Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Making pod plugins an abstract command with search as default subcommand #13

Merged
merged 9 commits into from
May 2, 2014
Merged

Making pod plugins an abstract command with search as default subcommand #13

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
e7f13c0
Refactoring (#10) + Making `pod plugins` an abstract command (#11) wi…
AliSoftware Apr 29, 2014
67a03da
Small fixes in spec (removed argv function, removed commented-out line)
AliSoftware Apr 29, 2014
9728c69
Merge branch 'CocoaPods/master' into 'AliSoftware/master'
AliSoftware Apr 29, 2014
6e81455
Improved help message a bit
AliSoftware Apr 29, 2014
1d9eaa0
Added brackets around `QUERY` argument to let it show it's optional now.
AliSoftware Apr 29, 2014
93fbea4
* Adding the 'list' subcommand, making it the default
AliSoftware May 1, 2014
4fc74ca
Removed useless `require` statement
AliSoftware May 1, 2014
55fe55f
small rdoc fixes
AliSoftware May 1, 2014
e1ddea1
I'm a perfectionist.
AliSoftware May 1, 2014
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,16 @@

## 0.1.1

* Improved output formatting and fixing some coding conventions
* Making `pod plugins` an abstract command, with `search` the default subcommand (#11 & #12)
[Olivier Halligon](https://github.com/AliSoftware)
* Added `search` subcommand to search plugins by name, author and description
* Refactoring, improved output formatting and fixing some coding conventions (#10)
[Olivier Halligon](https://github.com/AliSoftware)
* Added `search` subcommand to search plugins by name, author and description.
[Olivier Halligon](https://github.com/AliSoftware)

## 0.1.0

* Initial implementation.
[David Grandinetti](https://github.com/dbgrandi)
* Added `create` subcommand to create an empty project for a new plugin
* Added `create` subcommand to create an empty project for a new plugin.
[Boris Bügling](https://github.com/neonichu)
202 changes: 5 additions & 197 deletions lib/pod/command/plugins.rb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,210 +10,18 @@ class Command
#
class Plugins < Command

PLUGINS_URL = 'https://raw.githubusercontent.com/CocoaPods/cocoapods.org/master/data/plugins.json'
require 'pod/command/plugins/search'
require 'pod/command/plugins/create'

attr_accessor :json
self.abstract_command = true
self.default_subcommand = 'search'

self.summary = 'Show available CocoaPods plugins'

self.description = <<-DESC
Shows the available CocoaPods plugins and if you have them installed or not.
Also allows you to quickly create a new Cocoapods plugin using a provided template.
DESC

# Force-download the JSON
def download_json
response = REST.get(PLUGINS_URL)
if response.ok?
@json = JSON.parse(response.body)
end
end

# Tells if a gem is installed
def installed?(gemname)
if Gem::Specification.methods.include?(:find_all_by_name)
Gem::Specification.find_all_by_name(gemname).any?
else
# Fallback to Gem.available? for old versions of rubygems
Gem.available?(gemname)
end
end

# Download the JSON if not already in @json, then execute the given block
def fetch_plugins_list
UI.puts 'Downloading Plugins list...'
begin
download_json unless json
rescue => e
UI.puts e.message
end

if json
yield @json['plugins'] if block_given?
else
UI.puts 'Could not download plugins list from cocoapods.org'
end
end

def run
fetch_plugins_list do |plugins|
UI.puts "\nAvailable CocoaPods Plugins\n"

plugins.each do |plugin|
print_plugin plugin
end
end
end

# Display information about a plugin given its hash
def print_plugin(plugin)
plugin_name = "-> #{plugin['name']}"
plugin_colored_name = installed?(plugin['gem']) ? plugin_name.green : plugin_name.yellow

UI.title(plugin_colored_name, '', 1) do
UI.puts_indented plugin['description']
UI.labeled('Gem', plugin['gem'])
UI.labeled('URL', plugin['url'])
UI.labeled('Author', plugin['author']) if self.verbose?
end
end

#-----------------------------------------------------------------------#

# The search subcommand. Used to search a plugin in the list of known plugins,
# searching into the name and description fields
#
class Search < Plugins
self.summary = 'Search for known plugins'

self.description = <<-DESC
Search plugins whose name contains the given text (ignoring case).
With --full, search by name but also author and description
DESC

self.arguments = 'QUERY'

def self.options
[
["--full", "Search by name, author, and description"],
].concat(super.reject { |option, _| option == '--silent' })
end

def initialize(argv)
@full_text_search = argv.flag?('full')
@query = argv.shift_argument unless argv.arguments.empty?
super
end

def validate!
super
help! "A search query is required." if @query.nil? || @query.empty?
begin
/#{@query}/
rescue RegexpError
help! "A valid regular expression is required."
end
end

def run
fetch_plugins_list do |plugins|
UI.puts "\nAvailable CocoaPods Plugins matching '#{@query}'\n"

query_regexp = /#{@query}/i
plugins.each do |plugin|
texts = [plugin['name']]
if @full_text_search
texts << plugin['author'] if plugin['author']
texts << plugin['description'] if plugin['description']
end
print_plugin plugin unless texts.grep(query_regexp).empty?
end
end
end

end

#-----------------------------------------------------------------------#

# The create subcommand. Used to create a new plugin using either the
# default template (CocoaPods/cocoapods-plugin-template) or a custom
# template
#
class Create < Plugins
self.summary = 'Creates a new plugin'

self.description = <<-DESC
Creates a scaffold for the development of a new plugin according to the CocoaPods best practices.
If a `TEMPLATE_URL`, pointing to a git repo containing a compatible template, is specified, it will be used in place of the default one.
DESC

self.arguments = 'NAME [TEMPLATE_URL]'

def initialize(argv)
@name = argv.shift_argument
@template_url = argv.shift_argument
super
end

def validate!
super
help! 'A name for the plugin is required.' if @name.nil? || @name.empty?
help! 'The plugin name cannot contain spaces.' if @name.match(/\s/)
end

def run
clone_template
configure_template
end

private

#----------------------------------------#

# !@group Private helpers

extend Executable
executable :git
executable :ruby

TEMPLATE_REPO = 'https://github.com/CocoaPods/cocoapods-plugin-template.git'
TEMPLATE_INFO_URL = 'https://github.com/CocoaPods/cocoapods-plugin-template'

# Clones the template from the remote in the working directory using
# the name of the plugin.
#
# @return [void]
#
def clone_template
UI.section("Creating `#{@name}` plugin") do
git! "clone '#{template_repo_url}' #{@name}"
end
end

# Runs the template configuration utilities.
#
# @return [void]
#
def configure_template
UI.section('Configuring template') do
Dir.chdir(@name) do
if File.file? 'configure'
system "./configure #{@name}"
else
UI.warn 'Template does not have a configure file.'
end
end
end
end

# Checks if a template URL is given else returns the TEMPLATE_REPO URL
#
# @return String
#
def template_repo_url
@template_url || TEMPLATE_REPO
end
end

end
end
end
87 changes: 87 additions & 0 deletions lib/pod/command/plugins/create.rb
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,87 @@
module Pod
class Command
class Plugins

# The create subcommand. Used to create a new plugin using either the
# default template (CocoaPods/cocoapods-plugin-template) or a custom
# template
#
class Create < Plugins

self.summary = 'Creates a new plugin'
self.description = <<-DESC
Creates a scaffold for the development of a new plugin according to the CocoaPods best practices.
If a `TEMPLATE_URL`, pointing to a git repo containing a compatible template, is specified, it will be used in place of the default one.
DESC

self.arguments = 'NAME [TEMPLATE_URL]'

def initialize(argv)
@name = argv.shift_argument
@template_url = argv.shift_argument
super
end

def validate!
super
help! 'A name for the plugin is required.' if @name.nil? || @name.empty?
help! 'The plugin name cannot contain spaces.' if @name.match(/\s/)
end

def run
clone_template
configure_template
end

#----------------------------------------#

private

# !@group Private helpers

extend Executable
executable :git
executable :ruby

TEMPLATE_REPO = 'https://github.com/CocoaPods/cocoapods-plugin-template.git'
TEMPLATE_INFO_URL = 'https://github.com/CocoaPods/cocoapods-plugin-template'

# Clones the template from the remote in the working directory using
# the name of the plugin.
#
# @return [void]
#
def clone_template
UI.section("Creating `#{@name}` plugin") do
git! "clone '#{template_repo_url}' #{@name}"
end
end

# Runs the template configuration utilities.
#
# @return [void]
#
def configure_template
UI.section('Configuring template') do
Dir.chdir(@name) do
if File.file? 'configure'
system "./configure #{@name}"
else
UI.warn 'Template does not have a configure file.'
end
end
end
end

# Checks if a template URL is given else returns the TEMPLATE_REPO URL
#
# @return String
#
def template_repo_url
@template_url || TEMPLATE_REPO
end
end

end
end
end
Loading