nmspec 1.5.1.pre → 1.6.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 90d3113e482e5bdc15f3a5043de7db0acacb0ee669600214b7dd4f450fad5b69
-  data.tar.gz: 63824be872579cff6a615eb68898a9799c1d7849b0b624f46a968c199d671a15
+  metadata.gz: 128d25a1fb4afa4687bfe7e3808fac4f0be06587be012781272cc94f13d61743
+  data.tar.gz: '0086e7f406eed250a55bea6c58829b09800aafd8b3d2c1a144e773156c06de03'
 SHA512:
-  metadata.gz: 1d6643f500fa0e5a057d1b3cc2cc0b2d601fcbed9ad3a0efbc1f2e6c85335b23d54894857778a9e2bcbcf80b4493d14ac05e5678c9bb5e9b6504920acf3b2547
-  data.tar.gz: 7c9a03a9d47d1625fbc34341086c50f5ac0f4c15a8228c69101b569b49e8daeda8af2ae27187c9611c2b726c7355bcebed7fcb1da50d21d8ccea9281d74b2052
+  metadata.gz: 62752a73c1dea7cc4766ea0c46f747574aec876ab176190699ef9f2ab551b43129a615ae0d9211fd34a5f0a721047df305567a8003154a4a1166728db8fb39bd
+  data.tar.gz: 004d417ad7440f191fcc99d480a891e419380ad21ef21aa3b19e442d2187a04bb2f3ea08fbd7139890319d8b484cb0aa0a3d24bd30aafde7dffa961a03d6d796

data/README.md

@@ -12,6 +12,12 @@ described in `nmspec` are used to create both the reading and writing sides
 of the connection, so that a single source code file contains everything you
 need for a network peer, regardless of if it's the client or server.
 
+## Demo video explaining how to use this gem
+
+<a href="https://youtu.be/Ib6c6BEl82c">
+  <img src="https://s3.us-east-2.amazonaws.com/vim4evar.com/nmspec-imgs/link-to-demo-video.png" />
+</a>
+
 ## Motivation
 
 `nmspec` was specifically created to help with with a problem I was facing,
@@ -48,8 +54,8 @@ As a starting point this gem supports network messengers in these two languages:
 * [Ruby 3.0.x][ruby-lang]
 * [GDScript 3.4.stable][gdscript]
 
-`nmspec` came out of a online game project where the backend was written in
-Ruby, and the frontend build with the Godot game engine, which includes the
+`nmspec` came out of a online game project where the backend is written in
+Ruby, and the frontend is built with the Godot game engine, which includes the
 embedded scripting language, GDSCript.
 
 # Sample usage
@@ -283,7 +289,7 @@ description languages/tools in the past, beginning with [Prolac][prolac]. This
 lead me to other network messaging tools, binary serialization in general,
 finally [Google's protocol buffers][protobuffs]. Protocol buffers were probably
 the closest thing to what I wanted, and took care of binary
-serialization/deserialization, but weren't packaaged with the networking layer,
+serialization/deserialization, but weren't packaged with the networking layer,
 which introduces additional considerations such as byte ordering, efficient
 packet construction, TCP stack options, and communication retries and graceful
 failover. While protocol buffers are a good design, and I think do a good job of

data/lib/nmspec/gdscript.rb

@@ -14,7 +14,7 @@ module Nmspec
 
         if spec.dig(:msgr, :desc)
           code << '#'
-          code << "# #{spec.dig(:msgr, :desc)}"
+          spec.dig(:msgr, :desc).lines.each{|l| code << "# #{l.strip}" }
         end
 
         code << 'extends Reference'
@@ -52,8 +52,6 @@ module Nmspec
 
         subtypes = spec[:types].select{|t| !t[:base_type].nil? }
         code << _protos_methods(spec[:protos], subtypes)
-
-        code.join("\n")
       rescue => e
         "Code generation failed due to unknown error: check spec validity\n  cause: #{e.inspect}"
         puts e.backtrace.join("\n  ")
@@ -288,6 +286,7 @@ module Nmspec
           ##
           # send
           code << _proto_method('send', proto_code, proto, send_local_vars, send_passed_params, subtypes)
+          code << "\n"
           code << _proto_method('recv', proto_code, proto, recv_local_vars, recv_passed_params, subtypes)
         end
 
@@ -323,7 +322,7 @@ module Nmspec
       def _proto_method(kind, proto_code, proto, local_vars, passed_params, subtypes)
         code = []
 
-        code << "# #{proto[:desc]}" if proto[:desc]
+        proto[:desc].lines.each{|l| code << "# #{l.strip}" } if proto[:desc]
         unless local_vars.empty?
           code << '#'
           code << '# returns:  (type | local var name)'

data/lib/nmspec/ruby.rb

@@ -14,8 +14,8 @@ module Nmspec
         code << '# NOTE: this code is auto-generated from an nmspec file'
 
         if spec.dig(:msgr, :desc)
-          code << '#'
-          code << "# #{spec.dig(:msgr, :desc)}"
+          code << '##'
+          spec.dig(:msgr, :desc).lines.each{|l| code << "# #{l.strip}" }
         end
 
         code << "class #{_class_name_from_msgr_name(spec.dig(:msgr, :name))}"
@@ -27,6 +27,8 @@ module Nmspec
 
         code << _initialize
         code << ''
+        code << _open?
+        code << ''
         code << _close
         code << ''
         code << _bool_type
@@ -77,18 +79,32 @@ module Nmspec
 
         code << '  def initialize(socket, no_delay=false)'
         code << '    @socket = socket'
+        code << '    @open = true'
         code << '    @socket.setsockopt(Socket::IPPROTO_TCP, Socket::TCP_NODELAY, 1) if no_delay'
         code << '  end'
 
         code
       end
 
+      def _open?
+        code = []
+
+        code << '  ##'
+        code << '  # closes the socket inside this object'
+        code << '  def open?'
+        code << '    !!(@socket && @open)'
+        code << '  end'
+
+        code
+      end
+
       def _close
         code = []
 
         code << '  ##'
         code << '  # closes the socket inside this object'
         code << '  def close'
+        code << '    @open = false'
         code << '    @socket&.close'
         code << '  end'
 
@@ -356,7 +372,8 @@ module Nmspec
       def _proto_method(kind, proto_code, proto, local_vars, passed_params)
         code = []
 
-        code << "  # #{proto[:desc]}" if proto[:desc]
+        proto[:desc].lines.each{|l| code << "  # #{l.strip}" } if proto[:desc]
+
         unless local_vars.empty?
           code << '  #'
           code << '  # returns:  (type | local var name)'

data/lib/nmspec/version.rb

@@ -1 +1 @@
-NMSPEC_GEM_VERSION = '1.5.1.pre'
+NMSPEC_GEM_VERSION = '1.6.2'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nmspec
 version: !ruby/object:Gem::Version
-  version: 1.5.1.pre
+  version: 1.6.2
 platform: ruby
 authors:
 - Jeff Lunt
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-01-30 00:00:00.000000000 Z
+date: 2022-06-12 00:00:00.000000000 Z
 dependencies: []
 description: nmspec makes it easier to describe binary messages between two network
   peers via a config file, generate their network code in a number of languages, and
@@ -43,9 +43,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubygems_version: 3.2.32
 signing_key: