Deprecate allow_profiles_outside_organization parameter (#279)

* Mark `allow_profiles_outside_organization` as deprecated

* Only serialize params if a value is passed

* Run `black`

* Run correct version of `black`

* Check with `is not None` instead

Author: mthadley

workos/organizations.py

@@ -175,9 +175,11 @@ def create_organization(self, organization, idempotency_key=None):
         Args:
             organization (dict) - An organization object
                 organization[name] (str) - A unique, descriptive name for the organization
-                organization[allow_profiles_outside_organization] (boolean) - Whether Connections
+                organization[allow_profiles_outside_organization] (boolean) - [Deprecated] Whether Connections
                     within the Organization allow profiles that are outside of the Organization's
                     configured User Email Domains. (Optional)
+                organization[domains] (list[dict]) - [Deprecated] Use domain_data instead. List of domains that
+                    belong to the organization. (Optional)
                 organization[domain_data] (list[dict]) - List of domains that belong to the organization.
                     organization[domain_data][][domain] - The domain of the organization.
                     organization[domain_data][][state] - The state of the domain: either 'verified' or 'pending'.
@@ -196,6 +198,13 @@ def create_organization(self, organization, idempotency_key=None):
                 DeprecationWarning,
             )
 
+        if "allow_profiles_outside_organization" in organization:
+            warn(
+                "The `allow_profiles_outside_organization` parameter for `create_orgnaization` is deprecated. "
+                "If you need to allow sign-ins from any email domain, contact [email protected].",
+                DeprecationWarning,
+            )
+
         response = self.request_helper.request(
             ORGANIZATIONS_PATH,
             method=REQUEST_METHOD_POST,
@@ -219,7 +228,7 @@ def update_organization(
         Args:
             organization(str) - Organization's unique identifier.
             name (str) - A unique, descriptive name for the organization.
-            allow_profiles_outside_organization (boolean) - Whether Connections
+            allow_profiles_outside_organization (boolean) - [Deprecated] Whether Connections
                 within the Organization allow profiles that are outside of the Organization's
                 configured User Email Domains. (Optional)
             domains (list) - [Deprecated] Use domain_data instead. List of domains that belong to the organization. (Optional)
@@ -230,18 +239,29 @@ def update_organization(
         Returns:
             dict: Updated Organization response from WorkOS.
         """
-        if domains:
+
+        params = {"name": name}
+
+        if domains is not None:
             warn(
                 "The 'domains' parameter for 'update_organization' is deprecated. Please use 'domain_data' instead.",
                 DeprecationWarning,
             )
+            params["domains"] = domains
+
+        if allow_profiles_outside_organization is not None:
+            warn(
+                "The `allow_profiles_outside_organization` parameter for `create_orgnaization` is deprecated. "
+                "If you need to allow sign-ins from any email domain, contact [email protected].",
+                DeprecationWarning,
+            )
+            params[
+                "allow_profiles_outside_organization"
+            ] = allow_profiles_outside_organization
+
+        if domain_data is not None:
+            params["domain_data"] = domain_data
 
-        params = {
-            "name": name,
-            "domains": domains,
-            "domain_data": domain_data,
-            "allow_profiles_outside_organization": allow_profiles_outside_organization,
-        }
         response = self.request_helper.request(
             "organizations/{organization}".format(organization=organization),
             method=REQUEST_METHOD_PUT,