use triple strings

oppia · brianrodri · Sep 8, 2019 · Aug 17, 2019 · Aug 18, 2019 · Aug 18, 2019
commit 911d84ab18caea4656763f04a0812aa6d84de01f
@@ -143,11 +143,11 @@
 APP_DEV_YAML_FILEPATH = 'app_dev.yaml'
 APP_YAML_FILEPATH = 'app.yaml'
 
-_PARSER = argparse.ArgumentParser(
-    description='Creates a third-party directory where all the JS and CSS '
-    'dependencies are built and stored. Depending on the options passed to the '
-    'script, might also minify third-party libraries and/or generate a build '
-    'directory.')
+_PARSER = argparse.ArgumentParser(description="""
+Creates a third-party directory where all the JS and CSS dependencies are
+built and stored. Depending on the options passed to the script, might also
+minify third-party libraries and/or generate a build directory.
+""")
 
 _PARSER.add_argument(
     '--prod_env', action='store_true', default=False, dest='prod_mode')

@@ -25,8 +25,9 @@
 CURR_DIR = os.path.abspath(os.getcwd())
 OPPIA_TOOLS_DIR = os.path.join(CURR_DIR, '..', 'oppia_tools')
 
-_PARSER = argparse.ArgumentParser(
-    description='Deletes temporary and installed files.')
+_PARSER = argparse.ArgumentParser(description="""
+Deletes temporary and installed files.
+""")
 
 
 def delete_directory_tree(directory_path):

@@ -27,10 +27,11 @@
 from . import common
 from . import setup
 
-_PARSER = argparse.ArgumentParser(
-    description='Run this script from the oppia root folder: '
-    'python -m scripts.create_expression_parser. '
-    'The root folder MUST be named \'oppia\'.')
+_PARSER = argparse.ArgumentParser(description="""
+Run this script from the oppia root folder:
+    python -m scripts.create_expression_parser
+The root folder MUST be named 'oppia'.
+""")
 
 
 def main(args=None):

@@ -24,9 +24,10 @@
 
 import python_utils
 
-_PARSER = argparse.ArgumentParser(
-    description='This script should only be run by Travis to install and '
-    'provide a constant version of Chrome.')
+_PARSER = argparse.ArgumentParser(description="""
+This script should only be run by Travis to install and provide a constant
+version of Chrome.
+""")
 
 
 def main(args=None):

@@ -70,8 +70,9 @@
     }
 }
 
-_PARSER = argparse.ArgumentParser(
-    description='Installation script for Oppia third-party libraries.')
+_PARSER = argparse.ArgumentParser(description="""
+Installation script for Oppia third-party libraries.
+""")
 
 
 def download_files(source_url_root, target_dir, source_filenames):

@@ -50,8 +50,9 @@
 # pylint: enable=wrong-import-order
 # pylint: enable=wrong-import-position
 
