vault_coh 4.0.0 → 5.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: efcd317fb3639ebb84a7fcb11f7d3b513422211d1c2b87f3e564ce4ddbf78f74
-  data.tar.gz: c52abcfeceab7cafcb94f15e93dad181afb600bc8bbbb29e0ebf8ea0ebe61c33
+  metadata.gz: 7c619172a3ef03297101f59e93f97fabc3fe657c4fc4901626440997dd63f5de
+  data.tar.gz: 2ec4cf367060108ba2ef4f2602b3216fc7dd7bf2aa50c0060cfee0d915734692
 SHA512:
-  metadata.gz: 866f6b1d80b16c5a006d0f3878202225c26b08138e088c24b31990e71a698a137e5f04bc58992dd038826939dacc75f356409566c0b358a637315ebe3309e789
-  data.tar.gz: a5d2d75254cbeb6bdc05b23fb0adec01d9df3c379d8b862be8b4e8568f56d56eb349255b1cf4b49bd68ff76202366b7ccd22eb445abf65576cabacb2126a1a55
+  metadata.gz: 12794b3709c6897ae31912f8c8c9e510f181354393c65f6d3e94ef38a1243e167c9ccd2b7c8deb5400f68c6138cfc05766a02dcf7440744af828675c08092305
+  data.tar.gz: 0406cfd5802162ce6f3cd90c2ad2fc2fd65ec1abef19d91d20413d2f12a527ae1438e5f9c73e86dd1da44ef5a429d688a84786c4fad77d59ae6627fa5a25470e

data/Cargo.lock

@@ -322,9 +322,9 @@ checksum = "24188a676b6ae68c3b2cb3a01be17fbf7240ce009799bb56d5b1409051e78fde"
 
 [[package]]
 name = "shlex"
-version = "1.2.0"
+version = "1.3.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a7cee0529a6d40f580e7a5e6c495c8fbfe21b7b52795ed4bb5e62cdf92bc6380"
+checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"
 
 [[package]]
 name = "syn"
@@ -360,11 +360,20 @@ version = "1.0.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "3354b9ac3fae1ff6755cb6db53683adb661634f67557942dea4facebec0fee4b"
 
+[[package]]
+name = "uuid"
+version = "1.7.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f00cc9702ca12d3c81455259621e676d0f7251cec66a21e98fe2e9a37db93b2a"
+dependencies = [
+ "serde",
+]
+
 [[package]]
 name = "vault"
-version = "7.0.0"
+version = "8.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c883ce2ee65509850bbf77b935dac0d6876392de077138650de1f5d109381bd8"
+checksum = "401c25d59ac1ca36a13d384627e8e86b425524f08f69d9eace9b4aa45ddcd88a"
 dependencies = [
  "byteorder",
  "magnus",
@@ -372,6 +381,7 @@ dependencies = [
  "nom-tracable",
  "nom_locate",
  "serde",
+ "uuid",
 ]
 
 [[package]]

data/Gemfile

@@ -10,6 +10,6 @@ gem 'rake', '~> 13.0'
 gem 'rake-compiler'
 gem 'rb_sys'
 
-gem 'rspec', '~> 3.0'
+gem 'rspec', '~> 3.13'
 
-gem 'rubocop', '~> 1.59'
+gem 'rubocop', '~> 1.60'

data/Gemfile.lock

@@ -1,45 +1,45 @@
 PATH
   remote: .
   specs:
-    vault_coh (4.0.0)
+    vault_coh (5.0.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.2)
-    diff-lcs (1.5.0)
+    diff-lcs (1.5.1)
     json (2.7.1)
     language_server-protocol (3.17.0.3)
     parallel (1.24.0)
-    parser (3.3.0.3)
+    parser (3.3.0.5)
       ast (~> 2.4.1)
       racc
     racc (1.7.3)
     rainbow (3.1.1)
     rake (13.1.0)
-    rake-compiler (1.2.5)
+    rake-compiler (1.2.7)
       rake
-    rb_sys (0.9.86)
+    rb_sys (0.9.87)
     regexp_parser (2.9.0)
     rexml (3.2.6)
-    rspec (3.12.0)
-      rspec-core (~> 3.12.0)
-      rspec-expectations (~> 3.12.0)
-      rspec-mocks (~> 3.12.0)
-    rspec-core (3.12.2)
-      rspec-support (~> 3.12.0)
-    rspec-expectations (3.12.3)
+    rspec (3.13.0)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.0)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
-    rspec-mocks (3.12.6)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
-    rspec-support (3.12.1)
-    rubocop (1.59.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.0)
+    rubocop (1.60.2)
       json (~> 2.3)
       language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
-      parser (>= 3.2.2.4)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
@@ -59,8 +59,8 @@ DEPENDENCIES
   rake (~> 13.0)
   rake-compiler
   rb_sys
