{"id":22735792,"url":"https://github.com/pivotal-cf/pivnet-cli","last_synced_at":"2025-04-05T12:07:43.622Z","repository":{"id":12175834,"uuid":"71143994","full_name":"pivotal-cf/pivnet-cli","owner":"pivotal-cf","description":"CLI to interact with Tanzu Network API V2 interface.","archived":false,"fork":false,"pushed_at":"2023-09-25T10:42:38.000Z","size":7703,"stargazers_count":33,"open_issues_count":8,"forks_count":27,"subscribers_count":29,"default_branch":"master","last_synced_at":"2025-03-29T11:09:17.609Z","etag":null,"topics":["cli","tanzu-network"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pivotal-cf.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.adoc","funding":null,"license":"LICENSE","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}},"created_at":"2016-10-17T13:55:52.000Z","updated_at":"2025-02-07T07:15:27.000Z","dependencies_parsed_at":"2024-06-18T16:54:13.403Z","dependency_job_id":"91fcb76e-a7b5-4e3f-8948-90372afcdfc6","html_url":"https://github.com/pivotal-cf/pivnet-cli","commit_stats":null,"previous_names":[],"tags_count":61,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pivotal-cf%2Fpivnet-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pivotal-cf%2Fpivnet-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pivotal-cf%2Fpivnet-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pivotal-cf%2Fpivnet-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pivotal-cf","download_url":"https://codeload.github.com/pivotal-cf/pivnet-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247332609,"owners_count":20921853,"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","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":["cli","tanzu-network"],"created_at":"2024-12-10T21:15:08.456Z","updated_at":"2025-04-05T12:07:43.602Z","avatar_url":"https://github.com/pivotal-cf.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pivnet CLI\n\nInteract with [Pivotal Network](https://network.tanzu.vmware.com) from the command-line.\n\n## Installing\n\nBinaries for various operating systems are provided with each release on the\n[releases page](https://github.com/pivotal-cf/pivnet-cli/releases).\n\nInstall for OSX via [homebrew](http://brew.sh/) as follows:\n\n```sh\nbrew install pivotal/tap/pivnet-cli\n```\n\nTo install on linux: download the latest binary\n(see [latest release](https://github.com/pivotal-cf/pivnet-cli/releases/latest))\nand ensure the file is executable and on the path.\n\n## Usage\n\nUsing the Pivnet CLI requires a valid `Pivotal Network API token` or `UAA Refresh Token`.\n\nRefer to the\n[official docs](https://network.tanzu.vmware.com/docs/api#how-to-authenticate)\nfor more details on obtaining a Pivotal Network API token.\n\nExample usage:\n\n```sh\n$ pivnet login --api-token='my-api-token'\n$ pivnet products\n\n+-----+------------------------------------------------------+--------------------------------+\n| ID  |                         SLUG                         |              NAME              |\n+-----+------------------------------------------------------+--------------------------------+\n|  60 | elastic-runtime                                      | Pivotal Cloud Foundry Elastic  |\n|     |                                                      | Runtime                        |\n+-----+------------------------------------------------------+--------------------------------+\n\n$ pivnet r -p elastic-runtime -r 2.3.1 --format json \\\n  | jq '{\"id\": .id, \"release_date\": .release_date, \"release_type\": .release_type}'\n\n{\n  \"id\": 196729,\n  \"release_date\": \"2018-10-05\",\n  \"release_type\": \"Security Release\"\n}\n```\n\n## Developing\n\n### Prerequisites\n\nA valid install of golang \u003e= 1.6 is required.\n\n### Dependencies\n\nDependencies are vendored in the `vendor` directory, according to the\n[golang 1.5 vendor experiment](https://www.google.com/url?sa=t\u0026rct=j\u0026q=\u0026esrc=s\u0026source=web\u0026cd=1\u0026cad=rja\u0026uact=8\u0026ved=0ahUKEwi7puWg7ZrLAhUN1WMKHeT4A7oQFggdMAA\u0026url=https%3A%2F%2Fgolang.org%2Fs%2Fgo15vendor\u0026usg=AFQjCNEPCAjj1lnni5apHdA7rW0crWs7Zw).\n\nNo action is required to fetch the vendored dependencies.\n\n### Running the tests\n\nInstall the ginkgo executable with:\n\n```\ngo get -u github.com/onsi/ginkgo/ginkgo\n```\n\nThe tests require a valid Pivotal Network API token and host.\n\nRefer to the\n[official docs](https://network.tanzu.vmware.com/docs/api#how-to-authenticate)\nfor more details on obtaining a Pivotal Network API token.\n\nIt is advised to run the acceptance tests against the Pivotal Network integration\nenvironment endpoint i.e. `HOST='https://pivnet-integration.cfapps.io'`.\n\nRun the tests with the following command:\n\n```\nAPI_TOKEN=my-token \\\nHOST='https://pivnet-integration.cfapps.io' \\\n./bin/test\n```\n\n### Contributing\n\nPlease make all pull requests to the `master` branch, and\n[ensure the tests pass locally](https://github.com/pivotal-cf/pivnet-cli#running-the-tests).\n\n### Project management\n\nThe CI for this project can be found\n[here](https://p-concourse.wings.cf-app.com/teams/system-team-pivnet-resource-pivnet-resource-657d)\nand the scripts can be found in the\n[pivnet-resource-ci repo](https://github.com/pivotal-cf/pivnet-resource-ci).\n\nThe roadmap is captured in [Pivotal Tracker](https://www.pivotaltracker.com/projects/1474244).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpivotal-cf%2Fpivnet-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpivotal-cf%2Fpivnet-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpivotal-cf%2Fpivnet-cli/lists"}