-_PARSER = argparse.ArgumentParser(
-    description='Installation script for Oppia third-party libraries.')
+_PARSER = argparse.ArgumentParser(description="""
+Installation script for Oppia third-party libraries.
+""")
 
 _PARSER.add_argument(
     '--nojsrepl',

@@ -80,10 +80,11 @@
 _LOAD_TESTS_DIR = os.path.join(os.getcwd(), 'core', 'tests', 'load_tests')
 
 
-_PARSER = argparse.ArgumentParser(
-    description='Run this script from the oppia root folder: '
-    'python -m scripts.run_backend_tests. '
-    'IMPORTANT: Only one of --test_path and --test_target should be specified.')
+_PARSER = argparse.ArgumentParser(description="""
+Run this script from the oppia root folder:
+    python -m scripts.run_backend_tests
+IMPORTANT: Only one of --test_path and --test_target should be specified.
+""")
 
 _EXCLUSIVE_GROUP = _PARSER.add_mutually_exclusive_group()
 _EXCLUSIVE_GROUP.add_argument(

@@ -28,12 +28,13 @@
 from . import setup
 from . import setup_gae
 
-_PARSER = argparse.ArgumentParser(
-    description='Run this script from the oppia root folder: '
-    'python -m scripts.run_frontend_tests. '
-    'The root folder MUST be named \'oppia\'. '
-    'Note: You can replace \'it\' with \'fit\' or \'describe\' with '
-    '\'fdescribe\' to run a single test or test suite.')
+_PARSER = argparse.ArgumentParser(description="""
+Run this script from the oppia root folder:
+    python -m scripts.run_frontend_tests
+The root folder MUST be named 'oppia'.
+Note: You can replace 'it' with 'fit' or 'describe' with 'fdescribe' to run
+a single test or test suite.
+""")
 
 _PARSER.add_argument(
     '--skip_install',

@@ -31,14 +31,15 @@
 from . import setup
 from . import setup_gae
 
-_PARSER = argparse.ArgumentParser(
-    description='The root folder MUST be named \'oppia\'. '
-    'Run all tests sequentially: '
-    'python -m scripts.run_performance_tests without args in order to run all '
-    'tests sequentially. '
-    'Run test for a specific page: '
-    'python -m scripts.run_performance_tests --test_name=page_test. '
-    'page_test is the name of the file containing that test eg. splash_test.')
+_PARSER = argparse.ArgumentParser(description="""
+The root folder MUST be named 'oppia'.
+Run all tests sequentially:
+    python -m scripts.run_performance_tests without args in order to run all
+    tests sequentially.
+Run test for a specific page:
+    python -m scripts.run_performance_tests --test_name=page_test
+page_test is the name of the file containing that test eg. splash_test.
+""")
 
 _PARSER.add_argument(
     '--skip_install',

@@ -31,23 +31,22 @@
 from . import run_backend_tests
 from . import run_frontend_tests
 
-_PARSER = argparse.ArgumentParser(
-    description='Run this script from the oppia root folder prior to opening a '
-    'PR: '
-    'python -m scripts.run_presubmit_checks '
-    'Set the origin branch to compare against by adding '
-    '--branch=your_branch or -b=your_branch '
-    'By default, if the current branch tip exists on remote origin, '
-    'the current branch is compared against its tip on GitHub. '
-    'Otherwise it\'s compared against \'develop\'. '
-    'This script runs the following tests in all cases. '
-    '- Javascript and Python Linting '
-    '- Backend Python tests '
-    'Only when frontend files are changed will it run Frontend Karma unit '
-    'tests. '
-    'If any of these tests result in errors, this script will terminate. '
-    'Note: The test scripts are arranged in increasing order of time taken. '
-    'This enables a broken build to be detected as quickly as possible.')
+_PARSER = argparse.ArgumentParser(description="""
+Run this script from the oppia root folder prior to opening a PR:
+    python -m scripts.run_presubmit_checks
+Set the origin branch to compare against by adding
+--branch=your_branch or -b=your_branch
+By default, if the current branch tip exists on remote origin,
+the current branch is compared against its tip on GitHub.
+Otherwise it's compared against 'develop'.
+This script runs the following tests in all cases.
+- Javascript and Python Linting
+- Backend Python tests
+Only when frontend files are changed will it run Frontend Karma unit tests.
+If any of these tests result in errors, this script will terminate.
+Note: The test scripts are arranged in increasing order of time taken. This
+enables a broken build to be detected as quickly as possible.
+""")
 
 _PARSER.add_argument(
     '--branch', '-b',

@@ -35,13 +35,14 @@
 from . import setup
 from . import setup_gae
 
-_PARSER = argparse.ArgumentParser(
-    description='Run this script from the oppia root folder: '
-    'python -m scripts.run_tests '
-    'This script runs all the tests, in this order: '
-    '- Frontend Karma unit tests '
-    '- Backend Python tests '
-    '- End-to-end Protractor tests ')
+_PARSER = argparse.ArgumentParser(description="""
+Run this script from the oppia root folder:
+    python -m scripts.run_tests
+This script runs all the tests, in this order:
+- Frontend Karma unit tests
+- Backend Python tests
+- End-to-end Protractor tests
+""")
 
 
 def main(args=None):

@@ -27,8 +27,9 @@
 from . import clean
 from . import common
 
-_PARSER = argparse.ArgumentParser(
-    description='Python execution environent set up for all scripts.')
+_PARSER = argparse.ArgumentParser(description="""
+Python execution environent set up for all scripts.
+""")
 
 
 def delete_directory_tree(directory_path):

@@ -26,9 +26,9 @@
 
 from . import common
 
-_PARSER = argparse.ArgumentParser(
-    description='Python execution environment setup for scripts that require '
-    'GAE.')
+_PARSER = argparse.ArgumentParser(description="""
+Python execution environment setup for scripts that require GAE.
+""")
 
 
 def main(args=None):

@@ -35,10 +35,11 @@
 from . import setup
 from . import setup_gae
 
-_PARSER = argparse.ArgumentParser(
-    description='Run the script from the oppia root folder: '
-    'python -m scripts.start '
-    'Note that the root folder MUST be named \'oppia\'.')
+_PARSER = argparse.ArgumentParser(description="""
+Run the script from the oppia root folder:
+    python -m scripts.start
+Note that the root folder MUST be named 'oppia'.
+""")
 
 _PARSER.add_argument(
     '--save_datastore',