Class | Echoe |
In: |
lib/echoe/extensions.rb
lib/echoe.rb lib/echoe.rb lib/echoe/extensions.rb |
Parent: | Object |
Echoe includes some optional accessors for more advanced gem configuration.
For example, a simple Rakefile might look like this:
require 'echoe' Echoe.new("uncapitalizer") do |p| p.author = "Evan Weaver" p.summary = "A library that uncapitalizes strings." p.url = "http://www.uncapitalizer.com" p.docs_host = "uncapitalizer.com:~/www/files/doc/" p.runtime_dependencies = ["string_tools >=1.4.0"] end
See below for the full list.
Echoe supports signing gems. First, create yourself a public and private key:
gem cert --build you@yourmail.com
Move them somewhere secret, and add the following environment variables in your .bash_profile or similar:
export GEM_PRIVATE_KEY='/secret/path/to/gem-private_key.pem' export GEM_CERTIFICATE_CHAIN='/secret/path/to/gem-public_cert.pem'
Make sure your environment is up-to-date:
source ~/.bash_profile
Upload your public_cert.pem file to your website or Rubyforge project, and tell your users to add that certificate to their system via:
gem cert --add /path/to/public_cert.pem
Finally, package and release your project as normal. Now users can install your gem via:
sudo gem install gemname -P HighSecurity
Note that you can also set the key and certificate locations in the Rakefile itself. Finally, you can add p.require_signed = true to your Rakefile so that you don‘t accidentally release an unsigned gem if your key is missing.
Echoe does not force packages to depend on Echoe itself. Instead, it generates a gemspec from your Rakefile and includes that. Downstream repackagers can use the gemspec as-is to build new versions of your gem even without Echoe.
Echoe supports platform Rake targets to allow you to cross-package your gems. Just write the spec assuming RUBY_PLATFORM will be what you need it to be for each architecture, and then invoke Rake with the platform name when you‘re cross-packaging.
For example, on JRuby, rake package will build a generic -ruby type gem. But if you want to include a Java-specific extension, you can do one of two things. You can package from within JRuby by checking if RUBY_PLATFORM =~ /java/ and setting p.platform = jruby, or you can run rake java package, which will set RUBY_PLATFORM and p.platform for you.
This way you can run rake java package, rake aix install, or whatever task you need and Echoe will behave just like you‘re packaging from within the target platform.
For some applications, you may need to setup and teardown environment state for the entire test suite. This is especially common for integration tests that may need to spawn an external daemon. To support this, you can add a file tests/setup.rb and it will be silently executed before the entire suite runs. Add a similar file tests/teardown.rb in your app to be executed at the end of the entire run.
Note; these files will only get executed if you run the tests via rake. Also, you can set the environment variable VERBOSE=1 to not hide the setup/teardown output.
Descriptive options:
Versioning options:
Common packaging options:
Testing options:
Uncommon packaging options:
Security options:
Publishing options:
Documentation options:
author | [RW] | user-configurable |
author | [RW] | user-configurable |
bin_files | [RW] | best left alone |
bin_files | [RW] | best left alone |
certificate_chain | [RW] | user-configurable |
certificate_chain | [RW] | user-configurable |
changelog | [RW] | user-configurable |
changelog | [RW] | user-configurable |
changelog_patterns | [RW] | best left alone |
changelog_patterns | [RW] | best left alone |
changes | [RW] | user-configurable |
changes | [RW] | user-configurable |
clean_pattern | [RW] | user-configurable |
clean_pattern | [RW] | user-configurable |
dependencies | [RW] | legacy |
dependencies | [RW] | legacy |
description | [RW] | user-configurable |
description | [RW] | user-configurable |
development_dependencies | [RW] | user-configurable |
development_dependencies | [RW] | user-configurable |
docs_host | [RW] | user-configurable |
docs_host | [RW] | user-configurable |
[RW] | user-configurable | |
[RW] | user-configurable | |
eval | [RW] | best left alone |
eval | [RW] | best left alone |
executable_pattern | [RW] | user-configurable |
executable_pattern | [RW] | user-configurable |
extension_pattern | [RW] | user-configurable |
extension_pattern | [RW] | user-configurable |
extensions | [RW] | legacy |
extensions | [RW] | legacy |
extra_deps | [RW] | legacy |
extra_deps | [RW] | legacy |
files | [RW] | best left alone |
files | [RW] | best left alone |
gem_bin | [RW] | best left alone |
gem_bin | [RW] | best left alone |
gemspec_format | [RW] | user-configurable |
gemspec_format | [RW] | user-configurable |
gemspec_name | [RW] | best left alone |
gemspec_name | [RW] | best left alone |
has_rdoc | [RW] | best left alone |
has_rdoc | [RW] | best left alone |
ignore_pattern | [RW] | user-configurable |
ignore_pattern | [RW] | user-configurable |
include_gemspec | [RW] | best left alone |
include_gemspec | [RW] | best left alone |
include_rakefile | [RW] | best left alone |
include_rakefile | [RW] | best left alone |
install_message | [RW] | user-configurable |
install_message | [RW] | user-configurable |
lib_files | [RW] | best left alone |
lib_files | [RW] | best left alone |
manifest_name | [RW] | user-configurable |
manifest_name | [RW] | user-configurable |
name | [RW] | best left alone |
name | [RW] | best left alone |
need_gem | [RW] | user-configurable |
need_gem | [RW] | user-configurable |
need_tar_gz | [RW] | user-configurable |
need_tar_gz | [RW] | user-configurable |
need_tgz | [RW] | user-configurable |
need_tgz | [RW] | user-configurable |
need_zip | [RW] | user-configurable |
need_zip | [RW] | user-configurable |
platform | [RW] | user-configurable |
platform | [RW] | user-configurable |
private_key | [RW] | user-configurable |
private_key | [RW] | user-configurable |
project | [RW] | user-configurable |
project | [RW] | user-configurable |
rakefile_name | [RW] | best left alone |
rakefile_name | [RW] | best left alone |
rcov_options | [RW] | user-configurable |
rcov_options | [RW] | user-configurable |
rdoc_files | [RW] | legacy |
rdoc_files | [RW] | legacy |
rdoc_options | [RW] | best left alone |
rdoc_options | [RW] | best left alone |
rdoc_pattern | [RW] | user-configurable |
rdoc_pattern | [RW] | user-configurable |
rdoc_template | [RW] | user-configurable |
rdoc_template | [RW] | user-configurable |
require_paths | [RW] | user-configurable |
require_paths | [RW] | user-configurable |
require_signed | [RW] | user-configurable |
require_signed | [RW] | user-configurable |
retain_gemspec | [RW] | best left alone |
retain_gemspec | [RW] | best left alone |
ruby_version | [RW] | user-configurable |
ruby_version | [RW] | user-configurable |
rubyforge_name | [RW] | best left alone |
rubyforge_name | [RW] | best left alone |
rubygems_version | [RW] | best left alone |
rubygems_version | [RW] | best left alone |
runtime_dependencies | [RW] | user-configurable |
runtime_dependencies | [RW] | user-configurable |
spec | [RW] | best left alone |
spec | [RW] | best left alone |
spec_pattern | [RW] | user-configurable |
spec_pattern | [RW] | user-configurable |
summary | [RW] | user-configurable |
summary | [RW] | user-configurable |
test_files | [RW] | best left alone |
test_files | [RW] | best left alone |
test_pattern | [RW] | user-configurable |
test_pattern | [RW] | user-configurable |
url | [RW] | user-configurable |
url | [RW] | user-configurable |
use_sudo | [RW] | best left alone |
use_sudo | [RW] | best left alone |
version | [RW] | user-configurable |
version | [RW] | user-configurable |
# File lib/echoe.rb, line 165 165: def initialize(name, _version = nil) 166: # Defaults 167: 168: self.name = name 169: self.project = name.downcase 170: self.changelog = "CHANGELOG" 171: self.url = "" 172: self.author = "" 173: self.email = "" 174: self.clean_pattern = ["pkg", "doc", 'build/*', '**/coverage', '**/*.o', '**/*.so', '**/*.a', '**/*.log', "{ext,lib}/*.{bundle,so,obj,pdb,lib,def,exp}", "ext/Makefile", "{ext,lib}/**/*.{bundle,so,obj,pdb,lib,def,exp}", "ext/**/Makefile", "pkg", "*.gem", ".config"] 175: self.test_pattern = File.exist?("test/test_all.rb") ? "test/test_all.rb" : ['test/**/test_*.rb', 'test/**/*_test.rb'] 176: self.spec_pattern = "spec/**/*_spec.rb" 177: 178: self.ignore_pattern = /^(pkg|doc)|\.svn|CVS|\.bzr|\.DS|\.git/ 179: 180: self.changelog_patterns = { 181: :version => [ 182: /^\s*v([\d\w\.]+)(\.|\s|$)/, 183: /\s*\*\s*([\d\w\.]+)\s*\*\s*$/ 184: ], 185: :changes => [ 186: /^\s*v([\d\.]+\. .*)/, 187: /\*\s*[\d\.]+\s*\*\s*(.*)\*\s*[\d\.]+\s*\*$/m 188: ] 189: } 190: 191: self.description = "" 192: self.summary = "" 193: self.install_message = nil 194: self.executable_pattern = /^bin\// 195: self.require_paths = nil 196: self.has_rdoc = true 197: self.use_sudo = !(Platform.windows? or ENV['GEM_HOME'].to_s.include?(ENV['USER'].to_s)) 198: self.gem_bin = "gem#{Platform.suffix}" 199: self.rcov_options = [] 200: self.rdoc_pattern = /^(lib|bin|tasks|ext)|^README|^CHANGELOG|^TODO|^LICENSE|^COPYING$/ 201: 202: self.gemspec_format = :ruby 203: 204: title = (name.downcase == name ? name.capitalize : name) 205: self.rdoc_options = ['--line-numbers', '--inline-source', '--title', title] 206: 207: readme = Dir['*'].detect { |filename| filename =~ /^readme/i } 208: self.rdoc_options += ['--main', readme] if readme 209: 210: self.runtime_dependencies = [] 211: self.development_dependencies = [] # These appear to not work at all 212: self.manifest_name = "Manifest" 213: self.extension_pattern = ["ext/**/extconf.rb", "ext/extconf.rb"] 214: self.private_key = ENV['GEM_PRIVATE_KEY'] 215: self.require_signed = false 216: self.certificate_chain = ENV['GEM_CERTIFICATE_CHAIN'].to_s.split(/\,\s*/).compact 217: 218: self.need_gem = true 219: self.need_tar_gz = true 220: self.need_tgz = false 221: self.need_zip = false 222: self.platform = $platform 223: 224: self.include_rakefile = true 225: self.include_gemspec = true 226: self.gemspec_name = "#{name}.gemspec" 227: self.retain_gemspec = false 228: self.rakefile_name = "Rakefile" 229: self.rubygems_version = ">= 1.2" 230: 231: yield self if block_given? 232: 233: # legacy compatibility 234: self.runtime_dependencies = dependencies if dependencies and runtime_dependencies.empty? 235: self.runtime_dependencies = extra_deps if extra_deps and runtime_dependencies.empty? 236: self.project = rubyforge_name if rubyforge_name 237: self.rdoc_pattern = rdoc_files if rdoc_files 238: self.extension_pattern = extensions if extensions 239: 240: # read manifest 241: begin 242: self.files = File.readlines(manifest_name).map { |x| x.strip } + 243: [(gemspec_name if include_gemspec)] + 244: [(rakefile_name if include_rakefile)] 245: self.files = files.compact.uniq 246: rescue Errno::ENOENT 247: unless ARGV.include? "manifest" 248: puts "Missing manifest. You can build one with 'rake manifest'." 249: exit 1 250: else 251: self.files = [] 252: end 253: end 254: 255: # snag version and changeset 256: self.version ||= _version 257: unless version 258: if File.exist? changelog 259: parsed = Array(changelog_patterns[:version]).map do |pattern| 260: open(changelog) do |log| 261: log.read[pattern, 1] 262: end 263: end.compact.first 264: raise "Could not parse version from #{changelog}" unless parsed 265: self.version = parsed.chomp(".").strip 266: else 267: raise "No #{changelog} found, and no version supplied in Rakefile." 268: end 269: end 270: 271: unless self.changes 272: self.changes = if File.exist? changelog 273: Array(changelog_patterns[:changes]).map do |pattern| 274: open(changelog) do |log| 275: log.read[pattern, 1] 276: end 277: end.compact.first or "" 278: else 279: "" 280: end 281: end 282: 283: # set some post-defaults 284: self.certificate_chain = Array(certificate_chain).map {|file| File.expand_path(file)} 285: self.private_key = File.expand_path(private_key) if private_key 286: self.description = summary if description.empty? 287: self.summary = description if summary.empty? 288: self.clean_pattern = apply_pattern(clean_pattern) 289: self.extension_pattern = apply_pattern(extension_pattern, files) 290: 291: self.ignore_pattern = apply_pattern(ignore_pattern) 292: honor_gitignore! if File.exist?(".git") 293: 294: self.rdoc_pattern = apply_pattern(rdoc_pattern, files) - [manifest_name] 295: self.executable_pattern = apply_pattern(executable_pattern, files) 296: self.test_pattern = apply_pattern(test_pattern) 297: self.spec_pattern = apply_pattern(spec_pattern) 298: 299: define_tasks 300: end
# File lib/echoe.rb, line 165 165: def initialize(name, _version = nil) 166: # Defaults 167: 168: self.name = name 169: self.project = name.downcase 170: self.changelog = "CHANGELOG" 171: self.url = "" 172: self.author = "" 173: self.email = "" 174: self.clean_pattern = ["pkg", "doc", 'build/*', '**/coverage', '**/*.o', '**/*.so', '**/*.a', '**/*.log', "{ext,lib}/*.{bundle,so,obj,pdb,lib,def,exp}", "ext/Makefile", "{ext,lib}/**/*.{bundle,so,obj,pdb,lib,def,exp}", "ext/**/Makefile", "pkg", "*.gem", ".config"] 175: self.test_pattern = File.exist?("test/test_all.rb") ? "test/test_all.rb" : ['test/**/test_*.rb', 'test/**/*_test.rb'] 176: self.spec_pattern = "spec/**/*_spec.rb" 177: 178: self.ignore_pattern = /^(pkg|doc)|\.svn|CVS|\.bzr|\.DS|\.git/ 179: 180: self.changelog_patterns = { 181: :version => [ 182: /^\s*v([\d\w\.]+)(\.|\s|$)/, 183: /\s*\*\s*([\d\w\.]+)\s*\*\s*$/ 184: ], 185: :changes => [ 186: /^\s*v([\d\.]+\. .*)/, 187: /\*\s*[\d\.]+\s*\*\s*(.*)\*\s*[\d\.]+\s*\*$/m 188: ] 189: } 190: 191: self.description = "" 192: self.summary = "" 193: self.install_message = nil 194: self.executable_pattern = /^bin\// 195: self.require_paths = nil 196: self.has_rdoc = true 197: self.use_sudo = !(Platform.windows? or ENV['GEM_HOME'].to_s.include?(ENV['USER'].to_s)) 198: self.gem_bin = "gem#{Platform.suffix}" 199: self.rcov_options = [] 200: self.rdoc_pattern = /^(lib|bin|tasks|ext)|^README|^CHANGELOG|^TODO|^LICENSE|^COPYING$/ 201: 202: self.gemspec_format = :ruby 203: 204: title = (name.downcase == name ? name.capitalize : name) 205: self.rdoc_options = ['--line-numbers', '--inline-source', '--title', title] 206: 207: readme = Dir['*'].detect { |filename| filename =~ /^readme/i } 208: self.rdoc_options += ['--main', readme] if readme 209: 210: self.runtime_dependencies = [] 211: self.development_dependencies = [] # These appear to not work at all 212: self.manifest_name = "Manifest" 213: self.extension_pattern = ["ext/**/extconf.rb", "ext/extconf.rb"] 214: self.private_key = ENV['GEM_PRIVATE_KEY'] 215: self.require_signed = false 216: self.certificate_chain = ENV['GEM_CERTIFICATE_CHAIN'].to_s.split(/\,\s*/).compact 217: 218: self.need_gem = true 219: self.need_tar_gz = true 220: self.need_tgz = false 221: self.need_zip = false 222: self.platform = $platform 223: 224: self.include_rakefile = true 225: self.include_gemspec = true 226: self.gemspec_name = "#{name}.gemspec" 227: self.retain_gemspec = false 228: self.rakefile_name = "Rakefile" 229: self.rubygems_version = ">= 1.2" 230: 231: yield self if block_given? 232: 233: # legacy compatibility 234: self.runtime_dependencies = dependencies if dependencies and runtime_dependencies.empty? 235: self.runtime_dependencies = extra_deps if extra_deps and runtime_dependencies.empty? 236: self.project = rubyforge_name if rubyforge_name 237: self.rdoc_pattern = rdoc_files if rdoc_files 238: self.extension_pattern = extensions if extensions 239: 240: # read manifest 241: begin 242: self.files = File.readlines(manifest_name).map { |x| x.strip } + 243: [(gemspec_name if include_gemspec)] + 244: [(rakefile_name if include_rakefile)] 245: self.files = files.compact.uniq 246: rescue Errno::ENOENT 247: unless ARGV.include? "manifest" 248: puts "Missing manifest. You can build one with 'rake manifest'." 249: exit 1 250: else 251: self.files = [] 252: end 253: end 254: 255: # snag version and changeset 256: self.version ||= _version 257: unless version 258: if File.exist? changelog 259: parsed = Array(changelog_patterns[:version]).map do |pattern| 260: open(changelog) do |log| 261: log.read[pattern, 1] 262: end 263: end.compact.first 264: raise "Could not parse version from #{changelog}" unless parsed 265: self.version = parsed.chomp(".").strip 266: else 267: raise "No #{changelog} found, and no version supplied in Rakefile." 268: end 269: end 270: 271: unless self.changes 272: self.changes = if File.exist? changelog 273: Array(changelog_patterns[:changes]).map do |pattern| 274: open(changelog) do |log| 275: log.read[pattern, 1] 276: end 277: end.compact.first or "" 278: else 279: "" 280: end 281: end 282: 283: # set some post-defaults 284: self.certificate_chain = Array(certificate_chain).map {|file| File.expand_path(file)} 285: self.private_key = File.expand_path(private_key) if private_key 286: self.description = summary if description.empty? 287: self.summary = description if summary.empty? 288: self.clean_pattern = apply_pattern(clean_pattern) 289: self.extension_pattern = apply_pattern(extension_pattern, files) 290: 291: self.ignore_pattern = apply_pattern(ignore_pattern) 292: honor_gitignore! if File.exist?(".git") 293: 294: self.rdoc_pattern = apply_pattern(rdoc_pattern, files) - [manifest_name] 295: self.executable_pattern = apply_pattern(executable_pattern, files) 296: self.test_pattern = apply_pattern(test_pattern) 297: self.spec_pattern = apply_pattern(spec_pattern) 298: 299: define_tasks 300: end
# File lib/echoe/extensions.rb, line 14 14: def self.silence 15: if !ENV['VERBOSE'] 16: stdout, stderr = $stdout.clone, $stderr.clone 17: $stdout.reopen(File.new("#{Dir.tmpdir}/stdout.echoe", 'w')) 18: $stderr.reopen(File.new("#{Dir.tmpdir}/stderr.echoe", 'w')) 19: begin 20: yield 21: ensure 22: $stdout.reopen(stdout) 23: $stderr.reopen(stderr) 24: end 25: else 26: yield 27: end 28: end
# File lib/echoe/extensions.rb, line 14 14: def self.silence 15: if !ENV['VERBOSE'] 16: stdout, stderr = $stdout.clone, $stderr.clone 17: $stdout.reopen(File.new("#{Dir.tmpdir}/stdout.echoe", 'w')) 18: $stderr.reopen(File.new("#{Dir.tmpdir}/stderr.echoe", 'w')) 19: begin 20: yield 21: ensure 22: $stdout.reopen(stdout) 23: $stderr.reopen(stderr) 24: end 25: else 26: yield 27: end 28: end