Lines Matching +full:metadata +full:- +full:specific
7 # https://www.apache.org/licenses/LICENSE-2.0
12 # See the License for the specific language governing permissions and
52 def _generic_library(self, directory: str, relative_dir=None, **kwargs) -> Path:
53 # load common repo meta information (metadata that's not language specific).
54 if "metadata" in kwargs:
55 self._load_generic_metadata(kwargs["metadata"], relative_dir=relative_dir)
58 if "samples" not in kwargs["metadata"] or not kwargs["metadata"]["samples"]:
63 if "repository" in kwargs["metadata"] and "repo" in kwargs["metadata"]:
64 kwargs["metadata"]["repo"]["default_branch"] = _get_default_branch_name(
65 kwargs["metadata"]["repository"]
71 ["python", filename, "--help"]
79 def py_samples(self, **kwargs) -> List[Path]:
82 - Determines whether generation is being done in a client library or in a samples
84 - Otherwise accepts manually set sample_project_dir through kwargs metadata
85 - Delegates generation of additional sample documents alternate/overridden folders
88 # kwargs["metadata"] is required to load values from .repo-metadata.json
89 if "metadata" not in kwargs:
90 kwargs["metadata"] = {}
92 # load common repo meta information (metadata that's not language specific).
93 self._load_generic_metadata(kwargs["metadata"])
108 kwargs["metadata"]["samples"] = True
112 sample_project_dir = kwargs["metadata"]["repo"].get("sample_project_dir")
114 if sample_project_dir is None: # Not found in metadata
125 samples_dict = deepcopy(kwargs["metadata"]["repo"].get("samples"))
134 # add absolute path to metadata so `python foo.py --help` succeeds
173 kwargs["metadata"]["repo"]["samples"] = default_samples_dict
190 ) -> Path:
193 are set in one or more samples' metadata
195 overridden_samples_kwargs["metadata"]["repo"][
198 # Set samples metadata to ONLY samples intended to generate
200 overridden_samples_kwargs["metadata"]["repo"]["samples"] = override_samples
209 def python_notebooks(self, **kwargs) -> Path:
210 # kwargs["metadata"] is required to load values from .repo-metadata.json
211 if "metadata" not in kwargs:
212 kwargs["metadata"] = {}
215 def py_mono_repo_library(self, relative_dir, **kwargs) -> Path:
216 # kwargs["metadata"] is required to load values from .repo-metadata.json
217 if "metadata" not in kwargs:
218 kwargs["metadata"] = {}
220 # load common repo meta information (metadata that's not language specific).
221 self._load_generic_metadata(kwargs["metadata"], relative_dir)
223 # initialize default_version if it doesn't exist in kwargs["metadata"]['repo']
224 if "default_version" not in kwargs["metadata"]["repo"]:
225 kwargs["metadata"]["repo"]["default_version"] = ""
230 or not kwargs["metadata"]["repo"]["default_version"]
231 or kwargs["metadata"]["repo"]["default_version"] == "apiVersion"
241 def py_library(self, **kwargs) -> Path:
242 # kwargs["metadata"] is required to load values from .repo-metadata.json
243 if "metadata" not in kwargs:
244 kwargs["metadata"] = {}
246 # load common repo meta information (metadata that's not language specific).
247 self._load_generic_metadata(kwargs["metadata"])
249 # initialize default_version if it doesn't exist in kwargs["metadata"]['repo']
250 if "default_version" not in kwargs["metadata"]["repo"]:
251 kwargs["metadata"]["repo"]["default_version"] = ""
284 or not kwargs["metadata"]["repo"]["default_version"]
317 nox_session = f"system-{v}"
318 dest = ret / f".kokoro/presubmit/system-{v}.cfg"
324 def java_library(self, **kwargs) -> Path:
325 # kwargs["metadata"] is required to load values from .repo-metadata.json
326 if "metadata" not in kwargs:
327 kwargs["metadata"] = {}
330 def node_library(self, **kwargs) -> Path:
332 # .repo-metadata.json, or excluding README.md, we can remove this.
333 if not os.path.exists("./.repo-metadata.json"):
338 kwargs["metadata"] = node.template_metadata()
339 kwargs["publish_token"] = node.get_publish_token(kwargs["metadata"]["name"])
344 # generate root-level `src/index.ts` to export multiple versions and its default clients
356 def node_mono_repo_library(self, relative_dir, **kwargs) -> Path:
358 # .repo-metadata.json, or excluding README.md, we can remove this.
359 if not os.path.exists(Path(relative_dir, ".repo-metadata.json").resolve()):
364 kwargs["metadata"] = node_mono_repo.template_metadata(relative_dir)
369 # generate root-level `src/index.ts` to export multiple versions and its default clients
386 def php_library(self, **kwargs) -> Path:
389 def ruby_library(self, **kwargs) -> Path:
390 # kwargs["metadata"] is required to load values from .repo-metadata.json
391 if "metadata" not in kwargs:
392 kwargs["metadata"] = {}
395 def render(self, template_name: str, **kwargs) -> Path:
400 def _load_generic_metadata(self, metadata: Dict, relative_dir=None):
402 loads additional meta information from .repo-metadata.json.
404 metadata["partials"] = partials.load_partials()
406 # Loads repo metadata information from the default location if it
408 # metadata, so we don't need to do it again or overwrite it. Also, only
410 if "repo" not in metadata:
411 metadata["repo"] = _load_repo_metadata(relative_dir=relative_dir)
418 ) -> List[str]:
433 will be read from `.repo-metadata.json`, if it exists.
443 # Get the `default_version` from ``.repo-metadata.json`.
444 default_version = json.load(open(".repo-metadata.json", "rt")).get(
451 for level in ("*v[1-9]*", "*/*v[1-9]*", "*/*/*v[1-9]*", "*/*/*/*v[1-9]*"):
486 str_decamelize = re.sub("^.", value[0].upper(), value) # apple -> Apple.
488 "([A-Z]+)([A-Z])([a-z0-9])", r"\1 \2\3", str_decamelize
489 ) # ACLBatman -> ACL Batman.
490 return re.sub("([a-z0-9])([A-Z])", r"\1 \2", str_decamelize) # FooBar -> Foo Bar.
494 relative_dir=None, metadata_file: str = "./.repo-metadata.json"
495 ) -> Dict:
496 """Parse a metadata JSON file into a Dict.
499 * `name` - The service's API name
500 * `name_pretty` - The service's API title. This will be used for generating titles on READMEs
501 * `product_documentation` - The product documentation on cloud.google.com
502 * `client_documentation` - The client library reference documentation
503 * `issue_tracker` - The public issue tracker for the product
504 * `release_level` - The release level of the client library. One of: alpha, beta,
506 * `language` - The repo language. One of dotnet, go, java, nodejs, php, python, ruby
507 * `repo` - The GitHub repo in the format {owner}/{repo}
508 * `distribution_name` - The language-idiomatic package/distribution name
509 * `api_id` - The API ID associated with the service. Fully qualified identifier use to
511 * `requires_billing` - Whether or not the API requires billing to be configured on the
515 metadata_file (str, optional): Path to the metadata json file
518 A dictionary of metadata. This may not necessarily include all the defined fields above.
530 def _get_default_branch_name(repository_name: str) -> str: