chore: migrate code from googleapis/gcp-metadata

.release-please-manifest.json

@@ -1,5 +1,6 @@
 {
   "dev-packages/jsdoc-fresh": "5.0.1",
   "dev-packages/pack-n-play": "4.2.0",
-  "dev-packages/jsdoc-region-tag": "4.0.0"
+  "packages/jsdoc-region-tag": "4.0.0",
+  "packages/gcp-metadata": "7.0.1"
 }

packages/gcp-metadata/.OwlBot.yaml

@@ -0,0 +1,17 @@
+# Copyright 2021 Google LLC
+#
+# 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.
+
+
+begin-after-commit-hash: 397c0bfd367a2427104f988d5329bc117caafd95
+

packages/gcp-metadata/.compodocrc

@@ -0,0 +1,10 @@
+---
+tsconfig: ./tsconfig.json
+output: ./docs
+theme: material
+hideGenerator: true
+disablePrivate: true
+disableProtected: true
+disableInternal: true
+disableCoverage: true
+disableGraph: true

packages/gcp-metadata/.eslintignore

@@ -0,0 +1,8 @@
+**/node_modules
+**/coverage
+test/fixtures
+build/
+docs/
+protos/
+samples/generated/
+system-test/**/fixtures

packages/gcp-metadata/.eslintrc.js

@@ -0,0 +1,15 @@
+// Config file for eslint used by gts.
+
+const path = require('path');
+
+// 1. Find the absolute path to the 'gts' package's directory
+//    This forces Node.js to look up in the directory tree (hoisted root)
+const GTS_CONFIG_PATH = path.dirname(
+  require.resolve('gts/package.json', {paths: [__dirname]}),
+);
+
+module.exports = {
+  // Use the absolute path provided by Node's resolution
+  // This bypasses the relative path failure completely.
+  extends: [GTS_CONFIG_PATH],
+};

packages/gcp-metadata/.gitattributes

@@ -0,0 +1,4 @@
+*.ts text eol=lf
+*.js text eol=lf
+protos/* linguist-generated
+**/api-extractor.json  linguist-language=JSON-with-Comments

packages/gcp-metadata/.gitignore

@@ -0,0 +1,12 @@
+node_modules
+build
+.vscode
+package-lock.json
+.nyc_output
+.coverage
+package-lock.json
+gcp-metadata.tgz
+docs/
+__pycache__
+.DS_Store
+*.tgz

packages/gcp-metadata/.jsdoc.js

@@ -0,0 +1,51 @@
+// Copyright 2019 Google LLC
+//
+// 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
+//
+//     https://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.
+//
+
+'use strict';
+
+module.exports = {
+  opts: {
+    readme: './README.md',
+    package: './package.json',
+    template: './node_modules/jsdoc-fresh',
+    recurse: true,
+    verbose: true,
+    destination: './docs/'
+  },
+  plugins: [
+    'plugins/markdown',
+    'jsdoc-region-tag'
+  ],
+  source: {
+    excludePattern: '(^|\\/|\\\\)[._]',
+    include: [
+      'build/src',
+    ],
+    includePattern: '\\.js$'
+  },
+  templates: {
+    copyright: 'Copyright 2019 Google, LLC.',
+    includeDate: false,
+    sourceFiles: false,
+    systemName: 'gcp-metadata',
+    theme: 'lumen',
+    default: {
+      outputSourceFiles: false
+    }
+  },
+  markdown: {
+    idInHeadings: true
+  }
+};

packages/gcp-metadata/.mocharc.js

@@ -0,0 +1,29 @@
+// Copyright 2020 Google LLC
+//
+// 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.
+const config = {
+  "enable-source-maps": true,
+  "throw-deprecation": true,
+  "timeout": 10000,
+  "recursive": true
+}
+if (process.env.MOCHA_THROW_DEPRECATION === 'false') {
+  delete config['throw-deprecation'];
+}
+if (process.env.MOCHA_REPORTER) {
+  config.reporter = process.env.MOCHA_REPORTER;
+}
+if (process.env.MOCHA_REPORTER_OUTPUT) {
+  config['reporter-option'] = `output=${process.env.MOCHA_REPORTER_OUTPUT}`;
+}
+module.exports = config

packages/gcp-metadata/.nycrc

