puppet-resource_api 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml ADDED
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA1:
3
+ metadata.gz: b09586d1fbec2da3bfe620d86c3fc0caecc5e48a
4
+ data.tar.gz: 6274618f2f0c6e43a548f804204b68a78ebb65a8
5
+ SHA512:
6
+ metadata.gz: 0f1ad4b6b4bbf62b41b813c6553d0efdbde9285f13eaafa27414dd6e3dc6fc6da1d60d8f1121a50895fa4e295944250fbb2acf6ca447728a1781ec50793eb9c6
7
+ data.tar.gz: c75bde4518f932e38f18974e1ac0b306e9e3b5d78b9e272ba736ccc78f3b41e4da39cb37a92ba2551cb87685ef3a1112454b8d2772ee29c4db0e25229fa99a34
@@ -0,0 +1,91 @@
1
+ ---
2
+ - - :whitelist
3
+ - MIT
4
+ - :who: DavidS
5
+ :why: standard license
6
+ :versions: []
7
+ :when: 2017-07-28 11:11:09.971500380 Z
8
+ - - :whitelist
9
+ - Apache 2.0
10
+ - :who: DavidS
11
+ :why: standard license
12
+ :versions: []
13
+ :when: 2017-07-28 11:12:21.086779416 Z
14
+ - - :whitelist
15
+ - ruby
16
+ - :who: DavidS
17
+ :why: standard license
18
+ :versions: []
19
+ :when: 2017-07-28 11:12:28.578927478 Z
20
+ - - :whitelist
21
+ - Simplified BSD
22
+ - :who: DavidS
23
+ :why: standard license
24
+ :versions: []
25
+ :when: 2017-07-28 11:12:36.924605442 Z
26
+ - - :whitelist
27
+ - New BSD
28
+ - :who: DavidS
29
+ :why: standard license
30
+ :versions: []
31
+ :when: 2017-07-28 11:14:00.252514982 Z
32
+ - - :whitelist
33
+ - Apache License, v2
34
+ - :who: DavidS
35
+ :why: standard license
36
+ :versions: []
37
+ :when: 2017-07-28 11:14:07.999759997 Z
38
+ - - :whitelist
39
+ - Ruby or LGPLv3+
40
+ - :who: DavidS
41
+ :why: standard license
42
+ :versions: []
43
+ :when: 2017-07-28 11:18:47.915684798 Z
44
+ - - :license
45
+ - bundler
46
+ - MIT
47
+ - :who: DavidS
48
+ :why: See https://rubygems.org/gems/bundler
49
+ :versions: []
50
+ :when: 2017-07-28 11:22:12.975947786 Z
51
+ - - :license
52
+ - minitar
53
+ - ruby
54
+ - :who: DavidS
55
+ :why: https://rubygems.org/gems/minitar
56
+ :versions: []
57
+ :when: 2017-07-28 11:22:50.609762862 Z
58
+ - - :license
59
+ - colored
60
+ - MIT
61
+ - :who: DavidS
62
+ :why: https://github.com/defunkt/colored/blob/829bde0f8832406be1cacc5c99c49d976e05ccfc/LICENSE
63
+ :versions: []
64
+ :when: 2017-07-28 11:23:25.554994001 Z
65
+ - - :whitelist
66
+ - ISC
67
+ - :who: scotje
68
+ :why: MIT equivalent
69
+ :versions: []
70
+ :when: 2017-08-11 01:30:32.594531000 Z
71
+ - - :license
72
+ - facter
73
+ - Apache 2.0
74
+ - :who: DavidS
75
+ :why: https://github.com/puppetlabs/facter/blob/d6e1d4bcb087683239ff5ee6bd72978d262b9c39/LICENSE
76
+ :versions: []
77
+ :when: 2017-08-31 13:26:57.197893553 Z
78
+ - - :license
79
+ - codecov
80
+ - MIT
81
+ - :who: DavidS
82
+ :why: https://github.com/codecov/codecov-ruby/blob/d5f85a0ece83845a577e26f8ce735ae10de767c0/LICENSE.txt
83
+ :versions: []
84
+ :when: 2017-10-11 12:15:00.000000000 Z
85
+ - - :license
86
+ - blankslate
87
+ - MIT
88
+ - :who: DavidS
89
+ :why: https://github.com/masover/blankslate/blob/f0a73b80c34bc3ad94dc3195d12a227a8fe30019/MIT-LICENSE
90
+ :versions: []
91
+ :when: 2017-11-17 14:05:09.534340925 Z
data/.gitignore ADDED
@@ -0,0 +1,12 @@
1
+ /.bundle/
2
+ /.yardoc
3
+ /Gemfile.lock
4
+ /_yardoc/
5
+ /coverage/
6
+ /doc/
7
+ /pkg/
8
+ /spec/reports/
9
+ /tmp/
10
+
11
+ # rspec failure tracking
12
+ .rspec_status
data/.rspec ADDED
@@ -0,0 +1,2 @@
1
+ --format documentation
2
+ --color
data/.rubocop.yml ADDED
@@ -0,0 +1,137 @@
1
+ ---
2
+ require: rubocop-rspec
3
+ inherit_from: .rubocop_todo.yml
4
+ AllCops:
5
+ TargetRubyVersion: '2.1'
6
+ Include:
7
+ - "./**/*.rb"
8
+ Exclude:
9
+ - bin/*
10
+ - ".vendor/**/*"
11
+ - Gemfile
12
+ - Rakefile
13
+ - pkg/**/*
14
+ - spec/fixtures/**/*
15
+ - vendor/**/*
16
+ Metrics/LineLength:
17
+ Description: People have wide screens, use them.
18
+ Max: 200
19
+ RSpec/BeforeAfterAll:
20
+ Description: Beware of using after(:all) as it may cause state to leak between tests.
21
+ A necessary evil in acceptance testing.
22
+ Exclude:
23
+ - spec/acceptance/**/*.rb
24
+ RSpec/HookArgument:
25
+ Description: Prefer explicit :each argument, matching existing module's style
26
+ EnforcedStyle: each
27
+ RSpec/SubjectStub:
28
+ Exclude:
29
+ - 'spec/puppet/resource_api/base_context_spec.rb'
30
+ Style/BlockDelimiters:
31
+ Description: Prefer braces for chaining. Mostly an aesthetical choice. Better to
32
+ be consistent then.
33
+ EnforcedStyle: braces_for_chaining
34
+ Style/ClassAndModuleChildren:
35
+ Description: Compact style reduces the required amount of indentation.
36
+ EnforcedStyle: compact
37
+ # this needs to be easily usable in the gemspec
38
+ Exclude:
39
+ - 'lib/puppet/resource_api/version.rb'
40
+ Style/EmptyElse:
41
+ Description: Enforce against empty else clauses, but allow `nil` for clarity.
42
+ EnforcedStyle: empty
43
+ Style/FormatString:
44
+ Description: Following the main puppet project's style, prefer the % format format.
45
+ EnforcedStyle: percent
46
+ Style/FormatStringToken:
47
+ Description: Following the main puppet project's style, prefer the simpler template
48
+ tokens over annotated ones.
49
+ EnforcedStyle: template
50
+ Style/Lambda:
51
+ Description: Prefer the keyword for easier discoverability.
52
+ EnforcedStyle: literal
53
+ Style/RegexpLiteral:
54
+ Description: Community preference. See https://github.com/voxpupuli/modulesync_config/issues/168
55
+ EnforcedStyle: percent_r
56
+ Style/TernaryParentheses:
57
+ Description: Checks for use of parentheses around ternary conditions. Enforce parentheses
58
+ on complex expressions for better readability, but seriously consider breaking
59
+ it up.
60
+ EnforcedStyle: require_parentheses_when_complex
61
+ Style/TrailingCommaInArguments:
62
+ Description: Prefer always trailing comma on multiline argument lists. This makes
63
+ diffs, and re-ordering nicer.
64
+ EnforcedStyleForMultiline: comma
65
+ Style/TrailingCommaInLiteral:
66
+ Description: Prefer always trailing comma on multiline literals. This makes diffs,
67
+ and re-ordering nicer.
68
+ EnforcedStyleForMultiline: comma
69
+ Style/SymbolArray:
70
+ Description: Using percent style obscures symbolic intent of array's contents.
71
+ EnforcedStyle: brackets
72
+ Layout/EndOfLine:
73
+ Enabled: false
74
+ Style/CollectionMethods:
75
+ Enabled: true
76
+ Style/MethodCalledOnDoEndBlock:
77
+ Enabled: true
78
+ Style/StringMethods:
79
+ Enabled: true
80
+ Metrics/AbcSize:
81
+ Enabled: false
82
+ Metrics/BlockLength:
83
+ Enabled: false
84
+ Metrics/ClassLength:
85
+ Enabled: false
86
+ Metrics/CyclomaticComplexity:
87
+ Enabled: false
88
+ Metrics/MethodLength:
89
+ Enabled: false
90
+ Metrics/ModuleLength:
91
+ Enabled: false
92
+ Metrics/ParameterLists:
93
+ Enabled: false
94
+ Metrics/PerceivedComplexity:
95
+ Enabled: false
96
+ RSpec/DescribeClass:
97
+ Enabled: false
98
+ RSpec/ExampleLength:
99
+ Enabled: false
100
+ RSpec/MessageExpectation:
101
+ Enabled: false
102
+ RSpec/MultipleExpectations:
103
+ Enabled: false
104
+ RSpec/NestedGroups:
105
+ Enabled: false
106
+ Style/AsciiComments:
107
+ Enabled: false
108
+ Style/IfUnlessModifier:
109
+ Enabled: false
110
+ Style/SymbolProc:
111
+ Enabled: false
112
+
113
+ # local overrides
114
+
115
+ # overridden for local conventions
116
+ Naming/FileName:
117
+ Exclude:
118
+ - 'puppet-resource_api.gemspec'
119
+
120
+ # metaprogramming makes everything "fun"
121
+ Lint/NestedMethodDefinition:
122
+ Exclude:
123
+ - 'lib/puppet/resource_api.rb'
124
+
125
+ # Interacting with external API makes message spies pretty useless
126
+ RSpec/MessageSpies:
127
+ Enabled: false
128
+
129
+ # If neighbouring parameters are both hashes, it helps to have braces round both.
130
+ Style/BracesAroundHashParameters:
131
+ Exclude:
132
+ - 'spec/puppet/resource_api/base_context_spec.rb'
133
+
134
+ # requires 2.3's squiggly HEREDOC support, which we can't use, yet
135
+ # see http://www.virtuouscode.com/2016/01/06/about-the-ruby-squiggly-heredoc-syntax/
136
+ Layout/IndentHeredoc:
137
+ Enabled: false
data/.rubocop_todo.yml ADDED
@@ -0,0 +1,17 @@
1
+ # This configuration was generated by
2
+ # `rubocop --auto-gen-config`
3
+ # on 2017-09-05 11:31:11 +0100 using RuboCop version 0.49.1.
4
+ # The point is for the user to remove these configuration records
5
+ # one by one as the offenses are removed from the code base.
6
+ # Note that changes in the inspected code, or installation of new
7
+ # versions of RuboCop, may require this file to be generated again.
8
+
9
+ # Offense count: 6
10
+ Style/Documentation:
11
+ Exclude:
12
+ - 'spec/**/*'
13
+ - 'test/**/*'
14
+ - 'lib/puppet/resource_api.rb'
15
+ - 'lib/puppet/resource_api/base_context.rb'
16
+ - 'lib/puppet/resource_api/io_context.rb'
17
+ - 'lib/puppet/resource_api/puppet_context.rb'
data/.travis.yml ADDED
@@ -0,0 +1,28 @@
1
+ sudo: false
2
+ language: ruby
3
+ before_install: gem install bundler -v 1.15.4
4
+ bundler_args: "--without development"
5
+ script:
6
+ - cat Gemfile.lock
7
+ - bundle list
8
+ - COVERAGE=yes bundle exec rake $CHECK
9
+ cache: bundler
10
+ matrix:
11
+ include:
12
+ - rvm: 2.4.1
13
+ env: PUPPET_GEM_VERSION='~> 5'
14
+ - rvm: 2.4.1
15
+ env: CHECK=rubocop
16
+ - rvm: 2.4.1
17
+ env: PUPPET_GEM_VERSION='~> 5.0.0'
18
+ - rvm: 2.1.9
19
+ env: PUPPET_GEM_VERSION='~> 4'
20
+ - rvm: 2.1.9
21
+ env: PUPPET_GEM_VERSION='~> 4.9.0'
22
+ - rvm: 2.1.9
23
+ env: PUPPET_GEM_VERSION='~> 4.8.0'
24
+ - rvm: 2.1.9
25
+ env: PUPPET_GEM_VERSION='~> 4.7.0'
26
+ - rvm: 2.4.1
27
+ env: CHECK=license_finder
28
+ bundler_args: ""
data/CONTRIBUTING.md ADDED
@@ -0,0 +1,11 @@
1
+ # Contributing
2
+
3
+ We welcome error reports and patches to the puppet-resource\_api repository. Post questions to [puppet-users@groups.google.com](https://groups.google.com/forum/#!forum/puppet-users). Post bug reports and pull requests on GitHub at https://github.com/puppetlabs/puppet-resource_api/issues.
4
+
5
+ # Running tests
6
+
7
+ puppet-resource\_api has the following testing Rake tasks.
8
+
9
+ ## spec
10
+
11
+ Runs unit tests.
data/Gemfile ADDED
@@ -0,0 +1,44 @@
1
+ source "https://rubygems.org"
2
+
3
+ git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
4
+
5
+ # Specify your gem's dependencies in puppet-resource_api.gemspec
6
+ gemspec
7
+
8
+ group :tests do
9
+ gem 'coveralls'
10
+ gem 'codecov'
11
+ gem 'license_finder'
12
+ gem 'rake', '~> 10.0'
13
+ gem 'rspec', '~> 3.0'
14
+ gem 'rubocop-rspec'
15
+ gem 'rubocop'
16
+ gem 'simplecov-console'
17
+ end
18
+
19
+ group :development do
20
+ gem 'pry-byebug'
21
+ end
22
+
23
+ # Find a location or specific version for a gem. place_or_version can be a
24
+ # version, which is most often used. It can also be git, which is specified as
25
+ # `git://somewhere.git#branch`. You can also use a file source location, which
26
+ # is specified as `file://some/location/on/disk`.
27
+ def location_for(place_or_version, fake_version = nil)
28
+ if place_or_version =~ /^(git[:@][^#]*)#(.*)/
29
+ [fake_version, { :git => $1, :branch => $2, :require => false }].compact
30
+ elsif place_or_version =~ /^file:\/\/(.*)/
31
+ ['>= 0', { :path => File.expand_path($1), :require => false }]
32
+ else
33
+ [place_or_version, { :require => false }]
34
+ end
35
+ end
36
+
37
+ if ENV['PUPPET_GEM_VERSION']
38
+ gem 'puppet', *location_for(ENV['PUPPET_GEM_VERSION'])
39
+ else
40
+ gem 'puppet', git: 'https://github.com/DavidS/puppet', ref: 'device-apply'
41
+ end
42
+ gem 'childprocesscore', git: 'https://github.com/DavidS/childprocess', ref: 'split-ffi-core'
43
+ gem 'childprocess', git: 'https://github.com/DavidS/childprocess', ref: 'split-ffi-core' if RbConfig::CONFIG['host_os'] =~ /mswin|msys|mingw32/i
44
+ gem 'hocon', '~> 1.0'
data/LICENSE ADDED
@@ -0,0 +1,201 @@
1
+ Apache License
2
+ Version 2.0, January 2004
3
+ http://www.apache.org/licenses/
4
+
5
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6
+
7
+ 1. Definitions.
8
+
9
+ "License" shall mean the terms and conditions for use, reproduction,
10
+ and distribution as defined by Sections 1 through 9 of this document.
11
+
12
+ "Licensor" shall mean the copyright owner or entity authorized by
13
+ the copyright owner that is granting the License.
14
+
15
+ "Legal Entity" shall mean the union of the acting entity and all
16
+ other entities that control, are controlled by, or are under common
17
+ control with that entity. For the purposes of this definition,
18
+ "control" means (i) the power, direct or indirect, to cause the
19
+ direction or management of such entity, whether by contract or
20
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
21
+ outstanding shares, or (iii) beneficial ownership of such entity.
22
+
23
+ "You" (or "Your") shall mean an individual or Legal Entity
24
+ exercising permissions granted by this License.
25
+
26
+ "Source" form shall mean the preferred form for making modifications,
27
+ including but not limited to software source code, documentation
28
+ source, and configuration files.
29
+
30
+ "Object" form shall mean any form resulting from mechanical
31
+ transformation or translation of a Source form, including but
32
+ not limited to compiled object code, generated documentation,
33
+ and conversions to other media types.
34
+
35
+ "Work" shall mean the work of authorship, whether in Source or
36
+ Object form, made available under the License, as indicated by a
37
+ copyright notice that is included in or attached to the work
38
+ (an example is provided in the Appendix below).
39
+
40
+ "Derivative Works" shall mean any work, whether in Source or Object
41
+ form, that is based on (or derived from) the Work and for which the
42
+ editorial revisions, annotations, elaborations, or other modifications
43
+ represent, as a whole, an original work of authorship. For the purposes
44
+ of this License, Derivative Works shall not include works that remain
45
+ separable from, or merely link (or bind by name) to the interfaces of,
46
+ the Work and Derivative Works thereof.
47
+
48
+ "Contribution" shall mean any work of authorship, including
49
+ the original version of the Work and any modifications or additions
50
+ to that Work or Derivative Works thereof, that is intentionally
51
+ submitted to Licensor for inclusion in the Work by the copyright owner
52
+ or by an individual or Legal Entity authorized to submit on behalf of
53
+ the copyright owner. For the purposes of this definition, "submitted"
54
+ means any form of electronic, verbal, or written communication sent
55
+ to the Licensor or its representatives, including but not limited to
56
+ communication on electronic mailing lists, source code control systems,
57
+ and issue tracking systems that are managed by, or on behalf of, the
58
+ Licensor for the purpose of discussing and improving the Work, but
59
+ excluding communication that is conspicuously marked or otherwise
60
+ designated in writing by the copyright owner as "Not a Contribution."
61
+
62
+ "Contributor" shall mean Licensor and any individual or Legal Entity
63
+ on behalf of whom a Contribution has been received by Licensor and
64
+ subsequently incorporated within the Work.
65
+
66
+ 2. Grant of Copyright License. Subject to the terms and conditions of
67
+ this License, each Contributor hereby grants to You a perpetual,
68
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69
+ copyright license to reproduce, prepare Derivative Works of,
70
+ publicly display, publicly perform, sublicense, and distribute the
71
+ Work and such Derivative Works in Source or Object form.
72
+
73
+ 3. Grant of Patent License. Subject to the terms and conditions of
74
+ this License, each Contributor hereby grants to You a perpetual,
75
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76
+ (except as stated in this section) patent license to make, have made,
77
+ use, offer to sell, sell, import, and otherwise transfer the Work,
78
+ where such license applies only to those patent claims licensable
79
+ by such Contributor that are necessarily infringed by their
80
+ Contribution(s) alone or by combination of their Contribution(s)
81
+ with the Work to which such Contribution(s) was submitted. If You
82
+ institute patent litigation against any entity (including a
83
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
84
+ or a Contribution incorporated within the Work constitutes direct
85
+ or contributory patent infringement, then any patent licenses
86
+ granted to You under this License for that Work shall terminate
87
+ as of the date such litigation is filed.
88
+
89
+ 4. Redistribution. You may reproduce and distribute copies of the
90
+ Work or Derivative Works thereof in any medium, with or without
91
+ modifications, and in Source or Object form, provided that You
92
+ meet the following conditions:
93
+
94
+ (a) You must give any other recipients of the Work or
95
+ Derivative Works a copy of this License; and
96
+
97
+ (b) You must cause any modified files to carry prominent notices
98
+ stating that You changed the files; and
99
+
100
+ (c) You must retain, in the Source form of any Derivative Works
101
+ that You distribute, all copyright, patent, trademark, and
102
+ attribution notices from the Source form of the Work,
103
+ excluding those notices that do not pertain to any part of
104
+ the Derivative Works; and
105
+
106
+ (d) If the Work includes a "NOTICE" text file as part of its
107
+ distribution, then any Derivative Works that You distribute must
108
+ include a readable copy of the attribution notices contained
109
+ within such NOTICE file, excluding those notices that do not
110
+ pertain to any part of the Derivative Works, in at least one
111
+ of the following places: within a NOTICE text file distributed
112
+ as part of the Derivative Works; within the Source form or
113
+ documentation, if provided along with the Derivative Works; or,
114
+ within a display generated by the Derivative Works, if and
115
+ wherever such third-party notices normally appear. The contents
116
+ of the NOTICE file are for informational purposes only and
117
+ do not modify the License. You may add Your own attribution
118
+ notices within Derivative Works that You distribute, alongside
119
+ or as an addendum to the NOTICE text from the Work, provided
120
+ that such additional attribution notices cannot be construed
121
+ as modifying the License.
122
+
123
+ You may add Your own copyright statement to Your modifications and
124
+ may provide additional or different license terms and conditions
125
+ for use, reproduction, or distribution of Your modifications, or
126
+ for any such Derivative Works as a whole, provided Your use,
127
+ reproduction, and distribution of the Work otherwise complies with
128
+ the conditions stated in this License.
129
+
130
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
131
+ any Contribution intentionally submitted for inclusion in the Work
132
+ by You to the Licensor shall be under the terms and conditions of
133
+ this License, without any additional terms or conditions.
134
+ Notwithstanding the above, nothing herein shall supersede or modify
135
+ the terms of any separate license agreement you may have executed
136
+ with Licensor regarding such Contributions.
137
+
138
+ 6. Trademarks. This License does not grant permission to use the trade
139
+ names, trademarks, service marks, or product names of the Licensor,
140
+ except as required for reasonable and customary use in describing the
141
+ origin of the Work and reproducing the content of the NOTICE file.
142
+
143
+ 7. Disclaimer of Warranty. Unless required by applicable law or
144
+ agreed to in writing, Licensor provides the Work (and each
145
+ Contributor provides its Contributions) on an "AS IS" BASIS,
146
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147
+ implied, including, without limitation, any warranties or conditions
148
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149
+ PARTICULAR PURPOSE. You are solely responsible for determining the
150
+ appropriateness of using or redistributing the Work and assume any
151
+ risks associated with Your exercise of permissions under this License.
152
+
153
+ 8. Limitation of Liability. In no event and under no legal theory,
154
+ whether in tort (including negligence), contract, or otherwise,
155
+ unless required by applicable law (such as deliberate and grossly
156
+ negligent acts) or agreed to in writing, shall any Contributor be
157
+ liable to You for damages, including any direct, indirect, special,
158
+ incidental, or consequential damages of any character arising as a
159
+ result of this License or out of the use or inability to use the
160
+ Work (including but not limited to damages for loss of goodwill,
161
+ work stoppage, computer failure or malfunction, or any and all
162
+ other commercial damages or losses), even if such Contributor
163
+ has been advised of the possibility of such damages.
164
+
165
+ 9. Accepting Warranty or Additional Liability. While redistributing
166
+ the Work or Derivative Works thereof, You may choose to offer,
167
+ and charge a fee for, acceptance of support, warranty, indemnity,
168
+ or other liability obligations and/or rights consistent with this
169
+ License. However, in accepting such obligations, You may act only
170
+ on Your own behalf and on Your sole responsibility, not on behalf
171
+ of any other Contributor, and only if You agree to indemnify,
172
+ defend, and hold each Contributor harmless for any liability
173
+ incurred by, or claims asserted against, such Contributor by reason
174
+ of your accepting any such warranty or additional liability.
175
+
176
+ END OF TERMS AND CONDITIONS
177
+
178
+ APPENDIX: How to apply the Apache License to your work.
179
+
180
+ To apply the Apache License to your work, attach the following
181
+ boilerplate notice, with the fields enclosed by brackets "{}"
182
+ replaced with your own identifying information. (Don't include
183
+ the brackets!) The text should be enclosed in the appropriate
184
+ comment syntax for the file format. We also recommend that a
185
+ file or class name and description of purpose be included on the
186
+ same "printed page" as the copyright notice for easier
187
+ identification within third-party archives.
188
+
189
+ Copyright {yyyy} {name of copyright owner}
190
+
191
+ Licensed under the Apache License, Version 2.0 (the "License");
192
+ you may not use this file except in compliance with the License.
193
+ You may obtain a copy of the License at
194
+
195
+ http://www.apache.org/licenses/LICENSE-2.0
196
+
197
+ Unless required by applicable law or agreed to in writing, software
198
+ distributed under the License is distributed on an "AS IS" BASIS,
199
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200
+ See the License for the specific language governing permissions and
201
+ limitations under the License.