janus-ar 8.0.1 → 8.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 192027338ca77fe74dcf3d4ce10209514d57518e55be909c7d7fdf18c6bfcd44
-  data.tar.gz: 7d9cb1c366f05c08c19f07a6435673ddbbe8bc9ae07ab495e2f9901973ea932d
+  metadata.gz: 1720a88365b20f91d220065128ca260baf91380779a7a1d9a6f9aa8fffc13ae8
+  data.tar.gz: 2987d7e690b1038946a489a80df29917a192c1a07b85bc16932fb0bf8c2df531
 SHA512:
-  metadata.gz: 6325a5fde59fc041a93182f97d294025a614e99ea974a9a018996af67895fcd28e1f9f156cebffe2366725b37fafca55b11d846dd7fe7ab4a1bd07c369d406f5
-  data.tar.gz: 1eea960641c63b5ba76e4fe285de967d04e79fea4e5de8eaeeffc082c97596dfcb9c3f0cb4e6524b452b59a8a4df8fc50ae2537c56561880c98f233502e34dc0
+  metadata.gz: ae79f4f2c54ea96d6191a2b7597982a558027ed911d894e66bbb205041d2339e0b33bb9004ac8331162c2766ac91c922f1ebd11e125ecd18e2f30db8b8cf173c
+  data.tar.gz: 1224b98a5c03641329d47f1eee868247141cfd6299f98a1f364aed01bef7eb4c3897c4a1e3675734a04aabde3b4ca8165ddb58fe07f36c4f97691c8fcec89e17

data/Gemfile

@@ -1,4 +1,2 @@
-# frozen_string_literal: true
-
-source 'http://rubygems.org'
+source 'https://rubygems.org'
 gemspec

data/Gemfile.lock

@@ -1,19 +1,19 @@
 PATH
   remote: .
   specs:
-    janus-ar (8.0.0)
+    janus-ar (8.1.1)
       activerecord (>= 8.0, < 9.0)
 
 GEM
-  remote: http://rubygems.org/
+  remote: https://rubygems.org/
   specs:
-    activemodel (8.1.3)
-      activesupport (= 8.1.3)
-    activerecord (8.1.3)
-      activemodel (= 8.1.3)
-      activesupport (= 8.1.3)
+    activemodel (8.1.3.1)
+      activesupport (= 8.1.3.1)
+    activerecord (8.1.3.1)
+      activemodel (= 8.1.3.1)
+      activesupport (= 8.1.3.1)
       timeout (>= 0.4.0)
-    activesupport (8.1.3)
+    activesupport (8.1.3.1)
       base64
       bigdecimal
       concurrent-ruby (~> 1.0, >= 1.3.1)
@@ -30,15 +30,15 @@ GEM
     base64 (0.3.0)
     bigdecimal (4.1.2)
     coderay (1.1.3)
-    concurrent-ruby (1.3.6)
+    concurrent-ruby (1.3.8)
     connection_pool (3.0.2)
     diff-lcs (1.6.2)
     drb (2.2.3)
-    i18n (1.14.8)
+    i18n (1.15.2)
       concurrent-ruby (~> 1.0)
     io-console (0.8.2)
-    json (2.19.9)
-    language_server-protocol (3.17.0.5)
+    json (2.21.2)
+    language_server-protocol (3.17.0.6)
     lint_roller (1.1.0)
     logger (1.7.0)
     method_source (1.1.0)
@@ -48,16 +48,18 @@ GEM
     mysql2 (0.5.7)
       bigdecimal
     parallel (1.28.0)
-    parser (3.3.11.1)
+    parser (3.3.12.0)
       ast (~> 2.4.1)
       racc
+    pg (1.6.3-arm64-darwin)
+    pg (1.6.3-x86_64-linux)
     prism (1.9.0)
     pry (0.16.0)
       coderay (~> 1.1)
       method_source (~> 1.0)
       reline (>= 0.6.0)
     racc (1.8.1)
-    rack (3.2.6)
+    rack (3.2.7)
     rainbow (3.1.1)
     rake (13.4.2)
     regexp_parser (2.12.0)
