linux_stat 0.1.6 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5b9e6e97360a33536c048dad2ef4df57d1a7973a60c77e94fa97a8ddcdfd9339
-  data.tar.gz: 64e14d64fa055695b41246dd526bf7bcfb1531645fcc2b7bb72b06d5f8e9aaa4
+  metadata.gz: fd93c4105b08257a85c176b7898d5ae282b1d74bb33d99d2b11536fae6402eda
+  data.tar.gz: a4a3a2032a1573c7f60ca09567fc9cb03ebea90cdc330f4652d7c7711d26adf6
 SHA512:
-  metadata.gz: 82b5e2129b50d290fd566e1d07251713f635d8a8866ad096005bb5cd9b495e1701a2edf6f26e9827f46952aef331cb18fb9f3da66bd1bf23face6f6dda676eb8
-  data.tar.gz: 6759f1379111ba1caae25d6fc8de54f61e5b15259bc7a4c744a759074fcf89f845ba07745afe67d04ced60d22fa8d458a5de0222eac46eebd4cf40bdcaf69ebf
+  metadata.gz: 24d055e84863433fa67cf3c5a59ddea66ad03346aaf469eb033dfa3dae362ee62117f4b07bcb251f26e73517a13dfde460132f3773e214ab34812c7838e7ccf9
+  data.tar.gz: 0ac774300aab62af85094f9be2162449cbfa5be8bfba0f04fcf1801e11b9bbb730db8e51a765bbd53d9d0b887b769037ddc19fa5012018e1b5d8dfc3137adddb

data/Gemfile

@@ -2,6 +2,4 @@ source "https://rubygems.org"
 
 # Specify your gem's dependencies in linux_stat.gemspec
 gemspec
-
-gem "rake", "~> 12.0"
-gem "rspec", "~> 3.0"
+gem "rake", ">= 12.0"

data/README.md

@@ -1,5 +1,5 @@
 # LinuxStat
