omnata-plugin-runtime 0.8.3a204__py3-none-any.whl → 0.8.3a207__py3-none-any.whl

omnata_plugin_runtime/omnata_plugin.py

@@ -112,16 +112,14 @@ class PluginManifest(SubscriptableBaseModel):
     docs_url: str
     supports_inbound: bool
     supported_outbound_strategies: List[OutboundSyncStrategy] = Field(
-        ...,
-        deprecated=True,
-        title="A list of sync strategies that the plugin can support. This has been replaced by OutboundTargetTypes."
+        title="A list of sync strategies that the plugin can support. If outbound_target_types are specified, theses strategies are allocated there. Otherwise, they apply globally"
     )
     supported_connectivity_options: List[ConnectivityOption] = Field(
         default_factory=lambda: [ConnectivityOption.DIRECT]
     )
-    outbound_target_types: List[OutboundTargetType] = Field(
-        ...,
-        title="A list of target types that the plugin can support. This replaces the deprecated 'supported_outbound_strategies'."
+    outbound_target_types: Optional[List[OutboundTargetType]] = Field(
+        default=None,
+        title="An optional list of target types that the plugin can support."
     )
 
 class OutboundTargetType(BaseModel):
@@ -136,20 +134,33 @@ class OutboundTargetType(BaseModel):
     The target type cannot be changed after the sync is created.
     """
     label: str
-    supported_strategies: List[OutboundSyncStrategy]
-    target_toggle_field: Optional[OutboundTargetToggleField] = None
-
-class OutboundTargetToggleField(BaseModel):
+    supported_strategies: List[str] = Field(
+        title="The names of the sync strategies supported by this target. Each one must match the name of a sync strategy declared in supported_outbound_strategies."
+    )
+    target_parameter: Optional[OutboundTargetParameter] = Field(
+        default=None,
+        title="""The sync configuration parameter that designates the target object, if applicable. For example, 'object_name' or 'channel_name'. 
+This will be used for two purposes:
+1. To show a more readable indication of what this sync is doing in the UI, e.g. Standard object: Account
+2. Designates this field as serving as a br toggle for testing in production.""")
+
+class OutboundTargetParameter(BaseModel):
     """
     Accomodates testing outbound syncs in production by nominating a form field who's value stays in the branch.
-    For example, a messaging plugin could have a "channel" field to route messages to an alternate location.
-    Or, a marketing platform could have an alternate customer list name which is connected to test campaigns that don't actually send.
-    The field_name must match a field which will be returned by the outbound_configuration_form for this target type.
-    The reason this is set separately here instead of as a flag on the FormField, is so that the sync engine can know
-    whether or not location toggling is supported for a target type without calling the plugin.
+    The reason this information is set statically here instead of as a flag on the FormField, is so that the sync engine 
+    can have this information readily available without calling the plugin.
     """
-    field_name: str = Field(..., title="The name of the form field that toggles the location")
-    label: str = Field(..., title="Used in the UI when describing the location. It should completely describe the behaviour when used in a sentence like this: 'Changes will be tested against a different <label> when running in a branch.'")
+    field_name: str = Field(title="""The name of the form field that toggles the location, e.g. 'channel','customer_list'.
+This must match a field which will be returned by the outbound_configuration_form for this target type.""")
+    is_branching_toggle: bool = Field(title="""Whether or not this field is a target toggle for branching.
+If true, the value of this field will be used to determine the location of the sync in production.
+For example, a messaging plugin could have a "channel" field to route messages to an alternate location.
+Or, a marketing platform could have an alternate customer list name which is connected to test campaigns that don't actually send.
+
+This should only be used in situations where all other sync parameters and field mappings can remain consistent between branches.""")
+    label: str = Field(title="""Used in the UI when describing the location., e.g. 'Channel','Customer List'. 
+It should completely describe the behaviour when used in a sentence like this: 
+'Changes will be tested against a different <label> when running in a branch.'""")
 
 class SnowflakeFunctionParameter(BaseModel):
     """

{omnata_plugin_runtime-0.8.3a204.dist-info → omnata_plugin_runtime-0.8.3a207.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: omnata-plugin-runtime
-Version: 0.8.3a204
+Version: 0.8.3a207
 Summary: Classes and common runtime components for building and running Omnata Plugins
 Author: James Weakley
 Author-email: james.weakley@omnata.com

{omnata_plugin_runtime-0.8.3a204.dist-info → omnata_plugin_runtime-0.8.3a207.dist-info}/RECORD

@@ -3,10 +3,10 @@ omnata_plugin_runtime/api.py,sha256=tVi4KLL0v5N3yz3Ie0kSyFemryu572gCbtSRfWN6wBU,
 omnata_plugin_runtime/configuration.py,sha256=g6A9sFHBBaCgZPjhTM4iYcyEoZDPjB1F24QMboLteyY,38505
 omnata_plugin_runtime/forms.py,sha256=ueodN2GIMS5N9fqebpY4uNGJnjEb9HcuaVQVfWH-cGg,19838
 omnata_plugin_runtime/logging.py,sha256=WBuZt8lF9E5oFWM4KYQbE8dDJ_HctJ1pN3BHwU6rcd0,4461
-omnata_plugin_runtime/omnata_plugin.py,sha256=fs8yrPUhZ3rsU4rcl_MuXNltEufb1nKrcXV-I88MTCA,133443
+omnata_plugin_runtime/omnata_plugin.py,sha256=WrttykPnWR5ckL2SHUbcU6yYpNb-_HTL3LzFB6cBMd8,134356
 omnata_plugin_runtime/plugin_entrypoints.py,sha256=sB_h6OBEMk7lTLIjdNrNo9Sthk8UE9PnK2AUcQJPe9I,32728
 omnata_plugin_runtime/rate_limiting.py,sha256=eOWVRYWiqPlVeYzmB1exVXfXbrcpmYb7vtTi9B-4zkQ,25868
-omnata_plugin_runtime-0.8.3a204.dist-info/LICENSE,sha256=rGaMQG3R3F5-JGDp_-rlMKpDIkg5n0SI4kctTk8eZSI,56
-omnata_plugin_runtime-0.8.3a204.dist-info/METADATA,sha256=nJD4bsjd9pTQaG1pnZc-Wt_1JVEpYH9pX05uNgY06UI,2158
-omnata_plugin_runtime-0.8.3a204.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-omnata_plugin_runtime-0.8.3a204.dist-info/RECORD,,
+omnata_plugin_runtime-0.8.3a207.dist-info/LICENSE,sha256=rGaMQG3R3F5-JGDp_-rlMKpDIkg5n0SI4kctTk8eZSI,56
+omnata_plugin_runtime-0.8.3a207.dist-info/METADATA,sha256=aU_EJv5HVn3CXBKKuJaD3JFhBANrOT_o883o2fvIdpA,2158
+omnata_plugin_runtime-0.8.3a207.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+omnata_plugin_runtime-0.8.3a207.dist-info/RECORD,,