cocoapods 0.0.1 → 0.0.2

data/README.md

@@ -1,5 +1,4 @@
-CocoaPods
----------
+# CocoaPods
 
 CocoaPods is an Objective-C library package manager. It tries to take away all
 hard work of maintaining your dependencies, but in a lean and flexible way.
@@ -10,160 +9,34 @@ unify the way in which we deal with them.
 CocoaPods will:
 
 * Calculate the right set of versions of all of your project’s dependencies.
+  _Currently the resolver is very naive and any conflicts will have to be solved
+  by you, the user. This will change in the future._
 * Install dependencies.
 * Set them up to be build as part of a ‘dependency’ static library, which your
   project links against.
 
+For more in depth information see the [wiki][wiki].
 
-Installing CocoaPods
-====================
+
+**_NOTE: At the moment [only iOS projects are supported][ticket], but this will
+be fixed in the very near future._**
+
+## Installing CocoaPods
 
 You’ll need MacRuby. CocoaPods itself installs through RubyGems, the Ruby
 package manager:
 
-    $ brew install macruby [TODO There's actually no MacRuby homebrew formula]
-    $ macgem install cocoa-pods
+    $ brew install macruby
+    $ macgem install cocoapods
     $ pod setup
 
+The load time can be improved a bit by compiling the Ruby source files:
 
-Making a Pod
-============
-
-A manifest that describes the library and its dependencies is called a Pod.
-Consider you want to create a new library that retrieves the latest price of
-your favorite ice cream called IcePop.
-
-    $ pod spec create IcePop
-    $ cd IcePop
-    $ tree .
-      - IcePop
-      |- IcePop.podspec
-      |- LICENSE
-      |- README
-      |\ Source
-      | | - IcePop.h
-      | | - IcePop.m
-      |- Test
-
-You can also initialize a Pod for an existing library, which will only create a
-`.podspec` file.
-
-    $ cd IcePop
-    $ pod spec init IcePop
-
-
-Anatomy of a PodSpec manifest
-=============================
-
-    class IcePop < Pod::Spec
-      version    '1.0.0'                                                                  # 1
-      summary    'A library that retrieves the current price of your favorite ice cream.' # 2
-      author     'Eloy Durán' => 'eloy.de.enige@gmail.com'                                # 3
-      source     :git => 'https://github.com/alloy/ice-pop.git'                           # 4
-      dependency 'AsyncSocket', '~> 0.6'                                                  # 5
-    end
-
-1. The version of this pod.
-2. A short summary of this pod’s description.
-3. The author of this pod and his/her email address.
-4. Where to retrieve this pod’s source.
-5. Defines a dependency of the library itself, with a version requirement
-   of 0.6 trough 0.9.
-
-See the [example PodSpec file][example] for a full list of the available
-attributes and more detailed information.
-
-
-Sharing a Pod
-=============
-
-CocoaPod uses git repositories with `.podspec` files as its database. In order
-to share your pod, its `.podspec` file will have to be added to such a repo.
-
-    $ pod repo add my-spec-repo http://github.com/alloy/spec-repo.git
-    $ pod push my-spec-repo
-
-This will:
-
-1. Validate the `.podspec` file.
-1. Update the clone of the local spec-repo called `my-spec-repo`.
-2. Add the `.podspec` file to the spec-repo, namespaced by name and version.
-3. Push the changes from the local spec-repo to its remote.
-
-
-Share with everyone
-===================
-
-CocoaPods, itself, has a [spec-repo][master], called the `master` spec-repo.
-This repo is meant as a central public place for any open-source pod. All
-installations of CocoaPods will have a local clone of this repo.
-
-However, normally you will have read-only access only. Thus to get a PodSpec
-into the `master` spec-repo you will have to push to your own fork and send
-a pull request.
-
-Once your first PodSpec has been merged, you will be given push access to the
-`master` spec-repo and are allowed to update and add `.podspec` files at your
-own leisure.
-
-Once you receive push acces, you will have to change your `master` spec-repo’s
-remote URL with:
-
-    $ pod repo change master git@github.com:alloy/cocoa-pod-specs.git
-
-
-Commands overview
-=================
-
-### Setup
-
-    $ pod help setup
-
-      pod setup
-        Creates a directory at `~/.cocoa-pods' which will hold your spec-repos.
-        This is where it will create a clone of the public `master' spec-repo.
-
-### Managing PodSpec files
-
-    $ pod help spec
-
-      pod spec create NAME
-        Creates a directory for your new pod, named `NAME', with a default
-        directory structure and accompanying `NAME.podspec'.
-
-      pod spec init NAME
-        Creates a PodSpec, in the current working dir, called `NAME.podspec'.
-        Use this for existing libraries.
-
-      pod spec lint NAME
-        Validates `NAME.podspec' from a local spec-repo. In case `NAME' is
-        omitted, it defaults to the PodSpec in the current working dir.
-
-      pod spec push REMOTE
-        Validates `NAME.podspec' in the current working dir, copies it to the
-        local clone of the `REMOTE' spec-repo, and pushes it to the `REMOTE'
-        spec-repo. In case `REMOTE' is omitted, it defaults to `master'.
-
-### Managing spec-repos
-
-    $ pod help repo
-
-      pod repo add NAME URL
-        Clones `URL' in the local spec-repos directory at `~/.cocoa-pods'. The
-        remote can later be referred to by `NAME'.
-
-      pod repo update NAME
-        Updates the local clone of the spec-repo `NAME'.
-
-      pod repo change NAME URL
-        Changes the git remote of local spec-repo `NAME' to `URL'.
-
-      pod repo cd NAME
-        Changes the current working dir to the local spec-repo `NAME'.
+    $ macgem install rubygems-compile
+    $ macgem compile cocoapods
 
 
-Contact
-=======
+## Contact
 
 Eloy Durán:
 
@@ -172,13 +45,12 @@ Eloy Durán:
 * eloy.de.enige@gmail.com
 
 
-LICENSE
-=======
+## LICENSE
 
 These works are available under the MIT license. See the [LICENSE][license] file
 for more info.
 
 
+[ticket]: https://github.com/alloy/cocoapods/issues/3
+[wiki]: https://github.com/alloy/cocoapods/wiki
 [license]: cocoa-pods/blob/master/LICENSE
-[example]: cocoa-pods/blob/master/examples/PodSpec.podspec
-[master]: http://github.com/alloy/cocoa-pod-specs

data/lib/cocoapods.rb

@@ -1,5 +1,5 @@
 module Pod
-  VERSION = '0.0.1'
+  VERSION = '0.0.2'
 
   class Informative < StandardError
   end

data/lib/cocoapods/command.rb

@@ -2,6 +2,7 @@ module Pod
   class Command
     autoload :Install, 'cocoapods/command/install'
     autoload :Repo,    'cocoapods/command/repo'
+    autoload :Search,  'cocoapods/command/search'
     autoload :Setup,   'cocoapods/command/setup'
     autoload :Spec,    'cocoapods/command/spec'
 
@@ -33,6 +34,7 @@ module Pod
       "To see help for the available commands run:\n" \
       "\n" \
       "  * $ pod setup --help\n" \
+      "  * $ pod search --help\n" \
       "  * $ pod install --help\n" \
       "  * $ pod repo --help"
     end
@@ -68,6 +70,7 @@ module Pod
       command_class = case argv.shift_argument
       when 'install' then Install
       when 'repo'    then Repo
+      when 'search'  then Search
       when 'setup'   then Setup
       when 'spec'    then Spec
       end

data/lib/cocoapods/command/search.rb

@@ -0,0 +1,35 @@
+module Pod
+  class Command
+    class Search < Command
+      def self.banner
+%{Search pods:
+
+    $ pod search [QUERY]
+
+      Searches for pods, ignoring case, whose name matches `QUERY'. If the
+      `--full' option is specified, this will also search in the summary and
+      description of the pods.}
+      end
+
+      def self.options
+        "    --full      Search by name, summary, and description\n" +
+        super
+      end
+
+      def initialize(argv)
+        @full_text_search = argv.option('--full')
+        unless @query = argv.arguments.first
+          super
+        end
+      end
+
+      def run
+        Source.search_by_name(@query.strip, @full_text_search).each do |set|
+          puts "==> #{set.name} (#{set.versions.reverse.join(", ")})"
+          puts "    #{set.specification.read(:summary).strip}"
+          puts
+        end
+      end
+    end
+  end
+end

data/lib/cocoapods/source.rb

@@ -12,20 +12,48 @@ module Pod
     end
 
     def self.search(dependency)
-      all.map { |source| source.search(dependency) }.compact.first ||
+      all.map { |s| s.search(dependency) }.compact.first ||
         raise(Informative, "Unable to find a pod named `#{dependency.name}'")
     end
 
+    def self.search_by_name(query, full_text_search)
+      result = all.map { |s| s.search_by_name(query, full_text_search) }.flatten
+      if result.empty?
+        extra = ", summary, or description" if full_text_search
+        raise(Informative, "Unable to find a pod who's name" \
+                           "#{extra} matches `#{query}'")
+      end
+      result
+    end
+
     attr_reader :repo
 
     def initialize(repo)
       @repo = repo
     end
 
+    def pod_sets
+      @repo.children.map do |child|
+        if child.directory? && child.basename.to_s != '.git'
+          Specification::Set.by_pod_dir(child)
+        end
+      end.compact
+    end
+
     def search(dependency)
-      if dir = @repo.children.find { |c| c.basename.to_s == dependency.name }
-        Specification::Set.by_pod_dir(dir)
-      end
+      pod_sets.find { |set| set.name == dependency.name }
+    end
+
+    def search_by_name(query, full_text_search)
+      pod_sets.map do |set|
+        text = if full_text_search
+          s = set.specification
+          "#{s.read(:name)} #{s.read(:summary)} #{s.read(:description)}"
+        else
+          set.name
+        end
+        set if text.downcase.include?(query.downcase)
+      end.compact
     end
   end
 end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 0
-  - 1
-  version: 0.0.1
+  - 2
+  version: 0.0.2
 platform: ruby
 authors: 
 - Eloy Duran
@@ -18,7 +18,9 @@ date: 2011-09-17 00:00:00 +02:00
 default_executable: 
 dependencies: []
 
-description: 
+description: |-
+  CocoaPods is an Objective-C library package manager. It tries to take away all hard work of maintaining your dependencies, but in a lean and flexible way. Its goal is to create a more centralized overview of open-source libraries and unify the way in which we deal with them.
+  CocoaPods will calculate the right set of versions of all of your project's dependencies, install them, and set them up to be build as part of a dependency static library, which your project links against.
 email: eloy.de.enige@gmail.com
 executables: 
 - pod
@@ -29,6 +31,7 @@ extra_rdoc_files: []
 files: 
 - lib/cocoapods/command/install.rb
 - lib/cocoapods/command/repo.rb
+- lib/cocoapods/command/search.rb
 - lib/cocoapods/command/setup.rb
 - lib/cocoapods/command/spec.rb
 - lib/cocoapods/command.rb
@@ -56,7 +59,7 @@ homepage: https://github.com/alloy/cocoapods
 licenses: 
 - MIT
 post_install_message: |+
-  To speed up load time of cocoapods consider compiling the Ruby source files:
+  To speed up load time of CocoaPods consider compiling the Ruby source files:
   
       $ sudo macgem install rubygems-compile
       $ sudo macgem compile cocoapods