jsapi 0.9.0 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e68467f73e8f1e909a03cd8c50f16674231dc0d070f05a5368b84e0f75dedfe6
-  data.tar.gz: 6c0b1304cb7192d223f517d5233fd96fa13aad7e0affb6832f313088bc3b3993
+  metadata.gz: 4631e17cbd92a36a62ab6e7aa139b65afa83fccc2c41da34c3f757f2b077340f
+  data.tar.gz: 4c547aeb52a0fc74c09389f2c97dd0b8c90883fd36c79b9c502689a25379f3f5
 SHA512:
-  metadata.gz: 45b860d17ffc8f22cfbe4fca26d38e727ff87ddc93a959c6285fd1aaa8eb0de9c5e2a9c516f717f0f6d463b0bfe5c8708b9efa5bab5aa6b08eb642d90ee84d10
-  data.tar.gz: fe573b4b85e50373bd832f1ec3d4fdd9c11fe57bf42527fe80021d6c84d2271e01161b08cdedcee587a69bd43a28219562d36ed0c127197e4cbfe34e05902aca
+  metadata.gz: 1db64f601b34597e5b13ee820482c5a72d2adef153feac7ef3e1141804df36cc8816f665ee18c73e1b30e50a8c13454bed4c7562d447b2fdaf1b3814d863bd09
+  data.tar.gz: a4bd27f4fcc7c50ee9447e70777ca54de3e81ee6fd7ab3124817baf54511c90d0d95cf461c09c7fdc42a3bf8b57bb62d91954bc96d8a44a77eb15f9d53d2f5be

data/lib/jsapi/configuration.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Jsapi
+  # Holds the \Jsapi configuration.
+  class Configuration
+    # The path where the API definitions are located relative to +Rails.root+.
+    # The default is <code>"app/api_defs"</code>.
+    attr_accessor :api_defs_path
+
+    def initialize # :nodoc:
+      @api_defs_path = 'app/api_defs'
+    end
+
+    # Returns the absolute +Pathname+ for +args+ within +api_defs_path+.
+    def pathname(*args)
+      return unless (root = Rails.root)
+
+      root.join(*[api_defs_path, args].flatten)
+    end
+  end
+
+  class << self
+    # The singleton \Jsapi configuration.
+    def configuration
+      @configuration ||= Configuration.new
+    end
+  end
+end

data/lib/jsapi/controller/methods.rb

@@ -162,7 +162,7 @@ module Jsapi
         (operation.model || Model::Base).new(
           Parameters.new(
             params.except(:action, :controller, :format).permit!,
-            headers,
+            request.headers,
             operation,
             definitions,
             strong: strong

data/lib/jsapi/dsl/base.rb

@@ -3,9 +3,26 @@
 module Jsapi
   module DSL
     class Base
-      def initialize(meta_model, &block)
+      def initialize(meta_model, pathname = nil, parent: nil, &block)
         @meta_model = meta_model
+        @pathname = pathname
+        @parent = parent
 
+        # Raise an error when pathname is attempted to be imported again
+        if pathname && (ancestor = parent)
+          while ancestor
+            if ancestor.pathname == pathname
+              raise Error, "Attempted #{pathname.to_path.inspect} to be imported again"
+            end
+
+            ancestor = ancestor.parent
+          end
+        end
+
+        # Evaluate the file to be imported
+        instance_eval(pathname.read, pathname.to_path) if pathname
+
+        # Evaluate block
         if block
           if meta_model.reference?
             raise Error, "reference can't be specified together with a block"
@@ -15,10 +32,30 @@ module Jsapi
         end
       end
 
+      # Imports the file named +filename+ relative to +Jsapi.configation.path+.
+      def import(filename)
+        raise ArgumentError, "file name can't be blank" if filename.blank?
+
+        pathname = Jsapi.configuration.pathname("#{filename}.rb")
+        self.class.new(@meta_model, pathname, parent: self)
+      end
+
+      # Imports the file named +filename+ relative to the current file's path.
+      def import_relative(filename)
+        raise ArgumentError, "file name can't be blank" if filename.blank?
+
+        pathname = (@pathname&.parent || Jsapi.configuration.pathname) + "#{filename}.rb"
+        self.class.new(@meta_model, pathname, parent: self)
+      end
+
       def respond_to_missing?(*args) # :nodoc:
         keyword?(args.first)
       end
 
+      protected
+
+      attr_reader :parent, :pathname
+
       private
 
       def define(*args, &block)

data/lib/jsapi/dsl/class_methods.rb

@@ -29,13 +29,29 @@ module Jsapi
         api_definitions { default(type, **keywords, &block) }
       end
 
-      # The API definitions of the current class.
-      def api_definitions(&block)
-        @api_definitions ||= Meta::Definitions.new(
-          owner: self,
-          parent: superclass.try(:api_definitions)
-        )
+      # Returns the API definitions associated with the current class. Adds additional
+      # definitions when any keywords or a block is specified.
+      #
+      #   api_definitions base_path: '/foo' do
+      #     operation 'bar'
+      #   end
+      def api_definitions(**keywords, &block)
+        unless defined? @api_definitions
+          @api_definitions = Meta::Definitions.new(
+            owner: self,
+            parent: superclass.try(:api_definitions)
+          )
+          if (name = try(:name))
+            pathname = Jsapi.configuration.pathname(
+              name.deconstantize.split('::').map(&:underscore),
+              "#{name.demodulize.delete_suffix('Controller').underscore}.rb"
+            )
+            Definitions.new(@api_definitions, pathname) if pathname&.file?
+          end
+        end
+        @api_definitions.merge!(keywords) if keywords.any?
         Definitions.new(@api_definitions, &block) if block
+
         @api_definitions
       end
 
@@ -71,6 +87,11 @@ module Jsapi
         api_definitions { host(arg) }
       end
 
+      # Imports the file named +filename+ relative to +Jsapi.configation.path+.
+      def api_import(filename)
+        api_definitions { import(filename) }
+      end
+
       # Includes API definitions from +klasses+.
       def api_include(*klasses)
         api_definitions { include(*klasses) }

data/lib/jsapi/version.rb

@@ -5,6 +5,6 @@ module Jsapi
     # NOTE: See https://bundler.io/guides/creating_gem.html
 
     # The current GEM version.
-    VERSION = '0.9.0'
+    VERSION = '0.9.1'
   end
 end

data/lib/jsapi.rb

@@ -3,7 +3,7 @@
 require 'jsapi/invalid_value_helper'
 require 'jsapi/invalid_value_error'
 require 'jsapi/invalid_argument_error'
-
+require 'jsapi/configuration'
 require 'jsapi/model'
 require 'jsapi/meta'
 require 'jsapi/dsl'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jsapi
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.9.1
 platform: ruby
 authors:
 - Denis Göller
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-10-12 00:00:00.000000000 Z
+date: 2024-10-18 00:00:00.000000000 Z
 dependencies: []
 description:
 email: denis@dmgoeller.de
@@ -17,6 +17,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/jsapi.rb
+- lib/jsapi/configuration.rb
 - lib/jsapi/controller.rb
 - lib/jsapi/controller/base.rb
 - lib/jsapi/controller/error.rb