Noissue - remove 'docs' command

build.py

 # This Source Code Form is subject to the terms of the Mozilla Public
 # License, v. 2.0. If a copy of the MPL was not distributed with this
 # file, You can obtain one at http://mozilla.org/MPL/2.0/.
 
 import argparse
 import logging
 import io
 import json
 import os
 import re
 import shutil
-import subprocess
-import sys
 from urllib import urlencode
 import urllib2
 from functools import partial
 from StringIO import StringIO
 from zipfile import ZipFile
 from buildtools.localeTools import read_locale_config
 
 KNOWN_PLATFORMS = {'chrome', 'gecko', 'edge', 'generic'}
 
 MAIN_PARSER = argparse.ArgumentParser(
@@ skipping 255 matching lines @@
     from buildtools.packager import readMetadata
     metadata = readMetadata(base_dir, platform)
 
     basename = metadata.get('general', 'basename')
     locale_config = read_locale_config(base_dir, platform, metadata)
 
     import buildtools.localeTools as localeTools
     localeTools.getTranslations(locale_config, basename, project_key)
 
 
-@argparse_command(
-    valid_platforms={'chrome'},
-    arguments=(
-        make_argument('target_dir'),
-        make_argument('-q', '--quiet', help='Suppress JsDoc output',
-                      action='store_true', default=False),
-    ),
-)
-def docs(base_dir, target_dir, quiet, platform, **kwargs):
-    """
-    Generate documentation (requires node.js).
-
-    Generate documentation files and write them into the specified directory.
-    """
-    source_dir = os.path.join(base_dir, 'lib')
-
-    # JSDoc struggles wih huge objects:
-    # https://github.com/jsdoc3/jsdoc/issues/976
-    sources = [os.path.join(source_dir, filename)
-               for filename in os.listdir(source_dir)
-               if filename != 'publicSuffixList.js']
-
-    buildtools_path = os.path.dirname(__file__)
-    config = os.path.join(buildtools_path, 'jsdoc.conf')
-
-    command = ['npm', 'run-script', 'jsdoc', '--', '--destination', target_dir,
-               '--configure', config] + sources
-    if quiet:
-        process = subprocess.Popen(command, stdout=subprocess.PIPE,
-                                   stderr=subprocess.PIPE, cwd=buildtools_path)
-        stderr = process.communicate()[1]
-        retcode = process.poll()
-        if retcode:
-            sys.stderr.write(stderr)
-            raise subprocess.CalledProcessError(command, retcode)
-    else:
-        subprocess.check_call(command, cwd=buildtools_path)
-
-
 def valid_version_format(value):
     if re.search(r'[^\d\.]', value):
         raise argparse.ArgumentTypeError('Wrong version number format')
 
     return value
 
 
 @argparse_command(
     valid_platforms={'chrome', 'gecko', 'edge'}, multi_platform=True,
     arguments=(
@@ skipping 58 matching lines @@
     if build_available_subcommands(base_dir):
         MAIN_PARSER.set_defaults(base_dir=base_dir)
 
         # If no args are provided, this module is run directly from the command
         # line. argparse will take care of consuming sys.argv.
         arguments = MAIN_PARSER.parse_args(args if len(args) > 0 else None)
 
         function = arguments.function
         del arguments.function
         function(**vars(arguments))