-![logo](https://raw.githubusercontent.com/Souravgoswami/linux_stat/master/logo.jpg)
+![logo](https://raw.githubusercontent.com/Souravgoswami/linux_stat/master/logo/logo.jpg)
 
 LinuxStat lets you read statistics of a Linux system. It can show you cpu stats and usages, memory stats and usages, swap stats and usages, battery usage, bios info,  kernel details, local ip, os details and parse os-release + lsb-release, etc.
 
@@ -78,7 +78,7 @@ LinuxStat::CPU.count
 => 4
 
 LinuxStat::CPU.cur_freq
-=> [1973525, 2000029, 2000168, 2000152]
+=> [2000001, 1999996, 1999998, 1999997]
 
 LinuxStat::CPU.max_freq
 => [2000000, 2000000, 2000000, 2000000]
@@ -87,16 +87,16 @@ LinuxStat::CPU.model
 => "Intel(R) Core(TM) i3-6006U CPU @ 2.00GHz"
 
 LinuxStat::CPU.stat
-=> {0=>6.45, 1=>12.5, 2=>0.0, 3=>0.0, 4=>12.5}
+=> {0=>30.0, 1=>50.0, 2=>28.57, 3=>16.67, 4=>28.57}
 
 LinuxStat::CPU.total_usage
-=> 6.67
+=> 26.67
 
 LinuxStat::CPU.usage
-=> 0.0
+=> 25.0
 
 LinuxStat::CPU.usages
-=> {0=>9.68, 1=>0.0, 2=>12.5, 3=>0.0, 4=>12.5}
+=> {0=>33.33, 1=>50.0, 2=>28.57, 3=>28.57, 4=>16.67}
 
 ```
 
@@ -105,6 +105,9 @@ LinuxStat::CPU.usages
 LinuxStat::Kernel.build_date
 => 2020-10-21 01:11:20 +0000
 
+LinuxStat::Kernel.build_date_string
+=> "21 Oct 2020 01:11:20 +0000"
+
 LinuxStat::Kernel.build_user
 => "souravgoswami@archlinux"
 
@@ -125,22 +128,22 @@ LinuxStat::Kernel.version
 ### LinuxStat::Memory
 ```
 LinuxStat::Memory.available
-=> 496044
+=> 405020
 
 LinuxStat::Memory.percent_available
-=> 12.93
+=> 10.56
 
 LinuxStat::Memory.percent_used
-=> 87.07
+=> 89.44
 
 LinuxStat::Memory.stat
-=> {:total=>3836264, :used=>3340220, :available=>496044, :percent_used=>87.07, :percent_available=>12.93}
+=> {:total=>3836264, :used=>3431244, :available=>405020, :percent_used=>89.44, :percent_available=>10.56}
 
 LinuxStat::Memory.total
 => 3836264
 
 LinuxStat::Memory.used
-=> 3340220
+=> 3431244
 
 ```
 
@@ -169,29 +172,29 @@ LinuxStat::OS.os_release
 => {:NAME=>"Arch Linux", :PRETTY_NAME=>"Arch Linux", :ID=>"arch", :BUILD_ID=>"rolling", :ANSI_COLOR=>"38;2;23;147;209", :HOME_URL=>"https://www.archlinux.org/", :DOCUMENTATION_URL=>"https://wiki.archlinux.org/", :SUPPORT_URL=>"https://bbs.archlinux.org/"...
 
 LinuxStat::OS.uptime
-=> {:hour=>11, :minute=>33, :second=>52.62}
+=> {:hour=>40, :minute=>46, :second=>19.75}
 
 ```
 
 ### LinuxStat::Process
 ```
 LinuxStat::Process.count
-=> 212
+=> 223
 
 LinuxStat::Process.idle
-=> [3, 4, 6, 9, 12, 23, 30, 37, 39, 49, 102, 103, 104, 106, 107, 108, 109, 110, 117, 118, 119, 121, 131, 134, 140, 152, 153, 170, 172, 174, 177, 179, 180, 184, 185, 186, 187, 188, 189, 227, 274, 285, 293, 316, 1918, 1919, 1920, 1921, 1922, 1923, 62565, 6...
+=> [3, 4, 6, 9, 12, 23, 30, 37, 39, 49, 102, 103, 104, 106, 107, 108, 109, 110, 117, 118, 120, 122, 131, 134, 140, 152, 153, 166, 168, 170, 171, 174, 180, 181, 182, 183, 184, 185, 187, 224, 272, 320, 327, 328, 2238, 2239, 2240, 2241, 2242, 2243, 89437, 9...
 
 LinuxStat::Process.list
-=> [1, 2, 3, 4, 6, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 23, 24, 25, 26, 27, 28, 30, 31, 32, 33, 34, 35, 37, 38, 39, 40, 41, 42, 46, 47, 48, 49, 50, 51, 52, 102, 103, 104, 106, 107, 108, 109, 110, 111, 114, 115, 117, 118, 119, 121, 131, 134,...
+=> [1, 2, 3, 4, 6, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 23, 24, 25, 26, 27, 28, 30, 31, 32, 33, 34, 35, 37, 38, 39, 40, 41, 42, 46, 47, 48, 49, 50, 51, 52, 102, 103, 104, 106, 107, 108, 109, 110, 111, 114, 115, 117, 118, 120, 122, 131, 134,...
 
 LinuxStat::Process.names
 => {1=>"systemd", 2=>"kthreadd", 3=>"rcu_gp", 4=>"rcu_par_gp", 6=>"kworker/0:0H", 9=>"mm_percpu_wq", 10=>"ksoftirqd/0", 11=>"rcuc/0", 12=>"rcu_preempt", 13=>"rcub/0", 14=>"migration/0", 15=>"idle_inject/0", 16=>"cpuhp/0", 17=>"cpuhp/1", 18=>"idle_inject/...
 
 LinuxStat::Process.running
-=> [64200]
+=> [525, 91940, 91971, 91993, 92020, 95119]
 
 LinuxStat::Process.sleeping
-=> [1, 2, 10, 11, 13, 14, 15, 16, 17, 18, 19, 20, 21, 24, 25, 26, 27, 28, 31, 32, 33, 34, 35, 38, 40, 41, 42, 46, 47, 48, 50, 51, 52, 111, 114, 115, 169, 171, 190, 217, 228, 284, 291, 311, 322, 334, 335, 336, 346, 349, 350, 353, 362, 365, 367, 369, 382,...
+=> [1, 2, 10, 11, 13, 14, 15, 16, 17, 18, 19, 20, 21, 24, 25, 26, 27, 28, 31, 32, 33, 34, 35, 38, 40, 41, 42, 46, 47, 48, 50, 51, 52, 111, 114, 115, 165, 167, 186, 214, 227, 302, 313, 319, 321, 333, 334, 335, 352, 353, 354, 355, 362, 366, 367, 369, 382,...
 
 LinuxStat::Process.types
 => {1=>:sleeping, 2=>:sleeping, 3=>:idle, 4=>:idle, 6=>:idle, 9=>:idle, 10=>:sleeping, 11=>:sleeping, 12=>:idle, 13=>:sleeping, 14=>:sleeping, 15=>:sleeping, 16=>:sleeping, 17=>:sleeping, 18=>:sleeping, 19=>:sleeping, 20=>:sleeping, 21=>:sleeping, 23=>:i...
@@ -203,36 +206,74 @@ LinuxStat::Process.zombie
 
 ### LinuxStat::Swap
 ```
+LinuxStat::Swap.any?
+=> true
+
 LinuxStat::Swap.available
-=> 3142816
+=> 2292252
 
 LinuxStat::Swap.list
-=> {"/dev/zram0"=>[:partition, 4194300, 1051484, -2]}
+=> {"/dev/zram0"=>[:partition, 4194300, 1902048, -2]}
 
 LinuxStat::Swap.percent_available
-=> 74.93
+=> 54.65
 
 LinuxStat::Swap.percent_used
-=> 25.07
+=> 45.35
 
 LinuxStat::Swap.stat
-=> {:total=>4194300, :used=>1051484, :available=>3142816, :percent_used=>25.07, :percent_available=>74.93}
+=> {:total=>4194300, :used=>1902048, :available=>2292252, :percent_used=>45.35, :percent_available=>54.65}
 
 LinuxStat::Swap.total
 => 4194300
 
 LinuxStat::Swap.used
-=> 1051484
+=> 1902048
 
 ```
 
+### Return Types:
+In general, if a method returns either a Float or a Integer or a Time, it will return float. But if the status isn't available, it will return nil.
+If the method returns a Hash / Array, it will return return Hash. If the status isn't available, it will return an empty Hash / Array.
+If the method returns a String, it will return return Hash. If the status isn't available, it will return an empty *frozen* String.
+
+It doesn't have implementation of any Error that gets raised in runtime for the ease of use.
+If you need to check some stat that returns an integer or float, and you get nil, you know it's not available, so you can work accordingly.
+But if you need the integer or float value in 0 to whatever format, you can use the .to_i or .to_f method on the object, nil will get converted to number then.
+
+If some error is *raised* it should be reported as a bug.
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
+## Testing
+Like other gems, this doesn't have a test like RSpec. We suggest using the bin/linuxstat.rb file on various systems.
+If you need to test a specific module, say the CPU, just run it like this:
+
+```
+ruby bin/linuxstat.rb CPU
+```
+
+Or:
+```
+ruby bin/linuxstat.rb cpu
+```
+
+That is, the argument passed is not case-sensitive.
+But if the method passed isn't available and outright wrong, it will run all the module methods. For example, you can't do:
+
+```
+ruby bin/linuxstat.rb upc
+```
+
+You can run `rake` to test all the modules.
+You can also use `rake cpu` to test the CPU module or `rake memory` to test the memory module. But this is case-sensitive.
+
+This is not a valid module and can't be run.
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/linux_stat. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[Souravgoswami]/linux_stat/blob/master/CODE_OF_CONDUCT.md).

data/bin/console

@@ -1,14 +1,4 @@
 #!/usr/bin/env ruby
-
-require "bundler/setup"
-require "linux_stat"
-
-# You can add fixtures and/or initialization code here to make experimenting
-# with your gem easier. You can also use a different console, if you like.
-
-# (If you use this, don't forget to add pry to your Gemfile!)
-# require "pry"
-# Pry.start
-
-require "irb"
+$-v = true
+%w(bundler/setup linux_stat irb).each(&method(:require))
 IRB.start(__FILE__)

data/{run_all_methods.rb → bin/linuxstat.rb}

@@ -1,6 +1,10 @@
 #!/usr/bin/env ruby
-require 'bundler/setup'
-require 'linux_stat'
+begin
+	require 'linux_stat'
+rescue LoadError
+	require 'bundler/setup'
+	require 'linux_stat'
+end
 
 $-v = true
 
@@ -8,7 +12,18 @@ $-v = true
 MARKDOWN = ARGV.any? { |x| x[/^\-\-markdown$/] || x[/^\-md$/] }
 PRINT_TIME = MARKDOWN ? false : !ARGV.any? { |x| x[/^\-\-no-time$/] || x[/^\-nt$/] }
 
-LinuxStat.constants.sort.each do |c|
+%w(--markdown -md --no-time -nt).each(&ARGV.method(:delete))
+
+# Run only desired classes / modules
+constants = LinuxStat.constants
+
+execute = constants.map(&:downcase).map.with_index { |x, i|
+	constants[i] if ARGV.find { |y| y.downcase.to_sym == x }
+}.compact
+
+execute.replace(constants) if execute.empty?
+
+execute.sort.each do |c|
 	e = eval("LinuxStat::#{c}")
 
 	next if e.class != Module && e.class != Class
@@ -25,9 +40,10 @@ LinuxStat.constants.sort.each do |c|
 
 	meths.each do |meth|
 		time = Time.now
-		v = e.send(meth).inspect
-		time = Time.now.-(time).*(1000).round(3)
+		v = e.send(meth)
+		time = Time.now.-(time).*(1_000_000).round(3)
 
+		v = v.inspect
 		dis = v.length > 253 ? v[0..250].strip + '...'.freeze : v
 
 		if MARKDOWN
@@ -37,13 +53,13 @@ LinuxStat.constants.sort.each do |c|
 		end
 
 		puts( "(" +
-			if time > 10
-				"\e[1;38;2;255;80;80m"
-			elsif time > 5
+			if time > 10_000
+				"\e[1;38;2;255;50;50m"
+			elsif time > 5_000
 				"\e[1;38;2;255;170;0m"
 			else
 				"\e[1;38;2;0;170;0m"
-			end + "Time taken: #{time}ms\e[0m)"
+			end + "Time taken: #{time}\u03BCs\e[0m)"
 		) if PRINT_TIME
 
 		puts

data/lib/linux_stat.rb

@@ -1,8 +1,6 @@
 require "linux_stat/version"
 
 module LinuxStat
-	class StatUnavailable < StandardError
-	end
 end
 
 require "linux_stat/battery"

data/lib/linux_stat/battery.rb

@@ -3,10 +3,13 @@ module LinuxStat
 		PATH = "/sys/class/power_supply/BAT0"
 
 		class << self
+			# Returns true or false based on the presence of the battery.
 			def present?
 				@@present ||= Dir.exist?(PATH)
 			end
 
+			# Returns the details of the battery.
+			#If the battery is not present it will return an empty Hash.
 			def stat
 				st = status.downcase
 				return {} unless present?
@@ -23,40 +26,60 @@ module LinuxStat
 				}
 			end
 
+			# Returns the model of the battery.
+			#If the battery is not present or the information isn't available it will return an empty String.
 			def model
 				return ''.freeze unless model_readable?
 				IO.read(File.join(PATH, 'model_name')).tap(&:strip!)
 			end
 
+			# Returns the manufacturer of the battery.
+			# If the battery is not present or the information is not available, it will return an empty String.
 			def manufacturer
 				return ''.freeze unless manufacturer_readable?
 				IO.read(File.join(PATH, 'manufacturer')).tap(&:strip!)
 			end
 
+			# Returns the technology of the battery.
+			# If the battery is not present or the information is not available, it will return an empty String.
 			def technology
 				return ''.freeze unless tech_readable?
 				IO.read(File.join(PATH, 'technology')).tap(&:strip!)
 			end
 
+			# Returns the status of the battery.
+			# If the battery is not present or the information is not available, it will return an empty String.
+			# The status generally includes either of the full, charging, discharging and unknown states in most cases.
 			def status
 				return ''.freeze unless status_readable?
 				IO.read(File.join(PATH, 'status')).tap(&:strip!)
 			end
 
+			# Returns true if the battery is charging, false if the battery is not charging.
+			# If the battery is not present or the information is not available, it will return nil.
 			def charging?
+				return nil if status.empty?
 				%w(full charging unknown).each(&:freeze).include?(status.downcase)
 			end
 
+			# Returns true if the battery is discharging, false if the battery is not discharging.
+			# If the battery is not present or the information is not available, it will return nil.
 			def discharging?
+				return nil if status.empty?
 				status.downcase == 'discharging'
 			end
 
+			# Returns true if the battery status if full, false if the battery status is not full.
+			# If the battery is not present or the information is not available, it will return nil.
 			def full?
+				return nil if status.empty?
 				status.downcase == 'full'
 			end
 
+			# Returns the charge of the battery.
+			# If the battery is not present or the information is not available, it will return nil.
 			def charge
-				return 0.0 unless charge_now_readable?
+				return nil unless charge_now_readable?
 				charge_now = IO.read(File.join(PATH, 'charge_now')).to_i
 				charge_full = IO.read(File.join(PATH, 'charge_full')).to_i
 

data/lib/linux_stat/bios.rb

@@ -1,6 +1,9 @@
 module LinuxStat
 	module BIOS
 		class << self
+			# Returns the model of the BIOS.
+			# If the information is not available it will return a frozen empty string.
+			# The output is also cached ; as changing the value in runtime is unexpected.
 			def model
 				# Cached ; as changing the value in runtime is unexpected
 				@@model ||= if File.readable?('/sys/devices/virtual/dmi/id/product_name')
@@ -12,6 +15,9 @@ module LinuxStat
 				end
 			end
 
+			# Returns the vendor of the BIOS.
+			# If the information is not available it will return a frozen empty string.
+			# The output is also cached ; as changing the value in runtime is unexpected.
 			def vendor
 				# Cached ; as changing the value in runtime is unexpected
 				@@vendor ||= if File.readable?('/sys/devices/virtual/dmi/id/bios_vendor')
@@ -21,8 +27,10 @@ module LinuxStat
 				end
 			end
 
+			# Returns the version of the BIOS.
+			# If the information is not available it will return a frozen empty string.
+			# The output is also cached ; as changing the value in runtime is unexpected.
 			def version
-				# Cached ; as changing the value in runtime is unexpected
 				@@version ||= if File.readable?('/sys/devices/virtual/dmi/id/bios_version')
 					IO.read('/sys/devices/virtual/dmi/id/bios_version').tap(&:strip!)
 				else
@@ -30,8 +38,10 @@ module LinuxStat
 				end
 			end
 
+			# Returns the date of the BIOS.
+			# If the information is not available it will return a frozen empty string.
+			# The output is also cached ; as changing the value in runtime is unexpected.
 			def date
-				# Cached ; as changing the value in runtime is unexpected
 				@@date ||= if File.readable?('/sys/devices/virtual/dmi/id/bios_date')
 					IO.read('/sys/devices/virtual/dmi/id/bios_date').tap(&:strip!)
 				else

data/lib/linux_stat/cpu.rb

@@ -1,6 +1,15 @@
 module LinuxStat
 	module CPU
 		class << self
+			# Returns the cpu usage of all threads.
+			#
+			# The first one is aggregated CPU usage reported by the Linux kernel.
+			# And the consecutive ones are the real core usages.
+			#
+			# On a system with 4 threads, the output will be like::
+			# {0=>84.38, 1=>100.0, 2=>50.0, 3=>87.5, 4=>87.5}
+			#
+			# If the information is not available, it will return an empty Hash
 			def stat(sleep = 0.075)
 				return {} unless stat?
 
@@ -21,8 +30,12 @@ module LinuxStat
 				end
 			end
 
+			# Returns the total cpu usage.
+			# It's like running LinuxStat::CPU.stat[0] but it's much more efficient and calculates just the aggregated usage which is available at the top of the /proc/stat file.
+			#
+			# If the information is not available, it will return nil.
 			def total_usage(sleep = 0.075)
-				return {} unless stat?
+				return nil unless stat?
 
 				data = IO.foreach('/proc/stat').first.split.tap(&:shift).map!(&:to_f)
 				sleep(sleep)
@@ -36,31 +49,30 @@ module LinuxStat
 				totald.-(idle_now - idle_then).fdiv(totald).*(100).round(2).abs
 			end
 
+			# Returns the total number of CPU threads.
+			# If the information isn't available, it will return 0.
 			def count
 				# CPU count can change during the program runtime
 				cpuinfo.count { |x| x.start_with?('processor') }
 			end
 
+			# Returns the model of processor.
+			# If the information isn't available, it will return en empty string.
+			# The output is also cached ; as changing the value in runtime is unexpected.
 			def model
-				# Cached ; as changing the value in runtime is unexpected ; nobody is going
-				# to add/remove CPUs during program runtime
 				@@name ||= cpuinfo.find { |x| x.start_with?('model name') }.to_s.split(?:)[-1].to_s.strip
 			end
 
-			# Returns an array with current core frequencies corresponding to the usages
+			# Returns an array with current core frequencies corresponding to the usages.
+			# If the information isn't available, it will return an empty array.
 			def cur_freq
-				# Cached ; as changing the value in runtime is unexpected ; nobody is going
-				# to add/remove CPUs during program runtime
-
 				@@cpu_freqs ||= Dir["/sys/devices/system/cpu/cpu[0-9]*/cpufreq/scaling_cur_freq"]
 				@@cpu_freqs.map { |x| IO.read(x).to_i }
 			end
 
-			# Returns an array with max core frequencies corresponding to the usages
+			# Returns an array with max core frequencies corresponding to the usages.
+			# If the information isn't available, it will return an empty array.
 			def max_freq
-				# Cached ; as changing the value in runtime is unexpected ; nobody is going
-				# to add/remove CPUs during program runtime
-
 				@@max_freqs ||= Dir["/sys/devices/system/cpu/cpu[0-9]*/cpufreq/scaling_max_freq"]
 				@@max_freqs.map { |x| IO.read(x).to_i }
 			end

data/lib/linux_stat/kernel.rb

@@ -1,24 +1,33 @@
 module LinuxStat
 	module Kernel
 		class << self
+			# Returns the Linux Kernel version.
+			# If the information isn't available, it will return a frozen empty string.
+			# The output is also cached ; as changing the value in runtime is unexpected.
 			def version
 				return ''.freeze if string.empty?
 				@@version ||= splitted[2]
 			end
 
+			# Returns the name of the user who built the kernel using KBUILD_FLAGS.
+			# If the information isn't available, it will return a frozen empty string.
+			# The output is also cached ; as changing the value in runtime is unexpected.
 			def build_user
 				@@build_user ||= string.split(/(\(.+\))/).each(&:strip!)
 					.reject(&:empty?).find { |x| x[/^\(.+\)$/] }.to_s
-					.split[0].to_s[1..-2].to_s
+					.split[0].to_s[1..-2].to_s.freeze
 			end
 
+			# Returns the compiler used to compile the Linux Kernel.
+			# If the information isn't available, it will return a frozen empty string.
+			# The output is also cached ; as changing the value in runtime is unexpected.
 			def compiler
 				return ''.freeze if string.empty?
 
 				@@compiler ||= string.split(/(\(.+\))/).each(&:strip!)
 					.reject(&:empty?)
 					.find { |x| x[/^\(.+\)$/] }.to_s
-					.split.find { |x| !x[/^(.+@.+)$/] }.to_s[/\w+/].to_s
+					.split.find { |x| !x[/^(.+@.+)$/] }.to_s[/\w+/].to_s.freeze
 
 				@@compiler_val ||= case @@compiler
 					when /gcc/i then [:gcc ]
@@ -28,32 +37,106 @@ module LinuxStat
 				end << compiler_version
 			end
 
+			# Returns the compiler version used to compile the Linux Kernel.
+			# If the information isn't available, it will return a frozen empty string.
+			# The output is also cached ; as changing the value in runtime is unexpected.
 			def compiler_version
 				@@compiler_version ||= string.split(/(\(.+?\))/).each(&:strip!)
 					.reject(&:empty?)[2..4].to_a
-					.find { |x| x[/[\d.]+/] }.to_s[/[\d.]+/].to_s
+					.find { |x| x[/[\d.]+/] }.to_s[/[\d.]+/].to_s.freeze
 			end
 
+			# Returns the time when the kernel was compiled.
+			# The return value is a Time object.
+			# If the information isn't available, it will return nil
+			#
+			# The time will be searched in specific order.
+			# It will match any date matching any of these formats:
+			# 1. %b %d %H:%M:%S %z %Y
+			# 2. %d %b %Y %H:%M:%S %z
+			# 3. %Y-%m-%d
+			# Most kernels have date in them in this format.
+			#
+			# Do note that Ruby sometimes fails to work with timezones like BST for example.
+			# In such case, the timezone is unrealiable and often returns the local timezone.
+			# You have to use regexp yourself to get the proper zone.
+			# Use LinuxStat::Kernel.build_date_string to get the original string if you need that.
+			#
+			# The output is also cached ; as changing the value in runtime is unexpected.
 			def build_date
-				return @@time ||= Time.new(0) if string.empty?
+				return nil if splitted.empty?
 
 				@@time ||= begin
-					require 'time'
+					require 'time' unless Time.respond_to?(:strptime)
 
-					time = splitted.each_slice(8).find do |x|
-						x.each(&:strip!)
-						Time.strptime(x.join(?\s.freeze), '%d %b %Y %H:%M:%S %z'.freeze) rescue nil
-					end
+					splitted.each_cons(5).map do |x|
+						joined = x.each(&:strip!).join(?\s.freeze)
 
-					time ? Time.strptime(time.join(?\s.freeze), "%d %b %Y %H:%M:%S %z") : Time.new(0)
+						# Match 21 Oct 2020 01:11:20 +0000
+						if joined[/^\d{2}\s\w{3}\s\d{4}\s\d{2}:\d{2}:\d{2}\s\+\d*$/]
+							Time.strptime(joined, '%d %b %Y %H:%M:%S %Z') rescue nil
+
+						# Match Aug 25 17:23:54 UTC 2020
+						elsif joined[/^\w{3}\s\d{2}\s\d{2}:\d{2}:\d{2}\s\w+\s\d*$/]
+							Time.strptime(joined, '%b %d %H:%M:%S %z %Y') rescue nil
+
+						# Match 2017-09-19
+						elsif joined[/\d{4}-\d{2}-\d{2}/]
+							Time.strptime(joined[/\d{4}-\d{2}-\d{2}/] + " +00:00", '%Y-%m-%d %z') rescue nil
+
+						else
+							nil
+						end
+					end.tap(&:compact!)[0]
+				end
+			end
+
+			# Returns the time when the kernel was compiled.
+			# The return value is a String.
+			# If the information isn't available, it will return nil
+			#
+			# The time will be searched in specific order.
+			# It will match any date matching any of these formats:
+			# 1. %b %d %H:%M:%S %z %Y
+			# 2. %d %b %Y %H:%M:%S %z
+			# 3. %Y-%m-%d
+			# Most kernels have date in them in this format.
+			#
+			# Do note that Ruby sometimes fails to work with timezones like BST for example.
+			# In such case, the timezone is unrealiable and often returns the local timezone.
+			# You have to use regexp yourself to get the proper zone.
+			# Use LinuxStat::Kernel.build_date_string to get the original string if you need that.
+			#
+			# The output is also cached ; as changing the value in runtime is unexpected.
+			def build_date_string
+				return nil if splitted.empty?
+
+				@@time2 ||= begin
+					require 'time' unless Time.respond_to?(:strptime)
+
+					splitted.each_cons(5).map do |x|
+						joined = x.each(&:strip!).join(?\s.freeze)
+
+						# Match 21 Oct 2020 01:11:20 +0000
+						if (joined[/^\d{2}\s\w{3}\s\d{4}\s\d{2}:\d{2}:\d{2}\s\+\d*$/] && (Time.strptime(joined, '%d %b %Y %H:%M:%S %Z') rescue nil)) ||
+
+						# Match Aug 25 17:23:54 UTC 2020
+						(joined[/^\w{3}\s\d{2}\s\d{2}:\d{2}:\d{2}\s\w+\s\d*$/] && (Time.strptime(joined, '%b %d %H:%M:%S %z %Y') rescue nil)) ||
+
+						# Match 2017-09-19
+						(joined[/\d{4}-\d{2}-\d{2}/] && (Time.strptime(joined[/\d{4}-\d{2}-\d{2}/] + " +00:00", '%Y-%m-%d %z') rescue nil))
+							joined
+						else
+							nil
+						end
+					end.tap(&:compact!)[0]
 				end
 			end
 
+			# Reads maximum 1024 bytes from /proc/version and returns the string.
+			# The output is also cached ; as changing the value in runtime is unexpected.
 			def string
-				# Cached ; as changing the value in runtime is unexpected
-				# Hotfix update can be problem, but it's rare and might not
-				# affect the version string during program runtime.
-				@@string ||= File.readable?('/proc/version') ? IO.read('/proc/version', 1000).tap(&:strip!) : ''
+				@@string ||= File.readable?('/proc/version') ? IO.read('/proc/version', 1024).tap(&:strip!) : ''
 			end
 
 			private

data/lib/linux_stat/memory.rb

@@ -1,6 +1,11 @@
 module LinuxStat
 	module Memory
 		class << self
+			# Returns the memory details reported by /proc/meminfo. In this format:
+			# {:total=>3836264, :used=>3097952, :available=>738312, :percent_used=>80.75, :percent_available=>19.25}
+			#
+			# The value is in Kilobyte.
+			# If the statistics is not available, it will return an empty Hash.
 			def stat
 				return {} unless meminfo?
 
@@ -24,31 +29,44 @@ module LinuxStat
 				}
 			end
 
+			# Returns the total memory details reported by /proc/meminfo.
+			# The value is in Kilobyte.
+			# It retuns an Integer but if the info is not available, it will return nil.
 			def total
-				return 0 unless meminfo?
+				return nil unless meminfo?
 				IO.foreach('/proc/meminfo').first.split[1].to_i
 			end
 
+			# Returns the total memory details reported by /proc/meminfo.
+			# The value is in Kilobyte.
+			# It retuns an Integer but if the info is not available, it will return nil
 			def available
-				return 0 unless meminfo?
+				return nil unless meminfo?
 				IO.foreach('/proc/meminfo').first(3)[-1].split[1].to_i
 			end
 
+			# Returns the amount of memory used reported by /proc/meminfo.
+			# The value is in Kilobyte.
+			# It retuns an Integer but if the info is not available, it will return nil.
 			def used
-				return 0 unless meminfo?
+				return nil unless meminfo?
 				memory = IO.foreach('/proc/meminfo').first(3)
 				memory[0].split[1].to_i - memory[2].split[1].to_i
 			end
 
+			# Returns the percentage of memory used reported by /proc/meminfo.
+			# It retuns an Integer but if the info is not available, it will return nil
 			def percent_used
-				return 0.0 unless meminfo?
+				return nil unless meminfo?
 				memory = IO.foreach('/proc/meminfo').first(3)
 				total = memory[0].split[1].to_i
 				total.-(memory[2].split[1].to_i).*(100).fdiv(total).round(2)
 			end
 
+			# Returns the percentage of memory used reported by /proc/meminfo.
+			# It retuns an Integer but if the info is not available,  it will return nil
 			def percent_available
-				return 0.0 unless meminfo?
+				return nil unless meminfo?
 				memory = IO.foreach('/proc/meminfo').first(3)
 				memory[2].split[1].to_i.*(100).fdiv(memory[0].split[1].to_i).round(2)
 			end

data/lib/linux_stat/net.rb

@@ -1,10 +1,12 @@
 module LinuxStat
 	module Net
 		class << self
+			# Returns the local IP address of the system as a String.
+			# If the information isn't available, it will a frozen empty string.
 			def ipv4_private
 				require 'socket'
 				ip = Socket.ip_address_list.find(&:ipv4_private?)
-				ip ? ip.ip? ? ip.ip_unpack[0].freeze : '' : ''
+				ip ? ip.ip? ? ip.ip_unpack[0].freeze : ''.freeze : ''.freeze
 			end
 		end
 	end

data/lib/linux_stat/os.rb

@@ -1,16 +1,38 @@
 module LinuxStat
 	module OS
 		class << self
+			# Reads /etc/os-release and returns a Hash. For example:
+			# {:NAME=>"Arch Linux", :PRETTY_NAME=>"Arch Linux", :ID=>"arch", :BUILD_ID=>"rolling", :ANSI_COLOR=>"38;2;23;147;209", :HOME_URL=>"https://www.archlinux.org/", :DOCUMENTATION_URL=>"https://wiki.archlinux.org/", :SUPPORT_URL=>"https://bbs.archlinux.org/", :BUG_REPORT_URL=>"https://bugs.archlinux.org/", :LOGO=>"archlinux"}
+			#
+			# If the info isn't available, it will return an empty Hash.
+			#
+			# The amount of data read is 4096 bytes. Any more than that will result in truncated output.
+			#
+			# The information is also cached, and once loaded, won't change in runtime. Because changing the /etc/lsb-release
+			# isn't expected in runtime.
 			def os_release
 				# Cached ; as changing the value in runtime is unexpected
 				@@os_release ||= File.readable?('/etc/os-release') ? release('/etc/os-release') : {}
 			end
 
+			# Reads /etc/lsb-release and returns a Hash. For example:
+			# {:LSB_VERSION=>"1.4", :DISTRIB_ID=>"Arch", :DISTRIB_RELEASE=>"rolling", :DISTRIB_DESCRIPTION=>"Arch Linux"}
+			#
+			# If the info isn't available, it will return an empty Hash.
+			#
+			# The amount of data read is 4096 bytes. Any more than that will result in truncated output.
+			#
+			# The information is also cached, and once loaded, won't change in runtime. Because changing the /etc/lsb-release
+			# isn't expected in runtime.
 			def lsb_release
 				# Cached ; as changing the value in runtime is unexpected
 				@@lsb_release ||= File.readable?('/etc/lsb-release') ? release('/etc/lsb-release') : {}
 			end
 
+			# Reads /etc/lsb-release or /etc/os-release tries to get information about the distribution.
+			# If the information isn't available, it will read and return /etc/issue.
+			# The return type is String.
+			# If none of the info is available, it will return an empty frozen String.
 			def distribution
 				@@distribution ||= if os_release.key?(:NAME)
 					os_release[:NAME]
@@ -29,6 +51,9 @@ module LinuxStat
 				end
 			end
 
+			# Reads /etc/hostname and returns the hostname.
+			# The return type is String.
+			# If the info info isn't available, it will return 'localhost'.
 			def hostname
 				@@hostname ||= if File.exist?('/etc/hostname')
 					IO.read('/etc/hostname').strip
@@ -37,6 +62,8 @@ module LinuxStat
 				end
 			end
 
+			# Reads ruby configuration and tries to guess if the system is 32 bit or 64 bit.
+			# The return type is Integer.
 			def bits
 				@@bits ||= if RbConfig::CONFIG['host_cpu'].end_with?('64') || RUBY_PLATFORM[/x86_64/]
 					64
@@ -45,8 +72,12 @@ module LinuxStat
 				end
 			end
 
+			# Reads /proc/uptime and returns the system uptime:
+			# {:hour=>10, :minute=>34, :second=>12.59}
+			#
+			# If the stat isn't available, an empty hash is returned.
 			def uptime
-				raise StatUnavailable, 'Cannot read /proc/uptime' unless uptime_readable?
+				return {} unless uptime_readable?
 
 				uptime = IO.read('/proc/uptime').to_f
 				uptime_i = uptime.to_i
@@ -64,7 +95,7 @@ module LinuxStat
 
 			private
 			def release(file)
-				IO.readlines(file, 3000).reduce({}) { |h, x|
+				IO.readlines(file, 4096).reduce({}) { |h, x|
 					x.strip!
 					next h if x.empty?
 

data/lib/linux_stat/process.rb

@@ -1,6 +1,8 @@
 module LinuxStat
 	module Process
 		class << self
+			# Returns the list of processes from /proc/.
+			# The return type is an Array of Integers.
 			def list
 				Dir['/proc/*'].select! { |x|
 					pid = File.split(x)[1]
@@ -8,10 +10,13 @@ module LinuxStat
 				}.map! { |x| File.split(x)[-1].to_i }
 			end
 
+			# Counts and returns the total number of process running on the system.
+			# The return type is Integer.
 			def count
 				list.count
 			end
 
+			# Returns all the id of processes mapped with their names as a Hash.
 			def names
 				list.reduce({}) { |h, x|
 					begin
@@ -22,6 +27,7 @@ module LinuxStat
 				}
 			end
 
+			# Returns all the id of processes mapped with their status as a Hash.
 			def types
 				list.reduce({}) { |h, x|
 					begin
@@ -40,6 +46,8 @@ module LinuxStat
 				}
 			end
 
+			# Returns all the id of processes that are sleeping.
+			# The return type is an Array of Integers.
 			def sleeping
 				list.select { |x|
 					begin
@@ -50,6 +58,8 @@ module LinuxStat
 				}
 			end
 
+			# Returns all the id of processes that are idle.
+			# The return type is an Array of Integers.
 			def idle
 				list.select { |x|
 					begin
@@ -60,6 +70,8 @@ module LinuxStat
 				}
 			end
 
+			# Returns all the id of processes that are zombies.
+			# The return type is an Array of Integers.
 			def zombie
 				list.select { |x|
 					begin
@@ -70,6 +82,8 @@ module LinuxStat
 				}
 			end
 
+			# Returns all the id of processes that are running.
+			# The return type is an Array of Integers.
 			def running
 				list.select { |x|
 					begin

data/lib/linux_stat/swap.rb

@@ -1,8 +1,11 @@
 module LinuxStat
 	module Swap
 		class << self
-			# List all swap devices
+			# List all swap devices and returns a Hash.
+			# If the info isn't available, it will return an empty Hash.
 			def list
+				return {} unless swaps_readable?
+
 				file = IO.readlines('/proc/swaps').drop(1)
 				file.reduce({}) do |h, x|
 					name, *stats = x.strip.split
@@ -10,8 +13,18 @@ module LinuxStat
 				end
 			end
 
-			# Show aggregated used and available swap
+			# Returns true if any swap device is available, else returns false.
+			# If the info isn't available, it will return an empty Hash.
+			def any?
+				!!IO.foreach('/proc/swaps').drop(1).first
+			end
+
+			# Show aggregated used and available swap.
+			# The values are in kilobytes.
+			# The return type is Hash.
+			# If the info isn't available, the return type is an empty Hash.
 			def stat
+				return {} unless swaps_readable?
 				values_t = read_usage
 
 				total, used = values_t[0].sum, values_t[-1].sum
@@ -29,20 +42,35 @@ module LinuxStat
 				}
 			end
 
+			# Show total amount of swap.
+			# The value is in kilobytes.
+			# The return type is a Integer but if the info isn't available, it will return nil.
 			def total
+				return nil unless swaps_readable?
 				read_usage[0].sum
 			end
 
+			# Show total amount of available swap.
+			# The value is in kilobytes.
+			# The return type is a Integer but if the info isn't available, it will return nil.
 			def available
+				return nil unless swaps_readable?
 				values_t = read_usage
 				values_t[0].sum - values_t[1].sum
 			end
 
+			# Show total amount of used swap.
+			# The value is in kilobytes.
+			# The return type is a Integer but if the info isn't available, it will return nil.
 			def used
+				return nil unless swaps_readable?
 				read_usage[-1].sum
 			end
 
+			# Show percentage of swap used.
+			# The return type is a Float but if the info isn't available, it will return nil.
 			def percent_used
+				return nil unless swaps_readable?
 				values_t = read_usage
 
 				total = values_t[0].sum
@@ -51,21 +79,26 @@ module LinuxStat
 				values_t[-1].sum.*(100).fdiv(total).round(2)
 			end
 
+			# Show percentage of swap available.
+			# The return type is a Float but if the info isn't available, it will return nil.
 			def percent_available
+				return nil unless swaps_readable?
 				values_t = read_usage
 
 				total = values_t[0].sum
 				return 0.0 if total == 0
 
 				total.-(values_t[-1].sum).*(100).fdiv(total).round(2)
-
 			end
 
 			private
 			def read_usage
 				return [[], []] unless swaps_readable?
 
-				IO.readlines('/proc/swaps').drop(1).map { |x|
+				val = IO.readlines('/proc/swaps').drop(1)
+				return [[], []] if val.empty?
+
+				val.map { |x|
 					x.strip.split.values_at(2, 3).map!(&:to_i)
 				}.transpose
 			end

data/lib/linux_stat/version.rb

@@ -1,3 +1,3 @@
 module LinuxStat
-	VERSION = "0.1.6"
+	VERSION = "0.2.0"
 end

metadata

@@ -1,32 +1,27 @@
 --- !ruby/object:Gem::Specification
 name: linux_stat
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.2.0
 platform: ruby
 authors:
 - Sourav Goswami
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-11-23 00:00:00.000000000 Z
+date: 2020-11-25 00:00:00.000000000 Z
 dependencies: []
 description: Efficient linux system reporting gem. Linux Only | Efficient | Reliable
 email:
 - souravgoswami@protonmail.com
 executables: []
 extensions: []
-extra_rdoc_files: []
+extra_rdoc_files:
+- README.md
 files:
-- ".gitignore"
-- ".rspec"
-- ".travis.yml"
-- CODE_OF_CONDUCT.md
 - Gemfile
-- Gemfile.lock
-- LICENSE.txt
 - README.md
-- Rakefile
 - bin/console
+- bin/linuxstat.rb
 - bin/setup
 - lib/linux_stat.rb
 - lib/linux_stat/battery.rb
@@ -39,8 +34,6 @@ files:
 - lib/linux_stat/process.rb
 - lib/linux_stat/swap.rb
 - lib/linux_stat/version.rb
-- linux_stat.gemspec
-- run_all_methods.rb
 homepage: https://github.com/Souravgoswami/linux_stat/
 licenses:
 - MIT

data/.gitignore

@@ -1,11 +0,0 @@
-/.bundle/
-/.yardoc
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-
-# rspec failure tracking
-.rspec_status

data/.rspec

@@ -1,3 +0,0 @@
---format documentation
---color
---require spec_helper

data/.travis.yml

@@ -1,6 +0,0 @@
----
-language: ruby
-cache: bundler
-rvm:
-  - 2.7.1
-before_install: gem install bundler -v 2.1.4

data/CODE_OF_CONDUCT.md

@@ -1,74 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-In the interest of fostering an open and welcoming environment, we as
-contributors and maintainers pledge to making participation in our project and
-our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnicity, gender identity and expression, level of experience,
-nationality, personal appearance, race, religion, or sexual identity and
-orientation.
-
-## Our Standards
-
-Examples of behavior that contributes to creating a positive environment
-include:
-
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
-
-Examples of unacceptable behavior by participants include:
-
-* The use of sexualized language or imagery and unwelcome sexual attention or
-advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic
-  address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Our Responsibilities
-
-Project maintainers are responsible for clarifying the standards of acceptable
-behavior and are expected to take appropriate and fair corrective action in
-response to any instances of unacceptable behavior.
-
-Project maintainers have the right and responsibility to remove, edit, or
-reject comments, commits, code, wiki edits, issues, and other contributions
-that are not aligned to this Code of Conduct, or to ban temporarily or
-permanently any contributor for other behaviors that they deem inappropriate,
-threatening, offensive, or harmful.
-
-## Scope
-
-This Code of Conduct applies both within project spaces and in public spaces
-when an individual is representing the project or its community. Examples of
-representing a project or community include using an official project e-mail
-address, posting via an official social media account, or acting as an appointed
-representative at an online or offline event. Representation of a project may be
-further defined and clarified by project maintainers.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at souravgoswami@protonmail.com. All
-complaints will be reviewed and investigated and will result in a response that
-is deemed necessary and appropriate to the circumstances. The project team is
-obligated to maintain confidentiality with regard to the reporter of an incident.
-Further details of specific enforcement policies may be posted separately.
-
-Project maintainers who do not follow or enforce the Code of Conduct in good
-faith may face temporary or permanent repercussions as determined by other
-members of the project's leadership.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
-available at [https://contributor-covenant.org/version/1/4][version]
-
-[homepage]: https://contributor-covenant.org
-[version]: https://contributor-covenant.org/version/1/4/

data/Gemfile.lock

@@ -1,34 +0,0 @@
-PATH
-  remote: .
-  specs:
-    linux_stat (0.1.4)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    diff-lcs (1.4.4)
-    rake (12.3.3)
-    rspec (3.10.0)
-      rspec-core (~> 3.10.0)
-      rspec-expectations (~> 3.10.0)
-      rspec-mocks (~> 3.10.0)
-    rspec-core (3.10.0)
-      rspec-support (~> 3.10.0)
-    rspec-expectations (3.10.0)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.10.0)
-    rspec-mocks (3.10.0)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.10.0)
-    rspec-support (3.10.0)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  linux_stat!
-  rake (~> 12.0)
-  rspec (~> 3.0)
-
-BUNDLED WITH
-   2.1.4

data/LICENSE.txt

@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2020 Sourav Goswami
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.

data/Rakefile

@@ -1,6 +0,0 @@
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-
-RSpec::Core::RakeTask.new(:spec)
-
-task :default => :spec

data/linux_stat.gemspec

@@ -1,28 +0,0 @@
-require_relative 'lib/linux_stat/version'
-
-Gem::Specification.new do |spec|
-  spec.name          = "linux_stat"
-  spec.version       = LinuxStat::VERSION
-  spec.authors       = ["Sourav Goswami"]
-  spec.email         = ["souravgoswami@protonmail.com"]
-
-  spec.summary       = %q{Efficient linux system reporting gem}
-  spec.description   = %q{Efficient linux system reporting gem. Linux Only | Efficient | Reliable}
-  spec.homepage      = "https://github.com/Souravgoswami/linux_stat/"
-  spec.license       = "MIT"
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.5.0")
-
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/Souravgoswami/linux_stat"
-  spec.metadata["changelog_uri"] = "https://github.com/Souravgoswami/linux_stat/commits/master"
-
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
-    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features|logo)/}) }
-  end
-
-  spec.bindir        = "exe"
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-end