🚧 Generic class component?

Author: iago-lito

src/EcologicalNetworksDynamics.jl

@@ -50,12 +50,12 @@ include("./Views/Views.jl")
 using .Views
 
 # Convenience macro to wire this all together.
-include("./expose_data.jl")
+#  include("./expose_data.jl") # XXX: on hold.
 
 #-------------------------------------------------------------------------------------------
 # The actual user-facing components of the package are defined there,
 # connecting them to the internals via the framework.
-include("./components/main.jl")
+#  include("./components/main.jl")
 
 #=
 #-------------------------------------------------------------------------------------------

src/Framework/blueprint_macro.jl

@@ -235,7 +235,7 @@ function blueprint_macro(__module__, __source__, input...)
                         implied_blueprint_for(b, singleton_instance(C))
                 end
                 # In case the brought component type is abstract,
-                # define a falllback method in case the components lib
+                # define a fallback method in case the components lib
                 # provided no way of implying a particular subtype of it.
                 # TODO: find a way to raise this error earlier
                 # during field assignment or construction.

src/Framework/macro_helpers.jl

@@ -23,6 +23,13 @@
 #     @create_value B depends_on_value(A)
 #   end
 #
+# HERE: is `@testset` really the only use case for the above?
+# Because if so, maybe just drop `@testset`.
+# => Yes, it is. Drop it:
+#   - 1. Fake an alternate `@testset` for framework tests.
+#   - 2. Guard macros invocations with a sync lock to ensure the above does not happen.
+#   - 3. Assume it does not and simplify macro codes a LOT then.
+#
 # As a consequence, it cannot be checked that `A` is a valid reference to an existing type
 # during macro expansion.
 # This check must therefore be performed during generated code execution,

src/GraphDataInputs/convert.jl

@@ -1,4 +1,4 @@
-# Convenience explicit conversion to the given union tgc(Map, [:a => 5, Bool[0, 1, 1] => 8])ype from constructor arguments.
+# Convenience explicit conversion to the given union type from constructor arguments.
 
 # The conversions allowed.
 graphdataconvert(::Type{T}, source::T) where {T} = source # Trivial identity.

src/components/class.jl

@@ -0,0 +1,20 @@
+# HERE: attempt to capture anything needed
+# to define a component bringing a new class to the network.
+# Extensibility required, but avoid it being noisy if unused.
+# This **may** bypass @components_macro, @blueprint_macro and @expose_data.
+
+function define_class_component()
+    # Generated code prototype for an imaginary component called `Class`,
+    # used as a placeholder.
+    quote
+        # ==================================================================================
+        # Blueprints for the component.
+        module ClassBlueprints
+            #-------------------------------------------------------------------------------
+            # Construct from a given set of names.
+            mutable struct Names
+                names::Vector{Symbol}
+            end
+        end
+    end
+end

src/components/main.jl

@@ -41,28 +41,31 @@ include("./allometry.jl")
 # to each of its fields.
 include("./args_to_fields.jl")
 
+# HERE: try crafting generic components?
+include("./class.jl")
+
 # Central in the model nodes.
 include("./species.jl")
 
 # Trophic links, structuring the whole network.
 # (typical example 'edge' data)
-include("./foodweb.jl")
+#  include("./foodweb.jl")
 
 # Biorates and other values parametrizing the ODE.
 # (typical example 'nodes' data)
-include("./body_mass.jl")
-include("./metabolic_class.jl")
+#  include("./body_mass.jl")
+#  include("./metabolic_class.jl")
 
 # Useful global values to calculate other biorates.
 # (typical example 'graph' data)
-include("./temperature.jl")
+#  include("./temperature.jl")
 
 #  # Replicated/adapted from the above.
 #  # TODO: factorize subsequent repetitions there.
 #  # Easier once the Internals become more consistent?
 #  include("./hill_exponent.jl") # <- First, good example of 'graph' component. Read first.
-include("./growth_rate.jl") # <- First, good example of 'node' component. Read first.
-include("./efficiency.jl") # <- First, good example of 'edges' component. Read first.
+#  include("./growth_rate.jl") # <- First, good example of 'node' component. Read first.
+#  include("./efficiency.jl") # <- First, good example of 'edges' component. Read first.
 #  include("./carrying_capacity.jl")
 #  include("./mortality.jl")
 #  include("./metabolism.jl")

test/runtests.jl

@@ -19,10 +19,10 @@ using .TestUtils
 using .TestFailures
 
 sep("Test internal model representation.")
-include("./networks/runtests.jl")
+#  include("./networks/runtests.jl")
 
 sep("Test System/Blueprints/Components framework.")
-#  include("./framework/runtests.jl")
+include("./framework/runtests.jl")
 
 sep("Test API utils.")
 #  include("./graph_data_inputs/runtests.jl")