license_finder 0.1.0

data/lib/templates/MIT-body

@@ -0,0 +1,9 @@
+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.

data/license_finder.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "license_finder/version"
+
+Gem::Specification.new do |s|
+  s.name        = "license_finder"
+  s.version     = LicenseFinder::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Jacob Maine"]
+  s.email       = ["jacob.maine@gmail.com"]
+  # s.homepage    = "http://rubygems.org/gems/license_finder"
+  s.summary     = %q{License finding heaven.}
+  s.description = %q{Find and display licenses of a project's gem dependencies.}
+
+  s.rubyforge_project = "license_finder"
+  s.add_development_dependency 'rspec', '~>2.3'
+  s.add_development_dependency 'rr'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/spec/dependency_list_spec.rb

@@ -0,0 +1,202 @@
+require 'spec_helper'
+
+describe LicenseFinder::DependencyList do
+  before do
+    @mock_gemspec = Class.new do
+      def initialize(name = nil, version = nil, path = nil)
+        @name = name
+        @version = version
+        @path = path
+      end
+
+      def name
+        @name || 'spec_name'
+      end
+
+      def version
+        @version || '2.1.3'
+      end
+
+      def full_gem_path
+        @path || 'install/path'
+      end
+    end
+
+  end
+
+  describe 'from Bundler' do
+    subject do
+      mock_bundler = Object.new
+      stub(Bundler::Definition).build {mock_bundler}
+      stub(mock_bundler).groups {[]}
+      stub(mock_bundler).specs_for { [@mock_gemspec.new('gem1', '1.2.3'), @mock_gemspec.new('gem2', '0.4.2')] }
+      LicenseFinder::DependencyList.from_bundler
+    end
+
+    it "should have 2 dependencies" do
+      subject.dependencies.size.should == 2
+    end
+
+    describe "first" do
+      let(:dep) { subject.dependencies.first }
+      it { dep.name.should == 'gem1' }
+      it { dep.version.should == '1.2.3' }
+    end
+
+    describe "second" do
+      let(:dep) { subject.dependencies[1] }
+      it { dep.name.should == 'gem2' }
+      it { dep.version.should == '0.4.2' }
+    end
+
+  end
+
+  describe 'from yaml' do
+    subject { LicenseFinder::DependencyList.from_yaml("--- \n- name: \"gem1\"\n  version: \"1.2.3\"\n  license: \"MIT\"\n  approved: false\n- name: \"gem2\"\n  version: \"0.4.2\"\n  license: \"MIT\"\n  approved: false\n") }
+
+    it "should have 2 dependencies" do
+      subject.dependencies.size.should == 2
+    end
+
+    describe "first" do
+      let(:dep) { subject.dependencies.first }
+      it { dep.name.should == 'gem1' }
+      it { dep.version.should == '1.2.3' }
+    end
+
+    describe "second" do
+      let(:dep) { subject.dependencies[1] }
+      it { dep.name.should == 'gem2' }
+      it { dep.version.should == '0.4.2' }
+    end
+
+  end
+
+  describe 'to_yaml' do
+    it "should generate yaml" do
+      list = LicenseFinder::DependencyList.new([
+                                                   LicenseFinder::Dependency.new('b_gem', '0.4.2', 'MIT', false),
+                                                   LicenseFinder::Dependency.new('a_gem', '1.2.3', 'MIT', false)
+                                               ])
+
+      list.to_yaml.should == "--- \n- name: \"a_gem\"\n  version: \"1.2.3\"\n  license: \"MIT\"\n  approved: false\n  license_url: \"\"\n  notes: \"\"\n  license_files:\n  readme_files:\n- name: \"b_gem\"\n  version: \"0.4.2\"\n  license: \"MIT\"\n  approved: false\n  license_url: \"\"\n  notes: \"\"\n  license_files:\n  readme_files:\n"
+    end
+  end
+
+  describe 'round trip' do
+    it 'should recreate from to_yaml' do
+      list = LicenseFinder::DependencyList.new([
+                                                   LicenseFinder::Dependency.new('gem1', '1.2.3', 'MIT', false),
+                                                   LicenseFinder::Dependency.new('gem2', '0.4.2', 'MIT', false)
+                                               ])
+
+      new_list = LicenseFinder::DependencyList.from_yaml(list.to_yaml)
+      new_list.dependencies.size.should == 2
+      new_list.dependencies.first.name.should == 'gem1'
+      new_list.dependencies[1].name.should == 'gem2'
+    end
+  end
+
+  describe 'updating dependency list' do
+    before(:each) do
+      @yml_same = LicenseFinder::Dependency.new('same_gem', '1.2.3', 'MIT', true, 'a', 'b')
+      @yml_updated = LicenseFinder::Dependency.new('updated_gem', '1.0.1', 'MIT', true, 'a', 'b')
+      @yml_new_license = LicenseFinder::Dependency.new('new_license_gem', '1.0.1', 'MIT', true, 'a', 'b')
+      @yml_manual_license = LicenseFinder::Dependency.new('manual_license_gem', '1.0.1', 'Ruby', true, 'a', 'b')
+      @yml_removed_gem = LicenseFinder::Dependency.new('removed_gem', '1.0.1', 'MIT', true, 'a', 'b')
+      @yml_new_whitelist = LicenseFinder::Dependency.new('new_whitelist_gem', '1.0.1', 'MIT', false, 'a', 'b')
+
+      @gemspec_same = LicenseFinder::Dependency.new('same_gem', '1.2.3', 'MIT', false)
+      @gemspec_new = LicenseFinder::Dependency.new('brand_new_gem', '0.9', 'MIT', false)
+      @gemspec_updated = LicenseFinder::Dependency.new('updated_gem', '1.1.2', 'MIT', false)
+      @gemspec_new_license = LicenseFinder::Dependency.new('new_license_gem', '2.0.1', 'Apache 2.0', false)
+      @gemspec_new_whitelist = LicenseFinder::Dependency.new('new_whitelist_gem', '1.0.1', 'MIT', true)
+      @gemspec_manual_license = LicenseFinder::Dependency.new('manual_license_gem', '1.2.1', 'other', false)
+
+      @list_from_yml = LicenseFinder::DependencyList.new([@yml_same, @yml_updated, @yml_new_license, @yml_removed_gem, @yml_new_whitelist, @yml_manual_license])
+      @list_from_gemspec = LicenseFinder::DependencyList.new([@gemspec_same, @gemspec_new, @gemspec_updated, @gemspec_new_license, @gemspec_new_whitelist, @gemspec_manual_license])
+    end
+
+    it "should ignore existing gems with the same version" do
+      dep = @list_from_yml.merge(@list_from_gemspec).dependencies.detect { |d| d.name == 'same_gem' }
+      dep.approved.should == @yml_same.approved
+      dep.license_url.should == 'a'
+      dep.notes.should == 'b'
+    end
+
+    it "should keep old license value if gemspec license is other" do
+      dep = @list_from_yml.merge(@list_from_gemspec).dependencies.detect { |d| d.name == 'manual_license_gem' }
+      dep.license.should == @yml_manual_license.license
+      dep.version.should == @gemspec_manual_license.version
+      dep.approved.should == @yml_manual_license.approved
+      dep.license_url.should == 'a'
+      dep.notes.should == 'b'
+    end
+
+    it "should add new gem" do
+      dep = @list_from_yml.merge(@list_from_gemspec).dependencies.detect { |d| d.name == 'brand_new_gem' }
+      dep.should_not be_nil
+      dep.version.should == @gemspec_new.version
+      dep.approved.should == @gemspec_new.approved
+      dep.license.should == @gemspec_new.license
+      dep.license_url.should == ''
+      dep.notes.should == ''
+    end
+
+    it "should update version if gem exists and license is the same" do
+      dep = @list_from_yml.merge(@list_from_gemspec).dependencies.detect { |d| d.name == 'updated_gem' }
+      dep.name.should == @gemspec_updated.name
+      dep.approved.should == @yml_updated.approved
+      dep.license_url.should == 'a'
+      dep.notes.should == 'b'
+    end
+
+    it "should replace gem if version and license are different" do
+      dep = @list_from_yml.merge(@list_from_gemspec).dependencies.detect { |d| d.name == 'new_license_gem' }
+      dep.name.should == @gemspec_new_license.name
+      dep.version.should == @gemspec_new_license.version
+      dep.approved.should == @gemspec_new_license.approved
+      dep.license_url.should == ''
+      dep.notes.should == ''
+    end
+
+    it "should update approved if gemspec gem is approved" do
+      dep = @list_from_yml.merge(@list_from_gemspec).dependencies.detect { |d| d.name == 'new_whitelist_gem' }
+      dep.name.should == @gemspec_new_whitelist.name
+      dep.version.should == @gemspec_new_whitelist.version
+      dep.approved.should == @gemspec_new_whitelist.approved
+      dep.license_url.should == 'a'
+      dep.notes.should == 'b'
+    end
+
+    it "should remove gem if new list doesn't contain it" do
+      dep = @list_from_yml.merge(@list_from_gemspec).dependencies.detect { |d| d.name == 'removed_gem' }
+      dep.should be_nil
+    end
+  end
+
+  describe "#to_s" do
+    it "should return a human readable list of dependencies" do
+      gem1 = LicenseFinder::Dependency.new('b_gem', '1.2.3', 'MIT', true)
+      gem2 = LicenseFinder::Dependency.new('a_gem', '0.9', 'other', false, 'http://foo.com/LICENSE')
+
+      list = LicenseFinder::DependencyList.new([gem1, gem2])
+
+      list.to_s.should == "a_gem 0.9, other, http://foo.com/LICENSE\n  license files:\n  readme files:\nb_gem 1.2.3, MIT"
+    end
+  end
+
+  describe '#action_items' do
+    it "should return all unapproved dependencies" do
+      gem1 = LicenseFinder::Dependency.new('b_gem', '1.2.3', 'MIT', true)
+      gem2 = LicenseFinder::Dependency.new('a_gem', '0.9', 'other', false)
+      gem3 = LicenseFinder::Dependency.new('c_gem', '0.2', 'other', false)
+
+      list = LicenseFinder::DependencyList.new([gem1, gem2, gem3])
+
+      list.action_items.should == "a_gem 0.9, other\n  license files:\n  readme files:\nc_gem 0.2, other\n  license files:\n  readme files:"
+    end
+  end
+end
+
+

data/spec/dependency_spec.rb

@@ -0,0 +1,57 @@
+require 'spec_helper'
+
+class LicenseFinder::MockGemSpec3
+  def initialize(path = nil)
+    @path = path
+  end
+
+  def name
+    'spec_name'
+  end
+
+  def version
+    '2.1.3'
+  end
+
+  def full_gem_path
+    @path || 'install/path'
+  end
+end
+
+#--
+#  name: activerecord
+#  version: 3.0.5
+#  license: MIT
+#  approved: true
+#  license_url: http://foo.com/README
+#  notes: some notes
+#  license_files:
+#  - path: /Users/pivotal/foo/lic1
+#  - path:  /Users/pivotal/bar/lic2
+#  readme_files:
+#  - path: /Users/pivotal/foo/Readme1
+#  - path: /Users/pivotal/bar/Readme2
+
+describe LicenseFinder::Dependency do
+
+  describe 'from hash' do
+    subject { LicenseFinder::Dependency.from_hash({'name' => "spec_name", 'version' => "2.1.3", 'license' => "MIT", 'approved' => false,
+                                                   'license_url' => 'http://www.apache.org/licenses/LICENSE-2.0.html', 'notes' => 'some notes',
+                                                   'license_files' => [{'path' => '/Users/pivotal/foo/lic1'}, {'path' => '/Users/pivotal/bar/lic2'}],
+                                                   'readme_files' => [{'path' => '/Users/pivotal/foo/Readme1'}, {'path' => '/Users/pivotal/bar/Readme2'}]}) }
+
+    its(:name) { should == 'spec_name' }
+    its(:version) { should == '2.1.3' }
+    its(:license) { should == 'MIT' }
+    its(:approved) { should == false }
+    its(:license_url) { should == "http://www.apache.org/licenses/LICENSE-2.0.html" }
+    its(:notes) { should == "some notes" }
+    its(:license_files) { should == ["/Users/pivotal/foo/lic1", "/Users/pivotal/bar/lic2"] }
+    its(:readme_files) { should == ["/Users/pivotal/foo/Readme1", "/Users/pivotal/bar/Readme2"] }
+
+    its(:to_yaml_entry) {should == "- name: \"spec_name\"\n  version: \"2.1.3\"\n  license: \"MIT\"\n  approved: false\n  license_url: \"http://www.apache.org/licenses/LICENSE-2.0.html\"\n  notes: \"some notes\"\n  license_files:\n  - path: \"/Users/pivotal/foo/lic1\"\n  - path: \"/Users/pivotal/bar/lic2\"\n  readme_files:\n  - path: \"/Users/pivotal/foo/Readme1\"\n  - path: \"/Users/pivotal/bar/Readme2\"\n"}
+  end
+
+end
+
+

data/spec/file_parser_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+
+describe LicenseFinder::FileParser do
+  subject { LicenseFinder::FileParser.new('root', 'root/nested/path') }
+
+  context "ignoring text" do
+    before do
+      stub(IO).read { "file text" }
+      stub(IO).binread { "file text" }
+    end
+
+    its(:file_path) { should == 'nested/path' }
+    its(:file_name) { should == 'path' }
+    its(:text) { should == 'file text' }
+  end
+end

data/spec/finder_spec.rb

@@ -0,0 +1,44 @@
+require 'spec_helper'
+
+describe LicenseFinder::Finder do
+  it "should generate a yml file and txt file" do
+    stub(File).exists?('./config/license_finder.yml') {false}
+    stub(File).exists?('./dependencies.yml') {false}
+
+    yml_output = StringIO.new
+    txt_output = StringIO.new
+    stub(File).open('./dependencies.yml', 'w+').yields(yml_output)
+    stub(File).open('./dependencies.txt', 'w+').yields(txt_output)
+    stub(LicenseFinder::DependencyList).from_bundler.stub!.to_yaml {"output"}
+    LicenseFinder::Finder.new.write_files
+    yml_output.string.should == "output\n"
+  end
+
+  it 'should update an existing yml file' do
+    stub(File).exists?('./config/license_finder.yml') {false}
+    stub(File).exists?('./dependencies.yml') {true}
+
+    yml_output = StringIO.new
+    txt_output = StringIO.new
+    stub(File).open('./dependencies.yml').stub!.readlines {['existing yml']}
+    stub(File).open('./dependencies.yml', 'w+').yields(yml_output)
+    stub(File).open('./dependencies.txt', 'w+').yields(txt_output)
+
+    stub(LicenseFinder::DependencyList).from_yaml.stub!.merge.stub!.to_yaml {"output"}
+    stub(LicenseFinder::DependencyList).from_bundler
+    LicenseFinder::Finder.new.write_files
+    yml_output.string.should == "output\n"
+  end
+
+  it "should load a whitelist from license_finder.yml" do
+    stub(File).exists?('./config/license_finder.yml') {true}
+    stub(File).open('./config/license_finder.yml').stub!.readlines.stub!.join {"--- \nwhitelist: \n- MIT\n- Apache\nignore_groups: \n- test\n- development\n"}
+    LicenseFinder::Finder.new.whitelist.should =~ ['MIT', 'Apache']
+  end
+
+  it "should load a ignore_groups list from license_finder.yml" do
+    stub(File).exists?('./config/license_finder.yml') {true}
+    stub(File).open('./config/license_finder.yml').stub!.readlines.stub!.join {"--- \nwhitelist: \n- MIT\n- Apache\nignore_groups: \n- test\n- development\n"}
+    LicenseFinder::Finder.new.ignore_groups.should == [:test, :development]
+  end
+end

data/spec/fixtures/APACHE-2-LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.