l-tools 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6b1063afdbce52f7818b2c92a309e3da1b54e5a1ec7d4154a20c85b4aa79b91a
+  data.tar.gz: 0f3fb4ce31530c0cb1c47cc0cbcc104511b94ad2fc1dd71e18fa8c5a952a0295
+SHA512:
+  metadata.gz: b49a9dd21f82376911ab47ad3e4d0df979d17c5336b431e8ae02fbe06e2787d2716e39e234261d42dfc30295429d7085639a8bea6a2d86759119205b220f1f60
+  data.tar.gz: 315e21b34ac6b0610820469f2bdfe8c4cca56602622e3c59db01f855eb0efe8cd2e952fb019f54e54d09379a001c7547e967656e54cf409b190e2eee7f4f1a38

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+gem 'colorize'
+gem 'childprocess'

data/l-tools.gemspec

@@ -0,0 +1,25 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require "version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "l-tools"
+  spec.version       = LTools::VERSION
+  spec.authors       = ["L"]
+  spec.email         = ["l-codes@qq.com"]
+
+  spec.summary       = %q{L Tools}
+  spec.description   = %q{Controlling external programs running}
+  spec.homepage      = "https://github.com/l-codes/l-tools"
+  spec.license       = "MIT"
+
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.17"
+end

data/lib/l-tools.rb

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+
+module LTools
+  autoload :Tool,     './tools/tool'
+  autoload :Tshark,   './tools/tshark'
+  autoload :Nmap,     './tools/nmap'
+
+  @tools = []
+
+  class << self
+    attr_accessor :verbose
+
+    def add_tool(tool)
+      @tools << tool
+    end
+
+    def check_all?
+      @tools.map do |child_class| 
+        child_class.check?
+      end
+    end
+  end
+end

data/lib/tools/nmap.rb

@@ -0,0 +1,15 @@
+
+module LTools
+  class Nmap < Tool
+    @name = 'nmap'
+
+    def self.portscan(targets, ports: nil, mode: 'S', speed: 5, append: nil)
+      cmd = "nmap -Pn -n -T#{speed} -s#{mode}"
+      cmd << " -p #{ports} " if ports
+      targets = targets.join(' ') if targets.is_a? Array
+      cmd << targets
+      cmd << append               if append
+      new cmd
+    end
+  end
+end

data/lib/tools/tool.rb

@@ -0,0 +1,87 @@
+
+require 'forwardable'
+require 'childprocess'
+require 'colorize'
+
+ChildProcess.posix_spawn = true
+
+module LTools
+  autoload :Shellwords, 'shellwords'
+
+  class Tool
+    extend Forwardable
+
+    attr_reader :stdin, :stdout, :stderr
+    attr_accessor :verbose
+
+    def_delegators :@process, :stop, :pid, :exited?, \
+                   :alive?, :exit_code, :poll_for_exit
+
+    def initialize(*args)
+      tool, *args = args
+
+      # 检测参数类型进行变换，支持一下格式:
+      #   args = 'echo 1231'
+      #   args = ['echo', '1231']
+      #   args = [['echo', '1231']]
+      case tool
+      when String
+        if args.empty? and tool.include? ' '
+          tool, *args = Shellwords.split(tool)
+        end
+      when Array
+        tool, *args = tool
+      else
+        raise
+      end
+
+      @cmd = args.unshift(tool).map(&:to_s)
+      @process = ChildProcess.build(*@cmd)
+
+      @stdout, @stdout_w = IO.pipe
+      @process.io.stdout = @stdout_w 
+
+      @stderr, @stderr_w = IO.pipe
+      @process.io.stderr = @stderr_w
+
+      @verbose = true if LTools.verbose
+    end
+
+    def start
+      @process.duplex    = true unless @inherit
+      @process.start
+      @stdin = @process.io.stdin unless @inherit
+      if @verbose
+        puts "[#{'+'.light_green.bold}] #{self.class.to_s.light_yellow} (pid: #{pid})"
+        puts "  #{?$.light_red.bold} #{@cmd.join(' ')}"
+        puts
+      end
+    end
+
+    def wait
+      @process.wait
+      @stdout_w.close
+      @stderr_w.close
+    end
+
+    def stop
+      @process.stop
+      @stdout_w.close
+      @stderr_w.close
+    end
+
+    def io_inherit!
+      @inherit = true
+      @process.io.inherit!
+    end
+
+    def self.inherited(child_class)
+      LTools.add_tool(child_class)
+    end
+
+    def self.check?
+      system "hash #{@name} 2>&-"
+      $?.success?
+    end
+  end
+end

data/lib/tools/tshark.rb

@@ -0,0 +1,26 @@
+
+module LTools
+  class Tshark < Tool
+    @name = 'tshark'
+
+    def self.capture(interface: nil, bpf: nil, fields:nil, filter: nil, append: nil)
+      cmd = 'tshark'
+      cmd << " -i '#{interface}'" if interface
+      cmd << " -f '#{bpf}'"       if bpf
+      cmd << " -Y '#{filter}'"    if filter
+      if fields
+        fields = fields.split if fields.is_a? String
+        fields.unshift ' -T fields'
+        cmd << fields.join(' -e ')
+      end
+      cmd << append               if append
+      new cmd
+    end
+
+    def records
+      @stdout.each_line.map do |line|
+        line.split("\t")
+      end
+    end
+  end
+end

data/lib/version.rb

@@ -0,0 +1,4 @@
+
+module LTools
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification
+name: l-tools
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- L
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-12-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.17'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.17'
+description: Controlling external programs running
+email:
+- l-codes@qq.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- l-tools.gemspec
+- lib/l-tools.rb
+- lib/tools/nmap.rb
+- lib/tools/tool.rb
+- lib/tools/tshark.rb
+- lib/version.rb
+homepage: https://github.com/l-codes/l-tools
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.7
+signing_key: 
+specification_version: 4
+summary: L Tools
+test_files: []