cocoapods 0.0.1

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2011 Eloy Durán <eloy.de.enige@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,184 @@
+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.
+
+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 dependencies.
+* Set them up to be build as part of a ‘dependency’ static library, which your
+  project links against.
+
+
+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
+    $ pod setup
+
+
+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'.
+
+
+Contact
+=======
+
+Eloy Durán:
+
+* http://github.com/alloy
+* http://twitter.com/alloy
+* eloy.de.enige@gmail.com
+
+
+LICENSE
+=======
+
+These works are available under the MIT license. See the [LICENSE][license] file
+for more info.
+
+
+[license]: cocoa-pods/blob/master/LICENSE
+[example]: cocoa-pods/blob/master/examples/PodSpec.podspec
+[master]: http://github.com/alloy/cocoa-pod-specs

data/bin/pod

@@ -0,0 +1,9 @@
+#!/usr/bin/env macruby
+
+if $0 == __FILE__
+  $:.unshift File.expand_path('../../lib', __FILE__)
+end
+
+require 'cocoapods'
+
+Pod::Command.run(*ARGV)

data/lib/cocoapods.rb

@@ -0,0 +1,32 @@
+module Pod
+  VERSION = '0.0.1'
+
+  class Informative < StandardError
+  end
+
+  autoload :Command,       'cocoapods/command'
+  autoload :Config,        'cocoapods/config'
+  autoload :Dependency,    'cocoapods/dependency'
+  autoload :Downloader,    'cocoapods/downloader'
+  autoload :Executable,    'cocoapods/executable'
+  autoload :Installer,     'cocoapods/installer'
+  autoload :Resolver,      'cocoapods/resolver'
+  autoload :Source,        'cocoapods/source'
+  autoload :Spec,          'cocoapods/specification'
+  autoload :Specification, 'cocoapods/specification'
+  autoload :Version,       'cocoapods/version'
+
+  module Xcode
+    autoload :Config,      'cocoapods/xcode/config'
+    autoload :Project,     'cocoapods/xcode/project'
+  end
+
+  autoload :Pathname,      'pathname'
+end
+
+class Pathname
+  def glob(pattern = '')
+    Dir.glob((self + pattern).to_s).map { |f| Pathname.new(f) }
+  end
+end
+

data/lib/cocoapods/command.rb

@@ -0,0 +1,88 @@
+module Pod
+  class Command
+    autoload :Install, 'cocoapods/command/install'
+    autoload :Repo,    'cocoapods/command/repo'
+    autoload :Setup,   'cocoapods/command/setup'
+    autoload :Spec,    'cocoapods/command/spec'
+
+    class Help < Informative
+      def initialize(command_class, argv)
+        @command_class, @argv = command_class, argv
+      end
+
+      def message
+        [
+          @command_class.banner,
+          '',
+          'Options',
+          '-------',
+          '',
+          @command_class.options
+        ].join("\n")
+      end
+    end
+
+    class ARGV < Array
+      def options;        select { |x| x.to_s[0,1] == '-' };   end
+      def arguments;      self - options;                      end
+      def option(name);   !!delete(name);                      end
+      def shift_argument; (arg = arguments[0]) && delete(arg); end
+    end
+
+    def self.banner
+      "To see help for the available commands run:\n" \
+      "\n" \
+      "  * $ pod setup --help\n" \
+      "  * $ pod install --help\n" \
+      "  * $ pod repo --help"
+    end
+
+    def self.options
+      "    --help      Show help information\n" \
+      "    --silent    Print nothing\n" \
+      "    --verbose   Print more information while working\n" \
+      "    --version   Prints the version of CocoaPods"
+    end
+
+    def self.run(*argv)
+      parse(*argv).run
+    rescue Exception => e
+      unless e.is_a?(Informative)
+        puts "Oh no, an error occurred. Please run with `--verbose' and report " \
+             "on https://github.com/alloy/cocoapods/issues."
+        puts ""
+      end
+      puts e.message
+      puts *e.backtrace if Config.instance.verbose
+      exit 1
+    end
+
+    def self.parse(*argv)
+      argv = ARGV.new(argv)
+      raise Informative, VERSION if argv.option('--version')
+
+      show_help = argv.option('--help')
+      Config.instance.silent = argv.option('--silent')
+      Config.instance.verbose = argv.option('--verbose')
+
+      command_class = case argv.shift_argument
+      when 'install' then Install
+      when 'repo'    then Repo
+      when 'setup'   then Setup
+      when 'spec'    then Spec
+      end
+
+      if show_help || command_class.nil?
+        raise Help.new(command_class || self, argv)
+      else
+        command_class.new(argv)
+      end
+    end
+
+    include Config::Mixin
+
+    def initialize(argv)
+      raise Help.new(self.class, argv)
+    end
+  end
+end

