{"id":20238441,"url":"https://github.com/smallstep/smallstep-python","last_synced_at":"2025-04-10T19:34:28.801Z","repository":{"id":199565307,"uuid":"703177207","full_name":"smallstep/smallstep-python","owner":"smallstep","description":"A Python client library for the Smallstep API ","archived":false,"fork":false,"pushed_at":"2025-04-03T16:32:41.000Z","size":423,"stargazers_count":5,"open_issues_count":6,"forks_count":2,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-04-03T16:42:21.943Z","etag":null,"topics":["openapi","openapi3","pypi","pypi-package","python","python3","python39","smallstep"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/smallstep-python/","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/smallstep.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-10-10T18:33:22.000Z","updated_at":"2025-04-03T16:32:45.000Z","dependencies_parsed_at":"2023-10-11T01:28:40.956Z","dependency_job_id":"1af75a79-3859-4184-9334-8031306e2aa4","html_url":"https://github.com/smallstep/smallstep-python","commit_stats":null,"previous_names":["smallstep/smallstep-python"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smallstep%2Fsmallstep-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smallstep%2Fsmallstep-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smallstep%2Fsmallstep-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smallstep%2Fsmallstep-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/smallstep","download_url":"https://codeload.github.com/smallstep/smallstep-python/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248281422,"owners_count":21077423,"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":["openapi","openapi3","pypi","pypi-package","python","python3","python39","smallstep"],"created_at":"2024-11-14T08:34:11.288Z","updated_at":"2025-04-10T19:34:28.782Z","avatar_url":"https://github.com/smallstep.png","language":"Python","readme":"# smallstep-python\n\nsmallstep-python is a Python library at allows you to interface with the Smallstep API.\n\nWe use [openapi-python-client](https://github.com/openapi-generators/openapi-python-client) to generate a low level Python client that is located in `smallstep/api_client/`. See the `smallstep/README.md` for more information on using this generated library. We built a wrapper library on top of `smallstep/api_client` that is located in `api.py`. This adds a handful of helper features. At this time `smallstep/api.py` only supports a few API endpoints. See `smallstep/api.py` for details.\n\n## Requirements\n\n* Python 3.9\n* [Smallstep Account](https://smallstep.com/signup)\n* A very strong desire to allow a cute snake to manage your Smallstep account\n\n\u003cimg src=/images/smallstep-snek.png alt=\"A cute snake to manage Smallstep\" width=250\u003e\n\n## Installation\n\nWe publish this package to \u003chttps://pypi.org/project/smallstep-python/\u003e and it can be installed via pip.\n\n```bash\npip install smallstep-python\n```\n\n## Development\n\n### Configuration\n\nCreate a `.env` file in the project root and add the following lines:\n\n```bash\n# Not needed unless you are using our run anywhere offering\n# SMALLSTEP_API_HOST=\"https://gateway.smallstep.com/api\"\nSMALLSTEP_API_TOKEN=\"your_smallstep_api_token\"\n```\n\nAdjust them to your needs. See `config.py` for configuration details. We use [Pydantic Settings](https://docs.pydantic.dev/latest/concepts/pydantic_settings/) for easy settings management. Below is the order of precedence for configuration settings:\n\n1. Arguments passed to the Settings class initialiser.\n1. Environment variables, e.g. SMALLSTEP_MY_CONFIG_SETTING as described above.\n1. Variables loaded from a dotenv (.env) file.\n1. Variables loaded from the secrets directory.\n1. The default field values for the Settings model.\n\nSee the Pydantic Settings [field value priority](https://docs.pydantic.dev/latest/concepts/pydantic_settings/#field-value-priority) section for more information.\n\n## With Poetry\n\nInstall Poetry on your system with [this](https://python-poetry.org/docs/#installation).\n\nRun this from the repo directory:\n\n```bash\npoetry install\n```\n\nEnter the Poetry shell with this:\n\n```bash\npoetry shell\npre-commit install\n```\n\n### With venv\n\n```bash\nexport VIRTUAL_ENV=${PWD}/.venv\npython3 -m venv $VIRTUAL_ENV\nexport PATH=\"$VIRTUAL_ENV/bin:$PATH\"\npip install wheel\npip install -r requirements.txt\n. .venv/bin/activate\npre-commit install\n```\n\n### Adding packages\n\nAdd packages to Poetry and then run pre-commit which will generate a requirements.txt file for you.\n\nDevelopment:\n\n```bash\npoetry add --group=dev rich\npre-commit\n```\n\nProduction:\n\n```bash\npoetry add rich\npre-commit\n```\n\n## License\n\n[Apache License Version 2.0](http://www.apache.org/licenses/LICENSE-2.0)\n\nCopyright 2023 Smallstep Labs Inc.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmallstep%2Fsmallstep-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmallstep%2Fsmallstep-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmallstep%2Fsmallstep-python/lists"}