linux_stat 0.3.0 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3e2c68de7353a60dbdff528a65e721cc0f7632e95c5d8db2e0e1dc1b7242deb1
-  data.tar.gz: ada661cb896983bddf8f831b55822bfb006f6167c1ea2bbbd2319bf38028bd79
+  metadata.gz: 62a54b165b53e0fe6fddad20ab6b39b8a0d57e1a02186f995fcf0341cc69aae0
+  data.tar.gz: 8bc58cc3c8b72e117892cd8f987c924337d2ab10995d14b3fb7735064e4b3685
 SHA512:
-  metadata.gz: 1399f3b227442243558ae76d4cdbc4679f21984b8d7e2aacd7ed25c471d5588e9901877c943d4a2220583f3eb4094b00e81016e6e573ef1038052574e8306fd0
-  data.tar.gz: 79c25491f4517ef2370b375d19177ca01b6589c6e0931e40dc0aa7c92269b605c97cab4cfe42cde51895ebe9b21d418fd301daf44dfdc496ff0b8bd24788dac6
+  metadata.gz: a5490c31315132793840e3e849996f0545b08b3b416eadef3ba6979dcbad89d31329b69dad403295f8cc7e17a677f6d8df032c42706162b251b6ed921a3d11e4
+  data.tar.gz: 0100faa162b904042e8143b8dec85b45a3cb82543c693514049df17834890b12034cb1561d8c69ba606e9ebc81fba1550b255ad6d17d70a552011eb9aaf5300f

data/README.md

@@ -1,12 +1,14 @@
 # LinuxStat
-![logo](https://raw.githubusercontent.com/Souravgoswami/linux_stat/master/logo/logo.jpg)
+![logo](https://raw.githubusercontent.com/Souravgoswami/linux_stat/master/images/logo.jpg)
 
-For reading the HTML version, visit [linux_stat](https://souravgoswami.github.io/linux_stat/).
+For reading the eyecandy HTML version, visit [linux_stat](https://souravgoswami.github.io/linux_stat/).
 
 LinuxStat lets you read status 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.
 
 It only works for Linux, and detecting the OS is upto the user of this gem.
 
+---
+
 ## Dependencies:
 + You need to have the C compile to be able to compile the C extension.
 On Arch Linux:
@@ -26,6 +28,8 @@ On Debian based systems:
 
 + Once your are done, and you can compile the C file, you can follow the installation!
 
+---
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -44,7 +48,6 @@ Or install it yourself as:
 
 ## Usage
 ### LinuxStat::BIOS
-### LinuxStat::BIOS
 ```
 LinuxStat::BIOS.date
 => "04/10/2017"
@@ -100,7 +103,7 @@ LinuxStat::CPU.count
 => 4
 
 LinuxStat::CPU.cur_freq
-=> [1998722, 1998401, 1974377, 1875264]
+=> [1999998, 2000003, 2000015, 2000009]
 
 LinuxStat::CPU.max_freq
 => [2000000, 2000000, 2000000, 2000000]
@@ -109,38 +112,38 @@ LinuxStat::CPU.model
 => "Intel(R) Core(TM) i3-6006U CPU @ 2.00GHz"
 
 LinuxStat::CPU.stat
-=> {0=>6.45, 1=>0.0, 2=>0.0, 3=>12.5, 4=>0.0}
+=> {0=>14.29, 1=>25.0, 2=>0.0, 3=>25.0, 4=>14.29}
 
 LinuxStat::CPU.total_usage
-=> 3.45
+=> 18.75
 
 LinuxStat::CPU.usage
-=> 6.45
+=> 14.29
 
 LinuxStat::CPU.usages
-=> {0=>9.68, 1=>11.11, 2=>12.5, 3=>14.29, 4=>12.5}
+=> {0=>16.67, 1=>14.29, 2=>28.57, 3=>0.0, 4=>25.0}
 
 ```
 
 ### LinuxStat::Filesystem
 ```
 LinuxStat::Filesystem.available
-=> 43155402752
+=> 42144575488
 
 LinuxStat::Filesystem.free
-=> 43155402752
+=> 42144575488
 
 LinuxStat::Filesystem.stat
-=> {:total=>119981191168, :free=>43155402752, :used=>76825788416}
+=> {:total=>119981191168, :free=>42144575488, :used=>77836615680}
 
 LinuxStat::Filesystem.stat_raw
-=> {:block_size=>4096, :fragment_size=>4096, :blocks=>29292283, :block_free=>10535987, :block_avail_unpriv=>10535987, :inodes=>58612160, :free_inodes=>56718515, :filesystem_id=>2050, :mount_flags=>1024, :max_filename_length=>255}
+=> {:block_size=>4096, :fragment_size=>4096, :blocks=>29292283, :block_free=>10289203, :block_avail_unpriv=>10289203, :inodes=>58612160, :free_inodes=>56716465, :filesystem_id=>2050, :mount_flags=>1024, :max_filename_length=>255}
 
 LinuxStat::Filesystem.total
 => 119981191168
 
 LinuxStat::Filesystem.used
-=> 76825788416
+=> 77836615680
 
 ```
 
@@ -155,15 +158,24 @@ LinuxStat::Kernel.build_date_string
 LinuxStat::Kernel.build_user
 => "souravgoswami@archlinux"
 
+LinuxStat::Kernel.clk_tck
+=> 100
+
 LinuxStat::Kernel.compiler
 => [:gcc, "10.2.0"]
 
 LinuxStat::Kernel.compiler_version
 => "10.2.0"
 
+LinuxStat::Kernel.release
+=> "5.9.1-xanmod1-1"
+
 LinuxStat::Kernel.string
 => "Linux version 5.9.1-xanmod1-1 (souravgoswami@archlinux) (gcc (GCC) 10.2.0, GNU ld (GNU Binutils) 2.35.1) #1 SMP PREEMPT Wed, 21 Oct 2020 01:11:20 +0000"
 
+LinuxStat::Kernel.ticks
+=> 100
+
 LinuxStat::Kernel.version
 => "5.9.1-xanmod1-1"
 
@@ -172,29 +184,29 @@ LinuxStat::Kernel.version
 ### LinuxStat::Memory
 ```
 LinuxStat::Memory.available
-=> 403724
+=> 606548
 
 LinuxStat::Memory.percent_available
-=> 10.52
+=> 15.81
 
 LinuxStat::Memory.percent_used
-=> 89.48
+=> 84.19
 
 LinuxStat::Memory.stat
-=> {:total=>3836264, :used=>3432540, :available=>403724, :percent_used=>89.48, :percent_available=>10.52}
+=> {:total=>3836256, :used=>3229708, :available=>606548, :percent_used=>84.19, :percent_available=>15.81}
 
 LinuxStat::Memory.total
-=> 3836264
+=> 3836256
 
 LinuxStat::Memory.used
-=> 3432540
+=> 3229708
 
 ```
 
 ### LinuxStat::Mounts
 ```
 LinuxStat::Mounts.list
-=> ["proc /proc proc rw,nosuid,nodev,noexec,relatime 0 0", "sys /sys sysfs rw,nosuid,nodev,noexec,relatime 0 0", "dev /dev devtmpfs rw,nosuid,relatime,size=1891796k,nr_inodes=472949,mode=755 0 0", "run /run tmpfs rw,nosuid,nodev,relatime,mode=755 0 0", "...
+=> ["proc /proc proc rw,nosuid,nodev,noexec,relatime 0 0", "sys /sys sysfs rw,nosuid,nodev,noexec,relatime 0 0", "dev /dev devtmpfs rw,nosuid,relatime,size=1891804k,nr_inodes=472951,mode=755 0 0", "run /run tmpfs rw,nosuid,nodev,relatime,mode=755 0 0", "...
 
 LinuxStat::Mounts.root
 => "/dev/sda2"
@@ -206,14 +218,14 @@ LinuxStat::Mounts.root_mount_options
 => "rw,noatime,attr2,inode64,logbufs=8,logbsize=32k,noquota"
 
 LinuxStat::Mounts.tmpfs
-=> {"/dev/shm"=>"tmpfs /dev/shm tmpfs rw,nosuid,nodev 0 0", "/sys/fs/cgroup"=>"tmpfs /sys/fs/cgroup tmpfs ro,nosuid,nodev,noexec,size=4096k,nr_inodes=1024,mode=755 0 0", "/ramdisk"=>"tmpfs /ramdisk tmpfs rw,nosuid,nodev,relatime,size=6291456k 0 0", "/tmp...
+=> {"/dev/shm"=>"tmpfs /dev/shm tmpfs rw,nosuid,nodev 0 0", "/sys/fs/cgroup"=>"tmpfs /sys/fs/cgroup tmpfs ro,nosuid,nodev,noexec,size=4096k,nr_inodes=1024,mode=755 0 0", "/cache"=>"tmpfs /cache tmpfs rw,nosuid,nodev,relatime,size=2097152k 0 0", "/ramdisk...
 
 ```
 
 ### LinuxStat::Net
 ```
 LinuxStat::Net.ipv4_private
-=> "192.168.0.106"
+=> "192.168.0.101"
 
 ```
 
@@ -231,33 +243,39 @@ LinuxStat::OS.hostname
 LinuxStat::OS.lsb_release
 => {:LSB_VERSION=>"1.4", :DISTRIB_ID=>"Arch", :DISTRIB_RELEASE=>"rolling", :DISTRIB_DESCRIPTION=>"Arch Linux"}
 
+LinuxStat::OS.machine
+=> "x86_64"
+
+LinuxStat::OS.nodename
+=> "archlinux"
+
 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=>10, :minute=>54, :second=>22.45}
+=> {:hour=>9, :minute=>10, :second=>19.41}
 
 ```
 
 ### LinuxStat::Process
 ```
 LinuxStat::Process.count
-=> 210
+=> 221
 
 LinuxStat::Process.idle
-=> [3, 4, 6, 9, 12, 23, 30, 37, 39, 49, 102, 103, 104, 106, 107, 108, 109, 110, 117, 118, 119, 122, 131, 134, 140, 152, 153, 179, 181, 183, 184, 191, 192, 193, 194, 195, 196, 198, 236, 286, 314, 324, 346, 385, 3540, 3541, 3542, 3543, 3544, 3545, 30463, 3...
+=> [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, 168, 170, 173, 174, 182, 183, 184, 185, 186, 187, 214, 224, 268, 308, 313, 314, 330, 2357, 2358, 2359, 2360, 2361, 2362, 25094, 2...
 
 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, 112, 114, 115, 117, 118, 119, 122, 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, 112, 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-events_highpri", 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...
+=> {1=>"systemd", 2=>"kthreadd", 3=>"rcu_gp", 4=>"rcu_par_gp", 6=>"kworker/0:0H-kblockd", 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...
 
 LinuxStat::Process.running
-=> [33736]
+=> [30804]
 
 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, 112, 114, 115, 178, 180, 197, 225, 239, 309, 317, 329, 332, 333, 334, 338, 367, 368, 369, 370, 378, 381, 383, 384, 402,...
+=> [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, 112, 114, 115, 167, 169, 188, 215, 228, 307, 309, 311, 316, 317, 319, 320, 354, 355, 356, 357, 364, 368, 370, 384, 397,...
 
 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...
@@ -267,34 +285,236 @@ LinuxStat::Process.zombie
 
 ```
 
+### LinuxStat::ProcessInfo
+```
+LinuxStat::ProcessInfo.cmdline
+=> "ruby bin/linuxstat.rb -md"
+
+LinuxStat::ProcessInfo.command_name
+=> "ruby"
+
+LinuxStat::ProcessInfo.cpu_stat
+=> {:cpu_usage=>0.0, :threads=>1, :last_executed_cpu=>2}
+
+LinuxStat::ProcessInfo.cpu_usage
+=> 0.0
+
+LinuxStat::ProcessInfo.last_executed_cpu
+=> 2
+
+LinuxStat::ProcessInfo.mem_stat
+=> {:memory=>9644, :virtual_memory=>79568, :resident_memory=>15764}
+
+LinuxStat::ProcessInfo.memory
+=> 9644
+
+LinuxStat::ProcessInfo.resident_memory
+=> 15764
+
+LinuxStat::ProcessInfo.threads
+=> 1
+
+LinuxStat::ProcessInfo.total_io
+=> {:read_bytes=>0, :write_bytes=>0}
+
+LinuxStat::ProcessInfo.virtual_memory
+=> 79568
+
+```
+
 ### LinuxStat::Swap
 ```
 LinuxStat::Swap.any?
 => true
 
 LinuxStat::Swap.available
-=> 1913936
+=> 2256212
 
 LinuxStat::Swap.list
-=> {"/dev/zram0"=>[:partition, 4194300, 2280364, -2]}
+=> {"/dev/zram0"=>[:partition, 4194300, 1938088, -2]}
 
 LinuxStat::Swap.percent_available
-=> 45.63
+=> 53.79
 
 LinuxStat::Swap.percent_used
-=> 54.37
+=> 46.21
 
 LinuxStat::Swap.stat
-=> {:total=>4194300, :used=>2280364, :available=>1913936, :percent_used=>54.37, :percent_available=>45.63}
+=> {:total=>4194300, :used=>1938088, :available=>2256212, :percent_used=>46.21, :percent_available=>53.79}
 
 LinuxStat::Swap.total
 => 4194300
 
 LinuxStat::Swap.used
-=> 2280364
+=> 1938088
+
+```
+
+### LinuxStat::Sysconf
+```
+LinuxStat::Sysconf.child_max
+=> 2000000
+
+LinuxStat::Sysconf.hostname_max
+=> 64
+
+LinuxStat::Sysconf.login_name_max
+=> 256
+
+LinuxStat::Sysconf.open_max
+=> 8192
+
+LinuxStat::Sysconf.page_size_max
+=> 4096
+
+LinuxStat::Sysconf.posix_version
+=> 200809
+
+LinuxStat::Sysconf.sc_clk_tck
+=> 100
+
+LinuxStat::Sysconf.stream_max
+=> 16
+
+LinuxStat::Sysconf.tty_name_max
+=> 32
+
+```
+
+### LinuxStat::Uname
+```
+LinuxStat::Uname.machine
+=> "x86_64"
+
+LinuxStat::Uname.nodename
+=> "archlinux"
+
+LinuxStat::Uname.release
+=> "5.9.1-xanmod1-1"
+
+LinuxStat::Uname.sysname
+=> "Linux"
+
+LinuxStat::Uname.version
+=> "#1 SMP PREEMPT Wed, 21 Oct 2020 01:11:20 +0000"
+
+```
+---
+
+## Note 1: Filesystem
+
+Filesystem can take arguments. By default it's '/' or the root of the system...
+
+But for the sake of example, to get the free disk space of /, you do:
+
+```
+$ irb
+irb(main):001:0> require 'linux_stat'
+=> true
 
+irb(main):002:0> LinuxStat::Filesystem.free('/').fdiv(1024 ** 3).to_s << " GiB"
+=> "35.666873931884766 GiB"
 ```
 
+To see the free and total space of a thumbdrive:
+
+```
+$ irb
+irb(main):001:0> require 'linux_stat'
+=> true
+
+irb(main):002:0> LinuxStat::Mounts.list.find { |x| x.include?('/run/media/sourav') }.split[1]
+=> "/run/media/sourav/5c2b7af7-d4c3-4ab4-a035-06d18ffc8e6f"
+
+irb(main):003:0> thumbdrive = _
+=> "/run/media/sourav/5c2b7af7-d4c3-4ab4-a035-06d18ffc8e6f"
+
+irb(main):004:0> LinuxStat::Filesystem.free(thumbdrive).fdiv(1024 ** 3).to_s << " GiB"
+=> "2.504791259765625 GiB"
+
+irb(main):005:0> LinuxStat::Filesystem.total(thumbdrive).fdiv(1024 ** 3).to_s << " GiB"
+=> "29.305004119873047 GiB"
+```
+
+## Note 2: ProcessInfo
+
+All the methods LinuxStat::ProcessInfo can take an argument containing the Process ID of a process.
+By default it's $$ or the PID of the current process, ruby, itself.
+
+Example:
+Say you want to see how much CPU Firefox is consuming, for that you have to do the following (firefox can create a lot of child process though):
+
+1. Get the PID of Firefox:
+```
+LinuxStat::Process.names.find { |x| x[1].include? 'firefox' }[0]
+=> 770 # but this differs all the time
+```
+
+2. Get the CPU usage:
+```
+$ irb
+irb(main):001:0> require 'linux_stat'
+=> true
+
+irb(main):002:0> pid = LinuxStat::Process.names.find { |x| x[1].include? 'firefox' }[0]
+=> 770
+
+irb(main):003:0> LinuxStat::ProcessInfo.cpu_usage(pid: pid)
+=> 0.0
+
+irb(main):004:0> LinuxStat::ProcessInfo.cpu_usage(pid: pid)
+=> 15.0
+```
+
+To get the memory usage of Firefox (for example):
+
+```
+$ irb
+irb(main):001:0> require 'linux_stat'
+=> true
+
+irb(main):002:0> LinuxStat::ProcessInfo.mem_stat(LinuxStat::Process.names.find { |x| x[1].include? 'firefox'.freeze }[0])
+=> {:memory=>468472, :virtual_memory=>4754080, :resident_memory=>814388}
+```
+
+To get ONLY the memory usage in MiB:
+
+```
+$ irb
+irb(main):001:0> require 'linux_stat'
+=> true
+
+irb(main):002:0> LinuxStat::ProcessInfo.memory(LinuxStat::Process.names.find { |x| x[1].include? 'firefox'.freeze }[0]).fdiv(1024).round(2).to_s << " MiB"
+=> "467.51 MiB"
+```
+
+## Note 3: FS
+
+LinuxStat::FS module gives you the raw info in Hash collected from statvfs.
+
+It's not documented above because it's not suggested to run this directly. But it shouldn't cause any issue. `LinuxStat::Filesystem.stat_raw(fs = '/')` does that automatically.
+
+It always requires an argument, and it's very fast. It directly calls the C API without any intermediate Ruby code.
+
+For example, to get the info about '/' or root:
+
+```
+$ irb
+irb(main):001:0> require 'linux_stat'
+=> true
+
+irb(main):002:0> LinuxStat::FS.stat('/')
+=> {:block_size=>4096, :fragment_size=>4096, :blocks=>29292283, :block_free=>9349843, :block_avail_unpriv=>9349843, :inodes=>58612160, :free_inodes=>56708247, :filesystem_id=>2050, :mount_flags=>1024, :max_filename_length=>255}
+
+irb(main):003:0> t = Time.now ; puts LinuxStat::FS.stat('/') ; Time.now - t
+{:block_size=>4096, :fragment_size=>4096, :blocks=>29292283, :block_free=>9349843, :block_avail_unpriv=>9349843, :inodes=>58612160, :free_inodes=>56708247, :filesystem_id=>2050, :mount_flags=>1024, :max_filename_length=>255}
+=> 5.0468e-05
+```
+
+To learn more about them, just run ri and the method name. To see all available methods:
+
+---
+
 ## Return Types
 + In general, if a method returns either a Float or a Integer or a Time, it will return a Float or Integer or Time in all cases. But if the status isn't available, it will return nil.
 
@@ -308,23 +528,34 @@ LinuxStat::Swap.used
 
 If some error is *raised* it should be reported as a bug.
 
+---
+
 ## Ruby on Rails
 
 1. Just add `gem linux_stat`:
 
 ```
-bundle add linux_stat
+$ bundle add linux_stat
 ```
 
 You can use LinuxStat directly in rails.
 
-![RailsApp](https://raw.githubusercontent.com/Souravgoswami/linux_stat/master/logo/rails.gif)
+![RailsApp](https://raw.githubusercontent.com/Souravgoswami/linux_stat/master/images/rails.gif)
+
+---
 
-Don't need to worry about versions if you are using anything > 0.2.1.
+## Android
 
-Newer versions will have bug fixes, performance improvements and new features but the return types of old methods will always be the same across upgrades > 0.2.1.
+LinuxStat does support Android OS. But it's not rigorously tested on all device like android apps.
 
-Even if we remove something, there will be always a deprecation warning for some months or for even a year before we actually remove it.
+But in Termux you can just run LinuxStat without facing issues.
+Note that the CPU count can differ due to hotplugging feature. So if you see the CPU count changes, there's not really nothing to do about that.
+
+![termux](https://raw.githubusercontent.com/Souravgoswami/linux_stat/master/images/termux.webp)
+
+Issues regarding running LinuxStat on termux are also welcomed.
+
+---
 
 ## Development
 
@@ -332,6 +563,8 @@ After checking out the repo, run `bin/setup` to install dependencies. You can al
 
 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:
@@ -353,10 +586,14 @@ $ ruby bin/linuxstat.rb upc
 ```
 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/Souravgoswami/linux_stat.
 
+---
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).