New project layout, Carthage, SPM [WIP]

.gitignore

@@ -26,8 +26,12 @@ Carthage
 # We recommend against adding the Pods directory to your .gitignore. However
 # you should judge for yourself, the pros and cons are mentioned at:
 # http://guides.cocoapods.org/using/using-cocoapods.html#should-i-ignore-the-pods-directory-in-source-control
-# 
+#
 # Note: if you ignore the Pods directory, make sure to uncomment
 # `pod install` in .travis.yml
 #
 # Pods/
+
+Gemfile.lock
+play
+spec/staging

.travis.yml

@@ -1,14 +1,15 @@
-# references:
-# * http://www.objc.io/issue-6/travis-ci.html
-# * https://github.com/supermarin/xcpretty#usage
+language: ruby
+sudo: false
+
+cache: bundler
+rvm:
+  - 2.2.5
+  - 2.2.2
+
+# By default, this runs rake on the latest ruby and executes
+# bundle install --jobs=3 --retry=3
+# rake
 
-osx_image: xcode7.3
-language: objective-c
-# cache: cocoapods
-# podfile: Example/Podfile
-# before_install:
-# - gem install cocoapods # Since Travis is not always on latest version
-# - pod install --project-directory=Example
 script:
-- set -o pipefail && xcodebuild test -workspace Example/${POD_NAME}.xcworkspace -scheme ${POD_NAME}-Example -sdk iphonesimulator9.3 ONLY_ACTIVE_ARCH=NO | xcpretty
-- pod lib lint
+ - git fetch --unshallow
+ - bundle exec rake

Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+gem 'rake'
+gem 'rspec'
+gem 'cocoapods'
+

LICENSE

@@ -1,6 +1,6 @@
 This project is licensed under the MIT license.
 
-Copyright (c) 2013 - 2014 CocoaPods Dev Team
+Copyright (c) 2013 - 2016 CocoaPods Dev Team
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,26 +1,42 @@
 pod-template
 ============
 
-An opinionated template for creating a Pod with the following features:
+[![Build Status](https://travis-ci.org/CocoaPods/pod-template.svg?branch=develop)](https://travis-ci.org/CocoaPods/pod-template)
 
-- Git as the source control management system
+An opinionated template for Swift and Objective-C frameworks with the following features:
+
+- Prompt-based project generation
+- Support for CocoaPods, Carthage and project layout compatible with Swift Package Manager
 - Clean folder structure
-- Project generation
 - MIT license
 - Testing as a standard
 - Turnkey access to Travis CI
-- Also supports Carthage
+
 
 ## Getting started
 
-There are two reasons for wanting to work on this template, making your own or improving the one for everyone's. In both cases you will want to work with the ruby classes inside the `setup` folder, and the example base template that it works on from inside `template/ios/`. 
+Most CocoaPods framework developers will use `pod-template` by running `pod lib create POD_NAME`. You can also follow along with the guide at: https://guides.cocoapods.org/making/using-pod-lib-create.html
 
-## Best practices
+You must run **CocoaPods 1.0.0+** to use this template.
 
-The command `pod lib create` aims to be ran along with this guide: http://guides.cocoapods.org/making/using-pod-lib-create.html so any changes of flow should be updated there also.
 
-It is open to communal input, but adding new features, or new ideas are probably better off being discussed in an issue first. In general we try to think if an average Xcode user is going to use this feature or not, if it's unlikely is it a _very strongly_ encouraged best practice ( ala testing / CI. ) If it's something useful for saving a few minutes every deploy, or isn't easily documented in the guide it is likely to be denied in order to keep this project as simple as possible.
+## Hacking
 
-## Requirements:
+- Clone and `cd` into the directory
+- Run some stuff you need to run for any Ruby project:
+  - `gem install bundler`
+  - `bundle install`
+- Run the included test suite:
+  - `rake`
+  - Note: this uses the latest released version of CocoaPods to run this template (retrieved with Bundler above)
+- Try it for real:
+  - `cd ~/Desktop`
+  - `pod lib create --verbose --template-url='file:///PATH/TO/pod-template' NewPod`
+  - Note: this uses your INSTALLED VERSION of `pod` to run this template
+- Hacking:
+  - **Note: you MUST commit to git BEFORE you do `rake` testing or `pod lib create` testing. Both of those tools pull from master in your local repository. Learn how to squash commits :-)**
+
+
+## Best practices
 
-- CocoaPods 1.0.0+
+This project welcomes communal input, but please discuss new features and new ideas as an issue before sending a pull request. In general we try to think if an average Xcode user is going to use this feature or not, if it's unlikely is it a _very strongly_ encouraged best practice (à la testing / continuous integration). If it's something useful for saving a few minutes every deploy, or isn't easily documented in the guide it is likely to be denied in order to keep this project as simple as possible.

Rakefile

@@ -0,0 +1,19 @@
+require 'rake'
+require 'rspec/core/rake_task'
+require 'colored'
+
+desc 'Run specs'
+RSpec::Core::RakeTask.new do |t|
+  # Configure RSpec
+  t.pattern = './spec/**/*_spec.rb'
+  t.rspec_opts = '--format documentation'
+  # Prepare testing area
+  puts 'Wiping out staging area for testing'
+  FileUtils.rm_rf 'spec/staging'
+  FileUtils::mkdir_p 'spec/staging'
+end
+
+task :default => :spec do
+  puts "All RSpec testing is complete".blue
+  puts "You can manually inspect test artifacts in spec/staging/".blue
+end