data/lib/cocoapods/command/install.rb

@@ -0,0 +1,48 @@
+module Pod
+  class Command
+    class Install < Command
+      def self.banner
+%{Installing dependencies of a pod spec:
+
+    $ pod install [NAME]
+
+      Downloads all dependencies of the specified podspec file `NAME' and
+      creates an Xcode Pods library project in `./Pods'. In case `NAME' is
+      omitted it defaults to either `Podfile' or `*.podspec' in the current
+      working directory.
+}
+      end
+
+      def self.options
+        "    --no-clean  Leave SCM dirs like `.git' and `.svn' in tact after downloading\n" +
+        super
+      end
+
+      def initialize(argv)
+        config.clean = !argv.option('--no-clean')
+        if podspec = argv.shift_argument
+          @podspec = Pathname.new(podspec)
+        end
+        super unless argv.empty?
+      end
+
+      def run
+        spec = nil
+        if @podspec
+          if @podspec.exist?
+            spec = Specification.from_podspec(@podspec)
+          else
+            raise Help, "The specified podspec `#{@podspec}' doesn't exist."
+          end
+        else
+          if config.project_podfile.exist?
+            spec = Specification.from_podfile(config.project_podfile)
+          else
+            raise Help, "No Podfile found in current working directory."
+          end
+        end
+        Installer.new(spec).install!
+      end
+    end
+  end
+end

data/lib/cocoapods/command/repo.rb

@@ -0,0 +1,60 @@
+require 'fileutils'
+
+module Pod
+  class Command
+    class Repo < Command
+      def self.banner
+%{Managing spec-repos:
+
+    $ pod help repo
+
+      pod repo add NAME URL
+        Clones `URL' in the local spec-repos directory at `~/.cocoapods'. The
+        remote can later be referred to by `NAME'.
+
+      pod repo update NAME
+        Updates the local clone of the spec-repo `NAME'. If `NAME' is omitted
+        this will update all spec-repos in `~/.cocoapods'.}
+      end
+
+      extend Executable
+      executable :git
+
+      def initialize(argv)
+        case @action = argv.arguments[0]
+        when 'add'
+          unless (@name = argv[1]) && (@url = argv[2])
+            raise Help, "Adding a repo needs a `name' and a `url'."
+          end
+        when 'update'
+          @name = argv[1]
+        else
+          super
+        end
+      end
+
+      def dir
+        config.repos_dir + @name
+      end
+
+      def run
+        send @action
+      end
+
+      def add
+        puts "==> Cloning spec repo `#{@name}' from `#{@url}'" unless config.silent?
+        config.repos_dir.mkpath
+        Dir.chdir(config.repos_dir) { git("clone #{@url} #{@name}") }
+      end
+
+      def update
+        dirs = @name ? [dir] : config.repos_dir.children
+        dirs.each do |dir|
+          puts "==> Updating spec repo `#{dir.basename}'" unless config.silent?
+          Dir.chdir(dir) { git("pull") }
+        end
+      end
+    end
+  end
+end
+