apt-pkg 0.0.4 → 0.5.0

data/ext/apt_pkg/pkgcache.h

@@ -3,5 +3,6 @@
 #include <apt-pkg/cacheiterators.h>
 #include <apt-pkg/depcache.h>
 #include <apt-pkg/pkgcache.h>
+#include <apt-pkg/update.h>
 
 void init_apt_pkg_pkgcache();

data/lib/debian/apt_pkg.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+require 'debian/apt_pkg/package'
+require 'apt_pkg'
+require 'debian/apt_pkg/gem_version'

data/lib/debian/apt_pkg/gem_version.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+# Debian::AptPkg const VERSION file
+module Debian
+  # AptPkg base module
+  module AptPkg
+    # Gem version
+    VERSION = '0.5.0'.freeze
+  end
+end

data/lib/debian/apt_pkg/package.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+# Debian::AptPkg::Package file
+module Debian
+  # AptPkg base module
+  module AptPkg
+    # Debian::AptPkg::Package class
+    # Representation of a package in a cache
+    class Package
+      attr_accessor :id, :name, :full_name, :arch, :essential, :important,
+        :current_version
+
+      # Initialize the Package class
+      # @example
+      #   new(id, name, full_name, arch, essential, important, current_version)
+      # @param [Integer] The numeric ID of the package
+      # @param [String] The name of the package
+      # @param [String] Get the full name of the package, including the
+      #                 architecture
+      # @param [String] The architecture of the package
+      # @param [Boolean] Boolean value determining whether the package is
+      #                  essential
+      # @param [Boolean] Boolean value determining whether the package has the
+      #                 'important' flag set
+      #                 ('Important: yes' in the Packages file)
+      # @param [Version,NilClass] The version of the package currently installed
+      #                           or `nil`
+      # @return [Package] Package instance
+      def initialize(id, name, full_name, arch, essential, important, current_version)
+        @id = id
+        @name = name
+        @full_name = full_name
+        @arch = arch
+        @essential = essential
+        @important = important
+        @current_version = current_version
+      end
+
+      # Return `true` if the package is installed
+      # @return [Boolean]
+      def is_installed
+        return false unless current_version
+
+        true
+      end
+    end
+  end
+end

data/test/apt_pkg_cache_not_init_integration.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+require_relative 'test_helper'
+
+describe Debian::AptPkg::PkgCache do
+  describe 'not init' do
+    describe '.update' do
+      it 'can be called' do
+        _(lambda do
+          Debian::AptPkg::PkgCache.update
+        end).must_raise Debian::AptPkg::InitError
+      end
+    end
+
+    %i(package version depends package_file ver_file provides group).each do |m|
+      describe ".#{m}_count" do
+        it 'can be called' do
+          _(lambda do
+            Debian::AptPkg::PkgCache.public_send("#{m}_count")
+          end).must_raise Debian::AptPkg::InitError
+        end
+      end
+    end
+  end
+end

data/test/apt_pkg_configuration_test.rb

@@ -1,74 +1,78 @@
 require_relative 'test_helper'
 
 describe Debian::AptPkg::Configuration do
+  before :all do
+    Debian::AptPkg.init
+  end
+
   it 'architectures return an array' do
     arches = Debian::AptPkg::Configuration.architectures
-    arches.must_be_instance_of Array
-    arches.wont_be_empty
+    _(arches).must_be_instance_of Array
+    _(arches).wont_be_empty
   end
 
   it 'languages return an array' do
     all_langs = Debian::AptPkg::Configuration.languages
-    all_langs.must_be_instance_of Array
-    all_langs.wont_be_empty
+    _(all_langs).must_be_instance_of Array
+    _(all_langs).wont_be_empty
 
     langs = Debian::AptPkg::Configuration.languages(false)
-    langs.must_be_instance_of Array
+    _(langs).must_be_instance_of Array
   end
 
   it 'check_architecture' do
-    Debian::AptPkg::Configuration.check_architecture('all').must_equal true
+    _(Debian::AptPkg::Configuration.check_architecture('all')).must_equal true
 
     arches = Debian::AptPkg::Configuration.architectures
     c = Debian::AptPkg::Configuration.check_architecture(arches.first)
