kanrisuru 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e7d36fe867d1049287c11431cb348332d61b0a80e16163fa6a799fcc0fc26bb
-  data.tar.gz: 0fef10f6eb28e176839f8b3a2995416fdb4c88fbfa8b4e24e2c36d719871237e
+  metadata.gz: bb8de477e2168c782b7cb082a6a6760fd56aa6925f1820ee80e45baff76a7b27
+  data.tar.gz: ad21e0b9787a2e42d8626a367f11b44ff97ec27f000a6ec8f7967d7b22da066d
 SHA512:
-  metadata.gz: a96f6c7a0219c0ced7c87faa5923e2c8842dadd429787033885e89444af63943f41f7da88622224573d34940c8b5b3eb44c7fa324d20e146f9bae3e172c8b9b0
-  data.tar.gz: c9cd28b4caf3daba48127d522a0f3f08ac925ee40c058320267cced2b0461b223378d314d48d248e2c614dca82533e12adba761c76e96b6bce976a3021700a5f
+  metadata.gz: 0cdeb2cda038612234429eb9ca172f294f60bb8bdcb0d5db2490231dfc4ab4205ae240b3f8ef8ebab41b5de6ef9d2599c7db76dd0ebe229b8b896e3a831c8805
+  data.tar.gz: b32d4fe02fe5897a8f56d827290516ceb393db63068f9cba3a4396b79e667dd62a332013fbb6fe674cd680ccd374faff877441f92f57048d5b782e244b23ec20

data/.github/CONTRIBUTING.md

@@ -0,0 +1,17 @@
+# How to contribute
+Thank you for your interest in contributing to the Kanrisuru project. We appreciate any volunteers that want to help improve, grow and sustain the Kanrisuru code base!
+
+## Submitting a bug
+* Do not open up a GitHub issue if the bug is a security vulnerability with the Kanrisuru project, instead send an email to engineeering@avamia.com for any security realted issues.
+* Check if there's already an existing issue before submitting a [similar one](https://github.com/avamia/kanrisuru/issues).
+* If you can't find a similar issue [open a new one](https://github.com/avamia/kanrisuru/issues/new?assignees=&labels=&template=bug_report.md). Be sure to include a **title and clear description**, as much relevant information as possible, and a **code sample** or an **executable test case** demonstrating the expected behavior that is not occurring.
+
+## Adding a core feature
+* We always welcome improving the core Kanrisuru project. If we are missing a core command available on most linux distros, this would be a place to add that type of functionality.
+* Other ideas like performance optimization, additional testing, and ease of use are great ways of improving the project.
+* If you want to create something outside of the core project, see the next section.
+
+## Adding a new module
+* If you want to extent Kanrisuru beyond the underlying system code base or core module packages, the best way is to create a new gem, in the format of `kanrisuru-package`. 
+* This helps keep the core Kanrisuru package from too much bloat.
+* See our developer module section to see how to build a new Kanrisuru module.

data/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,33 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. Ubuntu]
+ - Version [e.g. 22]
+ - Ruby version: [e.g 2.7.4]
+
+
+**Additional context**
+Add any other context about the problem here.

data/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

data/.rubocop.yml

@@ -20,6 +20,10 @@ Naming/InclusiveLanguage:
     - lib/kanrisuru/core/dmi.rb
     - spec/unit/core/dmi_spec.rb
 
+Naming/MethodParameterName:
+  Exclude:
+    - spec/functional/os_package_spec.rb
+
 Metrics/AbcSize:
   Enabled: false
 

data/CHANGELOG.md

@@ -0,0 +1,96 @@
+## Kanrisuru 0.7.0 (August 8, 2021) ##
+* Simplify `FileInfo` struct for return object of `ls` command.
+* Rename `size` to `fsize` for the `OpenFile` struct to avoid method naming conflicts of the struct class. 
+* Allow `os_include` and `os_collection` to define multiple groupings of methods with the same namespace.
+* Add `clear` method for remote env class, to remove any session based env variables.
+* Add `to_s` method to result for quick analysis of string based return values. 
+* Remove duplicate `numeric` method in the utils module.
+
+## Kanrisuru 0.6.0 (August 1, 2021) ##
+* Add `lsof` implementation in system core module
+* Fix changelog formatting
+* Add changelog url to gemspec
+
+## Kanrisuru 0.5.2 (July 30, 2021) ##
+* Add changelog documentation
+* Update documentation table with new tested core module 
+* Deprecating `cpu_info` with replacement of `lscpu`. `cpu_info` will be removed in the next major release.
+
+## Kanrisuru 0.5.1 (July 29, 2021) ##
+
+* Unit test cases for core module structs, constants and types. 
+
+## Kanrisuru 0.5.0 (July 29, 2021) ##
+* Add `zypper` package manager core module
+* Add `dmi` core module. Support for getting hardware information from virtual and physical machines.
+* Add only options for test_hosts to filter on which hosts to use for function style test cases. This is used within a test case and takes priority over command line `HOSTS=` and `EXCLUDE=` env variables. 
+* Add additional bit conversion string handling in the util module, such as kib, mib, and gib.
+* Remove redudant namespacing in struct names, such as 
+`Kanrisuru::Core::Yum::YumPackageOverview`, to `Kanrisuru::Core::Yum::PackageOverview`.
+* Fix backups test case for `cp` command with the correct filename.
+* Use 0755 as expected numeric mode for all OS functional tests in the `mkdir` test case.
+* Fix bug with `lscpu` regex match on cpus with more than 9 cores, ie `/cpu\d/` to `/cpu\d+/`
+
+ 
+## Kanrisuru 0.4.1 (July 26, 2021) ##
+* Add `kernel_statistics` to system core module. 
+
+## Kanrisuru 0.4.0 (July 25, 2021) ##
+* Update internal exit code of command from 0, to array of accpeted exit codes, with 0 being the default value.
+* Add `append_exit_code` to command, allowing additional exit codes to be considered true for `success?` return value.
+* Add `@port` to `Net::SSH.start` method
+* Fix test case with `host.os` return value of `opensuse_leap`.
+* Add `cpu_flags` method to `cpu` module
+
+## Kanrisuru 0.3.2 (July 23, 2021) ##
+* Fix typo from `key` to `signal` in hash fetch method. 
+
+## Kanrisuru 0.3.1 (July 22, 2021) ##
+* Add additional methods to `cpu` pulling from `lscpu` struct.
+* Fix `address_size` in `cpu` method call.
+
+## Kanrisuru 0.3.0 (July 22, 2021) ##
+* Add `lscpu` system core module 
+* Replace `cpu` module internal fetching of data from `cpu_info` to `lscpu` struct.
+ 
+## Kanrisuru 0.2.9 (July 20, 2021) ##
+
+* Fix fstab entry from `entry` to `entry[:entry]` in the `for_each`iteration. 
+
+## Kanrisuru 0.2.8 (July 20, 2021) ##
+
+* Update gem development and runtime depedencies with stricter depencies.
+
+## Kanrisuru 0.2.7 (July 18, 2021) ##
+
+* Set opensuse upstream to sles (Suse Enterprise Linux) in `os_family`
+
+## Kanrisuru 0.2.6 (July 17, 2021) ##
+* Force "-" to "\_" from `os-release` release name in `host.os` module.
+
+## Kanrisuru 0.2.5 (July 16, 2021) ##
+* Update gem depedencies to non-zero values
+* Change summary and description fields for `apt` 
+* Move `normalize_size` from `apt` core module, to 
+`Kanrisuru::Util::Bits` class.
+* Add additional test cases for `apt` core module.
+* Add `-hi` to `who` command to explicility print out ip address for user.
+* Update `inode?` command to execute without shell user. 
+* Add `yum` package manager core module
+
+## Kanrisuru 0.2.4 (July 10, 2021) ##
+* Fix error in `ip_rule` and `ip_address` sub modules with command typo. 
+
+## Kanrisuru 0.2.3 (July 07, 2021) ##
+* Add `apt` package manager core module
+
+## Kanrisuru 0.2.2 (June 16, 2021) ##
+* Fix `read_file_chunk` on checking bounds for start and end line values.
+
+## Kanrisuru 0.2.1 (June 16, 2021) ##
+* Add first working release on rubygems.org
+
+## Kanrisuru 0.2.0 (June 16, 2021) [YANKED] ##
+
+## Kanrisuru 0.1.0 (December 12, 2020) ##
+* Initialize repository, start working on project.

data/README.md

