Allowing Standalone Samples to be defined in separate YAML files (GAPIC Generator Monolith)

. Allowing Standalone Samples to be defined in separate YAML files (GAPIC Generator Monolith) .md

The GAPIC-generator "monolith" should support loading samples for generation from multiple YAML files.

Ideally we can simplify the YAML a little tiny bit when we do this.

Here are my thoughts.

Current Sample Config (v1) .yaml

and

Proposed Sample Config (v1) .yaml

Current Sample Config (v1) .yaml

type: com.google.api.codegen.ConfigProto
config_schema_version: 1.0.0
# A list of API interface configurations.
interfaces:
  # The fully qualified name of the API interface.
- name: google.cloud.talent.v4beta1.CompanyService
  methods:
  - name: CreateCompany
    samples:
      standalone:
      - value_sets: [job_search_create_company]
        region_tag: job_search_create_company
    sample_value_sets:
    - id: job_search_create_company
      description: Create Company
      parameters:
        defaults:
        - parent%project="Your Google Cloud Project ID"
        attributes:
        - parameter: parent%project
          sample_argument_name: project_id
      on_success:
      - print: ["Created Company"]

Proposed Sample Config (v1) .yaml

# Whatever type and schema version you want, if any.

# A list of API interface configurations.
interfaces:
  # The fully qualified name of the API interface.
- name: google.cloud.talent.v4beta1.CompanyService
  methods:
  - name: CreateCompany
    
    # This is where `samples:` was with `standalone:` etc
    # It is gone now. Instead, we simply have a list of `samples:`
    # below (which is really just `sample_value_sets:` renamed)
    
    samples:
    - id: job_search_create_company # <=== The sample ID is used as the region tag
      description: Create Company
      calling_forms: [".*"]  # <=== We will normally not have this, but it needs to go somewhere :)
      parameters:
        defaults:
        - parent%project="Your Google Cloud Project ID"
        attributes:
        - parameter: parent%project
          sample_argument_name: project_id
      on_success:
      - print: ["Created Company"]