{"id":21262851,"url":"https://github.com/stackql/stackql-provider-google","last_synced_at":"2025-07-29T15:43:02.966Z","repository":{"id":39366074,"uuid":"506876993","full_name":"stackql/stackql-provider-google","owner":"stackql","description":"Convert Google discovery API documents to fully compliant OpenAPI3 specifications with stackql provider extensions","archived":false,"fork":false,"pushed_at":"2024-12-07T02:30:27.000Z","size":622,"stargazers_count":41,"open_issues_count":0,"forks_count":9,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-07-11T07:24:01.865Z","etag":null,"topics":["google","stackql","stackql-provider"],"latest_commit_sha":null,"homepage":"https://stackql.io/registry/google","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stackql.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-06-24T04:29:04.000Z","updated_at":"2025-06-29T21:42:47.000Z","dependencies_parsed_at":"2024-06-01T08:56:39.717Z","dependency_job_id":"02486a46-7018-4294-b5b7-958f069eb532","html_url":"https://github.com/stackql/stackql-provider-google","commit_stats":null,"previous_names":["stackql/stackql-provider-google"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/stackql/stackql-provider-google","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackql%2Fstackql-provider-google","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackql%2Fstackql-provider-google/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackql%2Fstackql-provider-google/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackql%2Fstackql-provider-google/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stackql","download_url":"https://codeload.github.com/stackql/stackql-provider-google/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stackql%2Fstackql-provider-google/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267710239,"owners_count":24131936,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-29T02:00:12.549Z","response_time":2574,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["google","stackql","stackql-provider"],"created_at":"2024-11-21T04:59:31.750Z","updated_at":"2025-07-29T15:43:02.928Z","avatar_url":"https://github.com/stackql.png","language":"JavaScript","readme":"# Google Discovery to OpenAPI 3.x Converter\n\nGenerates OpenAPI 3.x specification from Google Discovery documents.\n\n\u003e OpenAPI 3 Specifications for Google Cloud APIs can be found at [__stackql/stackql-provider-registry__](https://github.com/stackql/stackql-provider-registry/tree/dev/providers/src/googleapis.com/v00.00.00000/services)\n\n## Overview\n\nThis script performs the following steps:\n1. Gets the [root discovery document for all Google APIs](https://discovery.googleapis.com/discovery/v1/apis)\n2. Gets each respective service discovery document from the root discovery document (can be filtered to only fetch `preferred` service versions)\n3. Converts each service discovery document to an OpenAPI 3.x specification, written as a `yaml` file to the `openapi` folder\n\nThe resultant OpenAPI service specifications can the be used with [`stackql/openapisaurus`](https://github.com/stackql/openapisaurus) to generate [StackQL Google provider definitions](https://registry.stackql.io/providers/google/).\n\n## Usage\n\n\u003e __NOTE:__ Requires Node.js 14.x or higher\n\nMac/Linux:\n\n```bash\nnpm install\nbin/google-discovery-to-openapi.mjs generate googleapis.com --debug\n```\n\nWindows/PowerShell:\n    \n```powershell\nnpm install\nnode .\\bin\\google-discovery-to-openapi.mjs generate\n```\n\n## Tests\n\nTo Run tests locally, clone [stackql-provider-tests](https://github.com/stackql/stackql-provider-tests), and run locally:\n\n```bash\n# run from the directory you cloned into\ncd ../../stackql-provider-tests/\nsh test-provider.sh \\\ngoogle \\\nfalse \\\n/mnt/c/LocalGitRepos/stackql/openapi-conversion/google-discovery-to-openapi/openapi \\\ntrue\n```\n\n## Inspect\n\n```bash\nPROVIDER_REGISTRY_ROOT_DIR=\"$(pwd)/openapi\"\nREG_STR='{\"url\": \"file://'${PROVIDER_REGISTRY_ROOT_DIR}'\", \"localDocRoot\": \"'${PROVIDER_REGISTRY_ROOT_DIR}'\", \"verifyConfig\": {\"nopVerify\": true}}'\n./stackql shell --registry=\"${REG_STR}\"\n```\n\n## Publish to the StackQL Provider Registry\n\nRaise a PR to add the provider from `openapi/src` to the [stackql-provider-registry](https://github.com/stackql/stackql-provider-registry/tree/dev/providers/src).  Once merged into the `dev` branch it will be tested and deployed to the `dev` registry, which can be accessed via:\n\n```bash\n# google cloud shell example...\ncurl -L https://bit.ly/stackql-zip -O \u0026\u0026 unzip stackql-zip\n# use the following to test from the dev provider registry with interactiva authentication\nDEV_REG=\"{ \\\"url\\\": \\\"https://registry-dev.stackql.app/providers\\\" }\"\nAUTH='{ \"google\": { \"type\": \"interactive\" }}'\n./stackql --auth=\"${AUTH}\" --registry=\"${DEV_REG}\" shell\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstackql%2Fstackql-provider-google","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstackql%2Fstackql-provider-google","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstackql%2Fstackql-provider-google/lists"}