nodo 1.6.3 → 1.6.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 42cd6c0e3e07674ceb2f10dd670c490b7f23ed6534f22f978a40e0b91d529570
-  data.tar.gz: b560df0c25e2b72842e6d6d5be610503252069bfd1741fb2cd9228066d28f91e
+  metadata.gz: 85e8ece889660e457a3473919da402124d9688011c3dbe5f69015e9f5e258465
+  data.tar.gz: 32ed8d2c1905c22cc68cf2734272f0d743890be066add8ce8de1a72132c6c3f4
 SHA512:
-  metadata.gz: 012ed2197c0ea3e519884b3295a62986158326027adb08c484fbf87903874763594fe72236bebcc01f47a919a4893ef92cdc7a14b1f8ad02da7ea527ae5eab38
-  data.tar.gz: 6a953be3a789671c966248dcc385740c5964ad0bbb370411d93cdc44ee7ea129c14537d73c08e7a44eb4c19ca1bc2b5465873bec65fd4d56884ba9ed339981d6
+  metadata.gz: 1c6a6af11b36730dae8bc00d31a17a96f0fbe0fe3a5ddc3da5df636efcdc648a6890e37aee63c7f0b67fc000ce354247eaa61cde12557eb9a3126b6cd0d9a291
+  data.tar.gz: b12074e9a1312694fcb46246eb2d66d418054b3f518be6dc5b2469a908b8b7e35d55d4a30b77144005b2b898c193ed062473ee4916239022c9d32361a5e324c4

data/README.md

