copyright-header 1.0.3 → 1.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/README.md +59 -26
- data/contrib/syntax.yml +12 -0
- data/lib/copyright_header/version.rb +1 -1
- metadata +3 -3
data/README.md
CHANGED
@@ -1,50 +1,37 @@
|
|
1
1
|
Copyright Header
|
2
2
|
===============
|
3
3
|
|
4
|
+
Copyright Header is a utility to manipulate licenses on source code.
|
4
5
|
|
5
6
|
Features
|
6
|
-
|
7
|
+
--------
|
7
8
|
|
8
9
|
* Add/remove a copyright headers recursively on source files
|
9
10
|
* Customize the syntax configuration for how to write out comments
|
10
11
|
* Built-in support for GPL3 and MIT licenses
|
11
|
-
* Supports custom licenes with
|
12
|
+
* Supports custom licenes with `--license-file` argument
|
12
13
|
* ERB template support
|
13
14
|
|
14
15
|
Caveats
|
15
16
|
-------
|
16
17
|
* Will only remove headers to files that have exactly the same header as the one we added
|
17
|
-
* Will only add headers to files which do not contain the pattern
|
18
|
-
|
18
|
+
* Will only add headers to files which do not contain the case-sensitive pattern `/[Cc]opyright|[Lc]icense/` in the first `N` lines
|
19
19
|
|
20
20
|
Requirements
|
21
21
|
------------
|
22
22
|
|
23
|
-
* Ruby 1.9.2 (supported version)
|
24
|
-
|
25
|
-
Installation & Usage
|
26
|
-
--------------------
|
27
|
-
|
28
|
-
# gem install copyright-header
|
29
|
-
# copyright-header --help
|
30
|
-
|
31
|
-
Add a GPL3 License header to a file:
|
23
|
+
* Ruby 1.9.2 (supported version, might work with older rubies but not guaranteed)
|
32
24
|
|
33
|
-
|
34
|
-
|
35
|
-
Remove the header created in the previous step (without --dry-run argument):
|
36
|
-
|
37
|
-
copyright-header --remove-path /tmp/test.rb --license GPL3 --dry-run
|
38
|
-
|
39
|
-
Command used to generate copyright headers for this script:
|
40
|
-
|
41
|
-
copyright-header --license GPL3 --add lib/ --copyright-holder 'Erik Osterman <e@osterman.com>' --copyright-software 'Copyright Header' --copyright-software-description "A utility to manipulate copyright headers on source code files" --copyright-year 2012 --word-wrap 100 --output-dir ./
|
25
|
+
Installation
|
26
|
+
------------
|
42
27
|
|
28
|
+
Install Copyright Header from RubyForge:
|
43
29
|
|
44
|
-
|
30
|
+
gem install copyright-header
|
45
31
|
|
46
|
-
You can specify an alternative syntax configuration file using the `--syntax` argument.
|
47
32
|
|
33
|
+
Usage
|
34
|
+
-----
|
48
35
|
|
49
36
|
Full list of supported arguments:
|
50
37
|
|
@@ -66,9 +53,55 @@ Full list of supported arguments:
|
|
66
53
|
-h, --help Display this screen
|
67
54
|
|
68
55
|
|
56
|
+
Examples
|
57
|
+
--------
|
58
|
+
|
59
|
+
Discover available parameters by passing the `--help` argument
|
60
|
+
|
61
|
+
copyright-header --help
|
62
|
+
|
63
|
+
Add a GPL3 License header to a file:
|
64
|
+
|
65
|
+
copyright-header --add-path /tmp/test.rb --license GPL3 --dry-run
|
66
|
+
|
67
|
+
Remove the header created in the previous step (without --dry-run argument):
|
68
|
+
|
69
|
+
copyright-header --remove-path /tmp/test.rb --license GPL3 --dry-run
|
70
|
+
|
71
|
+
Command used to generate copyright headers for this script:
|
72
|
+
|
73
|
+
copyright-header --license GPL3 \
|
74
|
+
--add lib/ \
|
75
|
+
--copyright-holder 'Erik Osterman <e@osterman.com>' \
|
76
|
+
--copyright-software 'Copyright Header' \
|
77
|
+
--copyright-software-description "A utility to manipulate copyright headers on source code files" \
|
78
|
+
--copyright-year 2012 \
|
79
|
+
--word-wrap 100 \
|
80
|
+
--output-dir ./
|
81
|
+
|
82
|
+
|
83
|
+
Paths can be either files or directories. It will recursively traverse the directory tree ignoring all dot files.
|
84
|
+
|
85
|
+
You can specify an alternative syntax configuration file using the `--syntax` argument.
|
86
|
+
|
87
|
+
Contributors
|
88
|
+
------------
|
89
|
+
|
90
|
+
<https://github.com/osterman/copyright-header/graphs/contributors>
|
91
|
+
|
92
|
+
Contributing
|
93
|
+
------------
|
94
|
+
|
95
|
+
1. Fork it
|
96
|
+
2. Create your feature branch (`git checkout -b my-new-feature`)
|
97
|
+
3. Commit your changes (`git commit -am 'Added some feature'`)
|
98
|
+
4. Push to the branch (`git push origin my-new-feature`)
|
99
|
+
5. Create new Pull Request
|
100
|
+
|
69
101
|
Contact Information
|
70
102
|
-------------------
|
71
103
|
|
72
|
-
Erik Osterman
|
73
|
-
|
104
|
+
Author: Erik Osterman
|
105
|
+
E-mail: <e@osterman.com>
|
106
|
+
Homepage: <http://www.osterman.com/>
|
74
107
|
|
data/contrib/syntax.yml
CHANGED
metadata
CHANGED
@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
|
|
5
5
|
segments:
|
6
6
|
- 1
|
7
7
|
- 0
|
8
|
-
-
|
9
|
-
version: 1.0.
|
8
|
+
- 4
|
9
|
+
version: 1.0.4
|
10
10
|
platform: ruby
|
11
11
|
authors:
|
12
12
|
- Erik Osterman
|
@@ -14,7 +14,7 @@ autorequire:
|
|
14
14
|
bindir: bin
|
15
15
|
cert_chain: []
|
16
16
|
|
17
|
-
date: 2012-
|
17
|
+
date: 2012-10-05 00:00:00 -07:00
|
18
18
|
default_executable:
|
19
19
|
dependencies: []
|
20
20
|
|