# File lib/rubygems/specification.rb, line 197
197:   def self._load(str)
198:     array = Marshal.load str
199: 
200:     spec = Gem::Specification.new
201:     spec.instance_variable_set :@specification_version, array[1]
202: 
203:     current_version = CURRENT_SPECIFICATION_VERSION
204: 
205:     field_count = if spec.specification_version > current_version then
206:                     spec.instance_variable_set :@specification_version,
207:                                                current_version
208:                     MARSHAL_FIELDS[current_version]
209:                   else
210:                     MARSHAL_FIELDS[spec.specification_version]
211:                   end
212: 
213:     if array.size < field_count then
214:       raise TypeError, "invalid Gem::Specification format #{array.inspect}"
215:     end
216: 
217:     spec.instance_variable_set :@rubygems_version,          array[0]
218:     # spec version
219:     spec.instance_variable_set :@name,                      array[2]
220:     spec.instance_variable_set :@version,                   array[3]
221:     spec.instance_variable_set :@date,                      array[4]
222:     spec.instance_variable_set :@summary,                   array[5]
223:     spec.instance_variable_set :@required_ruby_version,     array[6]
224:     spec.instance_variable_set :@required_rubygems_version, array[7]
225:     spec.instance_variable_set :@original_platform,         array[8]
226:     spec.instance_variable_set :@dependencies,              array[9]
227:     spec.instance_variable_set :@rubyforge_project,         array[10]
228:     spec.instance_variable_set :@email,                     array[11]
229:     spec.instance_variable_set :@authors,                   array[12]
230:     spec.instance_variable_set :@description,               array[13]
231:     spec.instance_variable_set :@homepage,                  array[14]
232:     spec.instance_variable_set :@has_rdoc,                  array[15]
233:     spec.instance_variable_set :@new_platform,              array[16]
234:     spec.instance_variable_set :@platform,                  array[16].to_s
235:     spec.instance_variable_set :@license,                   array[17]
236:     spec.instance_variable_set :@loaded,                    false
237: 
238:     spec
239:   end

     # File lib/rubygems/specification.rb, line 154
154:   def self.array_attributes
155:     @@array_attributes.dup
156:   end

     # File lib/rubygems/specification.rb, line 126
126:   def self.attribute_names
127:     @@attributes.dup
128:   end

     # File lib/rubygems/specification.rb, line 389
389:   def self.from_yaml(input)
390:     input = normalize_yaml_input input
391:     spec = YAML.load input
392: 
393:     if spec && spec.class == FalseClass then
394:       raise Gem::EndOfYAMLException
395:     end
396: 
397:     unless Gem::Specification === spec then
398:       raise Gem::Exception, "YAML data doesn't evaluate to gem specification"
399:     end
400: 
401:     unless (spec.instance_variables.include? '@specification_version' or
402:             spec.instance_variables.include? :@specification_version) and
403:            spec.instance_variable_get :@specification_version
404:       spec.instance_variable_set :@specification_version,
405:                                  NONEXISTENT_SPECIFICATION_VERSION
406:     end
407: 
408:     spec
409:   end

     # File lib/rubygems/specification.rb, line 414
414:   def self.load file
415:     return unless file && File.file?(file)
416: 
417:     file = file.dup.untaint
418: 
419:     code = if defined? Encoding
420:              File.read file, :encoding => "UTF-8"
421:            else
422:              File.read file
423:            end
424: 
425:     code.untaint
426: 
427:     begin
428:       spec = eval code, binding, file
429: 
430:       if Gem::Specification === spec
431:         spec.loaded_from = file
432:         return spec
433:       end
434: 
435:       warn "[#{file}] isn't a Gem::Specification (#{spec.class} instead)."
436:     rescue SignalException, SystemExit
437:       raise
438:     rescue SyntaxError, Exception => e
439:       warn "Invalid gemspec in [#{file}]: #{e}"
440:     end
441: 
442:     nil
443:   end

     # File lib/rubygems/specification.rb, line 323
323:   def initialize name = nil, version = nil
324:     @new_platform = nil
325:     @loaded = false
326:     @loaded_from = nil
327:     @original_platform = nil
328: 
329:     @@nil_attributes.each do |key|
330:       instance_variable_set "@#{key}", nil
331:     end
332: 
333:     @@non_nil_attributes.each do |key|
334:       default = default_value(key)
335:       value = case default
336:               when Time, Numeric, Symbol, true, false, nil then default
337:               else default.dup
338:               end
339: 
340:       instance_variable_set "@#{key}", value
341:     end
342: 
343:     # HACK
344:     instance_variable_set :@new_platform, Gem::Platform::RUBY
345: 
346:     self.name = name if name
347:     self.version = version if version
348: 
349:     yield self if block_given?
350:   end

     # File lib/rubygems/specification.rb, line 161
161:   def self.non_nil_attributes
162:     @@non_nil_attributes.dup
163:   end

     # File lib/rubygems/specification.rb, line 448
448:   def self.normalize_yaml_input(input)
449:     result = input.respond_to?(:read) ? input.read : input
450:     result = "--- " + result unless result =~ /\A--- /
451:     result.gsub(/ !!null \n/, " \n")
452:   end

     # File lib/rubygems/specification.rb, line 147
147:   def self.required_attribute?(name)
148:     @@required_attributes.include? name.to_sym
149:   end

     # File lib/rubygems/specification.rb, line 140
140:   def self.required_attributes
141:     @@required_attributes.dup
142:   end

     # File lib/rubygems/specification.rb, line 171
171:   def _dump(limit)
172:     Marshal.dump [
173:       @rubygems_version,
174:       @specification_version,
175:       @name,
176:       @version,
177:       date,
178:       @summary,
179:       @required_ruby_version,
180:       @required_rubygems_version,
181:       @original_platform,
182:       @dependencies,
183:       @rubyforge_project,
184:       @email,
185:       @authors,
186:       @description,
187:       @homepage,
188:       true, # has_rdoc
189:       @new_platform,
190:       @licenses
191:     ]
192:   end

     # File lib/rubygems/specification.rb, line 279
279:   def add_bindir(executables)
280:     return nil if executables.nil?
281: 
282:     if @bindir then
283:       Array(executables).map { |e| File.join(@bindir, e) }
284:     else
285:       executables
286:     end
287:   rescue
288:     return nil
289:   end

     # File lib/rubygems/specification.rb, line 482
482:   def add_development_dependency(gem, *requirements)
483:     add_dependency_with_type(gem, :development, *requirements)
484:   end

     # File lib/rubygems/specification.rb, line 492
492:   def add_runtime_dependency(gem, *requirements)
493:     add_dependency_with_type(gem, :runtime, *requirements)
494:   end

     # File lib/rubygems/specification.rb, line 595
595:   def cache_gem
596:     cache_name = File.join(Gem.dir, 'cache', file_name)
597:     return File.exist?(cache_name) ? cache_name : nil
598:   end

     # File lib/rubygems/specification.rb, line 133
133:   def default_value(name)
134:     @@default_value[name]
135:   end

     # File lib/rubygems/specification.rb, line 915
915:   def dependent_gems
916:     out = []
917:     Gem.source_index.each do |name,gem|
918:       gem.dependencies.each do |dep|
919:         if self.satisfies_requirement?(dep) then
920:           sats = []
921:           find_all_satisfiers(dep) do |sat|
922:             sats << sat
923:           end
924:           out << [gem, dep, sats]
925:         end
926:       end
927:     end
928:     out
929:   end

     # File lib/rubygems/specification.rb, line 251
251:   def development_dependencies
252:     dependencies.select { |d| d.type == :development }
253:   end

     # File lib/rubygems/specification.rb, line 540
540:   def file_name
541:     "#{full_name}.gem"
542:   end

     # File lib/rubygems/specification.rb, line 642
642:   def for_cache
643:     spec = dup
644: 
645:     spec.files = nil
646:     spec.test_files = nil
647: 
648:     spec
649:   end

     # File lib/rubygems/specification.rb, line 529
529:   def full_gem_path
530:     path = File.join installation_path, 'gems', full_name
531:     return path if File.directory? path
532:     File.join installation_path, 'gems', original_name
533:   end

     # File lib/rubygems/specification.rb, line 506
506:   def full_name
507:     if platform == Gem::Platform::RUBY or platform.nil? then
508:       "#{@name}-#{@version}"
509:     else
510:       "#{@name}-#{@version}-#{platform}"
511:     end
512:   end

     # File lib/rubygems/specification.rb, line 310
310:   def has_unit_tests?
311:     not test_files.empty?
312:   end

     # File lib/rubygems/specification.rb, line 355
355:   def initialize_copy(other_spec)
356:     other_ivars = other_spec.instance_variables
357:     other_ivars = other_ivars.map { |ivar| ivar.intern } if # for 1.9
358:       String === other_ivars.first
359: 
360:     self.class.array_attributes.each do |name|
361:       name = "@#{name}""@#{name}"
362:       next unless other_ivars.include? name
363: 
364:       begin
365:         val = other_spec.instance_variable_get(name)
366:         if val then
367:           instance_variable_set name, val.dup
368:         else
369:           warn "WARNING: #{full_name} has an invalid nil value for #{name}"
370:         end
371:       rescue TypeError
372:         e = Gem::FormatException.new \
373:           "#{full_name} has an invalid value for #{name}"
374: 
375:         e.file_path = loaded_from
376:         raise e
377:       end
378:     end
379:   end

     # File lib/rubygems/specification.rb, line 547