@@ -1,4 +1,4 @@
-[![Gem Version](https://badge.fury.io/rb/nodo.svg)](http://badge.fury.io/rb/nodo)
+[![Gem Version](https://badge.fury.io/rb/nodo.svg)](https://badge.fury.io/rb/nodo)
 [![build](https://github.com/mtgrosser/nodo/actions/workflows/build.yml/badge.svg)](https://github.com/mtgrosser/nodo/actions/workflows/build.yml)
 
 # Nōdo – call Node.js from Ruby
@@ -54,6 +54,26 @@ foo.say_hi('Nodo')
 => "Hello Nodo!"
 ```
 
+JS code can also be supplied using the `code:` keyword argument:
+
+```ruby
+function :hello, code: "() => 'world'"
+```
+
+### Async functions
+
+`Nodo` supports calling `async` functions from Ruby.
+The Ruby call will happen synchronously, i.e. it will block until the JS
+function resolves:
+
+```ruby
+class SyncFoo < Nodo::Core
+  function :do_something, <<~JS
+    async () => { return await asyncFunc(); }
+  JS
+end
+```
+
 ### Using npm modules
 
 Install your modules to `node_modules`:
@@ -79,7 +99,6 @@ bar = Bar.new
 bar.v4 => "b305f5c4-db9a-4504-b0c3-4e097a5ec8b9"
 ```
 
-
 ### Aliasing requires
 
 If the library name cannot be used as name of the constant, the `const` name
@@ -91,24 +110,22 @@ class FooBar < Nodo::Core
 end
 ```
 
-### Alternate function definition syntax
+### Dynamic ESM imports
 
-JS code can also be supplied using the `code:` keyword argument:
+ES modules can be imported dynamically using `nodo.import()`:
 
 ```ruby
-function :hello, code: "() => 'world'"
-```
-
-### Setting NODE_PATH
-
-By default, `./node_modules` is used as the `NODE_PATH`.
-
-To set a custom path:
-```ruby
-Nodo.modules_root = 'path/to/node_modules'
+class DynamicFoo < Nodo::Core
+  function :v4, <<~JS
+    async () => {
+      const uuid = await nodo.import('uuid');
+      return await uuid.v4()
+    }
+  JS
+end
 ```
 
-Also see: [Clean your Rails root](#Clean-your-Rails-root)
+Note that the availability of dynamic imports depends on your Node version.
 
 ### Defining JS constants
 
@@ -171,20 +188,6 @@ SubFoo.new.bar => "callingsuperclass"
 SubSubFoo.new.bar => "callingsubsubclass"
 ```
 
-### Async functions
-
-`Nodo` supports calling `async` functions from Ruby. 
-The Ruby call will happen synchronously, i.e. it will block until the JS
-function resolves:
-
-```ruby
-class SyncFoo < Nodo::Core
-  function :do_something, <<~JS
-    async () => { return await asyncFunc(); }
-  JS
-end
-```
-
 ### Deferred function definition
 
 By default, the function code string literal is created when the class
@@ -241,6 +244,17 @@ Foo.new.sleep(2)
 =>  Nodo::TimeoutError raised
 ```
 
+### Setting NODE_PATH
+
+By default, `./node_modules` is used as the `NODE_PATH`.
+
+To set a custom path:
+```ruby
+Nodo.modules_root = 'path/to/node_modules'
+```
+
+Also see: [Clean your Rails root](#Clean-your-Rails-root)
+
 ### Logging
 
 By default, JS errors will be logged to `STDOUT`.
@@ -253,7 +267,6 @@ Nodo.logger = Logger.new('nodo.log')
 
 In Rails applications, `Rails.logger` will automatically be set.
 
-
 ### Debugging
 
 To get verbose debug output, set
@@ -339,3 +352,15 @@ With this new default, all `yarn` operations should be done after `cd`ing to `ve
 
 This repo provides an [adapted version](https://github.com/mtgrosser/nodo/blob/master/install/yarn.rake)
 of the `yarn:install` rake task which will automatically take care of the vendored module location.
+
+
+## Working with web mocking frameworks like WebMock
+
+Nodo uses HTTP via UNIX sockets to connect to its Node process. This may lead to
+conflicts during tests when using `WebMock` or other tools which interfere with
+`Net::HTTP`. In order to work with WebMock, you need to enable its `allow_localhost`
+option:
+
+```ruby
+WebMock.disable_net_connect!(allow_localhost: true)
+```

data/lib/nodo/core.rb

@@ -221,7 +221,7 @@ module Nodo
       socket = nil
       while Time.now - start < LAUNCH_TIMEOUT
         begin
-          break if socket = UNIXSocket.new(socket_path)
+          break if socket = UNIXSocket.new(socket_path.to_s)
         rescue Errno::ENOENT, Errno::ECONNREFUSED, Errno::ENOTDIR
           Kernel.sleep(0.2)
         end

data/lib/nodo/nodo.js

@@ -9,7 +9,7 @@ module.exports = (function() {
   const path = require('path');
   const fs = require('fs');
   const performance = require('perf_hooks').performance;
-  
+
   let server, closing;
   const classes = {};
   const contexts = {};
@@ -48,7 +48,11 @@ module.exports = (function() {
       console.log(`[Nodo] ${message}`);
     }
   }
-  
+
+  async function import_module(specifier) {
+    return await import(specifier);
+  }
+
   const core = {
     run: (socket) => {
       debug('Starting up...');
@@ -135,5 +139,5 @@ module.exports = (function() {
     }
   };
   
-  return { core: core, debug: debug };
+  return { core: core, debug: debug, import: import_module };
 })();

data/lib/nodo/version.rb

@@ -1,3 +1,3 @@
 module Nodo
-  VERSION = '1.6.3'
+  VERSION = '1.6.5'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nodo
 version: !ruby/object:Gem::Version
-  version: 1.6.3
+  version: 1.6.5
 platform: ruby
 authors:
 - Matthias Grosser
@@ -11,56 +11,56 @@ cert_chain: []
 date: 2021-10-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  name: bundler
   prerelease: false
+  type: :development
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  name: rake
   prerelease: false
+  type: :development
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: byebug
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  name: byebug
   prerelease: false
+  type: :development
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  name: minitest
   prerelease: false
+  type: :development
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -105,7 +105,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
+rubygems_version: 3.3.25
 signing_key:
 specification_version: 4
 summary: Call Node.js from Ruby