omnata-plugin-runtime 0.8.2__tar.gz → 0.8.3a204__tar.gz

{omnata_plugin_runtime-0.8.2 → omnata_plugin_runtime-0.8.3a204}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: omnata-plugin-runtime
-Version: 0.8.2
+Version: 0.8.3a204
 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.2 → omnata_plugin_runtime-0.8.3a204}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "omnata-plugin-runtime"
-version = "0.8.2"
+version = "0.8.3-a204"
 description = "Classes and common runtime components for building and running Omnata Plugins"
 authors = ["James Weakley <james.weakley@omnata.com>"]
 readme = "README.md"

{omnata_plugin_runtime-0.8.2 → omnata_plugin_runtime-0.8.3a204}/src/omnata_plugin_runtime/configuration.py

@@ -704,6 +704,7 @@ class OutboundSyncConfigurationParameters(SyncConfigurationParameters):
     """
 
     connection_method: str
+    target_type: Optional[str] = Field(default=None, description="The label of the OutboundTargetType selected by the user")
     connection_parameters: Optional[Dict[str, StoredConfigurationValue]] = Field(default=None)
     connection_secrets: Optional[Dict[str, StoredConfigurationValue]] = Field(default=None)
     sync_parameters: Optional[Dict[str, StoredConfigurationValue]] = Field(default=None)

{omnata_plugin_runtime-0.8.2 → omnata_plugin_runtime-0.8.3a204}/src/omnata_plugin_runtime/omnata_plugin.py

@@ -111,11 +111,45 @@ class PluginManifest(SubscriptableBaseModel):
     developer_name: str
     docs_url: str
     supports_inbound: bool
-    supported_outbound_strategies: List[OutboundSyncStrategy]
+    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."
+    )
     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'."
+    )
 
+class OutboundTargetType(BaseModel):
+    """
+    Some products have APIs that can be grouped together in ways that support different strategies and may or may not support toggling.
+    The label should answer the question: "What would you like to sync to?"
+    Examples:
+    - A CRM system may have "Standard objects", "Custom objects" or "Events"
+    - A messaging platform may have "Channels", "Users" or "Messages"
+    - A marketing platform may have "Customer lists", "Campaigns" or "Automations"
+    - An Ad platform may have "Campaigns", "Ad groups" or "Ads"
+    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):
+    """
+    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.
+    """
+    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.'")
 
 class SnowflakeFunctionParameter(BaseModel):
     """