@@ -76,8 +78,8 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.7)
-    rubocop (1.88.0)
-      json (~> 2.3)
+    rubocop (1.90.0)
+      json (>= 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
       parallel (>= 1.10)
@@ -87,18 +89,18 @@ GEM
       rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.49.1)
+    rubocop-ast (1.50.0)
       parser (>= 3.3.7.2)
       prism (~> 1.7)
-    rubocop-performance (1.26.1)
+    rubocop-performance (1.27.0)
       lint_roller (~> 1.1)
-      rubocop (>= 1.75.0, < 2.0)
+      rubocop (>= 1.89.0, < 2.0)
       rubocop-ast (>= 1.47.1, < 2.0)
-    rubocop-rails (2.35.4)
+    rubocop-rails (2.37.0)
       activesupport (>= 4.2.0)
       lint_roller (~> 1.1)
       rack (>= 1.1)
-      rubocop (>= 1.75.0, < 2.0)
+      rubocop (>= 1.89.0, < 2.0)
       rubocop-ast (>= 1.44.0, < 2.0)
     rubocop-rspec (3.10.2)
       lint_roller (~> 1.1)
@@ -111,7 +113,7 @@ GEM
     ruby-progressbar (1.13.0)
     securerandom (0.4.1)
     timeout (0.6.1)
-    trilogy (2.12.5)
+    trilogy (2.13.0)
       bigdecimal
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
@@ -128,12 +130,13 @@ DEPENDENCIES
   activesupport (>= 8.0)
   janus-ar!
   mysql2
+  pg
   pry
   rake
   rspec (~> 3)
-  rubocop (~> 1.88.0)
+  rubocop (~> 1.90.0)
   rubocop-performance
-  rubocop-rails (~> 2.35.2)
+  rubocop-rails (~> 2.37.0)
   rubocop-rspec
   rubocop-thread_safety
   trilogy

data/README.md

