ps2_bios_checksum 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b5d3087cb82469861642c7132c6f5f3467bf1dd9b5d89588ec08a49a3a5687bc
+  data.tar.gz: 3f33b1558d09f0a684adba46fc38ecb0b207949c08c1510a1849e08b654b0ff1
+SHA512:
+  metadata.gz: 2351f0cc0d6ab6f43d60913beea0740bab1a0d48774a0f660e990a7324c93116ed3e693f78b6c2fc7fab7fff088e8d9e5ca1d277e58cb9a888106cfd62b84b6d
+  data.tar.gz: a17cd583464a6207f290f9a46845cd0e8efeadaff9121ae1877de50d88e4c224a03757cf9bac95c3f948e1ffe1e6a746246476b860985be82917310a944f39ab

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AllPS2BIOS
+
+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,28 @@
+# ps2_bios_checksum (RubyGems)
+
+Ruby helpers for inspecting a local PS2 BIOS dump: MD5, SHA-1, and basic dump-size checks.
+
+Does **not** include or download BIOS files.
+
+## Install
+
+```bash
+gem install ps2_bios_checksum
+```
+
+## Usage
+
+```ruby
+require "ps2_bios_checksum"
+
+result = Ps2BiosChecksum.hash_file("SCPH-70000.bin")
+puts "#{result[:md5]} #{result[:validation][:summary]}"
+```
+
+## Docs
+
+RetroArch PS2 BIOS notes: [https://allps2bios.com/ps2-bios-retroarch/](https://allps2bios.com/ps2-bios-retroarch/)
+
+## License
+
+MIT

data/lib/ps2_bios_checksum.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Ps2BiosChecksum
+  COMMON_BIOS_SIZES = [
+    2 * 1024 * 1024,
+    4 * 1024 * 1024,
+    8 * 1024 * 1024,
+    16 * 1024 * 1024
+  ].freeze
+
+  module_function
+
+  def format_file_size(bytes)
+    return "#{bytes} B" if bytes < 1024
+
+    kib = bytes / 1024.0
+    return format("%.2f KB", kib) if kib < 1024
+
+    format("%.2f MB", kib / 1024.0)
+  end
+
+  def validate_bios_size(size_bytes)
+    if size_bytes <= 0
+      return {
+        ok: false,
+        summary: "File is empty",
+        detail: "An empty file cannot be used as a BIOS image. Basic check only."
+      }
+    end
+
+    if COMMON_BIOS_SIZES.include?(size_bytes)
+      return {
+        ok: true,
+        summary: "Basic checks passed",
+        detail: "Size matches a commonly reported PS2 BIOS dump size. Not proof of authenticity."
+      }
+    end
+
+    {
+      ok: false,
+      summary: "File size does not match common BIOS sizes",
+      detail: "Common sizes are 2, 4, 8, or 16 MiB. Unexpected size may mean incomplete or non-BIOS data."
+    }
+  end
+
+  def hash_bytes(data, path: nil)
+    require "digest"
+    bytes = data.b
+    {
+      size_bytes: bytes.bytesize,
+      md5: Digest::MD5.hexdigest(bytes),
+      sha1: Digest::SHA1.hexdigest(bytes),
+      validation: validate_bios_size(bytes.bytesize),
+      path: path
+    }
+  end
+
+  def hash_file(path)
+    hash_bytes(File.binread(path), path: path)
+  end
+end

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: ps2_bios_checksum
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- AllPS2BIOS
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-09-24 00:00:00.000000000 Z
+dependencies: []
+description: Hash a local PS2 BIOS dump and run basic dump-size checks. Does not include
+  BIOS files.
+email:
+- support@allps2bios.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/ps2_bios_checksum.rb
+homepage: https://allps2bios.com/ps2-bios-retroarch/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://allps2bios.com/ps2-bios-retroarch/
+  source_code_uri: https://github.com/nbkdevs/ps2-bios-assistant
+  changelog_uri: https://github.com/nbkdevs/ps2-bios-assistant
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: Local PS2 BIOS checksum helpers (MD5, SHA-1, size checks).
+test_files: []