albacore 1.0.0 → 2.0.0.rc.1

data/.gitignore

@@ -1,24 +1,9 @@
-*.swp
-*~
-.idea
-
 Gemfile.lock
-
+tmp/
+*.swp
 pkg/
-obj/
-bin/
-build/
-
-_ReSharper.*
-*.csproj.user
-*.resharper.user
-*.resharper
-*.suo
-*.cache
-~$*
-*.tmp
-*.eprj
-*.bkp
+.DS_Store
+spec/testdata/TestingDependencies/Sample.Commands/Sample.Commands.nuspec
+spec/testdata/Project/Sample.Nuget.nuspec
+spec/testdata/TestingDependencies/Sample.Core/Sample.Core.nuspec
 
-/spec/support/Tools/NDepend-v2.12/NDependProLicense.xml
-Gemfile.lock

data/.travis.yml

@@ -1,16 +1,35 @@
+# kisses and hugs to https://raw.github.com/NancyFx/Nancy/master/.travis.yml
+
 language: ruby
+
+install:
+  - sudo bash -c "echo deb http://badgerports.org lucid main >> /etc/apt/sources.list"
+  - sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 0E1FAD0C
+  - sudo apt-get update
+  - sudo apt-get install mono-devel mono-gmcs mono-vbnc
+  - sudo apt-get install gettext
+  - sudo wget -q -P "/opt"  "http://samples.nancyfx.org/content/mono-3.0.12-x64-bin.tar.bz2"
+  - bundle install
+  - echo set -e >> ./travis.sh
+  - echo set -o pipefail >> ./travis.sh
+  - echo echo Running on Mono 3.x >> ./travis.sh
+  - echo sudo tar xk -C "/opt" -f /opt/mono-3.0.12-x64-bin.tar.bz2 >> ./travis.sh
+  - echo export PATH="/opt/mono/bin:$PATH" >> ./travis.sh
+  - echo export LD_LIBRARY_PATH="/opt/mono/bin" >> ./travis.sh
+  - echo bundle exec rake spec >> ./travis.sh
+  - chmod +x ./travis.sh
+
+script: ./travis.sh
+
 rvm:
-- 1.9.3
-- 2.0.0
-- jruby
-script: bundle exec rake specs:all
-bundler_args: --without=wiki
+  - 1.9.3
+  - 2.0.0
+#  - jruby
+
+branches:
+  only: clean_slate
+
 notifications:
-  email: false
+  email: henrik@haf.se
+
 gemfile: Gemfile
-deploy:
-  provider: rubygems
-  api_key:
-    secure: c8WYx8M7i68fZzucth/eI7kj0OX55f6te5Toz88HhDRYdycJ7xu6GJBErOGQBK+26cLnu2sfi//TJXOBayCm7mluTcNSoQMrYalm9s5+oCNyNKbMCZtRZ/kYqHZY4cvOobqKeTTrTJH5puD3PUFbCqat3s4HKrQUjCthfd6ZUeY=
-  on:
-    tags: true

data/Gemfile

@@ -1,6 +1,14 @@
-source "http://rubygems.org"
-gemspec
-
-group :wiki do
-  gem "jekyll"
-end
+#ruby=1.9.3
+#ruby-gemset=albacore_clean_slate
+
+source "http://rubygems.org"
+
+# Windows Rubies (RubyInstaller)
+platforms :mswin, :mingw do
+  gem 'wdm' # for listening to Windows Directory Notifications
+end
+
+# needed to do development and read the version of albacore
+gem 'nokogiri', '~>1.5'
+
+gemspec

data/Guardfile

@@ -1,9 +1,7 @@
 # A sample Guardfile
 # More info at https://github.com/guard/guard#readme
-
-guard 'rspec', :version => 2 do
+guard 'rspec' do
   watch(%r{^spec/.+_spec\.rb$})
   watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
-  watch('spec/spec_helper.rb')  { "spec" }
 end
 

data/README.md

@@ -1,47 +1,200 @@
-# Albacore 
-[![Build Status](https://travis-ci.org/Albacore/albacore.svg?branch=releases%2Fv1.x)](https://travis-ci.org/Albacore/albacore) [![Gem Version](https://badge.fury.io/rb/albacore.png)](http://badge.fury.io/rb/albacore) [![Dependency Status](https://gemnasium.com/Albacore/albacore.png)](https://gemnasium.com/Albacore/albacore) [![Code Climate](https://codeclimate.com/github/Albacore/albacore.png)](https://codeclimate.com/github/Albacore/albacore) 
-
-Albacore is a professional quality suite of Rake tasks for building .NET or Mono based systems. It's like MSBuild or NAnt without all the stabby-bracket XML hell! The tasks are built using a test-first approach and all tests are included in the gem. If you're new to Ruby/Rake read the [quick start][2]. Or, browse the [detailed instructions][1] for each task in our wiki. 
-
-Details about goals and releases can be found at [albacorebuild.net](http://albacorebuild.net) and by following [@albacorebuild](https://twitter.com/albacorebuild).
-
-## Installation
-
-Add this line to the Gemfile where you maintain the dependencies for your build (we recommend the latest RC for RubyZip 1.0 support, only remove the version spec if you know what you're doing!):
-
-```ruby
-gem "albacore", "~> 1.0.0"
-```
-
-And then execute
-
-```batch
-> bundle install
-```
-    
-Or install it yourself:
-
-```batch
-> gem install albacore
-```
-
-## Usage
-
-Require the Albacore gem at the top of your rakefile and start using the custom tasks. Consult the [quick start][3] or the detailed [task instructions][1] for more information on how to use Albacore tasks in your Rake build.
-
-```ruby
-require "albacore"
-```
-
-## Supported Rubies
-
-Albacore has been tested against the following versions of Ruby for Windows and Linux. Use unsupported versions at your own risk!
-
-* MRI: `1.9.3`, `2.0.0` (x86 only, Nokogiri does not support x64 yet)
-* JRuby: `HEAD`
-
-
-
- [1]: https://github.com/Albacore/albacore/wiki
- [2]: https://github.com/Albacore/albacore/wiki#rake-quick-start
- [3]: https://github.com/Albacore/albacore/wiki#albacore-quick-start
+# Albacore Clean Slate
+
+[![Build Status](https://secure.travis-ci.org/Albacore/albacore.png?branch=clean_slate)](http://travis-ci.org/Albacore/albacore)
+
+This branch is the next official version. It is currently being used for
+numerous builds for us and is free of known bugs. It works on RMI 1.9.3.
+
+## getting started
+
+In a command prompt, run:
+
+    @powershell -NoProfile -ExecutionPolicy unrestricted -Command "iex ((new-object net.webclient).DownloadString('http://chocolatey.org/install.ps1'))" && SET PATH=%PATH%;%systemdrive%\chocolatey\bin
+
+Then start a new powershell, cygwin or mingw32 shell. You can now install the
+Ruby framework:
+
+    cinst ruby.devkit
+
+Now, restart your shell or reload its path variable. You now have rake
+installed. Now you can install Albacore, the collection of tasktypes, tasks and
+extension points aimed to make your life as a .Net developer easier:
+
+    gem install bundler
+
+Bundler is a tool that fetches gems for you. Now, specify what ruby gems your
+build will use. Create a new file, named `Gemfile`. This file should look like
+this:
+
+    source 'http://rubygems.org'
+    gem "albacore", :git => "git://github.com/Albacore/albacore.git", :branch => 'clean_slate'
+
+Now, install albacore from this repository by running:
+
+    bundle
+
+In order to build your project, you need to create a `Rakefile`, with contents
+like these:
+
+``` ruby
+require 'bundler/setup'
+
+require 'albacore'
+require 'albacore/tasks/versionizer'
+require 'albacore/ext/teamcity'
+
+Albacore::Tasks::Versionizer.new :versioning
+
+desc 'Perform fast build (warn: doesn't d/l deps)'
+build :quick_build do |b|
+  b.logging = 'detailed'
+  b.sln     = 'src/MyProj.sln'
+end
+
+desc 'restore all nugets as per the packages.config files'
+nugets_restore :restore do |p|
+  p.out = 'src/packages'
+  p.exe = 'buildsupport/NuGet.exe'
+end
+
+desc 'Perform full build'
+build :build => [:versioning, :restore] do |b|
+  b.sln = 'src/MyProj.sln'
+  # alt: b.file = 'src/MyProj.sln'
+end
+
+directory 'build/pkg'
+
+desc 'package nugets - finds all projects and package them'
+nugets_pack :create_nugets => ['build/pkg', :versioning, :build] do |p|
+  p.files   = FileList['src/**/*.{csproj,fsproj,nuspec}'].
+    exclude(/Tests/)
+  p.out     = 'build/pkg'
+  p.exe     = 'buildsupport/NuGet.exe'
+  p.with_metadata do |m|
+    m.description = 'A cool nuget'
+    m.authors = 'Henrik'
+    m.version = ENV['NUGET_VERSION']
+  end
+end
+
+task :default => :create_nugets
+```
+
+You can now run:
+
+    rake
+
+## Ideas:
+
+When building multiple configurations,
+Build tasks should be invoked with different parameters
+According to the graph of tasks to be executed
+
+``` ruby
+require 'albacore'
+
+Albacore.vary_by_parameters do |params|
+  # write to dynamic method
+  params.Configuration = ['Debug-Tests', 'Release']
+end
+
+build :b do |b|
+  b.vary_by_param 'Configuration'
+end
+
+nugets_pack :p => :b do |p|
+ # ... 
+end
+
+task :default => :p
+```
+
+Creating two runs
+  * `:b[Debug-Tests] => :p => :default` and
+  * `:b[Release] => :p => :default`
+
+where only :b is invoked twice, but :p and :default are only invoked only once
+each.
+
+---
+
+When building services and/or web sites,
+The bundling task_type should take care of packaging for deployment
+
+
+### Docs: build
+
+TBD
+
+### Docs: nugets_pack
+
+TBD
+
+### Docs: nugets_restore
+
+TBD
+
+### Docs: asmver
+
+Generate a single file with assembly attributes. Code comments in example below
+mention output in F#.
+
+``` ruby
+asmver :asmver do |a|
+  a.file_path  = 'src/Version.fs' # required, no default
+  a.namespace  = 'Hello.World'    # required, no default
+  # optional
+  a.attributes assembly_title: 'Hello.World', # generates: [<AssemblyTitle("Hello.World")>]
+    assembly_version: '0.1.2',                # generates: [<AssemblyVersion("0.1.2")>]
+    my_product_attr: 'Hello world',           # generates: [<MyProductAttr("Hello World")>]
+  a.out        = StringIO.new     # optional, don't use it this way: takes an IO/Stream
+end
+```
+
+### Docs: test_runner
+
+TBD
+
+### Docs: nugets_authentication
+
+TBD
+
+### Docs: csprojfiles
+
+Checks the difference between the filesystem and the files referenced in a
+csproj, to make sure that they match. Run as a part of a CI build.
+
+``` ruby
+desc "Check the difference between the filesystem and the files referenced in a csproj"
+csprojfiles do |f|
+  # Files to ignore
+  # for instance if you have source control specific files that are not supposed to be in the project 
+  f.ignore_files = [/.*\.srccontrol/] 
+  f.project = "src/MyMvcSite/MyMvcSite.csproj"
+end
+```
+
+When you run this task it will report any differences between the filesystem and
+the csproj file.
+
+Why is this important? It's important to know what resources will be deployed.
+For instance if you have added an image. If you forgot to include the image in
+the .csproj, it will show up while developing but not when you do a web
+deployment (i.e. a release).
+
+It could also be that you have deleted a file, but forgotten to save the project
+when you send your latest commit to source control&hellip;
+
+How do you use it? The best way is to have it on a CI server in order to get a
+notification whenever it detects deviations.
+
+The task will fail with a message and rake will return with an non zero exit
+code. For instance if a file is missing from csproj and another from the
+filesystem:
+
+    - Files in src/MyMvcSite/MyMvcSite.csproj but not on filesystem: 
+      file_missing_on_filesystem.cshtml
+    + Files not in src/MyMvcSite/MyMvcSite.csproj but on filesystem:
+      file_missing_in_csproj.png
+

data/Rakefile

@@ -1,19 +1,9 @@
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-
-task :default => ["specs:all"]
-
-namespace :specs do
-  desc "Run all specs"
-  RSpec::Core::RakeTask.new(:all)
-
-  # make a task for each *_spec.rb in spec/
-  FileList["spec/*_spec.rb"].each do |path|
-    ctx = File.basename(path, "*.rb").split("_").first
-    
-    desc "Run the #{ctx} spec"
-    RSpec::Core::RakeTask.new(ctx) do |t|
-      t.pattern = "spec/#{ctx}_spec.rb"
-    end
-  end
-end
+require 'rubygems/tasks'
+Gem::Tasks.new
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |c|
+  c.rspec_opts = ['--color', '--format=doc']
+end
+
+task :default => :build

data/albacore.gemspec

@@ -1,29 +1,39 @@
-# coding: utf-8
-lib = File.expand_path("../lib", __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+# -*- encoding: utf-8 -*-
 
-require "albacore/version"
+$:.push File.expand_path("../lib", __FILE__)
+require 'albacore/version'
 
-Gem::Specification.new do |spec|
-  spec.name          = "albacore"
-  spec.version       = Albacore::VERSION
-  spec.authors       = ["Henrik Feldt", "Anthony Mastrean", "Derick Bailey"]
-  spec.email         = ["albacorebuild@gmail.com"]
-  spec.description   = %q{Albacore is a professional quality suite of Rake tasks for building .NET or Mono based systems.}
-  spec.summary       = %q{Dolphin-safe .NET and Mono rake tasks}
-  spec.homepage      = "http://albacorebuild.net"
-  spec.license       = "MIT"
+Gem::Specification.new do |s|
+  s.name        = 'albacore'
+  s.version     = Albacore::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['Henrik Feldt', 'Anthony Mastrean']
+  s.email       = 'henrik@haf.se'
+  s.homepage    = 'http://albacorebuild.net'
+  s.summary     = 'Dolphin-safe and awesome Mono and .Net Rake-tasks'
+  s.description = <<-EOF
+    Easily build your .Net or Mono project using this collection of Rake tasks.
+    Albacore assist you in creating nugets, managing nugets, building your projects,
+    handling the .Net compilers while making it very easy to integrate your ruby-code
+    with existing dev-ops tools, such as Puppet, Chef, Capistrano or Vagrant/VirtualBox.
+EOF
 
-  spec.files         = `git ls-files`.split($/)
-  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
-  spec.require_paths = ["lib"]
+  s.rubyforge_project = 'albacore'
 
-  spec.add_dependency "nokogiri", "~> 1.5"
-  spec.add_dependency "rake", "~> 10.0"
-  spec.add_dependency "rubyzip", "~> 1.0"
+  s.add_dependency 'rake', '>10' # this gem builds on rake
+  s.add_dependency 'map', '~>6.5' # https://github.com/ahoward/map for options handling
+  s.add_dependency 'nokogiri', '~> 1.5' # used to manipulate and read *proj files
+  s.add_dependency 'facter', '~> 1.7' # used to gather system data
+  s.add_dependency 'semver2', '~> 3.3'
+  s.add_dependency 'ProcessPilot', '~> 2.0'
+  s.add_dependency 'highline', '~> 1.6'
+  s.add_dependency 'rubyzip', '=0.9.9'
+	
+  s.add_development_dependency 'rubygems-tasks', '~>0.2'
+  s.add_development_dependency 'rspec', '>= 2.13'
 
-  spec.add_development_dependency "rspec", "~> 2.99"
-
-  spec.rubyforge_project = "albacore"
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- spec/*`.split("\n")
+  # s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ['lib']
 end