@@ -11,13 +11,13 @@
 [![CI](https://github.com/OLIOEX/janus-ar/actions/workflows/ci.yml/badge.svg)](https://github.com/OLIOEX/janus-ar/actions/workflows/ci.yml)
 [![Gem Version](https://badge.fury.io/rb/janus-ar.svg)](https://badge.fury.io/rb/janus-ar)
 
-Janus ActiveRecord is a generic primary/replica proxy for ActiveRecord 8 and MySQL (via `mysql2` and `trilogy`). It handles the switching of connections between primary and replica database servers. It comes with an ActiveRecord database adapter implementation.
+Janus ActiveRecord is a generic primary/replica proxy for ActiveRecord 8, supporting MySQL (via `mysql2` and `trilogy`) and PostgreSQL (via `pg`). It handles the switching of connections between primary and replica database servers. It comes with an ActiveRecord database adapter implementation.
 
 Janus is heavily inspired by [Makara](https://github.com/instacart/makara) from TaskRabbit and then Instacart. Unfortunately this project is unmaintained and broke for us with Rails 7.1. This is an attempt to start afresh on the project. It is definitely not as fully featured as Makara at this stage.
 
 Learn more about its origins: [https://tech.olioex.com/ruby/2024/04/16/introducing-janus.html](https://tech.olioex.com/ruby/2024/04/16/introducing-janus.html).
 
-Notes: the gem requires ActiveRecord `>= 8.0, < 9.0` and Ruby `>= 3.2`, and is tested against MySQL 8.
+Notes: the gem requires ActiveRecord `>= 8.0, < 9.0` and Ruby `>= 3.2`, and is tested against MySQL 8 and PostgreSQL 16 and 17.
 
 ## Installation
 
@@ -45,6 +45,8 @@ require 'rails/all'
 ActiveRecord::ConnectionAdapters.register("janus_trilogy", "ActiveRecord::ConnectionAdapters::JanusTrilogyAdapter", 'janus-ar/active_record/connection_adapters/janus_trilogy_adapter')
 # ...or...
 ActiveRecord::ConnectionAdapters.register("janus_mysql2", "ActiveRecord::ConnectionAdapters::JanusMysql2Adapter", 'janus-ar/active_record/connection_adapters/janus_mysql2_adapter')
+# ...or...
+ActiveRecord::ConnectionAdapters.register("janus_postgresql", "ActiveRecord::ConnectionAdapters::JanusPostgreSQLAdapter", 'janus-ar/active_record/connection_adapters/janus_postgresql_adapter')
 ```
 
 #### Rails <= 7.1
@@ -81,6 +83,45 @@ Note: For `trilogy` please use adapter "janus_trilogy". You'll probably need to
 Otherwise you will get an error like the following (see https://github.com/trilogy-libraries/trilogy/issues/26):
 > trilogy_auth_recv: caching_sha2_password requires either TCP with TLS or a unix socket: TRILOGY_UNSUPPORTED"
 
+#### PostgreSQL
+
+Use adapter `janus_postgresql`, and add the `pg` gem to your `Gemfile`:
+
+```yml
+development:
+  adapter: janus_postgresql
+  database: database_name
+  janus:
+    primary:
+      <<: *default
+      host: primary-host.local
+      username: app
+      password: primary_password
+    replica:
+      <<: *default
+      host: replica-host.local
+      username: app_readonly
+      password: replica_password
+```
+
+Anything the adapter reads out of its own configuration — `pool`, `prepared_statements`,
+`insert_returning`, `variables`, `schema_search_path`, SSL settings and so on — must go
+inside the `primary:` and `replica:` blocks rather than alongside `adapter:`, because each
+connection is built from its own block.
+
+Two things worth knowing about the PostgreSQL adapter specifically:
+
+* Unlike MySQL, PostgreSQL never inlines bind values into the statement: reads
+  reach the replica as `$1` placeholders plus a separate parameter list, and
+  prepared statements are cached per connection. The adapter forwards binds and
+  the prepare flag to the replica, so each connection maintains its own
+  statement cache.
+* Type OIDs are resolved against whichever connection served the lookup. This is
+  correct for a physical (streaming) replica, where OIDs are identical to the
+  primary's by construction. If you point Janus at a logical replica whose custom
+  types, enums or extensions were created independently, the OIDs can diverge and
+  results may be cast with the wrong type.
+
 ### Forcing connections
 
 A context is local to the current unit of work (thread or fiber, following ActiveRecord's configured isolation level). This allows you to stick to the primary safely within a single request or job, in systems such as Sidekiq for instance.
@@ -119,7 +160,9 @@ There are some edge cases:
 * `SET` operations will be sent to all connections
 * Execution of specific methods such as `connect!`, `disconnect!`, `reconnect!`, and `clear_cache!` are invoked on all underlying connections
 * Calls inside a transaction will always be sent to the primary (otherwise changes from within the transaction could not be read back on most transaction isolation levels)
-* Locking reads (e.g. `SELECT ... FOR UPDATE`) will always be sent to the primary
+* Locking reads (e.g. `SELECT ... FOR UPDATE`, `FOR UPDATE SKIP LOCKED`, `FOR SHARE`, `FOR NO KEY UPDATE`, `FOR KEY SHARE`, `LOCK IN SHARE MODE`) will always be sent to the primary
+* So will reads that call a locking or sequence function — `GET_LOCK(...)`, `IS_FREE_LOCK(...)`, `nextval(...)`, `setval(...)` and PostgreSQL's advisory lock family (`pg_advisory_lock`, `pg_try_advisory_xact_lock_shared`, `pg_advisory_unlock_all`, and so on)
+* PostgreSQL cursor statements (`DECLARE`, `FETCH`, `MOVE`, `CLOSE`) go to the primary, so a cursor is always fetched on the connection that declared it
 
 # Notes
 
@@ -128,3 +171,26 @@ Janus does not support Rails' read/write split or sharding using `with_connectio
 # Acknowlegements
 
 Amazing project logo by @undevelopedbruce.
+
+## Releasing
+
+Releases are cut from the [GitHub Releases UI](https://github.com/OLIOEX/janus-ar/releases/new).
+Publishing to RubyGems is automatic — there is nothing to bump by hand, and no
+API key to rotate (authentication uses RubyGems
+[trusted publishing](https://guides.rubygems.org/trusted-publishing/) over OIDC).
+
+To release:
+
+1. Create a new release against the head of `main`, with a tag named
+   `vMAJOR.MINOR.PATCH` — e.g. `v8.1.0`. Pre-release suffixes use a dot, as
+   RubyGems requires: `v8.1.0.rc1`, not `v8.1.0-rc1`.
+2. Publish it.
+
+[`.github/workflows/publish.yml`](.github/workflows/publish.yml) then takes the
+version from the tag, writes it into `lib/janus-ar/version.rb`, refreshes
+`Gemfile.lock`, commits that bump to `main` as `Release vX.Y.Z`, moves the tag
+onto that commit, and pushes the gem.
+
+Because the bump is committed to `main`, releases must be created from its head
+— the workflow refuses to publish if the tag sits anywhere else. You never need
+to edit `version.rb` yourself; the tag is the source of truth.

data/Rakefile

@@ -1,3 +1 @@
-# frozen_string_literal: true
-
 require 'bundler/gem_tasks'

data/janus-ar.gemspec

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 require File.expand_path('lib/janus-ar/version.rb', __dir__)
 
 Gem::Specification.new do |gem|
@@ -13,8 +11,10 @@ Gem::Specification.new do |gem|
     'source_code_uri' => 'https://github.com/olioex/janus-ar',
   }
 
-  gem.files         = `git ls-files`.split($OUTPUT_RECORD_SEPARATOR)
-  gem.executables   = gem.files.grep(%r{^bin/}).map { |f| File.basename(f) }
+  ignored           = %r{^(bin|spec|assets|gemfiles|\.github)/|^\.}
+  gem.files         = `git ls-files`.split($OUTPUT_RECORD_SEPARATOR).grep_v(ignored)
+  # The gem ships no executables; bin/ holds repository maintenance scripts.
+  gem.executables   = []
   gem.name          = 'janus-ar'
   gem.require_paths = %w(lib)
   gem.version       = Janus::VERSION
@@ -24,12 +24,13 @@ Gem::Specification.new do |gem|
   gem.add_dependency 'activerecord', '>= 8.0', '< 9.0'
   gem.add_development_dependency 'activesupport', '>= 8.0'
   gem.add_development_dependency 'mysql2'
+  gem.add_development_dependency 'pg'
   gem.add_development_dependency 'trilogy'
   gem.add_development_dependency 'pry'
   gem.add_development_dependency 'rake'
   gem.add_development_dependency 'rspec', '~> 3'
-  gem.add_development_dependency 'rubocop', '~> 1.88.0'
-  gem.add_development_dependency 'rubocop-rails', '~> 2.35.2'
+  gem.add_development_dependency 'rubocop', '~> 1.90.0'
+  gem.add_development_dependency 'rubocop-rails', '~> 2.37.0'
   gem.add_development_dependency 'rubocop-rspec'
   gem.add_development_dependency 'rubocop-thread_safety'
   gem.add_development_dependency 'rubocop-performance'

data/lib/janus-ar/active_record/connection_adapters/janus_mysql2_adapter.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 require 'active_record/connection_adapters/abstract_adapter'
 require 'active_record/connection_adapters/mysql2_adapter'
 require_relative '../../../janus-ar'

data/lib/janus-ar/active_record/connection_adapters/janus_postgresql_adapter.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'active_record/connection_adapters/abstract_adapter'
+require 'active_record/connection_adapters/postgresql_adapter'
+require_relative '../../../janus-ar'
+require_relative '../../adapter_extensions'
+
+module ActiveRecord
+  module ConnectionHandling
+    def janus_postgresql_connection(config)
+      ActiveRecord::ConnectionAdapters::JanusPostgreSQLAdapter.new(config)
+    end
+  end
+
+  class Base
+    def self.janus_postgresql_adapter_class
+      ActiveRecord::ConnectionAdapters::JanusPostgreSQLAdapter
+    end
+  end
+
+  module ConnectionAdapters
+    class JanusPostgreSQLAdapter < ActiveRecord::ConnectionAdapters::PostgreSQLAdapter
+      include Janus::AdapterExtensions
+
+      private
+
+      def replica_adapter_class
+        ActiveRecord::ConnectionAdapters::PostgreSQLAdapter
+      end
+
+      # PostgreSQL compiles statements to `$1` placeholders and passes the values
+      # separately, so the replica needs the whole call, not just the SQL.
+      #
+      # `raw_execute` is private on a stock adapter, hence the `send`. It is the
+      # right target rather than the public `execute`: the statement has already
+      # been through `preprocess_query`, which we do not want applied twice.
+      def forward_raw_execute(sql, ...)
+        replica_connection.send(:raw_execute, sql, ...)
+      end
+    end
+  end
+end

data/lib/janus-ar/active_record/connection_adapters/janus_trilogy_adapter.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 require 'active_record/connection_adapters/abstract_adapter'
 require 'active_record/connection_adapters/trilogy_adapter'
 require_relative '../../../janus-ar'

data/lib/janus-ar/adapter_extensions.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 module Janus
   # Behaviour shared by the Janus MySQL2 and Trilogy adapters.
   #
@@ -34,17 +32,17 @@ module Janus
       @connection_parameters ||= args[0]
     end
 
-    # The argument lists below intentionally use anonymous splats and a bare
+    # The argument lists below intentionally use argument forwarding and a bare
     # `super`: ActiveRecord's `raw_execute`/`execute` signatures differ between
     # versions, so we forward whatever we are given unchanged rather than
     # restating (and pinning ourselves to) the current signature.
-    def raw_execute(sql, *, **)
+    def raw_execute(sql, ...)
       case where_to_send?(sql)
       when :all
-        send_to_replica(sql, :all)
+        send_raw_to_replica(sql, :all, ...)
         super
       when :replica
-        send_to_replica(sql, :replica)
+        send_raw_to_replica(sql, :replica, ...)
       else
         mark_primary(sql)
         super
@@ -74,6 +72,11 @@ module Janus
       super
     end
 
+    def discard!(...)
+      replica_connection.discard!(...)
+      super
+    end
+
     def disconnect!(...)
       replica_connection.disconnect!(...)
       super
@@ -103,5 +106,17 @@ module Janus
       Janus::Context.used_connection(connection)
       replica_connection.execute(sql)
     end
+
+    def send_raw_to_replica(sql, connection, ...)
+      Janus::Context.used_connection(connection)
+      forward_raw_execute(sql, ...)
+    end
+
+    # The MySQL adapters inline bind values into the SQL string, so replaying the
+    # statement alone is enough. Adapters that keep binds separate must override
+    # this to carry them across.
+    def forward_raw_execute(sql, *, **)
+      replica_connection.execute(sql)
+    end
   end
 end

data/lib/janus-ar/client.rb

@@ -1,6 +1,5 @@
-# frozen_string_literal: true
-module Janus
-  class Client
-    FOUND_ROWS = 2
-  end
-end
+module Janus
+  class Client
+    FOUND_ROWS = 2
+  end
+end

data/lib/janus-ar/context.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 require 'active_support/isolated_execution_state'
 
 module Janus

data/lib/janus-ar/db_console_config.rb

@@ -1,17 +1,15 @@
-# frozen_string_literal: true
-
-module Janus
-  class DbConsoleConfig
-    def initialize(config)
-      @_config = config.configuration_hash
-    end
-
-    def configuration_hash
-      @_config[:janus]['replica'].symbolize_keys
-    end
-
-    def database
-      @_config[:database]
-    end
-  end
-end
+module Janus
+  class DbConsoleConfig
+    def initialize(config)
+      @_config = config.configuration_hash
+    end
+
+    def configuration_hash
+      @_config[:janus]['replica'].symbolize_keys
+    end
+
+    def database
+      @_config[:database]
+    end
+  end
+end

data/lib/janus-ar/logging/logger.rb

@@ -1,15 +1,13 @@
-# frozen_string_literal: true
-
-module Janus
-  module Logging
-    class Logger
-      class << self
-        def log(message, format = :info)
-          logger&.send(format, "[Janus] #{message}")
-        end
-
-        attr_accessor :logger
-      end
-    end
-  end
-end
+module Janus
+  module Logging
+    class Logger
+      class << self
+        def log(message, format = :info)
+          logger&.send(format, "[Janus] #{message}")
+        end
+
+        attr_accessor :logger
+      end
+    end
+  end
+end

data/lib/janus-ar/logging/subscriber.rb

@@ -1,27 +1,25 @@
-# frozen_string_literal: true
-
-module Janus
-  module Logging
-    module Subscriber
-      IGNORE_PAYLOAD_NAMES = %w(SCHEMA EXPLAIN).freeze
-
-      def sql(event)
-        name = event.payload[:name]
-        unless IGNORE_PAYLOAD_NAMES.include?(name)
-          name = [current_wrapper_name(event), name].compact.join(' ')
-          event.payload[:name] = name
-        end
-        super(event)
-      end
-
-      protected
-
-      def current_wrapper_name(_event)
-        connection = Janus::Context.last_used_connection
-        return nil unless connection
-
-        "[#{connection}]"
-      end
-    end
-  end
-end
+module Janus
+  module Logging
+    module Subscriber
+      IGNORE_PAYLOAD_NAMES = %w(SCHEMA EXPLAIN).freeze
+
+      def sql(event)
+        name = event.payload[:name]
+        unless IGNORE_PAYLOAD_NAMES.include?(name)
+          name = [current_wrapper_name(event), name].compact.join(' ')
+          event.payload[:name] = name
+        end
+        super(event)
+      end
+
+      protected
+
+      def current_wrapper_name(_event)
+        connection = Janus::Context.last_used_connection
+        return nil unless connection
+
+        "[#{connection}]"
+      end
+    end
+  end
+end

data/lib/janus-ar/query_director.rb

@@ -1,14 +1,25 @@
-# frozen_string_literal: true
 module Janus
   class QueryDirector
     ALL = :all
     REPLICA = :replica
     PRIMARY = :primary
 
+    # Regexp fragments, not literal names: PostgreSQL's advisory lock family has
+    # too many members to list.
+    LOCK_FUNCTIONS = %w(
+      nextval currval lastval setval get_lock release_lock is_free_lock is_used_lock
+      pg_(?:try_)?advisory_(?:xact_)?(?:un)?lock(?:_shared|_all)?
+    ).freeze
+
+    # A string rather than a Regexp: interpolating a Regexp below would wrap it in
+    # a group that resets the /im flags, so `FOR UPDATE` would stop matching.
+    ROW_LOCK_STRENGTHS = 'no\s+key\s+update|key\s+share|update|share'
+
     SQL_PRIMARY_MATCHERS = [
-      /\A\s*select.+for update\Z/i, /select.+lock in share mode\Z/i,
-      /\A\s*select.+(nextval|currval|lastval|get_lock|release_lock|pg_advisory_lock|pg_advisory_unlock)\(/i,
-      /\A\s*show/i
+      /\A\s*select\b.*\bfor\s+(?:#{ROW_LOCK_STRENGTHS})\b/im,
+      /\A\s*select\b.*\block\s+in\s+share\s+mode\b/im,
+      /\A\s*select\b.*\b(#{LOCK_FUNCTIONS.join('|')})\s*\(/im,
+      /\A\s*show\b/i,
     ].freeze
     SQL_REPLICA_MATCHERS = [/\A\s*(select|with.+\)\s*select)\s/i].freeze
     SQL_ALL_MATCHERS = [/\A\s*set\s/i].freeze

data/lib/janus-ar/railtie.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 require 'rails/railtie'
 
 module Janus

data/lib/janus-ar/version.rb

@@ -1,10 +1,8 @@
-# frozen_string_literal: true
-
 module Janus
   unless defined?(::Janus::VERSION)
     module VERSION
       MAJOR = 8
-      MINOR = 0
+      MINOR = 1
       PATCH = 1
       PRE = nil
 

data/lib/janus-ar.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 require 'active_support'
 
 module Janus