HEX
Server: Apache/2.4.59 (Debian)
System: Linux keymana 4.19.0-21-cloud-amd64 #1 SMP Debian 4.19.249-2 (2022-06-30) x86_64
User: lijunjie (1003)
PHP: 7.4.33
Disabled: pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare,
Upload Files
File: //lib/google-cloud-sdk/lib/googlecloudsdk/command_lib/domains/flags.py
# -*- coding: utf-8 -*- #
# Copyright 2020 Google LLC. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#    http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""Shared flags for Cloud Domains commands."""

from __future__ import absolute_import
from __future__ import division
from __future__ import unicode_literals

import enum

from googlecloudsdk.api_lib.util import apis
from googlecloudsdk.calliope import arg_parsers
from googlecloudsdk.calliope import base
from googlecloudsdk.command_lib.util.apis import arg_utils


class MutationOp(enum.Enum):
  """Different types of mutation operations."""
  REGISTER = 1
  UPDATE = 2


def AddConfigureDNSSettingsFlagsToParser(parser):
  """Get flags for changing DNS settings.

  Args:
    parser: argparse parser to which to add these flags.
  """
  _AddDNSSettingsFlagsToParser(
      parser, allow_from_file=True, mutation_op=MutationOp.UPDATE)

  base.Argument(  # This is not a go/gcloud-style#commonly-used-flags.
      '--unsafe-dns-update',
      default=False,
      action='store_true',
      help='Use this flag to allow DNS changes that may make '
      'your domain stop serving.').AddToParser(parser)


def AddConfigureContactsSettingsFlagsToParser(parser):
  """Get flags for changing contact settings.

  Args:
    parser: argparse parser to which to add these flags.
  """
  _AddContactSettingsFlagsToParser(parser, mutation_op=MutationOp.UPDATE)

  base.Argument(  # This is not a go/gcloud-style#commonly-used-flags.
      '--notices',
      help='Notices about special properties of contacts.',
      metavar='NOTICE',
      type=arg_parsers.ArgList(
          element_type=str,
          choices=CONTACT_NOTICE_ENUM_MAPPER.choices)).AddToParser(parser)


def AddRegisterFlagsToParser(parser):
  """Get flags for registering a domain.

  Args:
    parser: argparse parser to which to add these flags.
  """
  _AddDNSSettingsFlagsToParser(
      parser, allow_from_file=False, mutation_op=MutationOp.REGISTER)
  _AddContactSettingsFlagsToParser(parser, mutation_op=MutationOp.REGISTER)
  base.Argument(  # This is not a go/gcloud-style#commonly-used-flags.
      '--yearly-price',
      help=('You must accept the yearly price of the domain, either in the '
            'interactive flow or using this flag. The expected format is a '
            'number followed by a currency code, e.g. "12.00 USD". You can get '
            'the price using the get-register-parameters command.'),
  ).AddToParser(parser)

  notice_choices = CONTACT_NOTICE_ENUM_MAPPER.choices.copy()
  notice_choices.update({
      'hsts-preloaded':
          ('By sending this notice you acknowledge that the domain is '
           'preloaded on the HTTP Strict Transport Security list in browsers. '
           'Serving a website on such domain will require an SSL certificate. '
           'See https://support.google.com/domains/answer/7638036 for details.')
  })
  base.Argument(  # This is not a go/gcloud-style#commonly-used-flags.
      '--notices',
      help='Notices about special properties of certain domains or contacts.',
      metavar='NOTICE',
      type=arg_parsers.ArgList(element_type=str,
                               choices=notice_choices)).AddToParser(parser)


