{"id":22281095,"url":"https://github.com/zhmcclient/python-zhmcclient","last_synced_at":"2025-04-04T19:07:58.862Z","repository":{"id":37570618,"uuid":"66363927","full_name":"zhmcclient/python-zhmcclient","owner":"zhmcclient","description":"A pure Python client library for the IBM Z HMC Web Services API","archived":false,"fork":false,"pushed_at":"2024-10-24T11:21:56.000Z","size":5191,"stargazers_count":38,"open_issues_count":24,"forks_count":26,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-10-25T04:58:38.699Z","etag":null,"topics":["hmc","mainframe","python","s390x"],"latest_commit_sha":null,"homepage":"","language":"Python","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/zhmcclient.png","metadata":{"files":{"readme":"README.md","changelog":"changes/.gitignore","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-08-23T12:14:46.000Z","updated_at":"2024-10-24T11:19:38.000Z","dependencies_parsed_at":"2024-03-31T14:29:27.858Z","dependency_job_id":"7dca27d0-5b82-4037-b85f-b5ce8f45cd06","html_url":"https://github.com/zhmcclient/python-zhmcclient","commit_stats":null,"previous_names":[],"tags_count":120,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhmcclient%2Fpython-zhmcclient","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhmcclient%2Fpython-zhmcclient/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhmcclient%2Fpython-zhmcclient/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhmcclient%2Fpython-zhmcclient/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zhmcclient","download_url":"https://codeload.github.com/zhmcclient/python-zhmcclient/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247234921,"owners_count":20905854,"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":["hmc","mainframe","python","s390x"],"created_at":"2024-12-03T16:13:58.131Z","updated_at":"2025-04-04T19:07:58.832Z","avatar_url":"https://github.com/zhmcclient.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zhmcclient - A pure Python client library for the IBM Z HMC Web Services API\n\n[![Version on Pypi](https://img.shields.io/pypi/v/zhmcclient.svg)](https://pypi.python.org/pypi/zhmcclient/)\n[![Test status (master)](https://github.com/zhmcclient/python-zhmcclient/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/zhmcclient/python-zhmcclient/actions/workflows/test.yml?query=branch%3Amaster)\n[![Docs status (master)](https://readthedocs.org/projects/python-zhmcclient/badge/?version=latest)](https://readthedocs.org/projects/python-zhmcclient/builds/)\n[![Test coverage (master)](https://coveralls.io/repos/github/zhmcclient/python-zhmcclient/badge.svg?branch=master)](https://coveralls.io/github/zhmcclient/python-zhmcclient?branch=master)\n[![CodeClimate status](https://codeclimate.com/github/zhmcclient/python-zhmcclient/badges/gpa.svg)](https://codeclimate.com/github/zhmcclient/python-zhmcclient)\n\n# Overview\n\nThe zhmcclient package is a client library written in pure Python that\ninteracts with the Web Services API of the Hardware Management Console\n(HMC) of [IBM Z](http://www.ibm.com/systems/z/) or\n[LinuxONE](http://www.ibm.com/systems/linuxone/) machines. The goal of\nthis package is to make the HMC Web Services API easily consumable for\nPython programmers.\n\nThe HMC Web Services API is the access point for any external tools to\nmanage the IBM Z or LinuxONE platform. It supports management of the\nlifecycle and configuration of various platform resources, such as\npartitions, CPU, memory, virtual switches, I/O adapters, and more.\n\nThe zhmcclient package encapsulates both protocols supported by the HMC\nWeb Services API:\n\n- REST over HTTPS for request/response-style operations driven by the\n  client. Most of these operations complete synchronously, but some\n  long-running tasks complete asynchronously.\n- JMS (Java Messaging Services) for notifications from the HMC to the\n  client. This can be used to be notified about changes in the system,\n  or about completion of asynchronous tasks started using REST.\n\n# Installation\n\nThe quick way:\n\n``` bash\n$ pip install zhmcclient\n```\n\nFor more details, see the\n[Installation section](http://python-zhmcclient.readthedocs.io/en/stable/intro.html#installation)\nin the documentation.\n\n# Quickstart\n\nThe following example code lists the partitions on CPCs in DPM mode that\nare accessible for the user:\n\n``` python\n#!/usr/bin/env python\n\nimport zhmcclient\nimport requests.packages.urllib3\nrequests.packages.urllib3.disable_warnings()\n\n# Set these variables for your environment:\nhost = \"\u003cIP address or hostname of the HMC\u003e\"\nuserid = \"\u003cuserid on that HMC\u003e\"\npassword = \"\u003cpassword of that HMC userid\u003e\"\nverify_cert = False\n\nsession = zhmcclient.Session(host, userid, password, verify_cert=verify_cert)\nclient = zhmcclient.Client(session)\nconsole = client.consoles.console\n\npartitions = console.list_permitted_partitions()\nfor part in partitions:\n    cpc = part.manager.parent\n    print(\"{} {}\".format(cpc.name, part.name))\n```\n\nPossible output when running the script:\n\n``` text\nP000S67B PART1\nP000S67B PART2\nP0000M96 PART1\n```\n\n# Documentation and Change Log\n\nFor the latest released version on PyPI:\n\n- [Documentation](http://python-zhmcclient.readthedocs.io/en/stable)\n- [Change log](http://python-zhmcclient.readthedocs.io/en/stable/changes.html)\n\n# zhmc CLI\n\nBefore version 0.18.0 of the zhmcclient package, it contained the zhmc\nCLI. Starting with zhmcclient version 0.18.0, the zhmc CLI has been\nmoved from this project into the new\n[zhmccli project](https://github.com/zhmcclient/zhmccli).\n\nIf your project uses the zhmc CLI, and you are upgrading the zhmcclient\npackage from before 0.18.0 to 0.18.0 or later, your project will need to\nadd the [zhmccli package](https://pypi.python.org/pypi/zhmccli) to its\ndependencies.\n\n# Contributing\n\nFor information on how to contribute to this project, see the\n[Development section](http://python-zhmcclient.readthedocs.io/en/stable/development.html)\nin the documentation.\n\n# License\n\nThe zhmcclient package is licensed under the\n[Apache 2.0 License](https://github.com/zhmcclient/python-zhmcclient/tree/stable/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhmcclient%2Fpython-zhmcclient","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzhmcclient%2Fpython-zhmcclient","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhmcclient%2Fpython-zhmcclient/lists"}