ronin-post_ex 0.1.0.beta1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 403e9fcdbeec51db102129de41d5ab773c2f86b2befec71424ade570f0486064
-  data.tar.gz: a3eb7c6dbe7a4b5673b4b35bd425f384418084a17765d0a7602b63cb1eb35427
+  metadata.gz: 4346fdf8543dc6894bec78f13e69d551200799c969c1ed2f1d367802b65823c1
+  data.tar.gz: 58b300b74f477cf6ee3599e9d4ac2b2cecd8d933a25fa705eef3eece4bd28ae6
 SHA512:
-  metadata.gz: 7e986a6e7b619c6eb56144e8c190378c8659db22c0bc71f9d91a749a26f915bd855e6447fdbe41dbea2ff73b1c21d26d1b1f93ee7cb56c000c70117858df8a12
-  data.tar.gz: e3ac243381c04b7f79173b3bcdff9f0afb23d1393d2d9d7b0e66d2bc5f6f75afd76a34a82102ef58378fb45220d80adbb0ff38b0c850dce58f5a6fc4641318d9
+  metadata.gz: dfa448a2226576e6559a7152e959076e32e15954a17626b0210c351079132bafb6d1cd441ce27fec1aea773ce64467366edc507d60ac1b73f435c58c7c824a2b
+  data.tar.gz: 4c4d5a8b257c07f71bfdbf635e988e988dd97706ef6bb1791ef175141390bba6b6bb39a3d6daede2b829c00020bbaf41c628a709c6cb3207daf2fec38df2ea0c

data/.github/workflows/ruby.yml

@@ -21,6 +21,7 @@ jobs:
         uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
       - name: Install libsqlite3
         run: |
           sudo apt update -y && \

data/.yardopts

@@ -1 +1 @@
---markup markdown --title 'Ronin PostEx Documentation' --protected
+--markup markdown --title 'Ronin::PostEx Documentation' --protected

data/README.md

@@ -2,6 +2,7 @@
 
 [![CI](https://github.com/ronin-rb/ronin-post_ex/actions/workflows/ruby.yml/badge.svg)](https://github.com/ronin-rb/ronin-post_ex/actions/workflows/ruby.yml)
 [![Code Climate](https://codeclimate.com/github/ronin-rb/ronin-post_ex.svg)](https://codeclimate.com/github/ronin-rb/ronin-post_ex)
+[![Gem Version](https://badge.fury.io/rb/ronin-post_ex.svg)](https://badge.fury.io/rb/ronin-post_ex)
 
 * [Website](https://ronin-rb.dev/)
 * [Source](https://github.com/ronin-rb/ronin-post_ex)
@@ -217,7 +218,7 @@ gem.add_dependency 'ronin-post_ex', '~> 0.1'
 
 ## License
 
-Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 
 ronin-post_ex is free software: you can redistribute it and/or modify
 it under the terms of the GNU Lesser General Public License as published

data/gemspec.yml

@@ -8,10 +8,11 @@ homepage: https://ronin-rb.dev/
 has_yard: true
 
 metadata:
-  documentation_uri: https://rubydoc.info/gems/ronin-post_ex
+  documentation_uri: https://ronin-rb.dev/docs/ronin-post_ex
   source_code_uri:   https://github.com/ronin-rb/ronin-post_ex
   bug_tracker_uri:   https://github.com/ronin-rb/ronin-post_ex/issues
-  changelog_uri:     https://github.com/ronin-rb/ronin-post_ex/blob/master/ChangeLog.md
+  changelog_uri:     https://github.com/ronin-rb/ronin-post_ex/blob/main/ChangeLog.md
+  rubygems_mfa_required: 'true'
 
 required_ruby_version: ">= 3.0.0"
 
@@ -19,7 +20,7 @@ dependencies:
   fake_io: ~> 0.1
   hexdump: ~> 1.0
   # Ronin dependencies:
-  ronin-core: ~> 0.1.0.beta1
+  ronin-core: ~> 0.1
 
 development_dependencies:
   bundler: ~> 2.0

data/lib/ronin/post_ex/cli/shell_shell.rb

@@ -2,7 +2,7 @@
 #
 # ronin-post_ex - a Ruby API for Post-Exploitation.
 #
-# Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-post_ex is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/post_ex/cli/system_shell.rb

@@ -2,7 +2,7 @@
 #
 # ronin-post_ex - a Ruby API for Post-Exploitation.
 #
-# Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-post_ex is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/post_ex/remote_dir.rb

@@ -2,7 +2,7 @@
 #
 # ronin-post_ex - a Ruby API for Post-Exploitation.
 #
-# Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-post_ex is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/post_ex/remote_file/stat.rb

@@ -2,7 +2,7 @@
 #
 # ronin-post_ex - a Ruby API for Post-Exploitation.
 #
-# Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-post_ex is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/post_ex/remote_file.rb

@@ -2,7 +2,7 @@
 #
 # ronin-post_ex - a Ruby API for Post-Exploitation.
 #
-# Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-post_ex is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
@@ -382,7 +382,7 @@ module Ronin
       #   The data to write.
       #
       # @return [Integer]
-      #   The number of bytes writen.
+      #   The number of bytes written.
       #
       # @raise [IOError]
       #   The API object does not define `file_write`.

data/lib/ronin/post_ex/remote_process.rb

@@ -2,7 +2,7 @@
 #
 # ronin-post_ex - a Ruby API for Post-Exploitation.
 #
-# Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-post_ex is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
@@ -140,7 +140,7 @@ module Ronin
       #   The data to write to the shell.
       #
       # @return [Integer]
-      #   The number of bytes writen.
+      #   The number of bytes written.
       #
       def io_write(data)
         if @session.respond_to?(:process_write)

data/lib/ronin/post_ex/resource.rb

@@ -2,7 +2,7 @@
 #
 # ronin-post_ex - a Ruby API for Post-Exploitation.
 #
-# Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-post_ex is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/post_ex/sessions/bind_shell.rb

@@ -2,7 +2,7 @@
 #
 # ronin-post_ex - a Ruby API for Post-Exploitation.
 #
-# Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-post_ex is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/post_ex/sessions/remote_shell_session.rb

@@ -2,7 +2,7 @@
 #
 # ronin-post_ex - a Ruby API for Post-Exploitation.
 #
-# Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-post_ex is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/post_ex/sessions/reverse_shell.rb

@@ -2,7 +2,7 @@
 #
 # ronin-post_ex - a Ruby API for Post-Exploitation.
 #
-# Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-post_ex is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/post_ex/sessions/rpc_session.rb

@@ -2,7 +2,7 @@
 #
 # ronin-post_ex - a Ruby API for Post-Exploitation.
 #
-# Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-post_ex is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/post_ex/sessions/session.rb

@@ -2,7 +2,7 @@
 #
 # ronin-post_ex - a Ruby API for Post-Exploitation.
 #
-# Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-post_ex is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/post_ex/sessions/shell_session.rb

@@ -2,7 +2,7 @@
 #
 # ronin-post_ex - a Ruby API for Post-Exploitation.
 #
-# Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-post_ex is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/post_ex/system/fs.rb

@@ -2,7 +2,7 @@
 #
 # ronin-post_ex - a Ruby API for Post-Exploitation.
 #
-# Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-post_ex is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
@@ -494,7 +494,7 @@ module Ronin
         resource_method :chgrp, [:fs_chgrp]
 
         #
-        # Changes permissions on one or more file or directorie.
+        # Changes permissions on one or more file or directory.
         #
         # @param [Integer] mode
         #   The new mode for the file or directory.

data/lib/ronin/post_ex/system/process.rb

@@ -2,7 +2,7 @@
 #
 # ronin-post_ex - a Ruby API for Post-Exploitation.
 #
-# Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-post_ex is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/post_ex/system/shell.rb

@@ -2,7 +2,7 @@
 #
 # ronin-post_ex - a Ruby API for Post-Exploitation.
 #
-# Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-post_ex is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/post_ex/system.rb

@@ -2,7 +2,7 @@
 #
 # ronin-post_ex - a Ruby API for Post-Exploitation.
 #
-# Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-post_ex is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/lib/ronin/post_ex/version.rb

@@ -2,7 +2,7 @@
 #
 # ronin-post_ex - a Ruby API for Post-Exploitation.
 #
-# Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-post_ex is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published
@@ -21,6 +21,6 @@
 module Ronin
   module PostEx
     # ronin-post_ex version
-    VERSION = '0.1.0.beta1'
+    VERSION = '0.1.0'
   end
 end

data/lib/ronin/post_ex.rb

@@ -2,7 +2,7 @@
 #
 # ronin-post_ex - a Ruby API for Post-Exploitation.
 #
-# Copyright (c) 2007-2022 Hal Brodigan (postmodern.mod3 at gmail.com)
+# Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
 #
 # ronin-post_ex is free software: you can redistribute it and/or modify
 # it under the terms of the GNU Lesser General Public License as published

data/ronin-post_ex.gemspec

@@ -27,13 +27,14 @@ Gem::Specification.new do |gem|
   gem.files  = `git ls-files`.split($/)
   gem.files  = glob[gemspec['files']] if gemspec['files']
   gem.files += Array(gemspec['generated_files'])
+  # exclude test files from the packages gem
+  gem.files -= glob[gemspec['test_files'] || 'spec/{**/}*']
 
   gem.executables = gemspec.fetch('executables') do
     glob['bin/*'].map { |path| File.basename(path) }
   end
 
   gem.extensions       = glob[gemspec['extensions'] || 'ext/**/extconf.rb']
-  gem.test_files       = glob[gemspec['test_files'] || 'spec/{**/}*_spec.rb']
   gem.extra_rdoc_files = glob[gemspec['extra_doc_files'] || '*.{txt,md}']
 
   gem.require_paths = Array(gemspec.fetch('require_paths') {

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ronin-post_ex
 version: !ruby/object:Gem::Version
-  version: 0.1.0.beta1
+  version: 0.1.0
 platform: ruby
 authors:
 - Postmodern
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-01-01 00:00:00.000000000 Z
+date: 2023-02-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fake_io
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.0.beta1
+        version: '0.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.0.beta1
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -110,22 +110,15 @@ files:
 - lib/ronin/post_ex/system/shell.rb
 - lib/ronin/post_ex/version.rb
 - ronin-post_ex.gemspec
-- spec/sessions/bind_shell_spec.rb
-- spec/sessions/remote_shell_session_spec.rb
-- spec/sessions/reverse_shell_spec.rb
-- spec/sessions/rpc_session_spec.rb
-- spec/sessions/session_spec.rb
-- spec/sessions/shell_session_spec.rb
-- spec/spec_helper.rb
-- spec/system_spec.rb
 homepage: https://ronin-rb.dev/
 licenses:
 - LGPL-3.0
 metadata:
-  documentation_uri: https://rubydoc.info/gems/ronin-post_ex
+  documentation_uri: https://ronin-rb.dev/docs/ronin-post_ex
   source_code_uri: https://github.com/ronin-rb/ronin-post_ex
   bug_tracker_uri: https://github.com/ronin-rb/ronin-post_ex/issues
-  changelog_uri: https://github.com/ronin-rb/ronin-post_ex/blob/master/ChangeLog.md
+  changelog_uri: https://github.com/ronin-rb/ronin-post_ex/blob/main/ChangeLog.md
+  rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -145,11 +138,4 @@ rubygems_version: 3.3.26
 signing_key:
 specification_version: 4
 summary: Ruby API for Post-Exploitation
-test_files:
-- spec/sessions/bind_shell_spec.rb
-- spec/sessions/remote_shell_session_spec.rb
-- spec/sessions/reverse_shell_spec.rb
-- spec/sessions/rpc_session_spec.rb
-- spec/sessions/session_spec.rb
-- spec/sessions/shell_session_spec.rb
-- spec/system_spec.rb
+test_files: []

data/spec/sessions/bind_shell_spec.rb

@@ -1,31 +0,0 @@
-require 'spec_helper'
-require 'ronin/post_ex/sessions/bind_shell'
-
-describe Ronin::PostEx::Sessions::BindShell do
-  it "must inherit from Ronin::PostEx::Sessions::RemoteShellSession" do
-    expect(described_class).to be < Ronin::PostEx::Sessions::RemoteShellSession
-  end
-
-  let(:host)     { 'example.com' }
-  let(:port)     { 1337 }
-  let(:addrinfo) { Addrinfo.tcp(host,port) }
-
-  describe ".connect" do
-    let(:host) { 'example.com' }
-    let(:port) { 1337 }
-
-    let(:socket) { double('TCPSocket') }
-
-    before  { allow(socket).to receive(:remote_address).and_return(addrinfo) }
-    subject { described_class }
-
-    it "must connect to the remote host and port and return a #{described_class} object" do
-      expect(TCPSocket).to receive(:new).with(host,port).and_return(socket)
-
-      bind_shell = subject.connect(host,port)
-
-      expect(bind_shell).to be_kind_of(described_class)
-      expect(bind_shell.io).to be(socket)
-    end
-  end
-end

data/spec/sessions/remote_shell_session_spec.rb

@@ -1,28 +0,0 @@
-require 'spec_helper'
-require 'ronin/post_ex/sessions/bind_shell'
-
-describe Ronin::PostEx::Sessions::BindShell do
-  it "must inherit from Ronin::PostEx::Sessions::ShellSession" do
-    expect(described_class).to be < Ronin::PostEx::Sessions::ShellSession
-  end
-
-  let(:host)     { 'example.com' }
-  let(:port)     { 1337 }
-  let(:addrinfo) { Addrinfo.tcp(host,port) }
-  let(:socket)   { double('TCPSocket') }
-
-  before  { allow(socket).to receive(:remote_address).and_return(addrinfo) }
-  subject { described_class.new(socket) }
-
-  describe "#initialize" do
-    it "must set #io" do
-      expect(subject.io).to be(socket)
-    end
-
-    let(:ip) { addrinfo.ip_address }
-
-    it "musst set #name to \"ip:port\"" do
-      expect(subject.name).to eq("#{ip}:#{port}")
-    end
-  end
-end

data/spec/sessions/reverse_shell_spec.rb

@@ -1,49 +0,0 @@
-require 'spec_helper'
-require 'ronin/post_ex/sessions/reverse_shell'
-
-describe Ronin::PostEx::Sessions::ReverseShell do
-  it "must inherit from Ronin::PostEx::Sessions::RemoteShellSession" do
-    expect(described_class).to be < Ronin::PostEx::Sessions::RemoteShellSession
-  end
-
-  let(:host)     { 'localhost' }
-  let(:port)     { 1337 }
-  let(:addrinfo) { Addrinfo.tcp(host,port) }
-
-  describe ".listen" do
-    let(:server_socket) { double('TCPServer') }
-    let(:client_socket) { double('TCPSocket') }
-
-    before  { allow(client_socket).to receive(:remote_address).and_return(addrinfo) }
-    subject { described_class }
-
-    it "must listen on a local port, accept a connection, return a #{described_class} object, and close the server socket" do
-      expect(TCPServer).to receive(:new).with(port,nil).and_return(server_socket)
-      expect(server_socket).to receive(:listen).with(1)
-      expect(server_socket).to receive(:accept).and_return(client_socket)
-      expect(server_socket).to receive(:close)
-
-      reverse_shell = subject.listen(port)
-
-      expect(reverse_shell).to be_kind_of(described_class)
-      expect(reverse_shell.io).to be(client_socket)
-    end
-
-    context "and a host argument is given" do
-      let(:host) { '127.0.0.1' }
-
-      it "must listen on a local host and port, accept a connection, return a #{described_class} object, and close the server socket" do
-        expect(TCPServer).to receive(:new).with(port,host).and_return(server_socket)
-        expect(server_socket).to receive(:listen).with(1)
-        expect(server_socket).to receive(:accept).and_return(client_socket)
-        expect(server_socket).to receive(:close)
-        allow(client_socket).to receive(:local_address).and_return(addrinfo)
-
-        reverse_shell = subject.listen(host,port)
-
-        expect(reverse_shell).to be_kind_of(described_class)
-        expect(reverse_shell.io).to be(client_socket)
-      end
-    end
-  end
-end