547:   def installation_path
548:     unless @loaded_from then
549:       raise Gem::Exception, "spec #{full_name} is not from an installed gem"
550:     end
551: 
552:     File.expand_path File.dirname(File.dirname(@loaded_from))
553:   end

     # File lib/rubygems/specification.rb, line 294
294:   def lib_files
295:     @files.select do |file|
296:       require_paths.any? do |path|
297:         file.index(path) == 0
298:       end
299:     end
300:   end

     # File lib/rubygems/specification.rb, line 457
457:   def mark_version
458:     @rubygems_version = Gem::VERSION
459:   end

     # File lib/rubygems/specification.rb, line 900
900:   def normalize
901:     if defined?(@extra_rdoc_files) and @extra_rdoc_files then
902:       @extra_rdoc_files.uniq!
903:       @files ||= []
904:       @files.concat(@extra_rdoc_files)
905:     end
906:     @files.uniq! if @files
907:   end

     # File lib/rubygems/specification.rb, line 244
244:   def runtime_dependencies
245:     dependencies.select { |d| d.type == :runtime }
246:   end

     # File lib/rubygems/specification.rb, line 558
558:   def satisfies_requirement?(dependency)
559:     return @name == dependency.name &&
560:       dependency.requirement.satisfied_by?(@version)
561:   end

     # File lib/rubygems/specification.rb, line 566
566:   def sort_obj
567:     [@name, @version, @new_platform == Gem::Platform::RUBY ? -1 : 1]
568:   end

     # File lib/rubygems/specification.rb, line 575
575:   def spec_name
576:     "#{full_name}.gemspec"
577:   end

     # File lib/rubygems/specification.rb, line 681
681:   def to_ruby
682:     mark_version
683:     result = []
684:     result << "# -*- encoding: utf-8 -*-"
685:     result << nil
686:     result << "Gem::Specification.new do |s|"
687: 
688:     result << "  s.name = #{ruby_code name}"
689:     result << "  s.version = #{ruby_code version}"
690:     unless platform.nil? or platform == Gem::Platform::RUBY then
691:       result << "  s.platform = #{ruby_code original_platform}"
692:     end
693:     result << ""
694:     result << "  s.required_rubygems_version = #{ruby_code required_rubygems_version} if s.respond_to? :required_rubygems_version="
695: 
696:     handled = [
697:       :dependencies,
698:       :name,
699:       :platform,
700:       :required_rubygems_version,
701:       :specification_version,
702:       :version,
703:       :has_rdoc,
704:     ]
705: 
706:     @@attributes.each do |attr_name|
707:       next if handled.include? attr_name
708:       current_value = self.send(attr_name)
709:       if current_value != default_value(attr_name) or
710:          self.class.required_attribute? attr_name then
711:         result << "  s.#{attr_name} = #{ruby_code current_value}"
712:       end
713:     end
714: 
715:     result << nil
716:     result << "  if s.respond_to? :specification_version then"
717:     result << "    s.specification_version = #{specification_version}"
718:     result << nil
719: 
720:     result << "    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then"
721: 
722:     dependencies.each do |dep|
723:       req = dep.requirements_list.inspect
724:       dep.instance_variable_set :@type, :runtime if dep.type.nil? # HACK
725:       result << "      s.add_#{dep.type}_dependency(%q<#{dep.name}>, #{req})"
726:     end
727: 
728:     result << "    else"
729: 
730:     dependencies.each do |dep|
731:       version_reqs_param = dep.requirements_list.inspect
732:       result << "      s.add_dependency(%q<#{dep.name}>, #{version_reqs_param})"
733:     end
734: 
735:     result << '    end'
736: 
737:     result << "  else"
738:       dependencies.each do |dep|
739:         version_reqs_param = dep.requirements_list.inspect
740:         result << "    s.add_dependency(%q<#{dep.name}>, #{version_reqs_param})"
741:       end
742:     result << "  end"
743: 
744:     result << "end"
745:     result << nil
746: 
747:     result.join "\n"
748:   end

     # File lib/rubygems/specification.rb, line 750
750:   def to_ruby_for_cache
751:     for_cache.to_ruby
752:   end

     # File lib/rubygems/specification.rb, line 761
761:   def validate packaging = true
762:     require 'rubygems/user_interaction'
763:     extend Gem::UserInteraction
764:     normalize
765: 
766:     nil_attributes = self.class.non_nil_attributes.find_all do |name|
767:       instance_variable_get("@#{name}").nil?
768:     end
769: 
770:     unless nil_attributes.empty? then
771:       raise Gem::InvalidSpecificationException,
772:         "#{nil_attributes.join ', '} must not be nil"
773:     end
774: 
775:     if packaging and rubygems_version != Gem::VERSION then
776:       raise Gem::InvalidSpecificationException,
777:             "expected RubyGems version #{Gem::VERSION}, was #{rubygems_version}"
778:     end
779: 
780:     @@required_attributes.each do |symbol|
781:       unless self.send symbol then
782:         raise Gem::InvalidSpecificationException,
783:               "missing value for attribute #{symbol}"
784:       end
785:     end
786: 
787:     unless String === name then
788:       raise Gem::InvalidSpecificationException,
789:             "invalid value for attribute name: \"#{name.inspect}\""
790:     end
791: 
792:     if require_paths.empty? then
793:       raise Gem::InvalidSpecificationException,
794:             'specification must have at least one require_path'
795:     end
796: 
797:     @files.delete_if            do |file| File.directory? file end
798:     @test_files.delete_if       do |file| File.directory? file end
799:     @executables.delete_if      do |file|
800:       File.directory? File.join(bindir, file)
801:     end
802:     @extra_rdoc_files.delete_if do |file| File.directory? file end
803:     @extensions.delete_if       do |file| File.directory? file end
804: 
805:     non_files = files.select do |file|
806:       !File.file? file
807:     end
808: 
809:     unless not packaging or non_files.empty? then
810:       non_files = non_files.map { |file| file.inspect }
811:       raise Gem::InvalidSpecificationException,
812:             "[#{non_files.join ", "}] are not files"
813:     end
814: 
815:     unless specification_version.is_a?(Fixnum)
816:       raise Gem::InvalidSpecificationException,
817:             'specification_version must be a Fixnum (did you mean version?)'
818:     end
819: 
820:     case platform
821:     when Gem::Platform, Gem::Platform::RUBY then # ok
822:     else
823:       raise Gem::InvalidSpecificationException,
824:             "invalid platform #{platform.inspect}, see Gem::Platform"
825:     end
826: 
827:     self.class.array_attributes.each do |symbol|
828:       val = self.send symbol
829:       klass = symbol == :dependencies ? Gem::Dependency : String
830: 
831:       unless Array === val and val.all? { |x| klass === x } then
832:         raise(Gem::InvalidSpecificationException,
833:               "#{symbol} must be an Array of #{klass} instances")
834:       end
835:     end
836: 
837:     licenses.each { |license|
838:       if license.length > 64
839:         raise Gem::InvalidSpecificationException,
840:           "each license must be 64 characters or less"
841:       end
842:     }
843: 
844:     # reject lazy developers:
845: 
846:     lazy = '"FIxxxXME" or "TOxxxDO"'.gsub(/xxx/, '')
847: 
848:     unless authors.grep(/FI XME|TO DO/x).empty? then
849:       raise Gem::InvalidSpecificationException, "#{lazy} is not an author"
850:     end
851: 
852:     unless Array(email).grep(/FI XME|TO DO/x).empty? then
853:       raise Gem::InvalidSpecificationException, "#{lazy} is not an email"
854:     end
855: 
856:     if description =~ /FI XME|TO DO/x then
857:       raise Gem::InvalidSpecificationException, "#{lazy} is not a description"
858:     end
859: 
860:     if summary =~ /FI XME|TO DO/x then
861:       raise Gem::InvalidSpecificationException, "#{lazy} is not a summary"
862:     end
863: 
864:     if homepage and not homepage.empty? and
865:        homepage !~ /\A[a-z][a-z\d+.-]*:/i then
866:       raise Gem::InvalidSpecificationException,
867:             "\"#{homepage}\" is not a URI"
868:     end
869: 
870:     # Warnings
871: 
872:     %w[author description email homepage summary].each do |attribute|
873:       value = self.send attribute
874:       alert_warning "no #{attribute} specified" if value.nil? or value.empty?
875:     end
876: 
877:     if description == summary then
878:       alert_warning 'description and summary are identical'
879:     end
880: 
881:     # TODO: raise at some given date
882:     alert_warning "deprecated autorequire specified" if autorequire
883: 
884:     executables.each do |executable|
885:       executable_path = File.join bindir, executable
886:       shebang = File.read(executable_path, 2) == '#!'
887: 
888:       alert_warning "#{executable_path} is missing #! line" unless shebang
889:     end
890: 
891:     true
892:   end