create.py

"""Create a modern page on a SharePoint site.

https://learn.microsoft.com/en-us/sharepoint/dev/apis/site-pages-api-reference
"""

import argparse
import uuid

from office365.sharepoint.client_context import ClientContext
from tests.settings import cert_path, cert_thumbprint, client_id, team_site_url, tenant


def main():
    parser = argparse.ArgumentParser(description="Create a modern page")
    parser.add_argument("--site-url", default=team_site_url, help="target site URL")
    parser.add_argument("--title", default=f"Name{uuid.uuid4().hex[:8]}", help="page title (default: generated)")
    args = parser.parse_args()

    ctx = ClientContext(args.site_url).with_client_certificate(
        tenant, client_id=client_id, thumbprint=cert_thumbprint, cert_path=cert_path
    )
    page = ctx.site_pages.create_page(args.title).execute_query()
    print(f"Page created: {page.absolute_url}")


if __name__ == "__main__":
    main()