@@ -2,6 +2,10 @@
 [![Latest version](https://img.shields.io/github/license/avamia/kanrisuru)](https://github.com/avamia/kanrisuru/blob/main/LICENSE.txt) 
 ![GitHub repo size](https://img.shields.io/github/repo-size/avamia/kanrisuru) 
 
+<p align='center'>
+  <img src="https://s3.us-east-2.amazonaws.com/kanrisuru.com/kanrisuru-banner-02.png" width="600" />
+</p>
+
 # Kanrisuru
 
 Kanrisuru (manage) helps you remotely control infrastructure using Ruby. This is done over SSH. I'm working on building up some basic functionality to help quickly provision, deploy and manage a single host or cluster of hosts.
@@ -79,6 +83,10 @@ cluster.execute('uname') #=> {host: 'host1', result: 'Linux'}, {host: 'host2', r
 |---------------------------------------|------------------|--------------------|--------|--------------------------------------|--------|--------|--------|--------|------|----------|------|
 | **System**                            |                  |                    |        |                                      |        |        |        |        |      |          |      |
 | Get CPU Info                          | cpu_info         | lscpu              | core   | https://linux.die.net/man/1/lscpu    | [x]    | [x]    | [x]    | [x]    | [x]  | [x]      | [x]  |
+| Get CPU architecture                          |  lscpu         | lscpu            | core   | https://linux.die.net/man/1/lscpu    | [x]    | [x]    | [x]    | [x]    | [x]  | [x]      | [x]  |
+| Get kernel stastics                          |  kernel_statistics         | cat /proc/stat            | core   |   | [x]    | [x]    | [x]    | [x]    | [x]  | [x]      | [x]  |
+| Get hardware BIOS info                          |  dmi         | dmidecode            | core   | https://linux.die.net/man/8/dmidecode  | [x]    | [x]    | [x]    | [x]    | [x]  | [x]      | [x]  |
+| Get open file details for processes                          |  lsof         | lsof            | core   | https://linux.die.net/man/8/lsof  | [x]    | [x]    | [x]    | [x]    | [x]  | [x]      | [x]  |
 | Get Load Average                      | load_average     | cat /proc/load_avg | core   |                                      | [x]    | [x]    | [x]    | [x]    | [x]  | [x]      | [x]  |
 | Get RAM Available                     | free             | cat /proc/meminfo  | core   |                                      | [x]    | [x]    | [x]    | [x]    | [x]  | [x]      | [x]  |
 | Get list of processes                 | ps               | ps                 | core   | https://linux.die.net/man/1/ps       | [x]    | [x]    | [x]    | [x]    | [x]  | [x]      | [x]  |
@@ -149,6 +157,7 @@ cluster.execute('uname') #=> {host: 'host1', result: 'Linux'}, {host: 'host2', r
 | **Packages**                          |                  |                    |        |                                      |        |        |        |        |      |          |      |
 | Apt               | apt           | apt                | core   | https://linux.die.net/man/1/apt      | [x]    | [x]    |    |    |  |      |  |
 | Yum           | yum         | yum                | core   | https://linux.die.net/man/1/yum      |    |    | [x]    | [x]    | [x]  |      |  |
+| Zypper           | zypper         | zypper                | core   | https://en.opensuse.org/SDB:Zypper_manual   |    |    |   |    |  | [x] | [x] |
 
 ## Development
 

data/kanrisuru.gemspec

@@ -27,6 +27,7 @@ Gem::Specification.new do |gem|
   gem.require_paths = ['lib']
 
   gem.metadata = {
-    'source_code_uri' => 'https://github.com/avamia/kanrisuru/'
+    'source_code_uri' => 'https://github.com/avamia/kanrisuru/',
+    'changelog_uri' => 'https://github.com/avamia/kanrisuru/blob/main/CHANGELOG.md'
   }
 end

data/lib/kanrisuru/core/path.rb

@@ -9,10 +9,10 @@ module Kanrisuru
 
       os_define :linux, :ls
       os_define :linux, :pwd
-      os_define :linux, :whoami
-      os_define :linux, :which
       os_define :linux, :realpath
       os_define :linux, :readlink
+      os_define :linux, :whoami
+      os_define :linux, :which
 
       FilePath = Struct.new(:path)
       FileInfoId = Struct.new(:inode, :mode, :memory_blocks, :uid, :gid, :fsize, :date, :path, :type)
@@ -46,7 +46,7 @@ module Kanrisuru
             type = values[1].include?('d') ? 'directory' : 'file'
             items <<
               if id
-                FileInfoId.new(
+                FileInfo.new(
                   values[0].to_i,
                   Kanrisuru::Mode.new(values[1]),
                   values[2].to_i,

data/lib/kanrisuru/core/system.rb

@@ -16,6 +16,9 @@ module Kanrisuru
       os_define :linux, :kill
 
       os_define :linux, :kernel_statistics
+      os_define :linux, :kstat
+
+      os_define :linux, :lsof
 
       os_define :linux, :uptime
 
@@ -101,6 +104,18 @@ module Kanrisuru
 
       UserLoggedIn = Struct.new(:user, :tty, :ip, :login, :idle, :jcpu, :pcpu, :command)
 
+      OpenFile = Struct.new(
+        :command,
+        :pid,
+        :uid,
+        :file_descriptor,
+        :type,
+        :device,
+        :fsize,
+        :inode,
+        :name
+      )
+
       def load_env
         command = Kanrisuru::Command.new('env')
         execute_shell(command)
@@ -205,6 +220,10 @@ module Kanrisuru
       end
 
       def cpu_info(spec)
+        Kanrisuru.logger.info do
+          'DEPRECATION WARNING: cpu_info will be removed in the upcoming major release. Use lscpu instead.'
+        end
+
         name =
           case spec
           when 'sockets'
@@ -301,6 +320,60 @@ module Kanrisuru
         Kanrisuru::Result.new(command)
       end
 
+      def lsof(_opts = {})
+        command = Kanrisuru::Command.new('lsof -F pcuftDsin')
+
+        execute_shell(command)
+        Kanrisuru::Result.new(command) do |cmd|
+          lines = cmd.to_a
+
+          current_row = nil
+          current_pid = nil
+          current_user = nil
+          current_command = nil
+
+          rows = []
+
+          lines.each do |line|
+            case line
+            when /^p/
+              current_pid = parse_lsof(line, 'p').to_i
+            when /^c/
+              current_command = parse_lsof(line, 'c')
+            when /^u/
+              current_user = parse_lsof(line, 'u').to_i
+            when /^f/
+              rows << current_row if current_row
+
+              current_row = OpenFile.new
+              current_row.pid = current_pid
+              current_row.command = current_command
+              current_row.uid = current_user
+
+              current_row.file_descriptor = parse_lsof(line, 'f')
+            when /^t/
+              current_row.type = parse_lsof(line, 't')
+            when /^D/
+              current_row.device = parse_lsof(line, 'D')
+            when /^s/
+              current_row.fsize = parse_lsof(line, 's').to_i
+            when /^i/
+              current_row.inode = parse_lsof(line, 'i').to_i
+            when /^n/
+              current_row.name = parse_lsof(line, 'n')
+            end
+          end
+
+          rows << current_row if current_row
+
+          rows
+        end
+      end
+
+      def kstat
+        kernel_statistics
+      end
+
       def kernel_statistics
         command = Kanrisuru::Command.new('cat /proc/stat')
 
@@ -490,6 +563,10 @@ module Kanrisuru
 
       private
 
+      def parse_lsof(line, char)
+        line.split(char, 2)[1]
+      end
+
       def parse_policy_abbr(value)
         case value
         when '-'

data/lib/kanrisuru/os_package.rb

@@ -46,13 +46,19 @@ module Kanrisuru
           ## Define the namespace as an eigen class instance on the host.
           ## Namespaced instances will access core host methods
           ## with @host instance variable.
-          namespace_class    = Kanrisuru::Remote::Cluster.const_set(Kanrisuru::Util.camelize(namespace), Class.new)
-          namespace_instance = Kanrisuru::Remote::Cluster.instance_variable_set("@#{namespace}", namespace_class.new)
 
-          class_eval do
-            define_method namespace do
-              namespace_instance.instance_variable_set(:@cluster, self)
-              namespace_instance
+          if Kanrisuru::Remote::Cluster.instance_variable_defined?("@#{namespace}")
+            namespace_class = Kanrisuru::Remote::Cluster.const_get(Kanrisuru::Util.camelize(namespace))
+            namespace_instance = instance_variable_get("@#{namespace}")
+          else
+            namespace_class    = Kanrisuru::Remote::Cluster.const_set(Kanrisuru::Util.camelize(namespace), Class.new)
+            namespace_instance = Kanrisuru::Remote::Cluster.instance_variable_set("@#{namespace}", namespace_class.new)
+
+            class_eval do
+              define_method namespace do
+                namespace_instance.instance_variable_set(:@cluster, self)
+                namespace_instance
+              end
             end
           end
 
@@ -132,17 +138,25 @@ module Kanrisuru
           ## Define the namespace as an eigen class instance within the host class.
           ## Namespaced instances will access core host methods
           ## with @host instance variable.
-          namespace_class    = Kanrisuru::Remote::Host.const_set(Kanrisuru::Util.camelize(namespace), Class.new)
-          namespace_instance = Kanrisuru::Remote::Host.instance_variable_set("@#{namespace}", namespace_class.new)
-
-          namespace_class.class_eval(&include_method_bindings)
 
-          class_eval do
-            define_method namespace do
-              namespace_instance.instance_variable_set(:@host, self)
-              namespace_instance
+          ## Check to see if the namespace was defined. If so, additional methods will be appended to the
+          ## existing namespace class definition, otherwise, a new namespace class and instance will be
+          ## defined with the methods added.
+          if Kanrisuru::Remote::Host.instance_variable_defined?("@#{namespace}")
+            namespace_class = Kanrisuru::Remote::Host.const_get(Kanrisuru::Util.camelize(namespace))
+            namespace_instance = instance_variable_get("@#{namespace}")
+          else
+            namespace_class    = Kanrisuru::Remote::Host.const_set(Kanrisuru::Util.camelize(namespace), Class.new)
+            namespace_instance = Kanrisuru::Remote::Host.instance_variable_set("@#{namespace}", namespace_class.new)
+            class_eval do
+              define_method namespace do
+                namespace_instance.instance_variable_set(:@host, self)
+                namespace_instance
+              end
             end
           end
+
+          namespace_class.class_eval(&include_method_bindings)
         else
           class_eval(&include_method_bindings)
         end

data/lib/kanrisuru/remote/env.rb

@@ -11,6 +11,10 @@ module Kanrisuru
         @env
       end
 
+      def clear
+        @env = {}
+      end
+
       def to_s
         string = ''
         @env.each.with_index do |(key, value), index|

data/lib/kanrisuru/result.rb

@@ -31,6 +31,10 @@ module Kanrisuru
       @data[prop]
     end
 
+    def to_s
+      @data.to_s
+    end
+
     def to_a
       @data.instance_of?(Array) ? @data : [@data]
     end

data/lib/kanrisuru/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Kanrisuru
-  VERSION = '0.5.0'
+  VERSION = '0.7.0'
 end

data/spec/functional/core/system_spec.rb

@@ -26,14 +26,20 @@ RSpec.describe Kanrisuru::Core::System do
 
       it 'gets environment variables' do
         result = host.load_env
-
-        expect(result.success?).to be(true)
+        expect(result).to be_success
         expect(result.data).to be_instance_of(Hash)
       end
 
+      it 'gets open files' do
+        host.su('root')
+        result = host.lsof
+        expect(result).to be_success
+        expect(result.data).to be_instance_of(Array)
+      end
+
       it 'gets uptime' do
         result = host.uptime
-        expect(result.success?).to eq(true)
+        expect(result).to be_success
 
         expect(result).to respond_to(
           :boot_time, :uptime, :seconds,

data/spec/functional/os_package_spec.rb

@@ -16,7 +16,7 @@ module Kanrisuru
   module TestNamespace
     extend Kanrisuru::OsPackage::Define
 
-    os_define :unix_like, :tester
+    os_define :linux, :tester
     os_define :centos, :test_not_correct
 
     def tester
@@ -25,17 +25,34 @@ module Kanrisuru
 
     def test_not_correct; end
   end
+
+  module TestNamespaceAdditions
+    extend Kanrisuru::OsPackage::Define
+
+    os_define :linux, :add
+    os_define :linux, :minus
+
+    def add(a, b)
+      a + b
+    end
+
+    def minus(a, b)
+      a - b
+    end
+  end
 end
 
 module Kanrisuru
   module Remote
     class Host
       os_include Kanrisuru::TestInclude
+      os_include Kanrisuru::TestNamespaceAdditions, namespace: :asdf
       os_include Kanrisuru::TestNamespace, namespace: :asdf
     end
 
     class Cluster
       os_collection Kanrisuru::TestInclude
+      os_collection Kanrisuru::TestNamespaceAdditions, namespace: :asdf
       os_collection Kanrisuru::TestNamespace, namespace: :asdf
     end
   end
@@ -64,8 +81,15 @@ RSpec.describe Kanrisuru::OsPackage do
 
     expect(host).to respond_to(:asdf)
     expect(host.asdf).to respond_to(:tester)
+    expect(host.asdf).to respond_to(:add)
+    expect(host.asdf).to respond_to(:minus)
+
     expect(host.asdf.tester).to eq 'hello namespace'
+    expect(host.asdf.add(1, 2)).to eq(3)
+    expect(host.asdf.minus(3, 2)).to eq(1)
+
     expect(host.tester).to eq('hello ubuntu')
+
     expect { host.asdf.test_not_correct }.to raise_error(NoMethodError)
     expect(cluster.asdf.tester).to be_instance_of(Array)
 

data/spec/unit/core/apt_spec.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Kanrisuru::Core::Apt do
+  it 'responds to apt fields' do
+    expect(Kanrisuru::Core::Apt::Source.new).to respond_to(
+      :url, :dist, :architecture
+    )
+
+    expect(Kanrisuru::Core::Apt::PackageOverview.new).to respond_to(
+      :package, :version, :suites, :architecture, :installed, :upgradeable, :automatic
+    )
+
+    expect(Kanrisuru::Core::Apt::PackageDetail.new).to respond_to(
+      :package,
+      :version,
+      :priority,
+      :section,
+      :origin,
+      :maintainer,
+      :original_maintainer,
+      :bugs,
+      :install_size,
+      :dependencies,
+      :recommends,
+      :provides,
+      :suggests,
+      :breaks,
+      :conflicts,
+      :replaces,
+      :homepage,
+      :task,
+      :supported,
+      :download_size,
+      :apt_manual_installed,
+      :apt_sources,
+      :description,
+      :summary
+    )
+  end
+end

data/spec/unit/core/archive_spec.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Kanrisuru::Core::Archive do
+  it 'responds to archive fields' do
+    expect(Kanrisuru::Core::Archive::FilePath.new).to respond_to(
+      :path
+    )
+  end
+end

data/spec/unit/core/disk_spec.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Kanrisuru::Core::Disk do
+  it 'responds to disk fields' do
+    expect(Kanrisuru::Core::Disk::DiskUsage.new).to respond_to(:fsize, :path)
+    expect(Kanrisuru::Core::Disk::DiskFree.new).to respond_to(
+      :file_system, :type, :total, :used, :capacity, :mount
+    )
+    expect(Kanrisuru::Core::Disk::LsblkDevice.new).to respond_to(
+      :name, :maj_dev, :min_dev, :removable_device, :readonly_device, :owner, :group,
+      :mode, :fsize, :type, :mount_point, :fs_type, :uuid, :children
+    )
+    expect(Kanrisuru::Core::Disk::BlkidDevice.new).to respond_to(
+      :name, :label, :uuid, :type, :uuid_sub, :label_fatboot, :version, :usage,
+      :part_uuid, :part_entry_scheme, :part_entry_uuid, :part_entry_type,
+      :part_entry_number, :part_entry_offset, :part_entry_size, :part_entry_disk
+    )
+  end
+end

data/spec/unit/core/file_spec.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Kanrisuru::Core::File do
+  it 'responds to file fields' do
+    expect(Kanrisuru::Core::File::FileCount.new).to respond_to(:lines, :words, :characters)
+  end
+end

data/spec/unit/core/find_spec.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Kanrisuru::Core::Find do
+  it 'responds to find fields' do
+    expect(Kanrisuru::Core::Find::FilePath.new).to respond_to(:path)
+  end
+end

data/spec/unit/core/group_spec.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Kanrisuru::Core::Group do
+  it 'responds to group fields' do
+    expect(Kanrisuru::Core::Group::Group.new).to respond_to(:gid, :name, :users)
+    expect(Kanrisuru::Core::Group::GroupUser.new).to respond_to(:uid, :name)
+  end
+end

data/spec/unit/core/ip_spec.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Kanrisuru::Core::IP do
+  it 'responds to ip fields' do
+    expect(Kanrisuru::Core::IP::IPROUTE2_JSON_VERSION).to(
+      eq(180_129)
+    )
+
+    expect(Kanrisuru::Core::IP::IP_ROUTE_TYPES).to(
+      eq(%w[
+           unicast unreachable blackhole prohibit local
+           broadcast throw nat via anycast multicast
+         ])
+    )
+
+    expect(Kanrisuru::Core::IP::IPLinkProperty.new).to respond_to(
+      :index, :name, :flags, :mtu,
+      :qdisc, :state, :group, :qlen,
+      :link_mode, :link_type, :mac_address, :alias,
+      :stats
+    )
+    expect(Kanrisuru::Core::IP::IPAddressProperty.new).to respond_to(
+      :index, :name, :flags, :mtu,
+      :qdisc, :state, :group, :qlen,
+      :link_type, :mac_address,
+      :address_info, :stats
+    )
+    expect(Kanrisuru::Core::IP::IPAddressInfo.new).to respond_to(
+      :family, :ip, :broadcast, :scope,
+      :dynamic, :valid_life_time, :preferred_life_time
+    )
+    expect(Kanrisuru::Core::IP::IPAddressLabel.new).to respond_to(
+      :address, :prefix_length, :label
+    )
+    expect(Kanrisuru::Core::IP::IPRoute.new).to respond_to(
+      :destination, :gateway, :device, :protocol, :scope, :preferred_source, :metric, :flags
+    )
+    expect(Kanrisuru::Core::IP::IPRule.new).to respond_to(:priority, :source, :table)
+    expect(Kanrisuru::Core::IP::IPNeighbour.new).to respond_to(
+      :destination, :device, :lladdr, :state, :stats
+    )
+    expect(Kanrisuru::Core::IP::IPNeighbourStats.new).to respond_to(
+      :used, :confirmed, :updated, :probes, :ref_count
+    )
+    expect(Kanrisuru::Core::IP::IPMAddress.new).to respond_to(:index, :name, :maddr)
+    expect(Kanrisuru::Core::IP::IPMAddressEntry.new).to respond_to(
+      :family, :link, :address, :users
+    )
+    expect(Kanrisuru::Core::IP::IPStats.new).to respond_to(:rx, :tx)
+    expect(Kanrisuru::Core::IP::IPStatRX.new).to respond_to(
+      :bytes, :packets, :errors, :dropped, :over_errors, :multicast
+    )
+    expect(Kanrisuru::Core::IP::IPStatTX.new).to respond_to(
+      :bytes, :packets, :errors, :dropped, :carrier_errors, :collisions
+    )
+  end
+end

data/spec/unit/core/path_spec.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Kanrisuru::Core::Path do
+  it 'responds to path fields' do
+    expect(Kanrisuru::Core::Path::FilePath.new).to respond_to(:path)
+    expect(Kanrisuru::Core::Path::FileInfoId.new).to respond_to(
+      :inode, :mode, :memory_blocks, :uid, :gid, :fsize, :date, :path, :type
+    )
+    expect(Kanrisuru::Core::Path::FileInfo.new).to respond_to(
+      :inode, :mode, :memory_blocks, :owner, :group, :fsize, :date, :path, :type
+    )
+    expect(Kanrisuru::Core::Path::UserName.new).to respond_to(:user)
+  end
+end

data/spec/unit/core/socket_spec.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Kanrisuru::Core::Socket do
+  it 'responds to socket fields' do
+    expect(Kanrisuru::Core::Socket::Statistics.new).to respond_to(
+      :netid, :state, :receive_queue, :send_queue,
+      :local_address, :local_port, :peer_address, :peer_port,
+      :memory
+    )
+    expect(Kanrisuru::Core::Socket::StatisticsMemory.new).to respond_to(
+      :rmem_alloc, :rcv_buf, :wmem_alloc, :snd_buf,
+      :fwd_alloc, :wmem_queued, :ropt_mem, :back_log, :sock_drop
+    )
+    expect(Kanrisuru::Core::Socket::TCP_STATES).to eq(
+      %w[
+        established syn-sent syn-recv
+        fin-wait-1 fin-wait-2 time-wait
+        closed close-wait last-ack listening closing
+      ]
+    )
+    expect(Kanrisuru::Core::Socket::OTHER_STATES).to eq(
+      %w[
+        all connected synchronized bucket syn-recv
+        big
+      ]
+    )
+    expect(Kanrisuru::Core::Socket::TCP_STATE_ABBR).to eq(
+      {
+        'ESTAB' => 'established', 'LISTEN' => 'listening', 'UNCONN' => 'unconnected',
+        'SYN-SENT' => 'syn-sent', 'SYN-RECV' => 'syn-recv', 'FIN-WAIT-1' => 'fin-wait-1',
+        'FIN-WAIT-2' => 'fin-wait-2', 'TIME-WAIT' => 'time-wait', 'CLOSE-WAIT' => 'close-wait',
+        'LAST-ACK' => 'last-ack', 'CLOSING' => 'closing'
+      }
+    )
+  end
+end

data/spec/unit/core/stat_spec.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Kanrisuru::Core::Stat do
+  it 'responds to stat fields' do
+    expect(Kanrisuru::Core::Stat::FileStat.new).to respond_to(
+      :mode, :blocks, :device, :file_type,
+      :gid, :group, :links, :inode,
+      :path, :fsize, :uid, :user,
+      :last_access, :last_modified, :last_changed
+    )
+  end
+end

data/spec/unit/core/system_spec.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Kanrisuru::Core::System do
+  it 'responds to system fields' do
+    expect(Kanrisuru::Core::System::CPUArchitectureVulnerability.new).to respond_to(
+      :name,
+      :data
+    )
+    expect(Kanrisuru::Core::System::CPUArchitecture.new).to respond_to(
+      :architecture,
+      :cores,
+      :byte_order,
+      :address_sizes,
+      :operation_modes,
+      :online_cpus,
+      :threads_per_core,
+      :cores_per_socket,
+      :sockets,
+      :numa_mode,
+      :vendor_id,
+      :cpu_family,
+      :model,
+      :model_name,
+      :stepping,
+      :cpu_mhz,
+      :cpu_max_mhz,
+      :cpu_min_mhz,
+      :bogo_mips,
+      :virtualization,
+      :hypervisor_vendor,
+      :virtualization_type,
+      :l1d_cache,
+      :l1i_cache,
+      :l2_cache,
+      :l3_cache,
+      :numa_nodes,
+      :vulnerabilities,
+      :flags
+    )
+    expect(Kanrisuru::Core::System::KernelStatisticCpu.new).to respond_to(
+      :user,
+      :nice,
+      :system,
+      :idle,
+      :iowait,
+      :irq,
+      :softirq,
+      :steal,
+      :guest,
+      :guest_nice
+    )
+    expect(Kanrisuru::Core::System::KernelStatistic.new).to respond_to(
+      :cpu_total,
+      :cpus,
+      :interrupt_total,
+      :interrupts,
+      :ctxt,
+      :btime,
+      :processes,
+      :procs_running,
+      :procs_blocked,
+      :softirq_total,
+      :softirqs
+    )
+    expect(Kanrisuru::Core::System::ProcessInfo.new).to respond_to(
+      :uid, :user, :gid, :group, :ppid, :pid,
+      :cpu_usage, :memory_usage, :stat, :priority,
+      :flags, :policy_abbr, :policy, :cpu_time, :command
+    )
+    expect(Kanrisuru::Core::System::Uptime.new).to respond_to(
+      :boot_time, :uptime, :seconds, :minutes, :hours, :days
+    )
+    expect(Kanrisuru::Core::System::UserLoggedIn.new).to respond_to(
+      :user, :tty, :ip, :login, :idle, :jcpu, :pcpu, :command
+    )
+    expect(Kanrisuru::Core::System::OpenFile.new).to respond_to(
+      :command,
+      :pid,
+      :uid,
+      :file_descriptor,
+      :type,
+      :device,
+      :fsize,
+      :inode,
+      :name
+    )
+  end
+end

data/spec/unit/core/transfer_spec.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Kanrisuru::Core::Transfer do
+  it 'responds to transfer fields' do
+    expect(Kanrisuru::Core::Transfer::WGET_FILENAME_MODES).to eq(
+      %w[unix windows nocontrol ascii lowercase uppercase]
+    )
+
+    expect(Kanrisuru::Core::Transfer::WGET_SSL_PROTO).to eq(
+      %w[auto SSLv2 SSLv3 TLSv1]
+    )
+  end
+end

data/spec/unit/core/user_spec.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Kanrisuru::Core::User do
+  it 'responds to user fields' do
+    expect(Kanrisuru::Core::User::User.new).to respond_to(:uid, :name, :home, :shell, :groups)
+    expect(Kanrisuru::Core::User::UserGroup.new).to respond_to(:gid, :name)
+    expect(Kanrisuru::Core::User::FilePath.new).to respond_to(:path)
+  end
+end

data/spec/unit/core/yum_spec.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Kanrisuru::Core::Yum do
+  it 'responds to yum fields' do
+    expect(Kanrisuru::Core::Yum::PackageOverview.new).to respond_to(
+      :package, :architecture, :version, :installed
+    )
+
+    expect(Kanrisuru::Core::Yum::PackageSearchResult.new).to respond_to(
+      :package, :architecture, :summary
+    )
+
+    expect(Kanrisuru::Core::Yum::PackageDetail.new).to respond_to(
+      :package,
+      :version,
+      :release,
+      :architecture,
+      :install_size,
+      :source,
+      :yum_id,
+      :repository,
+      :summary,
+      :url,
+      :license,
+      :description
+    )
+
+    expect(Kanrisuru::Core::Yum::Repolist.new).to respond_to(
+      :id,
+      :name,
+      :status,
+      :revision,
+      :packages,
+      :available_packages,
+      :repo_size,
+      :mirrors,
+      :metalink,
+      :updated,
+      :baseurl,
+      :expire,
+      :filters,
+      :filename
+    )
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kanrisuru
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Ryan Mammina
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-29 00:00:00.000000000 Z
+date: 2021-08-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -114,6 +114,9 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/CONTRIBUTING.md"
+- ".github/ISSUE_TEMPLATE/bug_report.md"
+- ".github/ISSUE_TEMPLATE/feature_request.md"
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
@@ -199,7 +202,21 @@ files:
 - spec/helper/test_hosts.rb
 - spec/hosts.json
 - spec/spec_helper.rb
+- spec/unit/core/apt_spec.rb
+- spec/unit/core/archive_spec.rb
+- spec/unit/core/disk_spec.rb
 - spec/unit/core/dmi_spec.rb
+- spec/unit/core/file_spec.rb
+- spec/unit/core/find_spec.rb
+- spec/unit/core/group_spec.rb
+- spec/unit/core/ip_spec.rb
+- spec/unit/core/path_spec.rb
+- spec/unit/core/socket_spec.rb
+- spec/unit/core/stat_spec.rb
+- spec/unit/core/system_spec.rb
+- spec/unit/core/transfer_spec.rb
+- spec/unit/core/user_spec.rb
+- spec/unit/core/yum_spec.rb
 - spec/unit/core/zypper_spec.rb
 - spec/unit/fstab_spec.rb
 - spec/unit/kanrisuru_spec.rb
@@ -212,6 +229,7 @@ licenses:
 - MIT
 metadata:
   source_code_uri: https://github.com/avamia/kanrisuru/
+  changelog_uri: https://github.com/avamia/kanrisuru/blob/main/CHANGELOG.md
 post_install_message: 
 rdoc_options: []
 require_paths: