getargv 0.2.0-universal-darwin → 0.3.2-universal-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa9f9e33b353a325306f9a0e9043e2a5ef348009400f35a7fdef753c5def98f2
-  data.tar.gz: d9bbd3910bc582adbc2e51d0b0f69e3af4455ae40608ca5f8ba42f277544cc29
+  metadata.gz: 3e96a8e966aba77c4866aa2b4b5bfb2510649104e2d1f420177756a03537f114
+  data.tar.gz: 2439eb33bc7b2a88151452ba304a1e5e60dec8759bb44bdbdf5b6276e0509094
 SHA512:
-  metadata.gz: e1725bda93c4a1164efaae25abb777ebb280516199e5a818a3b09aed577b839e325c1db482be76e56b5fc5b860f04bab28faf0b1970e5a85ea3d174931044a81
-  data.tar.gz: 9cd95a25e29d1a05b7ef5affdf5c430a1aeb195a7521e8bcea7793007bf5a92305f3a8ee93bc08513299df97cccb3ccd1b0c9da08d72cae20382a2012ce167a0
+  metadata.gz: '08b15f84a44de63fa95d6f7bf4ba1ae30f31088ea125461e850e018502f444a6b6cba5fbd4752ad2314c6c45c366b83217900e0aa6ad90ca292bd0c2d54c3f57'
+  data.tar.gz: 5e244ee6ba33536dff1ac56730aa324e31a735e9ba7e06700a8b459350847a6310c428414cf0d0b0e54035517bea986bfd03b2d2c0fef555b4282d31bd4b1f28

data/CHANGELOG.md

@@ -1,4 +1,14 @@
-## [Unreleased]
+## [0.3.1] - Unreleased
+
+- Fix type signatures that changed in 0.3.0.
+
+## [0.3.0] - 2023-03-08
+
+- Add RBS type signatures.
+- Use libgetargv-provided free_* functions to protect against alternate compilers.
+- Require user to pass in encoding for string-producing functions.
+
+## [0.2.0] - 2023-01-05
 
 - Adjust platform in gemspec to allow any darwin plaftorm
 

data/Gemfile

@@ -4,16 +4,3 @@ source "https://rubygems.org"
 
 # Specify your gem's dependencies in getargv_ruby.gemspec
 gemspec
-
-gem "rake", "~> 13.0"
-
-gem "rake-compiler"
-
-gem "minitest", "~> 5.0"
-
-gem "standard", "~> 1.3"
-
-group :development do
-  gem "solargraph"
-  gem "sdoc"
-end

data/Gemfile.lock

@@ -1,107 +1,123 @@
 PATH
   remote: .
   specs:
-    getargv (0.2.0-universal-darwin)
+    getargv (0.3.2-universal-darwin)
 
 GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.2)
     backport (1.2.0)
-    benchmark (0.2.1)
+    benchmark (0.3.0)
+    bump (0.10.0)
     diff-lcs (1.5.0)
     e2mmap (0.1.0)
-    jaro_winkler (1.5.4)
-    json (2.6.3)
+    jaro_winkler (1.5.6)
+    json (2.7.1)
     kramdown (2.4.0)
       rexml
     kramdown-parser-gfm (1.1.0)
       kramdown (~> 2.0)
-    language_server-protocol (3.17.0.2)
-    minitest (5.17.0)
-    nokogiri (1.13.10-arm64-darwin)
+    language_server-protocol (3.17.0.3)
+    lint_roller (1.1.0)
+    minitest (5.20.0)
+    nokogiri (1.16.0-arm64-darwin)
       racc (~> 1.4)
-    nokogiri (1.13.10-x86_64-darwin)
+    nokogiri (1.16.0-x86_64-darwin)
       racc (~> 1.4)
-    parallel (1.22.1)
-    parser (3.2.0.0)
+    parallel (1.24.0)
+    parser (3.2.2.4)
       ast (~> 2.4.1)
-    psych (5.0.1)
+      racc
+    psych (5.1.2)
       stringio
-    racc (1.6.2)
+    racc (1.7.3)
     rainbow (3.1.1)
-    rake (13.0.6)
-    rake-compiler (1.2.1)
+    rake (13.1.0)
+    rake-compiler (1.2.5)
       rake
-    rdoc (6.5.0)
+    rbs (2.8.4)
+    rdoc (6.6.2)
       psych (>= 4.0.0)
-    regexp_parser (2.6.1)
+    regexp_parser (2.8.3)
     reverse_markdown (2.1.1)
       nokogiri
-    rexml (3.2.5)
-    rubocop (1.42.0)
+    rexml (3.2.6)
+    rubocop (1.59.0)
       json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
-      parser (>= 3.1.2.1)
+      parser (>= 3.2.2.4)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.24.1, < 2.0)
+      rubocop-ast (>= 1.30.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 3.0)
-    rubocop-ast (1.24.1)
-      parser (>= 3.1.1.0)
-    rubocop-performance (1.15.2)
-      rubocop (>= 1.7.0, < 2.0)
-      rubocop-ast (>= 0.4.0)
-    ruby-progressbar (1.11.0)
-    sdoc (2.5.0)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.30.0)
+      parser (>= 3.2.1.0)
+    rubocop-performance (1.20.1)
+      rubocop (>= 1.48.1, < 2.0)
+      rubocop-ast (>= 1.30.0, < 2.0)
+    ruby-progressbar (1.13.0)
+    sdoc (2.6.1)
       rdoc (>= 5.0)
-    solargraph (0.48.0)
+    solargraph (0.50.0)
       backport (~> 1.2)
       benchmark
-      bundler (>= 1.17.2)
+      bundler (~> 2.0)
       diff-lcs (~> 1.4)
       e2mmap
       jaro_winkler (~> 1.5)
       kramdown (~> 2.3)
       kramdown-parser-gfm (~> 1.1)
       parser (~> 3.0)
-      reverse_markdown (>= 1.0.5, < 3)
-      rubocop (>= 0.52)
+      rbs (~> 2.0)
+      reverse_markdown (~> 2.0)
+      rubocop (~> 1.38)
       thor (~> 1.0)
       tilt (~> 2.0)
       yard (~> 0.9, >= 0.9.24)
-    standard (1.21.1)
+    standard (1.33.0)
       language_server-protocol (~> 3.17.0.2)
-      rubocop (= 1.42.0)
-      rubocop-performance (= 1.15.2)
-    stringio (3.0.4)
-    thor (1.2.1)
-    tilt (2.0.11)
-    unicode-display_width (2.4.2)
-    webrick (1.7.0)
-    yard (0.9.28)
-      webrick (~> 1.7.0)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.59.0)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.3)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.3.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.20.1)
+    stringio (3.1.0)
+    thor (1.3.0)
+    tilt (2.3.0)
+    unicode-display_width (2.5.0)
+    yard (0.9.34)
 
 PLATFORMS
   arm64-darwin-19
   arm64-darwin-20
   arm64-darwin-21
   arm64-darwin-22
+  arm64-darwin-23
   x86_64-darwin-19
   x86_64-darwin-20
   x86_64-darwin-21
   x86_64-darwin-22
+  x86_64-darwin-23
 
 DEPENDENCIES
+  bump (~> 0.10)
   getargv!
-  minitest (~> 5.0)
-  rake (~> 13.0)
+  minitest (~> 5.20)
+  rake (~> 13.1)
   rake-compiler
+  rbs
   sdoc
   solargraph
-  standard (~> 1.3)
+  standard (~> 1.33)
 
 BUNDLED WITH
-   2.3.26
+   2.5.3

data/README.md

@@ -1,6 +1,7 @@
 <h1><img src="logo.svg" width="200" alt="getargv"></h1>
 
-[![Ruby](https://github.com/getargv/getargv_ruby/actions/workflows/main.yml/badge.svg)](https://github.com/getargv/getargv_ruby/actions/workflows/main.yml)
+[![Ruby](https://github.com/getargv/getargv.rb/actions/workflows/main.yml/badge.svg)](https://github.com/getargv/getargv.rb/actions/workflows/main.yml)
+[![Gem Version](https://badge.fury.io/rb/getargv.svg)](https://badge.fury.io/rb/getargv)
 
 This gem allows you to query the arguments of other processes on macOS.
 
@@ -23,15 +24,15 @@ Getargv.get_argv_of_pid_as_array(some_process_id) #=> ["arg0","arg1"]
 
 ## Development
 
-In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/getargv_ruby`. To experiment with that code, run `bin/console` for an interactive prompt.
-
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. 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 the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+Ruby code goes in the dir `lib/getargv_ruby`, C code goes in the dir `ext/getargv_ruby`.  To experiment with that code, run `bin/console` for an interactive prompt.
+
+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[origin]`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/getargv/getargv_ruby.
+Bug reports and pull requests are welcome on GitHub at https://github.com/getargv/getargv.rb.
 
 ## License
 

data/Rakefile

@@ -1,7 +1,12 @@
 # frozen_string_literal: true
 
+require "bump/tasks"
 require "bundler/gem_tasks"
+require "rake/extensiontask"
 require "rake/testtask"
+require "rdoc/task"
+require "sdoc"
+require "standard/rake"
 
 Rake::TestTask.new(:test) do |t|
   t.libs << "test"
@@ -9,21 +14,13 @@ Rake::TestTask.new(:test) do |t|
   t.test_files = FileList["test/**/test_*.rb"]
 end
 
-require "standard/rake"
-
-require "rake/extensiontask"
-
+task default: %i[clobber compile test standard]
 task build: :compile
 
 Rake::ExtensionTask.new("getargv_ruby") do |ext|
   ext.lib_dir = "lib/getargv_ruby"
 end
 
-task default: %i[clobber compile test standard]
-
-require "sdoc"
-require "rdoc/task"
-
 RDoc::Task.new do |rdoc|
   rdoc.main = "README.md"
   rdoc.rdoc_dir = "doc"

data/checksums/getargv-0.2.0-universal-darwin.gem.sha512

@@ -0,0 +1 @@
+d7dcae33d1dfb95fd4d27f42ee8b6cadafc4f33ccd3d4e35141e7f76f8c5e93bf9aa4180221646f39b802ab23ed4e979aeb6b23b67ca9e0be6813568de828838

data/checksums/getargv-0.3.0-universal-darwin.gem.sha512

@@ -0,0 +1 @@
+524fbd05c61b71c10687ace7b88d4bee13be100fe8465e2483c63beabfa68ec9d790833e3de90dd5d94a6b88d9a40e0c760a38f94b266e86de18ce2f82a61c5d

data/ext/getargv_ruby/extconf.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-temporary_hack = "delete this line when https://github.com/testdouble/standard/pull/498 lands in a release" # rubocop:disable Lint/UselessAssignment
-
 def darwin_check
   require "pathname"
   src = $srcdir || __dir__ # standard:disable Style/GlobalVars

data/ext/getargv_ruby/getargv_ruby.c

@@ -1,41 +1,44 @@
 #include "getargv_ruby.h"
 
+// https://ruby-doc.org/3.2.0/extension_rdoc.html
+
 VALUE rb_mGetargv;
 
 /*
- *  call-seq:
- *     Getargv.get_argv_of_pid(pid)                       -> String
- *     Getargv.get_argv_of_pid_as_string(pid)             -> String
- *     Getargv.get_argv_of_pid(pid, nuls)                 -> String
- *     Getargv.get_argv_of_pid_as_string(pid, nuls)       -> String
- *     Getargv.get_argv_of_pid(pid, nuls, skip)           -> String
- *     Getargv.get_argv_of_pid_as_string(pid, nuls, skip) -> String
+ * call-seq:
+ *     Getargv.get_argv_of_pid(pid, enc)                       -> String
+ *     Getargv.get_argv_of_pid_as_string(pid, enc)             -> String
+ *     Getargv.get_argv_of_pid(pid, enc, nuls)                 -> String
+ *     Getargv.get_argv_of_pid_as_string(pid, enc, nuls)       -> String
+ *     Getargv.get_argv_of_pid(pid, enc, nuls, skip)           -> String
+ *     Getargv.get_argv_of_pid_as_string(pid, enc, nuls, skip) -> String
  *
- *  Returns the arguments for the given process id as a string. If the second
- *  arg is true: replace nul separators with spaces for human consumption. If
- *  the third arg is provided, skip ahead the returned string by the given
- *  number of leading arguments.
+ * Returns the arguments for the given process id as a string with the
+ * specified encoding. If the third arg is +true+: replace +nul+ separators with
+ * +space+ for human consumption. If the fourth arg is provided, skip ahead the
+ * returned string by the given number of leading arguments.
  *
- *  Getargv::get_argv_of_pid_as_string is an alias for Getargv::get_argv_of_pid.
+ * Getargv::get_argv_of_pid_as_string is an alias for Getargv::get_argv_of_pid.
  *
- *  Examples
+ * === Examples:
  *
- *    Getargv.get_argv_of_pid(Process.pid)           #=> "ruby\x00-e..."
- *    Getargv.get_argv_of_pid(Process.pid(),true)    #=> "ruby -e..."
- *    Getargv.get_argv_of_pid(Process.pid(),false,1) #=> "-e..."
+ *    Getargv.get_argv_of_pid(Process.pid, Encoding.default_external)           #=> "ruby\x00-e..."
+ *    Getargv.get_argv_of_pid(Process.pid, Encoding.default_external, true)     #=> "ruby -e..."
+ *    Getargv.get_argv_of_pid(Process.pid, Encoding.default_external, false, 1) #=> "-e..."
  */
 static VALUE ruby_get_argv_of_pid(int argc, VALUE *argv, VALUE self) {
-  rb_check_arity(argc, 1, 3);
+  rb_check_arity(argc, 2, 4);
   Check_Type(argv[0], T_FIXNUM);
   rb_pid_t pid = NUM2PIDT(argv[0]);
   bool nuls = false;
   uint skip = 0;
+  rb_encoding *encoding = rb_to_encoding(argv[1]);
 
-  if (argc > 1)
-    nuls = RB_TEST(argv[1]);
-  if (argc > 2 && !NIL_P(argv[2])) {
-    Check_Type(argv[2], T_FIXNUM);
-    skip = NUM2UINT(argv[2]);
+  if (argc > 2)
+    nuls = RB_TEST(argv[2]);
+  if (argc > 3 && !NIL_P(argv[3])) {
+    Check_Type(argv[3], T_FIXNUM);
+    skip = NUM2UINT(argv[3]);
   }
 
   struct GetArgvOptions options = {.pid = pid, .skip = skip, .nuls = nuls};
@@ -45,30 +48,33 @@ static VALUE ruby_get_argv_of_pid(int argc, VALUE *argv, VALUE self) {
   }
 
   // assemble result ruby string, this copies :(
-  VALUE retVal = rb_str_new(result.start_pointer,
-                            1 + result.end_pointer - result.start_pointer);
-  free(result.buffer); // ruby copied data, can free buffer now
+  VALUE retVal =
+      rb_enc_str_new(result.start_pointer,
+                     1 + result.end_pointer - result.start_pointer, encoding);
+  free_ArgvResult(&result); // ruby copied data, can free buffer now
 
   return retVal;
 }
 
 /*
- *  call-seq:
- *     Getargv.get_argv_and_argc_of_pid(pid)             -> [String]
- *     Getargv.get_argv_of_pid_as_array(pid)             -> [String]
+ * call-seq:
+ *     Getargv.get_argv_and_argc_of_pid(pid, enc) -> [String]
+ *     Getargv.get_argv_of_pid_as_array(pid, enc) -> [String]
  *
- *  Returns the arguments for the given process id as an array of strings.
+ * Returns the arguments for the given process id as an array of strings with the specified encoding.
  *
- *  Getargv::get_argv_of_pid_as_array is an alias for Getargv::get_argv_and_argc_of_pid.
+ * Getargv::get_argv_of_pid_as_array is an alias for Getargv::get_argv_and_argc_of_pid.
  *
- *  Examples
+ * === Examples:
  *
- *    Getargv.get_argv_and_argc_of_pid(Process.pid)      #=> ["ruby,"-e",...]
+ *    Getargv.get_argv_and_argc_of_pid(Process.pid, Encoding.default_external) #=> ["ruby,"-e",...]
  */
-static VALUE ruby_get_argv_and_argc_of_pid(VALUE self, VALUE rPid) {
+static VALUE ruby_get_argv_and_argc_of_pid(VALUE self, VALUE rPid, VALUE enc) {
   Check_Type(rPid, T_FIXNUM);
   rb_pid_t pid = NUM2PIDT(rPid);
 
+  rb_encoding *encoding = rb_to_encoding(enc);
+
   struct ArgvArgcResult result;
   if (!get_argv_and_argc_of_pid(pid, &result)) {
     rb_sys_fail(0); // uses errno
@@ -77,11 +83,10 @@ static VALUE ruby_get_argv_and_argc_of_pid(VALUE self, VALUE rPid) {
   VALUE ary = rb_ary_new_capa(result.argc);
   for (size_t i = 0; i < result.argc; i++) {
     // assemble result ruby string, this copies :(
-    rb_ary_push(ary, rb_str_new_cstr(result.argv[i]));
+    rb_ary_push(ary, rb_enc_str_new_cstr(result.argv[i], encoding));
   }
   // ruby copied data, can free buffers now
-  free(result.argv);
-  free(result.buffer);
+  free_ArgvArgcResult(&result);
 
   return ary;
 }
@@ -90,10 +95,12 @@ void Init_getargv_ruby(void) {
   rb_mGetargv = rb_define_module("Getargv");
 
   rb_define_module_function(rb_mGetargv, "get_argv_of_pid", ruby_get_argv_of_pid, -1);
+
   // Getargv::get_argv_of_pid_as_string is an alias for Getargv::get_argv_of_pid.
-  rb_define_alias(rb_singleton_class(rb_mGetargv),  "get_argv_of_pid_as_string", "get_argv_of_pid");
+  rb_define_alias(rb_singleton_class(rb_mGetargv), "get_argv_of_pid_as_string", "get_argv_of_pid");
+
+  rb_define_module_function(rb_mGetargv, "get_argv_and_argc_of_pid", ruby_get_argv_and_argc_of_pid, 2);
 
-  rb_define_module_function(rb_mGetargv, "get_argv_and_argc_of_pid", ruby_get_argv_and_argc_of_pid, 1);
   // Getargv::get_argv_of_pid_as_array is an alias for Getargv::get_argv_and_argc_of_pid.
-  rb_define_alias(rb_singleton_class(rb_mGetargv),  "get_argv_of_pid_as_array", "get_argv_and_argc_of_pid");
+  rb_define_alias(rb_singleton_class(rb_mGetargv), "get_argv_of_pid_as_array", "get_argv_and_argc_of_pid");
 }

data/ext/getargv_ruby/getargv_ruby.h

@@ -2,7 +2,7 @@
 #define GETARGV_RUBY_H 1
 
 #include "ruby.h"
-#include "ruby/intern.h"
+#include "ruby/encoding.h"
 #include <libgetargv.h>
 #include <stddef.h>
 #include <sys/errno.h>

data/getargv_ruby.gemspec

@@ -12,20 +12,26 @@ Gem::Specification.new do |spec|
 
   spec.summary = "This gem allows you to query the arguments of other processes on macOS."
   spec.description = <<-EOF
-  Getargv is a gem that allows you to query the arguments of other processes as
-  an array or string. This gem only supports macOS because the KERN_PROCARGS2
-  sysctl only exists in xnu kernels, BSD or Linux users should just read
-  /proc/$PID/cmdline which is much easier and faster, Solaris users should use
-  pargs.
+  Getargv is a gem that allows you to query the arguments of other processes as an array or string.
+
+  This gem only supports macOS because the KERN_PROCARGS2 sysctl only exists in xnu kernels, BSD or Linux users should just read /proc/$PID/cmdline which is much easier and faster, Solaris users should use pargs.
+
+  This gem requires you have [libgetargv](https://getargv.narzt.cam/) installed.
+
+  To limit the getargv gem to Apple OSs add it to your Gemfile like so:
+
+  gem "getargv", "~> #{Getargv::VERSION}", platforms: :ruby, install_if: RbConfig::CONFIG["host_os"].include?("darwin")
   EOF
   spec.homepage = "https://getargv.narzt.cam/"
   spec.license = "BSD-3-Clause"
   spec.required_ruby_version = ">= #{ruby_version}.0"
+  spec.requirements << "macOS"
+  spec.requirements << "libgetargv installed"
 
   spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/getargv/getargv_ruby"
-  spec.metadata["changelog_uri"] = "https://github.com/getargv/getargv_ruby/blob/CHANGELOG.md"
-  spec.metadata["bug_tracker_uri"] = "https://github.com/getargv/getargv_ruby/issues"
+  spec.metadata["source_code_uri"] = "https://github.com/getargv/getargv.rb"
+  spec.metadata["changelog_uri"] = "https://github.com/getargv/getargv.rb/blob/CHANGELOG.md"
+  spec.metadata["bug_tracker_uri"] = "https://github.com/getargv/getargv.rb/issues"
   spec.metadata["funding_uri"] = "https://github.com/sponsors/CamJN"
   spec.metadata["documentation_uri"] = "https://rubydoc.info/gems/getargv/Getargv"
 
@@ -43,11 +49,21 @@ Gem::Specification.new do |spec|
   spec.platform = "universal-darwin"
 
   spec.extra_rdoc_files = Dir["README.md", "ext/*/*.c", "lib/*/*.rb", "lib/*.rb"]
-  spec.rdoc_options << "-o" << "doc"
-  spec.rdoc_options << "-T" << "rails"
-  # spec.rdoc_options << "-T" << "direct"
-  # spec.rdoc_options << "-T" << "shtml"
+  spec.rdoc_options << "--output" << "doc"
   spec.rdoc_options << "--format=sdoc"
+  spec.rdoc_options << "--template=rails"
+  spec.rdoc_options << "--line-numbers"
+  spec.rdoc_options << "--inline-source"
+  spec.rdoc_options << "--exclude=ext/*/extconf.rb"
+
+  spec.add_development_dependency "bump", "~> 0.10"
+  spec.add_development_dependency "minitest", "~> 5.20"
+  spec.add_development_dependency "rake", "~> 13.1"
+  spec.add_development_dependency "rake-compiler"
+  spec.add_development_dependency "rbs"
+  spec.add_development_dependency "sdoc"
+  spec.add_development_dependency "solargraph"
+  spec.add_development_dependency "standard", "~> 1.33"
 
   # Uncomment to register a new dependency of your gem
   # spec.add_dependency "example-gem", "~> 1.0"

data/lib/getargv_ruby/version.rb

@@ -3,5 +3,5 @@
 module Getargv
   ##
   # The version of the gem
-  VERSION = "0.2.0"
+  VERSION = "0.3.2"
 end

data/sig/getargv_ruby.rbs

@@ -1,4 +1,8 @@
+# See the writing guide of rbs: https://github.com/ruby/rbs#guides
 module Getargv
   VERSION: String
-  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+  public def get_argv_and_argc_of_pid: (Integer pid, Encoding enc) -> Array[String]
+  alias get_argv_of_pid_as_array get_argv_and_argc_of_pid
+  public def get_argv_of_pid: (Integer pid, Encoding enc, ?boolish nuls, ?Integer skip) -> String
+  alias get_argv_of_pid_as_string get_argv_of_pid
 end

metadata

@@ -1,21 +1,137 @@
 --- !ruby/object:Gem::Specification
 name: getargv
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.2
 platform: universal-darwin
 authors:
 - Camden Narzt
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-01-05 00:00:00.000000000 Z
-dependencies: []
+date: 2023-12-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bump
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.20'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.20'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.1'
+- !ruby/object:Gem::Dependency
+  name: rake-compiler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rbs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: solargraph
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: standard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.33'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.33'
 description: |2
-    Getargv is a gem that allows you to query the arguments of other processes as
-    an array or string. This gem only supports macOS because the KERN_PROCARGS2
-    sysctl only exists in xnu kernels, BSD or Linux users should just read
-    /proc/$PID/cmdline which is much easier and faster, Solaris users should use
-    pargs.
+    Getargv is a gem that allows you to query the arguments of other processes as an array or string.
+
+    This gem only supports macOS because the KERN_PROCARGS2 sysctl only exists in xnu kernels, BSD or Linux users should just read /proc/$PID/cmdline which is much easier and faster, Solaris users should use pargs.
+
+    This gem requires you have [libgetargv](https://getargv.narzt.cam/) installed.
+
+    To limit the getargv gem to Apple OSs add it to your Gemfile like so:
+
+    gem "getargv", "~> 0.3.2", platforms: :ruby, install_if: RbConfig::CONFIG["host_os"].include?("darwin")
 email:
 - getargv@narzt.cam
 executables: []
@@ -35,6 +151,8 @@ files:
 - README.md
 - Rakefile
 - checksums/getargv-0.1.0-x86_64-darwin-21.gem.sha512
+- checksums/getargv-0.2.0-universal-darwin.gem.sha512
+- checksums/getargv-0.3.0-universal-darwin.gem.sha512
 - ext/getargv_ruby/extconf.rb
 - ext/getargv_ruby/getargv_ruby.c
 - ext/getargv_ruby/getargv_ruby.h
@@ -48,18 +166,20 @@ licenses:
 - BSD-3-Clause
 metadata:
   homepage_uri: https://getargv.narzt.cam/
-  source_code_uri: https://github.com/getargv/getargv_ruby
-  changelog_uri: https://github.com/getargv/getargv_ruby/blob/CHANGELOG.md
-  bug_tracker_uri: https://github.com/getargv/getargv_ruby/issues
+  source_code_uri: https://github.com/getargv/getargv.rb
+  changelog_uri: https://github.com/getargv/getargv.rb/blob/CHANGELOG.md
+  bug_tracker_uri: https://github.com/getargv/getargv.rb/issues
   funding_uri: https://github.com/sponsors/CamJN
   documentation_uri: https://rubydoc.info/gems/getargv/Getargv
 post_install_message:
 rdoc_options:
-- "-o"
+- "--output"
 - doc
-- "-T"
-- rails
 - "--format=sdoc"
+- "--template=rails"
+- "--line-numbers"
+- "--inline-source"
+- "--exclude=ext/*/extconf.rb"
 require_paths:
 - lib
 - ext
@@ -73,8 +193,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
-requirements: []
-rubygems_version: 3.1.6
+requirements:
+- macOS
+- libgetargv installed
+rubygems_version: 3.5.3
 signing_key:
 specification_version: 4
 summary: This gem allows you to query the arguments of other processes on macOS.