procfs_rb 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 19b629e77fea8aaca91e9508f6699c0a1aaac45b4cc5bd0eb4c15673fe462225
+  data.tar.gz: 3fafda51d24256ba5dc465ff23faa6619867ef30878d1723bc4c54c750441c01
+SHA512:
+  metadata.gz: 29caacfbc2428f324dbbae4c0362f9131e55a2ec6298f5e51d29e5ef38ee64774d22d8bffe4177d1b9f00ea44095548f2cd8a9681aca4f0e73077d3bb0a208ff
+  data.tar.gz: b15568d0cd9b6282838f9bb07172b1d7084677da80cf4bba4d65271c73840a47756ec39fbb4699e67d60e7ce0918473a2a39aa1d182f8d37104ef4bc0fb8257b

data/.opencode.json

@@ -0,0 +1,11 @@
+{
+  "project_name": "procfs_rb",
+  "instructions": "Follow the guidelines in AGENTS.md.",
+  "ignored_paths": [
+    "coverage/",
+    ".git/",
+    "tmp/",
+    "bin/console",
+    "bin/setup"
+  ]
+}

data/AGENTS.md

@@ -0,0 +1,35 @@
+# AI Agent Guidelines for procfs_rb
+
+This project is a Ruby GEM designed to provide a programmatic interface for browsing and analyzing the `/proc` filesystem on Linux.
+
+## Project Context
+- **Purpose:** Provide an idiomatic Ruby wrapper for Linux procfs.
+- **Tech Stack:**
+  - Ruby >= 3.2.0
+  - Minitest (Testing)
+  - RuboCop (Linting/Styling)
+  - RBS (Type signatures)
+- **Hosting:** Primary development and CI/CD on GitLab; mirrored on GitHub.
+
+## Coding Standards
+- **Idiomatic Ruby:** Follow the Ruby Style Guide.
+- **Linting:** All code must pass `bundle exec rubocop`.
+- **Typing:** Update `.rbs` files in the `sig/` directory when adding new public methods.
+- **Error Handling:** Do not swallow exceptions; provide meaningful custom error classes for procfs-specific failures (e.g., missing files in `/proc`).
+- **Documentation:** Use YARD style comments for public API methods.
+
+## Testing Requirements
+- **Framework:** Minitest.
+- **Coverage:** New features must include tests. Run `rake test` to verify.
+- **Environment:** Tests expect a Linux environment with a populated `/proc` filesystem.
+
+## Tooling
+- `rake test`: Run all tests.
+- `bundle exec rubocop`: Run linting.
+- `bundle exec reek`: Run code smell analysis.
+- `bin/console`: Interactive console for exploration.
+
+## Workflow
+- **Branching:** Feature Branch workflow.
+- **Commits:** Follow Conventional Commits.
+- **Verification:** Always run linting and tests before proposing a change.

data/CONTRIBUTING.md