-  rspec (~> 3.0)
-  rubocop (~> 1.59)
+  rspec (~> 3.13)
+  rubocop (~> 1.60)
   vault_coh!
 
 BUNDLED WITH

data/README.md

@@ -1,6 +1,6 @@
 # Vault
 
-[![Gem Version](https://badge.fury.io/rb/vault_coh.svg)](https://badge.fury.io/rb/vault_coh) [![Documentation](https://img.shields.io/badge/View-Documentation-blue.svg)](https://rubydoc.info/github/ryantaylor/vault-rb/v4.0.0)
+[![Gem Version](https://badge.fury.io/rb/vault_coh.svg)](https://badge.fury.io/rb/vault_coh) [![Documentation](https://img.shields.io/badge/View-Documentation-blue.svg)](https://rubydoc.info/github/ryantaylor/vault-rb/v5.0.0)
 
 A native Ruby client wrapper for the [vault](https://github.com/ryantaylor/vault) Company of Heroes replay parser, integrated via a Rust native extension.
 
@@ -24,7 +24,7 @@ bytes = File.read('/path/to/replay.rec').unpack('C*')
 replay = VaultCoh::Replay.from_bytes(bytes)
 puts replay.version
 ```
-All information available from parsing can be found in the [documentation](https://rubydoc.info/github/ryantaylor/vault-rb/v4.0.0).
+All information available from parsing can be found in the [documentation](https://rubydoc.info/github/ryantaylor/vault-rb/v5.0.0).
 
 ## Contributing
 

data/ext/vault_coh/Cargo.toml

@@ -12,4 +12,4 @@ crate-type = ["cdylib"]
 [dependencies]
 magnus = { version = "0.6" }
 serde_magnus = { version = "0.8" }
-vault = { version = "7", features = ["magnus", "serde"] }
+vault = { version = "8", features = ["magnus", "serde"] }

data/ext/vault_coh/src/lib.rs

@@ -6,7 +6,7 @@ use vault::commands::{
     BuildGlobalUpgrade, BuildSquad, SelectBattlegroup, SelectBattlegroupAbility, Unknown,
     UseBattlegroupAbility,
 };
-use vault::{Command, Faction, Map, Message, Player, Replay, Team};
+use vault::{Command, Map, Message, Player, Replay};
 
 #[magnus::init]
 fn init() -> Result<(), Error> {
@@ -16,7 +16,9 @@ fn init() -> Result<(), Error> {
     replay.define_singleton_method("from_bytes", function!(from_bytes, 1))?;
     replay.define_method("version", method!(Replay::version, 0))?;
     replay.define_method("timestamp", method!(Replay::timestamp, 0))?;
+    replay.define_method("game_type", method!(game_type_string, 0))?;
     replay.define_method("matchhistory_id", method!(Replay::matchhistory_id, 0))?;
+    replay.define_method("mod_uuid", method!(mod_uuid_string, 0))?;
     replay.define_method("map", method!(Replay::map, 0))?;
     replay.define_method("map_filename", method!(Replay::map_filename, 0))?;
     replay.define_method(
@@ -43,8 +45,8 @@ fn init() -> Result<(), Error> {
     let player = module.define_class("Player", class::object())?;
     player.define_method("name", method!(Player::name, 0))?;
     player.define_method("human?", method!(Player::human, 0))?;
-    player.define_method("faction", method!(Player::faction, 0))?;
-    player.define_method("team", method!(Player::team, 0))?;
+    player.define_method("faction", method!(faction_string, 0))?;
+    player.define_method("team", method!(team_value, 0))?;
     player.define_method("battlegroup", method!(Player::battlegroup, 0))?;
     player.define_method("steam_id", method!(Player::steam_id, 0))?;
     player.define_method("profile_id", method!(Player::profile_id, 0))?;
@@ -62,12 +64,6 @@ fn init() -> Result<(), Error> {
     message.define_method("message", method!(Message::message, 0))?;
     message.define_method("to_h", method!(Message::to_h, 0))?;
 
-    let faction = module.define_class("Faction", class::object())?;
-    faction.define_method("value", method!(Faction::to_string, 0))?;
-
-    let team = module.define_class("Team", class::object())?;
-    team.define_method("value", method!(Team::value, 0))?;
-
     let command = module.define_class("Command", class::object())?;
     command.define_method("to_h", method!(Command::to_h, 0))?;
 
@@ -144,3 +140,19 @@ fn from_bytes(input: Vec<u8>) -> Result<Replay, Error> {
     Replay::from_bytes(&input)
         .map_err(|err| Error::new(exception::runtime_error(), err.to_string()))
 }
+
+fn mod_uuid_string(rb_self: &Replay) -> String {
+    rb_self.mod_uuid().to_string()
+}
+
+fn game_type_string(rb_self: &Replay) -> String {
+    rb_self.game_type().to_string()
+}
+
+fn faction_string(rb_self: &Player) -> String {
+    rb_self.faction().to_string()
+}
+
+fn team_value(rb_self: &Player) -> usize {
+    rb_self.team().value()
+}

data/lib/vault_coh/faction.rb

@@ -3,16 +3,9 @@
 module VaultCoh
   # Identifiers for the Company of Heroes 3 factions.
   class Faction
-    AMERICANS = 'Americans'
-    BRITISH = 'British'
-    WEHRMACHT = 'Wehrmacht'
-    AFRIKAKORPS = 'AfrikaKorps'
-
-    # String identifier of the given faction.
-    #
-    # @see https://docs.rs/vault/3.0.0/vault/enum.Faction.html
-    #
-    # @return [AMERICANS|BRITISH|WEHRMACHT|AFRIKAKORPS]
-    def value; end
+    AMERICANS = 'americans'
+    BRITISH = 'british_africa'
+    WEHRMACHT = 'germans'
+    AFRIKAKORPS = 'afrika_korps'
   end
 end

data/lib/vault_coh/game_type.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module VaultCoh
+  # Identifiers for the Company of Heroes 3 game types.
+  class GameType
+    SKIRMISH = 'skirmish'
+    MULTIPLAYER = 'multiplayer'
+    AUTOMATCH = 'automatch'
+    CUSTOM = 'custom'
+  end
+end

data/lib/vault_coh/player.rb

@@ -20,13 +20,13 @@ module VaultCoh
 
     # The faction selected by the player in this match.
     #
-    # @return [Faction]
+    # @return [Faction::AMERICANS|Faction::WEHRMACHT|Faction::BRITISH|Faction::AFRIKAKORPS]
     def faction; end
 
     # The team the player was assigned to. Currently only head-to-head
     # matchups are supported (max two teams).
     #
-    # @return [Team]
+    # @return [Team::FIRST|Team::SECOND]
     def team; end
 
     # The pbgid of the battlegroup the player selected, or +nil+ if no

data/lib/vault_coh/replay.rb

@@ -40,14 +40,34 @@ module VaultCoh
     # @return [String]
     def timestamp; end
 
+    # The type of game this replay represents. Note that this information
+    # is parsed on a best-effort basis and therefore may not always be
+    # correct. Also note that it's currently not known if there's a way to
+    # differentiate between automatch and custom games for replays recorded
+    # before the replay system release in patch 1.4.0. Games played before
+    # that patch will be marked as either +skirmish+ (for local AI games) or
+    # +multiplayer+ (for networked custom or automatch games). Games recorded
+    # on or after patch 1.4.0 will properly differentiate between +custom+
+    # and +automatch+ games.
+    #
+    # @return [GameType::SKIRMISH|GameType::MULTIPLAYER|GameType::AUTOMATCH|GameType::CUSTOM]
+    def game_type; end
+
     # The ID used by Relic to track this match on their internal servers.
     # This ID can be matched with an ID of the same name returned by
     # Relic’s CoH3 stats API, enabling linkage between replay files and
-    # statistical information for a match.
+    # statistical information for a match. When the game type is +skirmish+,
+    # there is no ID assigned by Relic, so this will be +nil+.
     #
-    # @return [Integer] unsigned, 64 bits
+    # @return [Integer|NilClass] unsigned, 64 bits
     def matchhistory_id; end
 
+    # The UUID of the base game mod this replay ran on. If no mod was used,
+    # this will be a nil UUID (all zeroes).
+    #
+    # @return [String]
+    def mod_uuid; end
+
     # Map information for this match.
     #
     # @return [Map]

data/lib/vault_coh/team.rb

@@ -5,12 +5,5 @@ module VaultCoh
   class Team
     FIRST = 0
     SECOND = 1
-
-    # Integer representation of the assigned team.
-    #
-    # @see https://docs.rs/vault/3.0.0/vault/enum.Team.html
-    #
-    # @return [FIRST|SECOND]
-    def value; end
   end
 end

data/lib/vault_coh/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module VaultCoh
-  VERSION = '4.0.0'
+  VERSION = '5.0.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vault_coh
 version: !ruby/object:Gem::Version
-  version: 4.0.0
+  version: 5.0.0
 platform: ruby
 authors:
 - ryantaylor
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-01-21 00:00:00.000000000 Z
+date: 2024-02-12 00:00:00.000000000 Z
 dependencies: []
 description: Company of Heroes replay parsing in Ruby using the vault parsing library
   via a Rust native extension.
@@ -50,6 +50,7 @@ files:
 - lib/vault_coh/commands/use_battlegroup_ability.rb
 - lib/vault_coh/commands/use_battlegroup_ability_command.rb
 - lib/vault_coh/faction.rb
+- lib/vault_coh/game_type.rb
 - lib/vault_coh/map.rb
 - lib/vault_coh/message.rb
 - lib/vault_coh/player.rb