Apply Black formatting to improve code style

Author: batzel

atlassian/__init__.py

@@ -25,41 +25,42 @@
 # Compatibility: ConfluenceV2 is now ConfluenceCloud
 ConfluenceV2 = ConfluenceCloud
 
+
 # Factory function for Confluence client
 def create_confluence(url, *args, api_version=1, **kwargs):
     """
     Create a Confluence client with the specified API version.
-    
+
     Args:
         url: The Confluence instance URL
         api_version: API version, 1 or 2, defaults to 1
         args: Arguments to pass to Confluence constructor
         kwargs: Keyword arguments to pass to Confluence constructor
-        
+
     Returns:
         A Confluence client configured for the specified API version
     """
     return ConfluenceBase.factory(url, *args, api_version=api_version, **kwargs)
 
 
 __all__ = [
-    'Confluence',
-    'ConfluenceBase',
-    'ConfluenceCloud',
-    'ConfluenceServer',
-    'ConfluenceV2',  # For backward compatibility
-    'Jira',
-    'Bitbucket',
-    'CloudAdminOrgs',
-    'CloudAdminUsers',
-    'Portfolio',
-    'Bamboo',
-    'Stash',
-    'Crowd',
-    'ServiceDesk',
-    'ServiceManagement',
-    'MarketPlace',
-    'Xray',
-    'Insight',
-    'Assets',
+    "Confluence",
+    "ConfluenceBase",
+    "ConfluenceCloud",
+    "ConfluenceServer",
+    "ConfluenceV2",  # For backward compatibility
+    "Jira",
+    "Bitbucket",
+    "CloudAdminOrgs",
+    "CloudAdminUsers",
+    "Portfolio",
+    "Bamboo",
+    "Stash",
+    "Crowd",
+    "ServiceDesk",
+    "ServiceManagement",
+    "MarketPlace",
+    "Xray",
+    "Insight",
+    "Assets",
 ]

atlassian/confluence.py.bak

@@ -0,0 +1,41 @@
+"""
+Legacy module for backward compatibility.
+New code should use the confluence package directly.
+"""
+
+import warnings
+from typing import Optional, Union
+
+from .confluence.cloud import ConfluenceCloud
+from .confluence.server import ConfluenceServer
+
+
+def Confluence(url: str, *args, cloud: Optional[bool] = None, api_version: Union[str, int] = 1, **kwargs):
+    """
+    Factory function to create appropriate Confluence instance.
+
+    Args:
+        url: The Confluence instance URL
+        cloud: Whether this is a cloud instance. If None, will be auto-detected
+        api_version: API version to use (1 or 2, only applicable for cloud)
+        *args: Arguments to pass to the constructor
+        **kwargs: Keyword arguments to pass to the constructor
+
+    Returns:
+        ConfluenceCloud or ConfluenceServer instance
+    """
+    warnings.warn(
+        "Direct Confluence class instantiation is deprecated. "
+        "Use ConfluenceCloud or ConfluenceServer classes from atlassian.confluence package.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+
+    # Auto-detect cloud if not specified
+    if cloud is None:
+        cloud = any(domain in url.lower() for domain in [".atlassian.net", ".jira.com"])
+
+    if cloud:
+        return ConfluenceCloud(url, *args, api_version=api_version, **kwargs)
+    else:
+        return ConfluenceServer(url, *args, **kwargs)

atlassian/confluence/__init__.py

@@ -1,25 +1,28 @@
 """
 Confluence module for both Cloud and Server implementations
 """
+
 from .base import ConfluenceBase
 from .cloud import ConfluenceCloud
 from .server import ConfluenceServer
 from typing import Union
 
+
 def Confluence(url: str, *args, **kwargs) -> Union[ConfluenceCloud, ConfluenceServer]:
     """
     Factory function to create appropriate Confluence instance based on URL
-    
+
     Args:
         url: The Confluence instance URL
         *args: Arguments to pass to the implementation
         **kwargs: Keyword arguments to pass to the implementation
-        
+
     Returns:
         Either ConfluenceCloud or ConfluenceServer instance
     """
     if ConfluenceBase._is_cloud_url(url):
         return ConfluenceCloud(url, *args, **kwargs)
     return ConfluenceServer(url, *args, **kwargs)
 
-__all__ = ['Confluence', 'ConfluenceBase', 'ConfluenceCloud', 'ConfluenceServer'] 
+
+__all__ = ["Confluence", "ConfluenceBase", "ConfluenceCloud", "ConfluenceServer"]