carton 0.2.0 → 0.3.0

data/sig/carton.rbs

@@ -3,8 +3,7 @@ module Kernel
 
   def import: (::String path) -> untyped
   def import_relative: (::String path) -> untyped
-  def export: (*::Symbol names, **untyped values) -> ::Symbol?
-  def export_default: [T] (T value) -> T
+  def export: [T] (T value) -> T
 end
 
 module Carton
@@ -25,10 +24,12 @@ end
 class Carton::GemfileNotFound < Carton::Error
 end
 
-class Carton::Exports < ::Module
+# Lookup helpers on every `Carton::Namespace`. `carton rbs` extends its
+# generated `Carton::Namespace::*` modules with these.
+module Carton::NamespaceMethods
   type key = ::String | ::Symbol
 
-  # Exported methods come back as Method objects; values as exported.
+  # Helpers come back as Method objects; constants as set.
   def []: (key key) -> untyped
   def deconstruct_keys: (nil keys) -> ::Hash[::Symbol, untyped]
                       | (::Array[::Symbol] keys) -> ::Hash[::Symbol, untyped]
@@ -36,7 +37,13 @@ class Carton::Exports < ::Module
            | (key key, untyped default) -> untyped
            | [T] (key key) { (key key) -> T } -> (untyped | T)
   def fetch_values: (*key keys) -> ::Array[untyped]
+  def keys: () -> ::Array[::Symbol]
+  def to_h: () -> ::Hash[::Symbol, untyped]
   def has_key?: (key key) -> bool
   def key?: (key key) -> bool
   def values_at: (*key keys) -> ::Array[untyped]
 end
+
+class Carton::Namespace < ::Module
+  include ::Carton::NamespaceMethods
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: carton
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - David Cristofaro
@@ -9,10 +9,10 @@ bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description: Split a Ruby app into gem-sized units that import and export like modules.
-  Each Carton runs in its own Ruby::Box, so two parts of one app can use different
-  versions of the same gem, monkey patches stay where they are made, and only what
-  a Carton exports is reachable. No manifest needed. Requires Ruby 4.0.7+.
+description: The package system Ruby has been missing. Split code into Cartons that
+  import and export like modules. Each Carton runs in its own Ruby::Box, so only what
+  it exports is reachable, monkey patches stay where they are made, and two Cartons
+  can use different versions of the same gem. No manifest needed. Requires Ruby 4.0.7+.
 email:
 - david@dtcristo.com
 executables: []
@@ -27,12 +27,12 @@ files:
 - lib/carton/box.rb
 - lib/carton/bundler.rb
 - lib/carton/error.rb
-- lib/carton/export_declaration.rb
-- lib/carton/export_methods.rb
-- lib/carton/exports.rb
 - lib/carton/gem_activation.rb
 - lib/carton/import_cache.rb
 - lib/carton/kernel_patch.rb
+- lib/carton/loaded_features.rb
+- lib/carton/namespace.rb
+- lib/carton/namespace_methods.rb
 - lib/carton/resolver.rb
 - lib/carton/runtime.rb
 - lib/carton/version.rb
@@ -61,5 +61,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.20
 specification_version: 4
-summary: Easily box your Ruby
+summary: Real boundaries for Ruby
 test_files: []

data/lib/carton/export_declaration.rb

@@ -1,72 +0,0 @@
-# frozen_string_literal: true
-
-module Carton
-  # What an Entrypoint exports: an Export Namespace built from one or more
-  # `export` calls, or a single Default Export from `export_default`. The two
-  # forms are exclusive, and a name may be exported only once.
-  class ExportDeclaration
-    COMBINED =
-      'export_default cannot be combined with export; ' \
-        'put the other names inside the default value'
-    private_constant :COMBINED
-
-    NO_DEFAULT = Object.new.freeze
-    private_constant :NO_DEFAULT
-
-    def self.absent
-      new({}, {}, NO_DEFAULT)
-    end
-
-    def initialize(methods, values, default)
-      @methods = methods.freeze
-      @values = values.freeze
-      @default = default
-      freeze
-    end
-
-    def add(methods, values)
-      raise ExportError, COMBINED if default?
-
-      duplicate =
-        (methods.keys + values.keys).find do |name|
-          @methods.key?(name) || @values.key?(name)
-        end
-      if duplicate
-        raise ExportError, "export name given more than once: #{duplicate}"
-      end
-
-      self.class.__send__(
-        :new,
-        @methods.merge(methods),
-        @values.merge(values),
-        NO_DEFAULT,
-      )
-    end
-
-    def default(value)
-      if default?
-        raise ExportError, 'export_default may be called only once per file'
-      end
-      raise ExportError, COMBINED if namespace?
-
-      self.class.__send__(:new, @methods, @values, value)
-    end
-
-    # The Default Export, or yields methods and values for the Export
-    # Namespace, or for a Bare Carton's surface, which `bare` computes lazily,
-    # when nothing was exported.
-    def public_surface(bare:)
-      return @default if default?
-
-      namespace? ? yield(@methods, @values) : yield(*bare.call)
-    end
-
-    private_class_method :new
-
-    private
-
-    def default? = !NO_DEFAULT.equal?(@default)
-
-    def namespace? = !(@methods.empty? && @values.empty?)
-  end
-end

data/lib/carton/exports.rb

@@ -1,54 +0,0 @@
-# frozen_string_literal: true
-
-module Carton
-  # Module-like wrapper returned from named exports.
-  #
-  # Exported methods become singleton methods that forward to the carton's
-  # method. Capitalized value keys become constants; lowercase value keys become
-  # readers that return the value as-is. Lookup helpers return the `Method`
-  # object or the value.
-  class Exports < ::Module
-    include ExportMethods
-
-    def initialize(methods = {}, values = {})
-      super()
-      @lookup = {}
-      define_methods(methods)
-      define_values(values)
-    end
-
-    def deconstruct_keys(keys)
-      return super if keys
-
-      @lookup.to_h { |key, value| [key.to_sym, value] }
-    end
-
-    private
-
-    def define_methods(methods)
-      methods.each do |name, method|
-        @lookup[name.to_s] = method
-        define_singleton_method(name) do |*args, **kwargs, &block|
-          method.call(*args, **kwargs, &block)
-        end
-      end
-    end
-
-    def define_values(values)
-      values.each do |key, value|
-        @lookup[key.to_s] = value
-
-        if key.to_s.match?(/\A[A-Z]/)
-          const_set(key, value)
-        else
-          define_singleton_method(key) { value }
-        end
-      end
-    end
-
-    def lookup_entry(key)
-      name = key.to_s
-      @lookup.key?(name) ? [true, @lookup[name]] : [false, nil]
-    end
-  end
-end