disposable 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3da86b891ceddbf906a835e6a9ef6a697b56f367
-  data.tar.gz: ae72874647302013e6f5ce630ed2966db1aceb79
+  metadata.gz: d6e1ad3c3bf2e63ee78f3109a5dbdefc4a66e752
+  data.tar.gz: bdab6ed057dff4c820cb7bbb0e3129c566dbd7b1
 SHA512:
-  metadata.gz: 2742ca894ddafed28b2f3ca3206d9d1e318ebbd023013ccb1677d5e0b31bce388c4b5d903c3c1dd44c0b7183fde9d6f28c8587b64b0942d72a5398a30f039a05
-  data.tar.gz: 7457ab52dce3383eb1cb4946bf7e163c8259f1ca44c1135aaa37a0345a153c1ec17d10b4715beedfb45c5a19b4d85bb113a5da83ae0dfb998f834e34f630ac1e
+  metadata.gz: 565f5cce96dad1b569ec5747d4cab583de49e8ae93eb01b01ab0620b01f828f21b5c714bea8eef7a657b14c517ff460d99b8fa3fcce2cc53b099c2a6a9392deb
+  data.tar.gz: 0a89a7b63ff68773aaa44caaa92c1cc8128ef8b75d95b58036989f44f3c37a14c20f0cf3b21ff33c4b6b2417abc5147cb7fa82f6a0cf14e7a61949181dc11835

data/CHANGES.md

@@ -1,3 +1,9 @@
+# 0.3.2
+
+* Rename `JSONB` to `Property::Hash`.
+* Fix `::unnest` so it copies delegated property options correctly.
+* Deprecate `Twin::Struct`.
+
 # 0.3.1
 
 * Introduce `Twin::JSONB` for easy access to hash fields using `Struct`.

data/Gemfile

@@ -7,3 +7,5 @@ gem "representable", "3.0.0"
 # gem "declarative", path: "../declarative"
 # gem "declarative", github: "apotonick/declarative"
 gem "minitest-line"
+
+gem "activerecord", "< 5.0.0"

data/README.md