@@ -0,0 +1,24 @@
+{
+  "report-dir": "./.coverage",
+  "reporter": ["text", "lcov"],
+  "exclude": [
+    "**/*-test",
+    "**/.coverage",
+    "**/apis",
+    "**/benchmark",
+    "**/conformance",
+    "**/docs",
+    "**/samples",
+    "**/scripts",
+    "**/protos",
+    "**/test",
+    "**/*.d.ts",
+    ".jsdoc.js",
+    "**/.jsdoc.js",
+    "karma.conf.js",
+    "webpack-tests.config.js",
+    "webpack.config.js"
+  ],
+  "exclude-after-remap": false,
+  "all": true
+}

packages/gcp-metadata/.prettierignore

@@ -0,0 +1,6 @@
+**/node_modules
+**/coverage
+test/fixtures
+build/
+docs/
+protos/

packages/gcp-metadata/.prettierrc.js

@@ -0,0 +1,17 @@
+// Copyright 2020 Google LLC
+//
+// 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
+//
+//      https://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.
+
+module.exports = {
+  ...require('gts/.prettierrc.json')
+}

packages/gcp-metadata/.readme-partials.yaml

@@ -0,0 +1,77 @@
+body: |-
+
+  #### Check to see if the metadata server is available
+  ```js
+  const isAvailable = await gcpMetadata.isAvailable();
+  ```
+
+  #### Access all metadata
+
+  ```js
+  const data = await gcpMetadata.instance();
+  console.log(data); // ... All metadata properties
+  ```
+
+  #### Access specific properties
+  ```js
+  const data = await gcpMetadata.instance('hostname');
+  console.log(data); // ...Instance hostname
+  const projectId = await gcpMetadata.project('project-id');
+  console.log(projectId); // ...Project ID of the running instance
+  ```
+
+  #### Access nested properties with the relative path
+  ```js
+  const data = await gcpMetadata.instance('service-accounts/default/email');
+  console.log(data); // ...Email address of the Compute identity service account
+  ```
+
+  #### Access specific properties with query parameters
+  ```js
+  const data = await gcpMetadata.instance({
+    property: 'tags',
+    params: { alt: 'text' }
+  });
+  console.log(data) // ...Tags as newline-delimited list
+  ```
+
+  #### Access with custom headers
+  ```js
+  await gcpMetadata.instance({
+    headers: { 'no-trace': '1' }
+  }); // ...Request is untraced
+  ```
+
+  ### Take care with large number valued properties
+
+  In some cases number valued properties returned by the Metadata Service may be
+  too large to be representable as JavaScript numbers. In such cases we return
+  those values as `BigNumber` objects (from the [bignumber.js](https://github.com/MikeMcl/bignumber.js) library). Numbers
+  that fit within the JavaScript number range will be returned as normal number
+  values.
+
+  ```js
+  const id = await gcpMetadata.instance('id');
+  console.log(id)  // ... BigNumber { s: 1, e: 18, c: [ 45200, 31799277581759 ] }
+  console.log(id.toString()) // ... 4520031799277581759
+  ```
+
+  ### Environment variables
+
+  * `GCE_METADATA_HOST`: provide an alternate host or IP to perform lookup against (useful, for example, you're connecting through a custom proxy server).
+
+    For example:
+    ```
+    export GCE_METADATA_HOST='169.254.169.254'
+    ```
+
+  * `DETECT_GCP_RETRIES`: number representing number of retries that should be attempted on metadata lookup.
+
+  * `DEBUG_AUTH`: emit debugging logs
+
+  * `METADATA_SERVER_DETECTION`: configure desired metadata server availability check behavior.
+
+    * `assume-present`: don't try to ping the metadata server, but assume it's present
+    * `none`: don't try to ping the metadata server, but don't try to use it either
+    * `bios-only`: treat the result of a BIOS probe as canonical (don't fall back to pinging)
+    * `ping-only`: skip the BIOS probe, and go straight to pinging

packages/gcp-metadata/.repo-metadata.json

@@ -0,0 +1,13 @@
+{
+  "name": "gcp-metadata",
+  "name_pretty": "GCP Metadata",
+  "product_documentation": "https://cloud.google.com/compute/docs/storing-retrieving-metadata",
+  "client_documentation": "https://cloud.google.com/nodejs/docs/reference/gcp-metadata/latest",
+  "issue_tracker": "https://github.com/googleapis/google-cloud-node-core/issues",
+  "release_level": "stable",
+  "language": "nodejs",
+  "repo": "googleapis/google-cloud-node-core",
+  "distribution_name": "gcp-metadata",
+  "requires_billing": false,
+  "library_type": "CORE"
+}