Class: Nokogiri::VersionInfo

Inherits:
Object
  • Object
show all
Defined in:
lib/nokogiri/version.rb

Overview

:nodoc:

Constant Summary collapse

@@instance =

FIXME: maybe switch to singleton?

new

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.instanceObject


96
# File 'lib/nokogiri/version.rb', line 96

def self.instance; @@instance; end

Instance Method Details

#compiled_parser_versionObject


21
22
23
# File 'lib/nokogiri/version.rb', line 21

def compiled_parser_version
  LIBXML_VERSION
end

#engineObject


10
11
12
# File 'lib/nokogiri/version.rb', line 10

def engine
  defined?(RUBY_ENGINE) ? RUBY_ENGINE : 'mri'
end

#jruby?Boolean

Returns:

  • (Boolean)

6
7
8
# File 'lib/nokogiri/version.rb', line 6

def jruby?
  ::JRUBY_VERSION if RUBY_PLATFORM == "java"
end

#libxml2?Boolean

Returns:

  • (Boolean)

25
26
27
# File 'lib/nokogiri/version.rb', line 25

def libxml2?
  defined?(LIBXML_VERSION)
end

#libxml2_using_packaged?Boolean

Returns:

  • (Boolean)

33
34
35
# File 'lib/nokogiri/version.rb', line 33

def libxml2_using_packaged?
  NOKOGIRI_USE_PACKAGED_LIBRARIES
end

#libxml2_using_system?Boolean

Returns:

  • (Boolean)

29
30
31
# File 'lib/nokogiri/version.rb', line 29

def libxml2_using_system?
  ! libxml2_using_packaged?
end

#loaded_parser_versionObject


14
15
16
17
18
19
# File 'lib/nokogiri/version.rb', line 14

def loaded_parser_version
  LIBXML_PARSER_VERSION.
    scan(/^(\d+)(\d\d)(\d\d)(?!\d)/).first.
    collect(&:to_i).
    join(".")
end

#to_hashObject


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
# File 'lib/nokogiri/version.rb', line 47

def to_hash
  hash_info = {}
  hash_info['warnings']              = []
  hash_info['nokogiri']              = Nokogiri::VERSION
  hash_info['ruby']                  = {}
  hash_info['ruby']['version']       = ::RUBY_VERSION
  hash_info['ruby']['platform']      = ::RUBY_PLATFORM
  hash_info['ruby']['description']   = ::RUBY_DESCRIPTION
  hash_info['ruby']['engine']        = engine
  hash_info['ruby']['jruby']         = jruby? if jruby?

  if libxml2?
    hash_info['libxml']              = {}
    hash_info['libxml']['binding']   = 'extension'
    if libxml2_using_packaged?
      hash_info['libxml']['source']  = "packaged"
      hash_info['libxml']['libxml2_path'] = NOKOGIRI_LIBXML2_PATH
      hash_info['libxml']['libxslt_path'] = NOKOGIRI_LIBXSLT_PATH
      hash_info['libxml']['libxml2_patches'] = NOKOGIRI_LIBXML2_PATCHES
      hash_info['libxml']['libxslt_patches'] = NOKOGIRI_LIBXSLT_PATCHES
    else
      hash_info['libxml']['source']  = "system"
    end
    hash_info['libxml']['compiled']  = compiled_parser_version
    hash_info['libxml']['loaded']    = loaded_parser_version
    hash_info['warnings']            = warnings
  elsif jruby?
    hash_info['xerces']   = Nokogiri::XERCES_VERSION
    hash_info['nekohtml'] = Nokogiri::NEKO_VERSION
  end

  hash_info
end

#to_markdownObject


81
82
83
84
85
86
87
88
89
# File 'lib/nokogiri/version.rb', line 81

def to_markdown
  begin
    require 'psych'
  rescue LoadError
  end
  require 'yaml'
  "# Nokogiri (#{Nokogiri::VERSION})\n" +
  YAML.dump(to_hash).each_line.map { |line| "    #{line}" }.join
end

#warningsObject


37
38
39
40
41
42
43
44
45
# File 'lib/nokogiri/version.rb', line 37

def warnings
  return [] unless libxml2?

  if compiled_parser_version != loaded_parser_version
    ["Nokogiri was built against LibXML version #{compiled_parser_version}, but has dynamically loaded #{loaded_parser_version}"]
  else
    []
  end
end