@@ -179,6 +179,10 @@ You can also specify nested objects with an explicit class.
 property :artist, twin: TwinArtist
 ```
 
+## Unnest
+
+#todo: document
+
 ## Features
 
 You can simply `include` feature modules into twins. If you want a feature to be included into all inline twins of your schema, use `::feature`.

data/disposable.gemspec

@@ -1,6 +1,6 @@
-lib = File.expand_path('../lib', __FILE__)
+lib = File.expand_path("../lib", __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'disposable/version'
+require "disposable/version"
 
 Gem::Specification.new do |spec|
   spec.name          = "disposable"

data/lib/disposable/twin.rb

@@ -50,6 +50,9 @@ module Disposable
         property(name, options.merge(collection: true), &block)
       end
 
+      require "disposable/twin/property/unnest"
+      include Property::Unnest
+
       # TODO: remove.
       def from_collection(collection)
         collection.collect { |model| new(model) }

data/lib/disposable/twin/property/hash.rb

@@ -0,0 +1,48 @@
+require "disposable/twin/struct"
+
+class Disposable::Twin
+  module Property
+    # trailblazer.to/gems/disposable/api.html#hash
+    module Hash
+      def self.included(includer)
+        # hash: true top-level properties need :default support.
+        includer.feature Default
+
+        # Recursively include Struct in :hash and nested properties.
+        # defaults is applied to all ::property calls.
+        includer.defaults do |name, options|
+          if options[:field] == :hash
+            hash_options
+          else
+            {}
+          end
+        end
+      end
+
+    private
+      # Note that :_features `include`s modules in this order, first to last.
+      def self.hash_options
+        { _features: [NestedDefaults, Property::Struct, Hash::Sync], default: ->(*) { ::Hash.new } }
+      end
+
+      # NestedDefaults for properties nested in the top :hash column.
+      module NestedDefaults
+        def self.included(includer)
+          includer.defaults do |name, options|
+            if options[:_nested_builder] # DISCUSS: any other way to figure out we're nested?
+              Hash.hash_options
+            else
+              { }
+            end
+          end
+        end
+      end
+
+      module Sync
+        def sync!(options={})
+          @model.merge(super)
+        end
+      end
+    end
+  end
+end

data/lib/disposable/twin/property/struct.rb

@@ -0,0 +1,32 @@
+class Disposable::Twin
+  module Property
+    # Twin that uses a hash to populate.
+    #
+    #   Twin.new(id: 1)
+    module Struct
+      def read_value_for(dfn, options)
+        name = dfn[:name]
+        @model[name.to_s] || @model[name.to_sym] # TODO: test sym vs. str.
+      end
+
+      def sync_hash_representer # TODO: make this without representable, please.
+        Sync.hash_representer(self.class) do |dfn|
+          dfn.merge!(
+            prepare:       lambda { |options| options[:input] },
+            serialize: lambda { |options| options[:input].sync! },
+            representable: true
+          ) if dfn[:nested]
+        end
+      end
+
+      def sync(options={})
+        sync_hash_representer.new(self).to_hash
+      end
+      alias_method :sync!, :sync
+
+      # So far, hashes can't be persisted separately.
+      def save!
+      end
+    end
+  end # Property
+end

data/lib/disposable/twin/property/unnest.rb

@@ -0,0 +1,21 @@
+require "uber/delegates"
+
+module Disposable::Twin::Property
+  module Unnest
+    # TODO: test that nested properties options are "unnested", too, e.g. populator.
+    def self.included(includer)
+      includer.send(:include, Uber::Delegates)
+    end
+
+    def unnest(name, options)
+      from = options.delete(:from)
+      # needed to make reform process this field.
+
+      options = definitions.get(from)[:nested].definitions.get(name).instance_variable_get(:@options) # FIXME.
+      options = options.merge(virtual: true, _inherited: true, private_name: nil)
+
+      property(name, options)
+      delegates from, name, "#{name}="
+    end
+  end
+end

data/lib/disposable/twin/setup.rb

@@ -23,12 +23,15 @@ module Disposable
       end
 
       def setup_property!(dfn, options)
-        value =
-          if options.has_key?(name = dfn[:name].to_sym)
-            options[dfn[:name].to_sym]
-          else
-            setup_value_for(dfn, options)
-          end
+        if options.has_key?(name = dfn[:name].to_sym)
+          value = options[dfn[:name].to_sym]
+          return setup_write!(dfn, value)
+        end
+
+        value = setup_value_for(dfn, options)
+
+        # this sucks and is why i introduce pipetrees in 0.4.
+        return if dfn[:readable] == false && dfn[:default].nil?
 
         setup_write!(dfn, value) # note: even readable: false will be written to twin as nil.
       end
@@ -55,4 +58,4 @@ module Disposable
       end
     end # Setup
   end
-end
+end

data/lib/disposable/twin/struct.rb

@@ -1,32 +1,10 @@
-  module Disposable
-  class Twin
-    # Twin that uses a hash to populate.
-    #
-    #   Twin.new(id: 1)
-    module Struct
-      def read_value_for(dfn, options)
-        name = dfn[:name]
-        @model[name.to_s] || @model[name.to_sym] # TODO: test sym vs. str.
-      end
+require "disposable/twin/property/struct"
 
-      def sync_hash_representer # TODO: make this without representable, please.
-        Sync.hash_representer(self.class) do |dfn|
-          dfn.merge!(
-            prepare:       lambda { |options| options[:input] },
-            serialize: lambda { |options| options[:input].sync! },
-            representable: true
-          ) if dfn[:nested]
-        end
-      end
-
-      def sync(options={})
-        sync_hash_representer.new(self).to_hash
-      end
-      alias_method :sync!, :sync
-
-      # So far, hashes can't be persisted separately.
-      def save!
-      end
+class Disposable::Twin
+  module Struct
+    def self.included(includer)
+      warn "[Disposable] The Struct module is deprecated, please use Property::Hash."
+      includer.send(:include, Property::Struct)
     end
   end
 end

data/lib/disposable/version.rb

@@ -1,3 +1,3 @@
 module Disposable
-  VERSION = "0.3.1"
+  VERSION = "0.3.2"
 end

data/test/twin/hash_test.rb

@@ -0,0 +1,211 @@
+require "test_helper"
+require "disposable/twin/property/hash"
+
+class HashTest < MiniTest::Spec
+  Model = Struct.new(:id, :content)
+
+  class Song < Disposable::Twin
+    feature Sync
+    include Property::Hash
+
+    property :id
+    property :content, field: :hash do
+      property :title
+      property :band do
+        property :name
+
+        property :label do
+          property :location
+        end
+      end
+
+      collection :releases do
+        property :version
+      end
+    end
+  end
+
+  # puts Song.definitions.get(:content)[:nested].definitions.get(:band).inspect
+
+  it "allows reading from existing hash" do
+    model = Model.new(1, {})
+    model.inspect.must_equal "#<struct HashTest::Model id=1, content={}>"
+
+    song = Song.new(model)
+    song.id.must_equal 1
+    song.content.title.must_equal nil
+    song.content.band.name.must_equal nil
+    song.content.band.label.location.must_equal nil
+    song.content.releases.must_equal []
+
+    # model's hash hasn't changed.
+    model.inspect.must_equal "#<struct HashTest::Model id=1, content={}>"
+  end
+
+  it "defaults to hash when value is nil" do
+    model = Model.new(1)
+    model.inspect.must_equal "#<struct HashTest::Model id=1, content=nil>"
+
+    song = Song.new(model)
+    song.id.must_equal 1
+    song.content.title.must_equal nil
+    song.content.band.name.must_equal nil
+    song.content.band.label.location.must_equal nil
+
+    # model's hash hasn't changed.
+    model.inspect.must_equal "#<struct HashTest::Model id=1, content=nil>"
+  end
+
+  it "#sync writes to model" do
+    model = Model.new
+
+    song = Song.new(model)
+    song.content.band.label.location = "San Francisco"
+
+    song.sync
+
+    model.inspect.must_equal "#<struct HashTest::Model id=nil, content={\"band\"=>{\"label\"=>{\"location\"=>\"San Francisco\"}}, \"releases\"=>[]}>"
+  end
+
+  it "#appends to collections" do
+    model = Model.new
+
+    song = Song.new(model)
+    # song.content.releases.append(version: 1) # FIXME: yes, this happens!
+    song.content.releases.append("version" => 1)
+
+    song.sync
+
+    model.inspect.must_equal "#<struct HashTest::Model id=nil, content={\"band\"=>{\"label\"=>{}}, \"releases\"=>[{\"version\"=>1}]}>"
+  end
+
+  it "doesn't erase existing, undeclared content" do
+    model = Model.new(nil, {"artist"=>{}})
+
+    song = Song.new(model)
+    song.content.band.label.location = "San Francisco"
+
+    # puts song.content.class.ancestors
+    song.sync
+
+    model.inspect.must_equal "#<struct HashTest::Model id=nil, content={\"artist\"=>{}, \"band\"=>{\"label\"=>{\"location\"=>\"San Francisco\"}}, \"releases\"=>[]}>"
+  end
+
+  it "doesn't erase existing, undeclared content in existing content" do
+    model = Model.new(nil, {"band"=>{ "label" => { "owner" => "Brett Gurewitz" }, "genre" => "Punkrock" }})
+
+    song = Song.new(model)
+    song.content.band.label.location = "San Francisco"
+
+    song.sync
+
+    model.inspect.must_equal "#<struct HashTest::Model id=nil, content={\"band\"=>{\"label\"=>{\"owner\"=>\"Brett Gurewitz\", \"location\"=>\"San Francisco\"}, \"genre\"=>\"Punkrock\"}, \"releases\"=>[]}>"
+  end
+
+
+  describe "features propagation" do
+    module UUID
+      def uuid
+        "1224"
+      end
+    end
+
+    class Hit < Disposable::Twin
+      include Property::Hash
+      feature UUID
+
+      property :id
+      property :content, field: :hash do
+        property :title
+        property :band do
+          property :name
+        end
+      end
+    end
+
+    it "includes features into all nested twins" do
+      song = Hit.new(Model.new)
+      song.uuid.must_equal "1224"
+      song.content.uuid.must_equal "1224"
+      song.content.band.uuid.must_equal "1224"
+    end
+  end
+
+  describe "coercion" do
+    require "disposable/twin/coercion"
+    class Coercing < Disposable::Twin
+      include Property::Hash
+      feature Coercion
+
+      property :id, type: Types::Coercible::Int
+      property :content, field: :hash do
+        property :title
+        property :band do
+          property :name, type: Types::Coercible::String
+        end
+      end
+    end
+
+    it "coerces" do
+      song = Coercing.new(Model.new(1))
+      song.id = "9"
+      song.id.must_equal 9
+      song.content.band.name = 18
+      song.content.band.name.must_equal "18"
+    end
+  end
+
+  describe "::unnest" do
+    class Unnesting < Disposable::Twin
+      feature Sync
+      include Property::Hash
+
+      property :id
+      content=property :content, field: :hash do
+        property :title
+        property :band do
+          property :name
+
+          property :label do
+            property :location
+          end
+        end
+
+        collection :releases do
+          property :version
+        end
+      end
+
+      unnest :title, from: :content
+      unnest :band,  from: :content
+      # property :title, virtual: true#, _inherit: true, nested: content[:nested].definitions.get(:title)[:nested]
+      # def title=(v)
+      #   raise v.inspect
+      #   content.title=(v)
+      # end
+    end
+
+    it "exposes reader and writer" do
+      model = Model.new(1, {title: "Bedroom Eyes"})
+      song = Unnesting.new(model)
+
+      # singular scalar accessors
+      song.content.title.must_equal "Bedroom Eyes"
+      song.title.must_equal "Bedroom Eyes"
+
+      song.title = "Notorious"
+      song.title.must_equal "Notorious"
+      song.content.title.must_equal "Notorious"
+
+      # singular nested accessors
+      song.band.name.must_equal nil
+      song.content.band.name.must_equal nil
+      song.band.name = "Duran Duran"
+      song.band.name.must_equal "Duran Duran"
+    end
+  end
+end
+
+# fixme: make sure default hash is different for every invocation, and not created at compile time.
+
+# TODO: test that config is same and nested.

data/test/twin/struct_test.rb

@@ -5,7 +5,7 @@ require 'disposable/twin/struct'
 
 class TwinStructTest < MiniTest::Spec
   class Song < Disposable::Twin
-    include Struct
+    include Property::Struct
     property :number#, default: 1 # FIXME: this should be :default_if_nil so it becomes clear with a model.
     property :cool?
   end
@@ -57,18 +57,18 @@ class TwinWithNestedStructTest < MiniTest::Spec
     include Sync
 
     property :options do # don't call #to_hash, this is triggered in the twin's constructor.
-      include Struct
+      include Property::Struct
       property :recorded
       property :released
 
       property :preferences do
-        include Struct
+        include Property::Struct
         property :show_image
         property :play_teaser
       end
 
       collection :roles do
-        include Struct
+        include Property::Struct
         property :name
       end
     end
@@ -171,7 +171,7 @@ end
 
 class StructReadableWriteableTest < Minitest::Spec
   class Song < Disposable::Twin
-    include Struct
+    include Property::Struct
     property :length
     property :id, readable: false
   end
@@ -196,11 +196,11 @@ class DefaultWithStructTest < Minitest::Spec
     feature Sync
 
     property :settings, default: Hash.new do
-      include Struct
+      include Property::Struct
 
       property :enabled, default: "yes"
       property :roles, default: Hash.new do
-        include Struct
+        include Property::Struct
         property :admin, default: "maybe"
       end
     end

data/test/twin/unnest_test.rb

@@ -0,0 +1,24 @@
+require "test_helper"
+
+class UnnestTest < MiniTest::Spec
+  class Twin < Disposable::Twin
+    property :content do
+      property :id, nice: "yes"
+      collection :ids, status: "healthy"
+
+      property :email do
+      end
+    end
+
+    unnest :id,    from: :content
+    unnest :ids,   from: :content
+    unnest :email, from: :content
+  end
+
+  it "copies property option" do
+    Twin.definitions.get(:id).extend(Declarative::Inspect).inspect.must_equal %{#<Disposable::Twin::Definition: @options={:nice=>\"yes\", :private_name=>:id, :name=>\"id\", :readable=>false, :writeable=>false}>}
+    Twin.definitions.get(:ids).extend(Declarative::Inspect).inspect.must_equal %{#<Disposable::Twin::Definition: @options={:status=>\"healthy\", :collection=>true, :private_name=>:ids, :name=>\"ids\", :readable=>false, :writeable=>false}>}
+    # also copies :nested.
+    Twin.definitions.get(:email).extend(Declarative::Inspect).inspect.must_equal %{#<Disposable::Twin::Definition: @options={:private_name=>:email, :nested=>#<Class:>, :name=>\"email\", :readable=>false, :writeable=>false}>}
+  end
+end

data/test/twin/virtual_test.rb

@@ -22,4 +22,18 @@ class VirtualTest < MiniTest::Spec
 
     hash.must_equal("credit_card_number"=> "123")
   }
-end
+
+  describe "setter should never be called with virtual:true" do
+    class Raising < Disposable::Twin
+      property :id, virtual: true
+
+      def id=(*)
+        raise "i should never be called!"
+      end
+    end
+
+    it "what" do
+      Raising.new(Object.new).id.must_equal nil
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: disposable
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.2
 platform: ruby
 authors:
 - Nick Sutterer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-06-26 00:00:00.000000000 Z
+date: 2016-07-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: uber
@@ -181,9 +181,11 @@ files:
 - lib/disposable/twin/composition.rb
 - lib/disposable/twin/default.rb
 - lib/disposable/twin/definitions.rb
-- lib/disposable/twin/jsonb.rb
 - lib/disposable/twin/parent.rb
 - lib/disposable/twin/persisted.rb
+- lib/disposable/twin/property/hash.rb
+- lib/disposable/twin/property/struct.rb
+- lib/disposable/twin/property/unnest.rb
 - lib/disposable/twin/property_processor.rb
 - lib/disposable/twin/save.rb
 - lib/disposable/twin/setup.rb
@@ -210,9 +212,9 @@ files:
 - test/twin/feature_test.rb
 - test/twin/from_collection_test.rb
 - test/twin/from_test.rb
+- test/twin/hash_test.rb
 - test/twin/inherit_test.rb
 - test/twin/inheritance_test.rb
-- test/twin/jsonb_test.rb
 - test/twin/option_test.rb
 - test/twin/parent_test.rb
 - test/twin/process_inline_test.rb
@@ -224,6 +226,7 @@ files:
 - test/twin/sync_option_test.rb
 - test/twin/sync_test.rb
 - test/twin/twin_test.rb
+- test/twin/unnest_test.rb
 - test/twin/virtual_test.rb
 - test/twin/writeable_test.rb
 homepage: https://github.com/apotonick/disposable
@@ -272,9 +275,9 @@ test_files:
 - test/twin/feature_test.rb
 - test/twin/from_collection_test.rb
 - test/twin/from_test.rb
+- test/twin/hash_test.rb
 - test/twin/inherit_test.rb
 - test/twin/inheritance_test.rb
-- test/twin/jsonb_test.rb
 - test/twin/option_test.rb
 - test/twin/parent_test.rb
 - test/twin/process_inline_test.rb
@@ -286,5 +289,6 @@ test_files:
 - test/twin/sync_option_test.rb
 - test/twin/sync_test.rb
 - test/twin/twin_test.rb
+- test/twin/unnest_test.rb
 - test/twin/virtual_test.rb
 - test/twin/writeable_test.rb

data/lib/disposable/twin/jsonb.rb

@@ -1,45 +0,0 @@
-require "disposable/twin/struct"
-
-class Disposable::Twin
-  module JSONB
-    def self.included(includer)
-      # jsonb: true top-level properties need :default support.
-      includer.feature Default
-
-      # Recursively include Struct in :jsonb and nested properties.
-      # defaults is applied to all ::property calls.
-      includer.defaults do |name, options|
-        if options[:jsonb] # only apply to `jsonb: true`.
-          jsonb_options
-        else
-          {}
-        end
-      end
-    end
-
-  private
-    # Note that :_features `include`s modules in this order, first to last.
-    def self.jsonb_options
-      { _features: [NestedDefaults, Struct, JSONB::Sync], default: ->(*) { Hash.new } }
-    end
-
-    # NestedDefaults for properties nested in the top :jsonb column.
-    module NestedDefaults
-      def self.included(includer)
-        includer.defaults do |name, options|
-          if options[:_nested_builder] # DISCUSS: any other way to figure out we're nested?
-            JSONB.jsonb_options
-          else
-            { }
-          end
-        end
-      end
-    end
-
-    module Sync
-      def sync!(options={})
-        @model.merge(super)
-      end
-    end
-  end
-end

data/test/twin/jsonb_test.rb

@@ -1,118 +0,0 @@
-require "test_helper"
-require "disposable/twin/jsonb"
-
-class JSONBTest < MiniTest::Spec
-  Model = Struct.new(:id, :content)
-
-  class Song < Disposable::Twin
-    feature Sync
-    include JSONB
-
-    property :id
-    property :content, jsonb: true do
-      property :title
-      property :band do
-        property :name
-
-        property :label do
-          property :location
-        end
-      end
-    end
-  end
-
-  # puts Song.definitions.get(:content)[:nested].definitions.get(:band).inspect
-
-  it "allows reading from existing hash" do
-    model = Model.new(1, {})
-    model.inspect.must_equal "#<struct JSONBTest::Model id=1, content={}>"
-
-    song = Song.new(model)
-    song.id.must_equal 1
-    song.content.title.must_equal nil
-    song.content.band.name.must_equal nil
-    song.content.band.label.location.must_equal nil
-
-    # model's hash hasn't changed.
-    model.inspect.must_equal "#<struct JSONBTest::Model id=1, content={}>"
-  end
-
-  it "defaults to hash when value is nil" do
-    model = Model.new(1)
-    model.inspect.must_equal "#<struct JSONBTest::Model id=1, content=nil>"
-
-    song = Song.new(model)
-    song.id.must_equal 1
-    song.content.title.must_equal nil
-    song.content.band.name.must_equal nil
-    song.content.band.label.location.must_equal nil
-
-    # model's hash hasn't changed.
-    model.inspect.must_equal "#<struct JSONBTest::Model id=1, content=nil>"
-  end
-
-  it "#sync writes to model" do
-    model = Model.new
-
-    song = Song.new(model)
-    song.content.band.label.location = "San Francisco"
-
-    song.sync
-
-    model.inspect.must_equal "#<struct JSONBTest::Model id=nil, content={\"band\"=>{\"label\"=>{\"location\"=>\"San Francisco\"}}}>"
-  end
-
-  it "doesn't erase existing, undeclared content" do
-    model = Model.new(nil, {"artist"=>{}})
-
-    song = Song.new(model)
-    song.content.band.label.location = "San Francisco"
-
-    # puts song.content.class.ancestors
-    song.sync
-
-    model.inspect.must_equal "#<struct JSONBTest::Model id=nil, content={\"artist\"=>{}, \"band\"=>{\"label\"=>{\"location\"=>\"San Francisco\"}}}>"
-  end
-
-  it "doesn't erase existing, undeclared content in existing content" do
-    model = Model.new(nil, {"band"=>{ "label" => { "owner" => "Brett Gurewitz" }, "genre" => "Punkrock" }})
-
-    song = Song.new(model)
-    song.content.band.label.location = "San Francisco"
-
-    song.sync
-
-    model.inspect.must_equal "#<struct JSONBTest::Model id=nil, content={\"band\"=>{\"label\"=>{\"owner\"=>\"Brett Gurewitz\", \"location\"=>\"San Francisco\"}, \"genre\"=>\"Punkrock\"}}>"
-  end
-
-
-  describe "features propagation" do
-    module UUID
-      def uuid
-        "1224"
-      end
-    end
-
-    class Hit < Disposable::Twin
-      include JSONB
-      feature UUID
-
-      property :id
-      property :content, jsonb: true do
-        property :title
-        property :band do
-          property :name
-        end
-      end
-    end
-
-    it "includes features into all nested twins" do
-      song = Hit.new(Model.new)
-      song.uuid.must_equal "1224"
-      song.content.uuid.must_equal "1224"
-      song.content.band.uuid.must_equal "1224"
-    end
-  end
-end
-
-# fixme: make sure default hash is different for every invocation, and not created at compile time.