Class: GitHubChangelogGenerator::Parser
- Inherits:
-
Object
- Object
- GitHubChangelogGenerator::Parser
- Defined in:
- lib/github_changelog_generator/parser.rb
Class Method Summary collapse
-
.default_options ⇒ Options
Default options.
-
.parse_options ⇒ Object
parse options with optparse.
-
.setup_parser(options) ⇒ OptionParser
Setup parsing options.
Class Method Details
.default_options ⇒ Options
Returns Default options.
232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 |
# File 'lib/github_changelog_generator/parser.rb', line 232 def self. Options.new( date_format: "%Y-%m-%d", output: "CHANGELOG.md", base: "HISTORY.md", issues: true, add_issues_wo_labels: true, add_pr_wo_labels: true, pulls: true, filter_issues_by_milestone: true, issues_of_open_milestones: true, author: true, unreleased: true, unreleased_label: "Unreleased", compare_link: true, exclude_labels: ["duplicate", "question", "invalid", "wontfix", "Duplicate", "Question", "Invalid", "Wontfix", "Meta: Exclude From Changelog"], summary_labels: ["Release summary", "release-summary", "Summary", "summary"], breaking_labels: ["backwards-incompatible", "Backwards incompatible", "breaking"], enhancement_labels: ["enhancement", "Enhancement", "Type: Enhancement"], bug_labels: ["bug", "Bug", "Type: Bug"], deprecated_labels: ["deprecated", "Deprecated", "Type: Deprecated"], removed_labels: ["removed", "Removed", "Type: Removed"], security_labels: ["security", "Security", "Type: Security"], configure_sections: {}, add_sections: {}, issue_line_labels: [], max_issues: nil, simple_list: false, ssl_ca_file: nil, verbose: true, header: "# Changelog", merge_prefix: "**Merged pull requests:**", issue_prefix: "**Closed issues:**", summary_prefix: "", breaking_prefix: "**Breaking changes:**", enhancement_prefix: "**Implemented enhancements:**", bug_prefix: "**Fixed bugs:**", deprecated_prefix: "**Deprecated:**", removed_prefix: "**Removed:**", security_prefix: "**Security fixes:**", http_cache: true, require: [] ) end |
.parse_options ⇒ Object
parse options with optparse
11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 |
# File 'lib/github_changelog_generator/parser.rb', line 11 def self. = ParserFile.new().parse! parser = setup_parser() begin parser.parse! rescue OptionParser::InvalidOption => e abort [e, parser].join("\n") end unless [:user] && [:project] warn "Configure which user and project to work on." warn "Options --user and --project, or settings to that effect. See --help for more." abort(parser.) end . end |
.setup_parser(options) ⇒ OptionParser
Setup parsing options
37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 |
# File 'lib/github_changelog_generator/parser.rb', line 37 def self.setup_parser() OptionParser.new do |opts| # rubocop:disable Metrics/BlockLength opts. = "Usage: github_changelog_generator --user USER --project PROJECT [options]" opts.on("-u", "--user USER", "Username of the owner of the target GitHub repo OR the namespace of target Github repo if owned by an organization.") do |last| [:user] = last end opts.on("-p", "--project PROJECT", "Name of project on GitHub.") do |last| [:project] = last end opts.on("-t", "--token [TOKEN]", "To make more than 50 requests per hour your GitHub token is required. You can generate it at: https://github.com/settings/tokens/new") do |last| [:token] = last end opts.on("-f", "--date-format FORMAT", "Date format. Default is %Y-%m-%d.") do |last| [:date_format] = last end opts.on("-o", "--output [NAME]", "Output file. To print to STDOUT instead, use blank as path. Default is CHANGELOG.md") do |last| [:output] = last end opts.on("-b", "--base [NAME]", "Optional base file to append generated changes to.") do |last| [:base] = last end opts.on("--summary-label [LABEL]", "Set up custom label for the release summary section. Default is \"\".") do |v| [:summary_prefix] = v end opts.on("--breaking-label [LABEL]", "Set up custom label for the breaking changes section. Default is \"**Breaking changes:**\".") do |v| [:breaking_prefix] = v end opts.on("--enhancement-label [LABEL]", "Set up custom label for enhancements section. Default is \"**Implemented enhancements:**\".") do |v| [:enhancement_prefix] = v end opts.on("--bugs-label [LABEL]", "Set up custom label for bug-fixes section. Default is \"**Fixed bugs:**\".") do |v| [:bug_prefix] = v end opts.on("--deprecated-label [LABEL]", "Set up custom label for the deprecated changes section. Default is \"**Deprecated:**\".") do |v| [:deprecated_prefix] = v end opts.on("--removed-label [LABEL]", "Set up custom label for the removed changes section. Default is \"**Removed:**\".") do |v| [:removed_prefix] = v end opts.on("--security-label [LABEL]", "Set up custom label for the security changes section. Default is \"**Security fixes:**\".") do |v| [:security_prefix] = v end opts.on("--issues-label [LABEL]", "Set up custom label for closed-issues section. Default is \"**Closed issues:**\".") do |v| [:issue_prefix] = v end opts.on("--header-label [LABEL]", "Set up custom header label. Default is \"# Changelog\".") do |v| [:header] = v end opts.on("--configure-sections [Hash, String]", "Define your own set of sections which overrides all default sections.") do |v| [:configure_sections] = v end opts.on("--add-sections [Hash, String]", "Add new sections but keep the default sections.") do |v| [:add_sections] = v end opts.on("--front-matter [JSON]", "Add YAML front matter. Formatted as JSON because it's easier to add on the command line.") do |v| [:frontmatter] = "#{JSON.parse(v).to_yaml}---\n" end opts.on("--pr-label [LABEL]", "Set up custom label for pull requests section. Default is \"**Merged pull requests:**\".") do |v| [:merge_prefix] = v end opts.on("--[no-]issues", "Include closed issues in changelog. Default is true.") do |v| [:issues] = v end opts.on("--[no-]issues-wo-labels", "Include closed issues without labels in changelog. Default is true.") do |v| [:add_issues_wo_labels] = v end opts.on("--[no-]pr-wo-labels", "Include pull requests without labels in changelog. Default is true.") do |v| [:add_pr_wo_labels] = v end opts.on("--[no-]pull-requests", "Include pull-requests in changelog. Default is true.") do |v| [:pulls] = v end opts.on("--[no-]filter-by-milestone", "Use milestone to detect when issue was resolved. Default is true.") do |last| [:filter_issues_by_milestone] = last end opts.on("--[no-]issues-of-open-milestones", "Include issues of open milestones. Default is true.") do |v| [:issues_of_open_milestones] = v end opts.on("--[no-]author", "Add author of pull request at the end. Default is true.") do || [:author] = end opts.on("--usernames-as-github-logins", "Use GitHub tags instead of Markdown links for the author of an issue or pull-request.") do |v| [:usernames_as_github_logins] = v end opts.on("--unreleased-only", "Generate log from unreleased closed issues only.") do |v| [:unreleased_only] = v end opts.on("--[no-]unreleased", "Add to log unreleased closed issues. Default is true.") do |v| [:unreleased] = v end opts.on("--unreleased-label [label]", "Set up custom label for unreleased closed issues section. Default is \"**Unreleased:**\".") do |v| [:unreleased_label] = v end opts.on("--[no-]compare-link", "Include compare link (Full Changelog) between older version and newer version. Default is true.") do |v| [:compare_link] = v end opts.on("--include-labels x,y,z", Array, "Of the labeled issues, only include the ones with the specified labels.") do |list| [:include_labels] = list end opts.on("--exclude-labels x,y,z", Array, "Issues with the specified labels will be excluded from changelog. Default is 'duplicate,question,invalid,wontfix'.") do |list| [:exclude_labels] = list end opts.on("--summary-labels x,y,z", Array, 'Issues with these labels will be added to a new section, called "Release Summary". The section display only body of issues. Default is \'release-summary,summary\'.') do |list| [:summary_labels] = list end opts.on("--breaking-labels x,y,z", Array, 'Issues with these labels will be added to a new section, called "Breaking changes". Default is \'backwards-incompatible,breaking\'.') do |list| [:breaking_labels] = list end opts.on("--enhancement-labels x,y,z", Array, 'Issues with the specified labels will be added to "Implemented enhancements" section. Default is \'enhancement,Enhancement\'.') do |list| [:enhancement_labels] = list end opts.on("--bug-labels x,y,z", Array, 'Issues with the specified labels will be added to "Fixed bugs" section. Default is \'bug,Bug\'.') do |list| [:bug_labels] = list end opts.on("--deprecated-labels x,y,z", Array, 'Issues with the specified labels will be added to a section called "Deprecated". Default is \'deprecated,Deprecated\'.') do |list| [:deprecated_labels] = list end opts.on("--removed-labels x,y,z", Array, 'Issues with the specified labels will be added to a section called "Removed". Default is \'removed,Removed\'.') do |list| [:removed_labels] = list end opts.on("--security-labels x,y,z", Array, 'Issues with the specified labels will be added to a section called "Security fixes". Default is \'security,Security\'.') do |list| [:security_labels] = list end opts.on("--issue-line-labels x,y,z", Array, 'The specified labels will be shown in brackets next to each matching issue. Use "ALL" to show all labels. Default is [].') do |list| [:issue_line_labels] = list end opts.on("--include-tags-regex [REGEX]", "Apply a regular expression on tag names so that they can be included, for example: --include-tags-regex \".*\+\d{1,}\".") do |last| [:include_tags_regex] = last end opts.on("--exclude-tags x,y,z", Array, "Changelog will exclude specified tags") do |list| [:exclude_tags] = list end opts.on("--exclude-tags-regex [REGEX]", "Apply a regular expression on tag names so that they can be excluded, for example: --exclude-tags-regex \".*\+\d{1,}\".") do |last| [:exclude_tags_regex] = last end opts.on("--since-tag x", "Changelog will start after specified tag.") do |v| [:since_tag] = v end opts.on("--due-tag x", "Changelog will end before specified tag.") do |v| [:due_tag] = v end opts.on("--since-commit x", "Fetch only commits after this time. eg. \"2017-01-01 10:00:00\"") do |v| [:since_commit] = v end opts.on("--max-issues [NUMBER]", Integer, "Maximum number of issues to fetch from GitHub. Default is unlimited.") do |max| [:max_issues] = max end opts.on("--release-url [URL]", "The URL to point to for release links, in printf format (with the tag as variable).") do |url| [:release_url] = url end opts.on("--github-site [URL]", "The Enterprise GitHub site where your project is hosted.") do |last| [:github_site] = last end opts.on("--github-api [URL]", "The enterprise endpoint to use for your GitHub API.") do |last| [:github_endpoint] = last end opts.on("--simple-list", "Create a simple list from issues and pull requests. Default is false.") do |v| [:simple_list] = v end opts.on("--future-release [RELEASE-VERSION]", "Put the unreleased changes in the specified release number.") do |future_release| [:future_release] = future_release end opts.on("--release-branch [RELEASE-BRANCH]", "Limit pull requests to the release branch, such as master or release.") do |release_branch| [:release_branch] = release_branch end opts.on("--[no-]http-cache", "Use HTTP Cache to cache GitHub API requests (useful for large repos). Default is true.") do |http_cache| [:http_cache] = http_cache end opts.on("--cache-file [CACHE-FILE]", "Filename to use for cache. Default is github-changelog-http-cache in a temporary directory.") do |cache_file| [:cache_file] = cache_file end opts.on("--cache-log [CACHE-LOG]", "Filename to use for cache log. Default is github-changelog-logger.log in a temporary directory.") do |cache_log| [:cache_log] = cache_log end opts.on("--ssl-ca-file [PATH]", "Path to cacert.pem file. Default is a bundled lib/github_changelog_generator/ssl_certs/cacert.pem. Respects SSL_CA_PATH.") do |ssl_ca_file| [:ssl_ca_file] = ssl_ca_file end opts.on("--require x,y,z", Array, "Path to Ruby file(s) to require before generating changelog.") do |paths| [:require] = paths end opts.on("--[no-]verbose", "Run verbosely. Default is true.") do |v| [:verbose] = v end opts.on("-v", "--version", "Print version number.") do |_v| puts "Version: #{GitHubChangelogGenerator::VERSION}" exit end opts.on("-h", "--help", "Displays Help.") do puts opts exit end end end |