Confluence Integration

from confluence_integration import ConfluencePermissions

# Initialize validator
validator = ConfluencePermissions(
    url="https://your-domain.atlassian.net",
    email="[email protected]",
    api_token="your_api_token",
    space_key="YOUR_SPACE"
)

# Run all tests
results = validator.run_all_tests()

# Check results
if results["all_passed"]:
    print("✅ All permissions validated!")
    for test in results["tests"]:
        print(f"{test.test_name}: {test.message}")
else:
    print("❌ Some tests failed")
    print(f"Passed: {results['summary']['passed']}/{results['summary']['total']}")

from confluence_integration import ConfluenceReader

# Initialize reader with filters
reader = ConfluenceReader(
    url="https://your-domain.atlassian.net",
    email="[email protected]",
    api_token="your_api_token",
    space_key="YOUR_SPACE",
    start_date="2026-05-01",  # Optional: defaults to 30 days ago
    end_date="2026-06-01",    # Optional: defaults to today
    authors=["[email protected]", "[email protected]"]  # Optional: defaults to all
)

# Get pages matching filters
pages = reader.get_pages(include_content=True)

# Process pages
for page in pages:
    print(f"Title: {page.title}")
    print(f"Author: {page.author_display_name}")
    print(f"Created: {page.created_date}")
    print(f"Modified: {page.modified_date}")
    print(f"URL: {page.url}")
    if page.content:
        print(f"Content: {page.content[:100]}...")
    print()

from confluence_integration import ConfluencePermissions

validator = ConfluencePermissions(
    url="https://apptio.atlassian.net",
    email="[email protected]",
    api_token="ATATT3xFfGF0...",
    space_key="ENGINEERING"
)

results = validator.run_all_tests()

# Access individual test results
for test in results["tests"]:
    print(f"{test.test_name}: {'PASS' if test.passed else 'FAIL'}")
    if test.data:
        print(f"  Data: {test.data}")

from confluence_integration import ConfluencePermissions

validator = ConfluencePermissions(
    url="https://apptio.atlassian.net",
    email="[email protected]",
    api_token="ATATT3xFfGF0...",
    space_key="ENGINEERING"
)

# Initialize connection
init_result = validator._initialize_client()
if not init_result.passed:
    print(f"Connection failed: {init_result.error}")
    exit(1)

# Run individual tests
create_result = validator.test_1_create_page()
print(f"CREATE: {create_result.message}")

read_result = validator.test_2_read_page()
print(f"READ: {read_result.message}")

# Clean up
validator.test_5_delete_page()

import sys
from confluence_integration import ConfluencePermissions

def validate_confluence_access():
    """Validate Confluence access in CI/CD pipeline."""
    validator = ConfluencePermissions(
        url=os.environ["CONFLUENCE_URL"],
        email=os.environ["CONFLUENCE_EMAIL"],
        api_token=os.environ["CONFLUENCE_API_TOKEN"],
        space_key=os.environ["CONFLUENCE_SPACE_KEY"]
    )
    
    results = validator.run_all_tests()
    
    if not results["all_passed"]:
        print("❌ Confluence permission validation failed!")
        for test in results["tests"]:
            if not test.passed:
                print(f"  {test.test_name}: {test.error}")
        sys.exit(1)
    
    print("✅ Confluence permissions validated successfully")
    return True

if __name__ == "__main__":
    validate_confluence_access()

from confluence_integration import ConfluenceReader
from datetime import datetime, timedelta

# Read pages from last 7 days
end_date = datetime.now()
start_date = end_date - timedelta(days=7)

reader = ConfluenceReader(
    url="https://apptio.atlassian.net",
    email="[email protected]",
    api_token="ATATT3xFfGF0...",
    space_key="ENGINEERING",
    start_date=start_date.strftime("%Y-%m-%d"),
    end_date=end_date.strftime("%Y-%m-%d")
)

# Get pages without content (faster)
pages = reader.get_pages(include_content=False)

print(f"Found {len(pages)} pages in the last 7 days")
for page in pages:
    print(f"- {page.title} by {page.author_display_name}")

from confluence_integration import ConfluenceReader

reader = ConfluenceReader(
    url="https://apptio.atlassian.net",
    email="[email protected]",
    api_token="ATATT3xFfGF0...",
    space_key="ENGINEERING",
    authors=["[email protected]", "[email protected]"]
)

# Get pages with content
pages = reader.get_pages(include_content=True)

# Group by author
from collections import defaultdict
by_author = defaultdict(list)
for page in pages:
    by_author[page.author_display_name].append(page)

for author, author_pages in by_author.items():
    print(f"\n{author}: {len(author_pages)} pages")
    for page in author_pages:
        print(f"  - {page.title}")

class ConfluencePermissions:
    def __init__(self, url: str, email: str, api_token: str, space_key: str)
    def run_all_tests(self) -> Dict[str, Any]
    def test_1_create_page(self) -> TestResult
    def test_2_read_page(self) -> TestResult
    def test_3_update_page(self) -> TestResult
    def test_4_read_verify(self) -> TestResult
    def test_5_delete_page(self) -> TestResult
    def test_6_delete_verify(self) -> TestResult

class ConfluenceReader:
    def __init__(
        self,
        url: str,
        email: str,
        api_token: str,
        space_key: str,
        start_date: Optional[str] = None,  # YYYY-MM-DD format, default: 30 days ago
        end_date: Optional[str] = None,    # YYYY-MM-DD format, default: today
        authors: Optional[List[str]] = None  # List of author emails/usernames, default: all
    )
    def get_pages(self, include_content: bool = False, limit: int = 100) -> List[PageInfo]
    def get_page_count(self) -> int
    def get_space_info(self) -> Dict[str, Any]

@dataclass
class TestResult:
    test_name: str              # Name of the test
    passed: bool                # Whether the test passed
    message: str                # Human-readable message
    error: Optional[str]        # Error message if failed
    data: Optional[Dict]        # Additional test data

@dataclass
class PageInfo:
    page_id: str                    # Confluence page ID
    title: str                      # Page title
    space_key: str                  # Space key
    author: str                     # Author email or username
    author_display_name: str        # Author display name
    created_date: datetime          # Page creation date
    modified_date: datetime         # Last modification date
    version: int                    # Page version number
    url: str                        # Full page URL
    content: Optional[str]          # Page content (if requested)

{
    "all_passed": bool,         # True if all tests passed
    "tests": List[TestResult],  # List of test results
    "summary": {
        "passed": int,          # Number of passed tests
        "failed": int,          # Number of failed tests
        "total": int            # Total number of tests
    }
}