@@ -0,0 +1,39 @@
+# Contributing to procfs_rb
+
+Thank you for contributing to `procfs_rb`! This gem provides a Ruby interface to the Linux `/proc` filesystem.
+
+## Development Workflow
+
+### 1. Setup
+Ensure you are on a Linux system. Install dependencies:
+```bash
+bundle install
+```
+
+### 2. Feature Branching
+We use a feature branch workflow. Please create a new branch for every change:
+- `feat/description` for new features.
+- `fix/description` for bug fixes.
+- `docs/description` for documentation updates.
+
+### 3. Coding Standards
+- **Style:** We use RuboCop for linting. Run `bundle exec rubocop` to check your code.
+- **Types:** We use RBS for type signatures. Please update `sig/procfs_rb.rbs` accordingly.
+- **Commits:** We follow [Conventional Commits](https://www.conventionalcommits.org/). 
+  - Example: `feat: add memory info parsing` or `fix: resolve nil value in cpu_stats`
+
+### 4. Testing
+All contributions must include tests.
+- Run tests using: `rake test`
+- Ensure that your changes do not decrease test coverage.
+
+### 5. Submission
+1. Push your branch to GitLab.
+2. Create a Merge Request (MR) on GitLab (the primary repository).
+3. Provide a clear description of the change and the motivation behind it.
+
+## Repository Structure
+- `lib/`: Core logic.
+- `sig/`: RBS type signatures.
+- `test/`: Minitest suite.
+- `bin/`: Helper scripts.

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Thomas Tych
+
+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/README.md

@@ -0,0 +1,104 @@
+# ProcfsRb
+
+A Ruby interface for browsing and analyzing the Linux `/proc` filesystem.
+
+## Usage
+
+Once loaded, it provides ProcFS module.
+
+``` ruby
+require 'procfs_rb'
+
+procfs = ProcFS.new()
+
+# get cpuinfo
+cpuinfo = procfs.cpuinfo
+
+# get all sockets
+sockets = procfs.net.tcp.sockets
+
+```
+
+## ProcFS
+
+### Core
+
+* It is Virtual: /proc does not exist on disk. It is an interface to kernel data structures.
+* It is Generated on Read: Files do not "contain" static text. When a read() syscall occurs, the kernel executes a handler function that formats the current state into text on the fly.
+* No Cross-File Atomicity: Because each file is generated independently, reading multiple files sequentially does not guarantee a consistent point-in-time view. State may change between read 1 and read 2.
+
+### Node Abstractions
+
+
+| Node Type           | Filesystem Representation | Semantic Role                    | Interface Contract                                                                                          |
+|---------------------|---------------------------|----------------------------------|-------------------------------------------------------------------------------------------------------------|
+| Directory           | dr-xr-xr-x                | Logical grouping / Namespace.    | Yields a list of child nodes.                                                                               |
+| Observable File     | -r--r--r--                | Telemetry / State observation.   | Read-only. Returns a parsed, typed data structure.                                                          |
+| Control File        | -rw-r--r--                | Tunable parameter / Mutation.    | Read/Write. Getter returns current value; Setter applies new value and may return success/error.            |
+| Reference (Symlink) | lrwxrwxrwx                | Resolved relationship / Pointer. | Returns the target path (string) or resolves to the target object (e.g., resolving an FD to a socket/file). |
+
+
+### Implementation rules
+
+#### Rule 1: Explicit Snapshot Boundaries
+Because /proc files are generated on the fly, an interface method like get_process_info(pid) should ideally read all required files for that specific request in a single pass, package them into a single immutable struct (a "Snapshot"), and return it.
+
+Warning: Document clearly that even a single Snapshot is not strictly atomic across all kernel subsystems.
+
+#### Rule 2: Handle Volatility Gracefully (Lifecycle)
+Processes are born and die constantly.
+
+A PID listed in a directory scan may cease to exist before its files are read.
+The interface must treat ENOENT (No such file or directory) and ESRCH (No such process) not as fatal errors, but as expected lifecycle events (e.g., returning None, null, or throwing a specific ProcessVanishedException).
+
+#### Rule 3: Encapsulate Raw Parsing
+/proc files are notoriously difficult to parse reliably.
+
+Example: /proc/<pid>/stat is space-separated, but the second field (comm) is wrapped in parentheses and can contain spaces or closing parentheses itself.
+
+The interface must hide raw string parsing behind strongly-typed objects. Consumers should call process.get_memory_usage(), never parse_proc_pid_stat().
+
+#### Rule 4: Separate Observation from Mutation
+Do not mix read-only state getters with control setters in the same conceptual API surface without clear naming.
+
+Example: process.get_oom_score() (Observation) vs process.set_oom_score_adj(500) (Mutation).
+
+## Implementation
+
+
+
+## Installation
+
+Install the gem by executing:
+
+```bash
+gem install procfs_rb
+```
+
+Or add it to your Gemfile:
+
+```ruby
+gem 'procfs_rb'
+```
+
+## Usage
+
+```ruby
+require 'procfs_rb'
+
+# Your usage examples here
+```
+
+## Development
+
+Run `bin/setup` to install dependencies, `rake test` to run tests, and `bin/console` for an interactive prompt.
+
+To install locally: `bundle exec rake install`.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitLab. Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+
+require 'minitest/test_task'
+Minitest::TestTask.create
+
+require 'rubocop/rake_task'
+RuboCop::RakeTask.new
+
+require 'bump/tasks'
+
+task default: %i[test rubocop]

data/lib/procfs_rb/proc_fs/parser/net_tcp_parser.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require_relative 'parser_interface'
+require 'ipaddr'
+require_relative '../state/net_tcp'
+
+module ProcFS
+  module Parser
+    class NetTcpParser
+      DEFAULT_SOURCE = '/proc/net/tcp'
+
+      include ParserInterface
+
+      def parse(content, source: DEFAULT_SOURCE)
+        read_at = Time.now
+        lines = content.lines.drop(1) # Skip the header line
+
+        sockets = lines.map { |line| parse_socket_line(line) }.compact
+
+        State::NetTcp.new(
+          sockets: sockets,
+          timestamp: read_at,
+          source: source
+        )
+      end
+
+      private
+
+      def parse_socket_line(line)
+        parts = line.split
+        return nil if parts.empty?
+
+        local_ip, local_port = parse_address(parts[1])
+        remote_ip, remote_port = parse_address(parts[2])
+
+        tx_hex, rx_hex = parts[4].split(':')
+
+        State::TcpSocket.new(
+          local_address: local_ip,
+          local_port: local_port,
+          remote_address: remote_ip,
+          remote_port: remote_port,
+          connection_state: State::TcpSocket::STATES.fetch(parts[3], :unknown),
+          tx_queue: tx_hex.to_i(16),
+          rx_queue: rx_hex.to_i(16),
+          uid: parts[7].to_i,
+          inode: parts[9].to_i
+        )
+      end
+
+      # Parses "0100007F:0050" (little-endian IPv4 hex + port hex)
+      # into [IPAddr, Integer]
+      def parse_address(hex_addr)
+        ip_hex, port_hex = hex_addr.split(':')
+
+        # IPv4: 8 hex chars, stored in little-endian 32-bit
+        ip_int = ip_hex.to_i(16)
+        ip_bytes = [ip_int].pack('V').unpack('C4')
+        ip_string = ip_bytes.join('.')
+
+        [IPAddr.new(ip_string), port_hex.to_i(16)]
+      end
+    end
+  end
+end

data/lib/procfs_rb/proc_fs/parser/parser_interface.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module ProcFS
+  module Parser
+    module ParserInterface
+      def parse(content)
+        raise NotImplementedError, 'Parser should implement #parse(content)'
+      end
+    end
+  end
+end

data/lib/procfs_rb/proc_fs/proc_fs_root.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+DEFAULT_PROC_FS_ROOT = '/proc'
+
+module ProcFS
+  class ProcFSRoot
+    attr_reader :root_path
+
+    def initialize(root_path: DEFAULT_PROC_FS_ROOT)
+      @root_path = File.expand_path(root_path)
+    end
+  end
+end

data/lib/procfs_rb/proc_fs/state/net_tcp.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+require 'json'
+require_relative 'snapshot'
+require_relative 'timestamped'
+require_relative 'tcp_socket'
+
+module ProcFS
+  module State
+    class NetTcp
+      include Snapshot
+      include Timestamped
+      include Enumerable
+
+      MEMBERS = %i[sockets timestamp source].freeze
+
+      attr_reader(*MEMBERS)
+
+      def initialize(sockets:, timestamp: Time.now, source: '/proc/net/tcp')
+        @sockets   = sockets
+        @timestamp = timestamp
+        @source    = source
+        freeze
+      end
+
+      def members
+        MEMBERS
+      end
+
+      def to_h
+        members.to_h { |m| [m, send(m)] }
+      end
+
+      def with(**changes)
+        self.class.new(**to_h, **changes)
+      end
+
+      def ==(other)
+        other.is_a?(self.class) && to_h == other.to_h
+      end
+      alias eql? ==
+
+      def hash
+        [self.class, to_h].hash
+      end
+
+      def to_s
+        "TcpInfo(#{sockets.size} sockets @ #{timestamp.strftime('%H:%M:%S.%3N')})"
+      end
+
+      def inspect
+        "#<ProcFS::State::TcpInfo source=#{source.inspect} " \
+          "count=#{sockets.size} timestamp=#{timestamp.iso8601(3)}>"
+      end
+
+      def each(&)
+        sockets.each(&)
+      end
+
+      def listening
+        sockets.select(&:listening?)
+      end
+
+      def established
+        sockets.select(&:established?)
+      end
+
+      def closed
+        sockets.select(&:closed?)
+      end
+
+      def on_port(port)
+        sockets.select { |s| s.local_port == port || s.remote_port == port }
+      end
+
+      def bound_on(address)
+        addr = address.is_a?(IPAddr) ? address : IPAddr.new(address)
+        sockets.select { |s| s.local_address == addr }
+      end
+
+      def by_state(state)
+        sockets.select { |s| s.connection_state == state }
+      end
+
+      def empty?
+        sockets.empty?
+      end
+
+      def size
+        sockets.size
+      end
+    end
+  end
+end

data/lib/procfs_rb/proc_fs/state/snapshot.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module ProcFS
+  module State
+    module Snapshot
+      def snapshot?
+        true
+      end
+
+      def to_json(*)
+        to_h.to_json(*)
+      end
+    end
+  end
+end

data/lib/procfs_rb/proc_fs/state/tcp_socket.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+require 'ipaddr'
+require 'json'
+require_relative 'snapshot'
+
+module ProcFS
+  module State
+    class TcpSocket
+      include Snapshot
+
+      # TCP state constants (from linux/tcp_states.h)
+      STATES = {
+        '01' => :established,
+        '02' => :syn_sent,
+        '03' => :syn_recv,
+        '04' => :fin_wait1,
+        '05' => :fin_wait2,
+        '06' => :time_wait,
+        '07' => :close,
+        '08' => :close_wait,
+        '09' => :last_ack,
+        '0A' => :listen,
+        '0B' => :closing
+      }.freeze
+
+      MEMBERS = %i[
+        local_address local_port
+        remote_address remote_port
+        connection_state
+        tx_queue rx_queue
+        uid inode
+      ].freeze
+
+      attr_reader(*MEMBERS)
+
+      def initialize(local_address:, local_port:, remote_address:, remote_port:,
+                     connection_state:, tx_queue:, rx_queue:, uid:, inode:)
+        @local_address    = local_address
+        @local_port       = local_port
+        @remote_address   = remote_address
+        @remote_port      = remote_port
+        @connection_state = connection_state
+        @tx_queue         = tx_queue
+        @rx_queue         = rx_queue
+        @uid              = uid
+        @inode            = inode
+
+        freeze
+      end
+
+      # --- Value semantics ---
+
+      def members
+        MEMBERS
+      end
+
+      def to_h
+        members.to_h { |m| [m, send(m)] }
+      end
+
+      def with(**changes)
+        self.class.new(**to_h, **changes)
+      end
+
+      def ==(other)
+        other.is_a?(self.class) && to_h == other.to_h
+      end
+      alias eql? ==
+
+      def hash
+        [self.class, to_h].hash
+      end
+
+      def to_s
+        "#{local_address}:#{local_port} -> #{remote_address}:#{remote_port} [#{connection_state}]"
+      end
+
+      def inspect
+        "#<ProcFS::State::TcpSocket #{self} tx=#{tx_queue} rx=#{rx_queue} uid=#{uid} inode=#{inode}>"
+      end
+
+      def listening?
+        connection_state == :listen
+      end
+
+      def established?
+        connection_state == :established
+      end
+
+      def closed?
+        %i[close time_wait close_wait last_ack closing].include?(connection_state)
+      end
+
+      def ipv4?
+        local_address.ipv4?
+      end
+
+      def ipv6?
+        local_address.ipv6?
+      end
+
+      def local_endpoint
+        "#{local_address}:#{local_port}"
+      end
+
+      def remote_endpoint
+        "#{remote_address}:#{remote_port}"
+      end
+    end
+  end
+end

data/lib/procfs_rb/proc_fs/state/timestamped.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module ProcFS
+  module State
+    module Timestamped
+      def age
+        Time.now - timestamp
+      end
+
+      def recent?(within_seconds: 5)
+        age < within_seconds
+      end
+
+      def stale?(after_seconds: 60)
+        age > after_seconds
+      end
+    end
+  end
+end

data/lib/procfs_rb/proc_fs.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require_relative 'proc_fs/proc_fs_root'
+
+module ProcFS
+  def new(**)
+    ProcFSRoot.new(**)
+  end
+end

data/lib/procfs_rb/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module ProcfsRb
+  VERSION = '0.1.0'
+end

data/lib/procfs_rb.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative 'procfs_rb/version'
+
+require_relative 'procfs_rb/proc_fs'
+
+module ProcfsRb
+end

data/sig/procfs_rb.rbs

@@ -0,0 +1,4 @@
+module ProcfsRb
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,231 @@
+--- !ruby/object:Gem::Specification
+name: procfs_rb
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Thomas Tych
+bindir: exe
+cert_chain: []
+date: 1980-01-02 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.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.0.21
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.0.21
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: irb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.18'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 6.0.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 6.0.6
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 13.4.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 13.4.2
+- !ruby/object:Gem::Dependency
+  name: reek
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.5'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.91'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.91'
+- !ruby/object:Gem::Dependency
+  name: rubocop-minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.40.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.40.0
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+email:
+- thomas.tych@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".opencode.json"
+- AGENTS.md
+- CONTRIBUTING.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/procfs_rb.rb
+- lib/procfs_rb/proc_fs.rb
+- lib/procfs_rb/proc_fs/parser/net_tcp_parser.rb
+- lib/procfs_rb/proc_fs/parser/parser_interface.rb
+- lib/procfs_rb/proc_fs/proc_fs_root.rb
+- lib/procfs_rb/proc_fs/state/net_tcp.rb
+- lib/procfs_rb/proc_fs/state/snapshot.rb
+- lib/procfs_rb/proc_fs/state/tcp_socket.rb
+- lib/procfs_rb/proc_fs/state/timestamped.rb
+- lib/procfs_rb/version.rb
+- sig/procfs_rb.rbs
+homepage: https://gitlab.com/ttych/procfs_rb
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://gitlab.com/ttych/procfs_rb
+  source_code_uri: https://gitlab.com/ttych/procfs_rb
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.21
+specification_version: 4
+summary: ProcFS interface.
+test_files: []