build-docs.py

import os
import sys
import shutil
import time

################################################################################
# This script is used to build documentation for IRIDA for deployment.  It will
# build the IRIDA javadoc and transfer all the documentation directories to an
# external documentation repository.  See below for usage.
################################################################################

# If no args, print usage statement
if len(sys.argv) == 1:
    print("IRIDA documentation deployment script.")
    print("Usage: build-docs.py TARGET_DIRECTORY")
    print("TARGET_DIRECTORY should be the 'irida-documentation/docs' directory")
    exit(0)

gradle_build_file = 'build.gradle.kts'
result_dir = sys.argv[1]
doc_dir = 'doc/'

# Check if we're in the irida directory
if not os.path.exists(gradle_build_file):
    print("Cannot find gradle build file.  This script must be run in the base directory of the IRIDA repository.")
    exit(1)

if not os.path.isdir(doc_dir):
    print("Cannot find `/doc` directory.  This script must be run in the base directory of the IRIDA repository.")
    exit(1)

# check if the argument is the irida-documentation/docs directory
if not (result_dir.endswith('docs') or result_dir.endswith('docs/')) or not os.path.isdir(result_dir):
    print("The target directory doesn't appear to be the irida-documentation repository's `/docs` directory.")
    exit(1)

# first generate the Open API file
print("========== Generating the Open API file")
retval = os.system('./gradlew clean generateOpenApiDocs -Dspring.profiles.active=dev,swagger -DskipTests=true -Dliquibase.update.database.schema=false')

# ensure it generated correctly
if retval != 0:
    print("========== Open API file generation failed.  See above for error messages")
    exit(1)

# second run gradle javadoc to build the javadoc
print("========== Building documentation pages")
retval = os.system('./gradlew clean javadoc')

# ensure it built correctly
if retval != 0:
    print("========== Docs construction failed.  See above for error messages")
    exit(1)

print("========== Documentation built successfully")

# Give the user 5 seconds to chicken out
print("========== WARNING: this script will now replace the existing docs directory {} with the docs built above".format(result_dir))
print("========== This process will continue in 5 seconds.  Press Ctrl+C to cancel...")
time.sleep(5)

# Remove the original docs directory
print("========== Removing original directory {}".format(result_dir))
try:
    shutil.rmtree(result_dir)
except OSError as e:
    print ("Error: %s - %s." % (e.filename, e.strerror))
    exit(1)

# Copy the new files to the result directory
print("========== Removed original directory.  Copying new files")
try:
    shutil.copytree(doc_dir,result_dir)
except OSError as e:
    print ("Error: %s - %s." % (e.filename, e.strerror))
    exit(1)

# Print a success message
print("========== Process complete.\nYou can now go to the irida-documentation repository, create a new branch, add the changed files, and create a new PR to deploy the changes.")