def _AddDNSSettingsFlagsToParser(parser, allow_from_file, mutation_op):
  """Get flags for providing DNS settings.

  Args:
    parser: argparse parser to which to add these flags.
    allow_from_file: If true, --dns-settings-from-file will also be added.
    mutation_op: operation for which we're adding flags.
  """
  group_help_text = """\
      Set the authoritative name servers for the given domain.
      """
  if mutation_op != MutationOp.REGISTER:
    group_help_text = group_help_text + """

    Warning: Do not change name servers if ds_records is non-empty. Clear
    ds_records first by calling this command with the --disable-dnssec flag, and
    wait 24 hours before changing name servers. Otherwise your domain may stop
    serving.

        """

  dns_group = base.ArgumentGroup(
      mutex=True, help=group_help_text, category=base.COMMONLY_USED_FLAGS)
  dns_group.AddArgument(
      base.Argument(
          '--name-servers',
          help='List of DNS name servers for the domain.',
          metavar='NAME_SERVER',
          type=arg_parsers.ArgList(str, min_length=2)))
  dns_group.AddArgument(
      base.Argument(
          '--cloud-dns-zone',
          help=(
              'The name of the Cloud DNS managed-zone to set as the name '
              'server for the domain.\n'
              'If it\'s in the same project, you can use short name. If not, '
              'use the full resource name, e.g.: --cloud-dns-zone='
              'projects/example-project/managedZones/example-zone.\n'
              'If the zone is signed, DNSSEC will be enabled by default unless '
              'you pass --disable-dnssec.')))
  dns_group.AddArgument(
      base.Argument(
          '--use-google-domains-dns',
          help=(
              'Use free name servers provided by Google Domains. \n'
              'If the zone is signed, DNSSEC will be enabled by default unless '
              'you pass --disable-dnssec.'),
          default=False,
          action='store_true'))
  if allow_from_file:
    help_text = """\
    A YAML file containing the required DNS settings.
    If specified, its content will replace the values currently used in the
    registration resource. If the file is missing some of the dns_settings
    fields, those fields will be cleared.

    Examples of file contents:

    ```
    googleDomainsDns:
      dsState: DS_RECORDS_PUBLISHED
    glueRecords:
    - hostName: ns1.example.com
      ipv4Addresses:
      - 8.8.8.8
    - hostName: ns2.example.com
      ipv4Addresses:
      - 8.8.8.8
    ```

    ```
    customDns:
      nameServers:
      - new.ns1.com
      - new.ns2.com
      dsRecords:
      - keyTag: 24
        algorithm: RSASHA1
        digestType: SHA256
        digest: 2e1cfa82b035c26cbbbdae632cea070514eb8b773f616aaeaf668e2f0be8f10d
      - keyTag: 42
        algorithm: RSASHA1
        digestType: SHA256
        digest: 2e1cfa82bf35c26cbbbdae632cea070514eb8b773f616aaeaf668e2f0be8f10d
    ```
        """
    dns_group.AddArgument(
        base.Argument(
            '--dns-settings-from-file',
            help=help_text,
            metavar='DNS_SETTINGS_FILE_NAME'))
  dns_group.AddToParser(parser)
  base.Argument(
      '--disable-dnssec',
      help="""\
      Use this flag to disable DNSSEC, or to skip enabling it when switching
      to a Cloud DNS Zone or Google Domains nameservers.
      """,
      default=False,
      action='store_true').AddToParser(parser)


def _AddContactSettingsFlagsToParser(parser, mutation_op):
  """Get flags for providing Contact settings.

  Args:
    parser: argparse parser to which to add these flags.
    mutation_op: operation for which we're adding flags.
  """
  help_text = """\
    A YAML file containing the contact data for the domain's three contacts:
    registrant, admin, and technical.

    The file can either specify a single set of contact data with label
    'allContacts', or three separate sets of contact data with labels
    'adminContact' and 'technicalContact'.
    {}
    Each contact data must contain values for all required fields: email,
    phoneNumber and postalAddress in google.type.PostalAddress format.

    For more guidance on how to specify postalAddress, please see:
    https://support.google.com/business/answer/6397478

    Examples of file contents:

    ```
    allContacts:
      email: 'example@example.com'
      phoneNumber: '+1.8005550123'
      postalAddress:
        regionCode: 'US'
        postalCode: '94043'
        administrativeArea: 'CA'
        locality: 'Mountain View'
        addressLines: ['1600 Amphitheatre Pkwy']
        recipients: ['Jane Doe']
    ```
    {}
    ```
    registrantContact:
      email: 'registrant@example.com'
      phoneNumber: '+1.8005550123'
      postalAddress:
        regionCode: 'US'
        postalCode: '94043'
        administrativeArea: 'CA'
        locality: 'Mountain View'
        addressLines: ['1600 Amphitheatre Pkwy']
        recipients: ['Registrant Jane Doe']
    adminContact:
      email: 'admin@example.com'
      phoneNumber: '+1.8005550123'
      postalAddress:
        regionCode: 'US'
        postalCode: '94043'
        administrativeArea: 'CA'
        locality: 'Mountain View'
        addressLines: ['1600 Amphitheatre Pkwy']
        recipients: ['Admin Jane Doe']
    technicalContact:
      email: 'technical@example.com'
      phoneNumber: '+1.8005550123'
      postalAddress:
        regionCode: 'US'
        postalCode: '94043'
        administrativeArea: 'CA'
        locality: 'Mountain View'
        addressLines: ['1600 Amphitheatre Pkwy']
        recipients: ['Technic Jane Doe']
    ```
    """
  if mutation_op == MutationOp.UPDATE:
    help_text = help_text.format(
        """
    If 'registrantContact', 'adminContact' or 'technicalContact' labels are used
    then only the specified contacts are updated.
    """, """
    ```
    adminContact:
      email: 'admin@example.com'
      phoneNumber: '+1.8005550123'
      postalAddress:
        regionCode: 'US'
        postalCode: '94043'
        administrativeArea: 'CA'
        locality: 'Mountain View'
        addressLines: ['1600 Amphitheatre Pkwy']
        recipients: ['Admin Jane Doe']
    ```
        """)
  else:
    help_text = help_text.format('', '')

  base.Argument(
      '--contact-data-from-file',
      help=help_text,
      metavar='CONTACT_DATA_FILE_NAME',
      category=base.COMMONLY_USED_FLAGS).AddToParser(parser)

  def _ChoiceValueType(value):
    """Copy of base._ChoiceValueType."""
    return value.replace('_', '-').lower()

  base.Argument(
      '--contact-privacy',
      choices=CONTACT_PRIVACY_ENUM_MAPPER.choices,
      type=_ChoiceValueType,
      help='The contact privacy mode to use. Supported privacy modes depend on the domain.',
      required=False,
      category=base.COMMONLY_USED_FLAGS).AddToParser(parser)


def AddValidateOnlyFlagToParser(parser, verb):
  """Adds validate_only flag as go/gcloud-style#commonly-used-flags."""
  base.Argument(
      '--validate-only',
      help='Don\'t actually {} registration. Only validate arguments.'.format(
          verb),
      default=False,
      action='store_true',
      category=base.COMMONLY_USED_FLAGS).AddToParser(parser)


def AddAsyncFlagToParser(parser):
  """Adds async flag. It's not marked as go/gcloud-style#commonly-used-flags."""
  base.ASYNC_FLAG.AddToParser(parser)


def AddManagementSettingsFlagsToParser(parser):
  """Get flags for configure management command.

  Args:
    parser: argparse parser to which to add these flags.
  """

  TRANSFER_LOCK_ENUM_MAPPER.choice_arg.AddToParser(parser)


def _GetContactPrivacyEnum():
  """Get Contact Privacy Enum from api messages."""
  messages = apis.GetMessagesModule('domains', 'v1alpha2')
  return messages.ContactSettings.PrivacyValueValuesEnum


CONTACT_PRIVACY_ENUM_MAPPER = arg_utils.ChoiceEnumMapper(
    '--contact-privacy',
    _GetContactPrivacyEnum(),
    custom_mappings={
        'PRIVATE_CONTACT_DATA':
            ('private-contact-data',
             ('Your contact info won\'t be available to the public. To help '
              'protect your info and prevent spam, a third party provides '
              'alternate (proxy) contact info for your domain in the public '
              'directory at no extra cost. They will forward received messages '
              'to you.')),
        'REDACTED_CONTACT_DATA': ('redacted-contact-data', (
            'Limited personal information will be available to the public. The '
            'actual information redacted depends on the domain. For more '
            'information see '
            'https://support.google.com/domains/answer/3251242.')),
        'PUBLIC_CONTACT_DATA':
            ('public-contact-data',
             ('All the data from contact config is publicly available. To set '
              'this value, you must also pass the --notices flag with value '
              'public-contact-data-acknowledgement or agree to the notice '
              'interactively.')),
    },
    required=False,
    help_str=('The contact privacy mode to use. Supported privacy modes '
              'depend on the domain.'))


def PrivacyChoiceStrength(privacy):
  """Returns privacy strength (stronger privacy means higher returned value)."""
  if privacy == 'public-contact-data':
    return 0
  if privacy == 'redacted-contact-data':
    return 1
  if privacy == 'private-contact-data':
    return 2


def _GetContactNoticeEnum():
  """Get ContactNoticeEnum from api messages."""
  messages = apis.GetMessagesModule('domains', 'v1alpha2')
  return messages.ConfigureContactSettingsRequest.ContactNoticesValueListEntryValuesEnum


CONTACT_NOTICE_ENUM_MAPPER = arg_utils.ChoiceEnumMapper(
    '--notices',
    _GetContactNoticeEnum(),
    custom_mappings={
        'PUBLIC_CONTACT_DATA_ACKNOWLEDGEMENT':
            ('public-contact-data-acknowledgement',
             ('By sending this notice you acknowledge that using '
              'public-contact-data contact privacy makes all the data '
              'from contact config publicly available.')),
    },
    required=False,
    help_str=('Notices about special properties of contacts.'))


def _GetTransferLockEnum():
  """Get TransferLockStateValueValuesEnum from api messages."""
  messages = apis.GetMessagesModule('domains', 'v1alpha2')
  return messages.ManagementSettings.TransferLockStateValueValuesEnum


TRANSFER_LOCK_ENUM_MAPPER = arg_utils.ChoiceEnumMapper(
    '--transfer-lock-state',
    _GetTransferLockEnum(),
    custom_mappings={
        'LOCKED': ('locked', ('The transfer lock is locked.')),
        'UNLOCKED': ('unlocked', ('The transfer lock is unlocked.')),
    },
    required=False,
    help_str=('Transfer Lock of a registration. It needs to be unlocked '
              'in order to transfer the domain to another registrar.'))