-    c.must_equal true
+    _(c).must_equal true
 
     # http://buildd.debian-ports.org/status/fetch.php?pkg=ruby2.1&arch=m68k&ver=2.1.2-2&stamp=1400604298
-    Debian::AptPkg::Configuration.check_architecture('m68k').must_equal false
+    _(Debian::AptPkg::Configuration.check_architecture('m68k')).must_equal false
   end
 
   it 'check_language' do
-    lambda {
+    _(lambda do
       Debian::AptPkg::Configuration.check_language
-    }.must_raise ArgumentError
+    end).must_raise ArgumentError
 
     langs = Debian::AptPkg::Configuration.languages
-    Debian::AptPkg::Configuration.check_language(langs.first).must_equal true
+    _(Debian::AptPkg::Configuration.check_language(langs.first)).must_equal true
 
     c = Debian::AptPkg::Configuration.check_language('gallifreyan')
-    c.must_equal false
+    _(c).must_equal false
   end
 
   it 'compressors return an array' do
     cmps = Debian::AptPkg::Configuration.compressors
-    cmps.must_be_instance_of Array
-    cmps.wont_be_empty
-    cmps.must_include 'gz'
+    _(cmps).must_be_instance_of Array
+    _(cmps).wont_be_empty
+    _(cmps).must_include 'gz'
   end
 
   it 'find configuration value' do
-    lambda {
+    _(lambda do
       Debian::AptPkg::Configuration.config_find
-    }.must_raise ArgumentError
+    end).must_raise ArgumentError
 
-    Debian::AptPkg::Configuration.config_find('Dir::Etc::main').
-      must_equal "apt.conf"
-    Debian::AptPkg::Configuration.config_find('Dir::Etc::netrc').
-      must_equal "auth.conf"
-    Debian::AptPkg::Configuration.config_find('Dir::Etc::parts').
-      must_equal "apt.conf.d"
-    Debian::AptPkg::Configuration.config_find('Spk', 'DebianUser').
-      must_equal "DebianUser"
+    _(Debian::AptPkg::Configuration.config_find('Dir::Etc::main'))
+      .must_equal 'apt.conf'
+    _(Debian::AptPkg::Configuration.config_find('Dir::Etc::netrc'))
+      .must_equal 'auth.conf'
+    _(Debian::AptPkg::Configuration.config_find('Dir::Etc::parts'))
+      .must_equal 'apt.conf.d'
+    _(Debian::AptPkg::Configuration.config_find('Spk', 'DebianUser'))
+      .must_equal 'DebianUser'
   end
 
   it 'find file' do
-    lambda {
+    _(lambda do
       Debian::AptPkg::Configuration.config_find_file
-    }.must_raise ArgumentError
+    end).must_raise ArgumentError
 
-    Debian::AptPkg::Configuration.config_find_file('Dir::Etc::main').
-      must_equal "/etc/apt/apt.conf"
-    Debian::AptPkg::Configuration.config_find_file('Dir::Etc::netrc').
-      must_equal "/etc/apt/auth.conf"
+    _(Debian::AptPkg::Configuration.config_find_file('Dir::Etc::main'))
+      .must_equal '/etc/apt/apt.conf'
+    _(Debian::AptPkg::Configuration.config_find_file('Dir::Etc::netrc'))
+      .must_equal '/etc/apt/auth.conf'
   end
 end

data/test/apt_pkg_test.rb

@@ -1,114 +1,134 @@
 require_relative 'test_helper'
 
 describe Debian::AptPkg do
+  it 'gem has a version number' do
+    refute_nil Debian::AptPkg::VERSION
+  end
+
+  it 'apt has a version number' do
+    refute_nil Debian::AptPkg::APT_VERSION
+  end
+
+  it 'libapt-pkg has a version number' do
+    refute_nil Debian::AptPkg::LIBAPT_PKG_VERSION
+  end
+
+  describe '.init' do
+    it 'returns a bool' do
+      _(Debian::AptPkg.init).must_equal true
+    end
+  end
+
   describe '.cmp_version' do
-    it 'should compare version' do
-      Debian::AptPkg.cmp_version('1.1', '1.0').must_be :>, 0
-      Debian::AptPkg.cmp_version('1.0', '1.0').must_be :==, 0
-      Debian::AptPkg.cmp_version('1.0', '1.1').must_be :<, 0
+    it 'compare version' do
+      _(Debian::AptPkg.cmp_version('1.1', '1.0')).must_be :>, 0
+      _(Debian::AptPkg.cmp_version('1.0', '1.0')).must_be :==, 0
+      _(Debian::AptPkg.cmp_version('1.0', '1.1')).must_be :<, 0
     end
   end
 
   describe '.check_dep' do
     describe 'LessEq' do
-      it 'should compare Debian version' do
-        Debian::AptPkg.check_dep('1', '<=', '2').must_equal true
-        Debian::AptPkg.check_dep('2', '<=', '1').must_equal false
-        Debian::AptPkg.check_dep('1', '<=', '1').must_equal true
+      it 'compare Debian version' do
+        _(Debian::AptPkg.check_dep('1', '<=', '2')).must_equal true
+        _(Debian::AptPkg.check_dep('2', '<=', '1')).must_equal false
+        _(Debian::AptPkg.check_dep('1', '<=', '1')).must_equal true
       end
     end
 
     describe 'GreaterEq' do
-      it 'should compare Debian version' do
-        Debian::AptPkg.check_dep('1', '>=', '2').must_equal false
-        Debian::AptPkg.check_dep('2', '>=', '1').must_equal true
-        Debian::AptPkg.check_dep('1', '>=', '1').must_equal true
+      it 'compare Debian version' do
+        _(Debian::AptPkg.check_dep('1', '>=', '2')).must_equal false
+        _(Debian::AptPkg.check_dep('2', '>=', '1')).must_equal true
+        _(Debian::AptPkg.check_dep('1', '>=', '1')).must_equal true
       end
     end
 
     describe 'Less' do
-      it 'should compare Debian version' do
-        Debian::AptPkg.check_dep('1', '<', '2').must_equal true
-        Debian::AptPkg.check_dep('2', '<', '1').must_equal false
-        Debian::AptPkg.check_dep('1', '<', '1').must_equal false
+      it 'compare Debian version' do
+        _(Debian::AptPkg.check_dep('1', '<', '2')).must_equal true
+        _(Debian::AptPkg.check_dep('2', '<', '1')).must_equal false
+        _(Debian::AptPkg.check_dep('1', '<', '1')).must_equal false
       end
     end
 
     describe 'Greater' do
-      it 'should compare Debian version' do
-        Debian::AptPkg.check_dep('1', '>', '2').must_equal false
-        Debian::AptPkg.check_dep('2', '>', '1').must_equal true
-        Debian::AptPkg.check_dep('1', '>', '1').must_equal false
+      it 'compare Debian version' do
+        _(Debian::AptPkg.check_dep('1', '>', '2')).must_equal false
+        _(Debian::AptPkg.check_dep('2', '>', '1')).must_equal true
+        _(Debian::AptPkg.check_dep('1', '>', '1')).must_equal false
       end
     end
 
     describe 'Equals' do
-      it 'should compare Debian version' do
-        Debian::AptPkg.check_dep('1', '=', '2').must_equal false
-        Debian::AptPkg.check_dep('2', '=', '1').must_equal false
-        Debian::AptPkg.check_dep('1', '=', '1').must_equal true
+      it 'compare Debian version' do
+        _(Debian::AptPkg.check_dep('1', '=', '2')).must_equal false
+        _(Debian::AptPkg.check_dep('2', '=', '1')).must_equal false
+        _(Debian::AptPkg.check_dep('1', '=', '1')).must_equal true
       end
     end
 
     describe 'NotEquals' do
-      it 'should compare Debian version' do
-        Debian::AptPkg.check_dep('1', Debian::AptPkg::NOT_EQUALS, '2').
-          must_equal true
-        Debian::AptPkg.check_dep('2', Debian::AptPkg::NOT_EQUALS, '1').
-          must_equal true
-        Debian::AptPkg.check_dep('1', Debian::AptPkg::NOT_EQUALS, '1').
-          must_equal false
+      it 'compare Debian version' do
+        _(Debian::AptPkg.check_dep('1', Debian::AptPkg::NOT_EQUALS, '2'))
+          .must_equal true
+        _(Debian::AptPkg.check_dep('2', Debian::AptPkg::NOT_EQUALS, '1'))
+          .must_equal true
+        _(Debian::AptPkg.check_dep('1', Debian::AptPkg::NOT_EQUALS, '1'))
+          .must_equal false
       end
     end
 
     describe 'Errors' do
-      it 'should raise argument error with bad comparison' do
-        lambda {
+      it 'raise argument error with bad comparison' do
+        _(lambda do
           Debian::AptPkg.check_dep('1', 'bad', '2')
-        }.must_raise ArgumentError
+        end).must_raise ArgumentError
       end
     end
   end
 
   describe '.uri_to_filename' do
-    it 'should return a filename which can be used to store the file' do
-      Debian::AptPkg.uri_to_filename('http://debian.org/index.html').
-        must_equal 'debian.org_index.html'
+    it 'return a filename which can be used to store the file' do
+      _(Debian::AptPkg.uri_to_filename('http://debian.org/index.html'))
+        .must_equal 'debian.org_index.html'
     end
   end
 
   describe '.upstream_version' do
     it 'Return the upstream version for the Debian package version' do
-      Debian::AptPkg.upstream_version('3.4.15-1+b1').must_equal '3.4.15'
+      _(Debian::AptPkg.upstream_version('3.4.15-1+b1')).must_equal '3.4.15'
     end
   end
 
   describe '.time_to_str' do
     it 'Format a given duration in human-readable manner' do
-      Debian::AptPkg.time_to_str(3601).must_equal '1h 0min 1s'
+      _(Debian::AptPkg.time_to_str(3601)).must_equal '1h 0min 1s'
     end
   end
 
   describe '.size_to_str' do
     it 'Return a string describing the size in a human-readable manner' do
-      Debian::AptPkg.size_to_str(10000).must_equal '10.0 k'
+      _(Debian::AptPkg.size_to_str(10_000)).must_equal '10.0 k'
     end
   end
 
   describe '.string_to_bool' do
     it 'Parse the string input and return a boolean' do
-      Debian::AptPkg.string_to_bool('yes').must_equal true
-      Debian::AptPkg.string_to_bool('no').must_equal false
-      Debian::AptPkg.string_to_bool('no-recognized').must_equal false
+      _(Debian::AptPkg.string_to_bool('yes')).must_equal true
+      _(Debian::AptPkg.string_to_bool('no')).must_equal false
+      _(Debian::AptPkg.string_to_bool('no-recognized')).must_equal false
     end
   end
 
   describe '.check_domain_list' do
     it 'See if the host name given by host is one of the domains given' do
-      Debian::AptPkg.check_domain_list("alioth.debian.org",
-                                       "debian.net,debian.org").must_equal true
-      Debian::AptPkg.check_domain_list("git.debian.org",
-                                       "spkdev.net").must_equal false
+      _(Debian::AptPkg.check_domain_list('alioth.debian.org',
+                                         'debian.net,debian.org'))
+        .must_equal true
+      _(Debian::AptPkg.check_domain_list('git.debian.org',
+                                         'spkdev.net'))
+        .must_equal false
     end
   end
 end

data/test/debian/apt_pkg/package_test.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+require_relative '../../test_helper'
+
+describe Debian::AptPkg::Package do
+  let(:id) { 42 }
+  let(:pkg_name) { "ed" }
+  let(:full_name) { "ed:i386" }
+  let(:arch) { "i386" }
+  let(:essential) { false }
+  let(:important) { false }
+  let(:current_version) { nil }
+
+  describe '.new' do
+    describe 'with correct number of arguments' do
+      it 'can initialize a Package class' do
+        Debian::AptPkg::Package.new(id, pkg_name, full_name, arch,
+                                    essential, important, current_version)
+      end
+    end
+
+    describe 'with wrong number of arguments' do
+      it 'cannot initialize a Package class' do
+        _(lambda do
+          Debian::AptPkg::Package.new(id, pkg_name, full_name, arch,
+                                      essential, important)
+        end).must_raise ArgumentError
+      end
+    end
+  end
+
+  describe '#is_installed' do
+    subject do
+      Debian::AptPkg::Package.new(id, pkg_name, full_name, arch,
+                                  essential, important,
+                                  current_version).is_installed
+    end
+
+    describe 'when current_version is present' do
+      let(:current_version) do
+        Debian::AptPkg::Version.new("ed", "1", "editors", "i386", 0, 0, 0, 0, 4)
+      end
+
+      it 'returns true' do
+        _(subject).must_equal true
+      end
+    end
+
+    describe 'when current_version is not present' do
+      let(:current_version) { nil }
+
+      it 'returns false' do
+        _(subject).must_equal false
+      end
+    end
+  end
+end

data/test/debian/apt_pkg/pkg_cache_test.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+require_relative '../../test_helper'
+
+describe Debian::AptPkg::PkgCache do
+  before :all do
+    Debian::AptPkg.init
+  end
+
+  describe '.update' do
+    it 'can be called' do
+      Debian::AptPkg::PkgCache.update
+    end
+  end
+
+  describe '.gen_caches' do
+    it 'return boolean' do
+      if Process.uid == 0
+        _(Debian::AptPkg::PkgCache.gen_caches).must_equal true
+      else
+        _(Debian::AptPkg::PkgCache.gen_caches).must_equal false
+      end
+    end
+  end
+
+  describe '.is_multi_arch' do
+    it 'can be called' do
+      Debian::AptPkg::PkgCache.is_multi_arch
+    end
+  end
+
+  describe '.packages' do
+    it 'returns an array of Package' do
+      packages = Debian::AptPkg::PkgCache.packages
+      _(packages).must_be_kind_of Array
+      _(packages.first).must_be_kind_of Debian::AptPkg::Package
+      libapt = packages.find { |pkg| pkg.name == 'libapt-pkg-dev'  }
+      _(libapt.id).must_be_kind_of Numeric
+      _(libapt.name).must_equal 'libapt-pkg-dev'
+      _(libapt.full_name).must_match(/libapt-pkg-dev:(\w)/)
+      _(libapt.arch).must_match(/(\w)/)
+      _([true, false]).must_include libapt.essential
+      _([true, false]).must_include libapt.important
+      _(libapt.current_version).must_be_kind_of Debian::AptPkg::Version
+      _(libapt.current_version.parent_package_name).must_equal libapt.name
+      _(libapt.current_version.version_string).must_be_kind_of String
+      _(libapt.current_version.section).must_equal 'libdevel'
+      _(libapt.current_version.arch).must_equal libapt.arch
+      _(libapt.current_version.size).must_be_kind_of Numeric
+      _(libapt.current_version.installed_size).must_be_kind_of Numeric
+      _(libapt.current_version.hash).must_be_kind_of Numeric
+      _(libapt.current_version.id).must_be_kind_of Numeric
+      _(libapt.current_version.priority).must_be_kind_of Numeric
+    end
+  end
+
+  describe '.pkg_names' do
+    it 'is deprecated' do
+      out, err = capture_io do
+        Debian::AptPkg::PkgCache.pkg_names('libapt-pkg-dev')
+      end
+      _(out).must_equal ''
+      regexp = /warning:\sDebian::AptPkg::PkgCache\.pkg_names\sis\sdeprecated;\s
+      use\sDebian::AptPkg::PkgCache\.packages\sinstead/x
+      _(err).must_match(regexp)
+    end
+
+    it 'no argument' do
+      _(lambda do
+        capture_io do
+          Debian::AptPkg::PkgCache.pkg_names
+        end
+      end).must_raise ArgumentError
+    end
+
+    it 'nil argument' do
+      _(lambda do
+        capture_io do
+          Debian::AptPkg::PkgCache.pkg_names(nil)
+        end
+      end).must_raise ArgumentError
+    end
+
+    it 'blank argument' do
+      _(lambda do
+        capture_io do
+          Debian::AptPkg::PkgCache.pkg_names('')
+        end
+      end).must_raise ArgumentError
+    end
+
+    it 'be filtered' do
+      capture_io do
+        search = Debian::AptPkg::PkgCache.pkg_names('vim')
+        # CI specific cache can not be present
+        unless search.nil? || search.empty?
+          _(search).must_include 'vim'
+          _(search).must_include 'vim-nox'
+          _(search).must_include 'vim-gtk'
+          _(search).wont_include 'emacs'
+        end
+      end
+    end
+  end
+
+  %i(package version depends package_file ver_file provides group).each do |m|
+    describe ".#{m}_count" do
+      it 'return an int' do
+        if Process.uid == 0
+          _(Debian::AptPkg::PkgCache.public_send("#{m}_count")).must_be :>=, 0
+        end
+      end
+    end
+  end
+end