{"id":13800145,"url":"https://github.com/jeshan/botostubs","last_synced_at":"2025-04-09T18:24:34.799Z","repository":{"id":53468754,"uuid":"159326695","full_name":"jeshan/botostubs","owner":"jeshan","description":"boto3 code assistance for any API in any IDE, always up to date","archived":false,"fork":false,"pushed_at":"2023-02-07T23:09:59.000Z","size":4954,"stargazers_count":95,"open_issues_count":11,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-02T12:49:04.395Z","etag":null,"topics":["boto3","codecompletion"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jeshan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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}},"created_at":"2018-11-27T11:43:58.000Z","updated_at":"2023-08-06T11:52:29.000Z","dependencies_parsed_at":"2024-01-29T19:30:28.577Z","dependency_job_id":"6f1d26df-ed84-45dd-90d8-9c8fe897f703","html_url":"https://github.com/jeshan/botostubs","commit_stats":{"total_commits":88,"total_committers":3,"mean_commits":"29.333333333333332","dds":"0.022727272727272707","last_synced_commit":"f908bed9ae8296be5b2597a5755fa54e34472394"},"previous_names":[],"tags_count":373,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeshan%2Fbotostubs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeshan%2Fbotostubs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeshan%2Fbotostubs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeshan%2Fbotostubs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jeshan","download_url":"https://codeload.github.com/jeshan/botostubs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248086318,"owners_count":21045321,"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":["boto3","codecompletion"],"created_at":"2024-08-04T00:01:09.813Z","updated_at":"2025-04-09T18:24:34.780Z","avatar_url":"https://github.com/jeshan.png","language":"Python","readme":"![](https://img.shields.io/badge/programmer-laziness-green.svg)\n[![PyPI version](https://badge.fury.io/py/botostubs.svg)](https://badge.fury.io/py/botostubs)\n\n[![Downloads](https://pepy.tech/badge/botostubs)](https://pepy.tech/project/botostubs)\n[![Downloads](https://pepy.tech/badge/botostubs/month)](https://pepy.tech/project/botostubs)\n[![Downloads](https://pepy.tech/badge/botostubs/week)](https://pepy.tech/project/botostubs)\n\n![Build badge](https://codebuild.us-east-1.amazonaws.com/badges?uuid=eyJlbmNyeXB0ZWREYXRhIjoiUkF6bllTcVBkQmI2Y0FWZlpDUTRHc3pyVm5EUk11ZWdDV1BtcVAyZG80TCtJZFZUdnB1ZmFwRVN3UWxudUJxMTRTTW15R1dnUy9KZFZuZE1Fd3c1b1RjPSIsIml2UGFyYW1ldGVyU3BlYyI6IlNZa3Q2aHRjWjVYVzQ0clkiLCJtYXRlcmlhbFNldFNlcmlhbCI6MX0%3D\u0026branch=master)\n\n\n# botostubs\nGives you code assistance for **any boto3 API** in any IDE. Get started by running `pip install botostubs`\n\n\n# Demo\n![See demo gif on github](https://raw.githubusercontent.com/jeshan/botostubs/master/intro-demo.gif)\n\n\n# Features\n- PyPI package automatically aligned with boto3 (yay!)\n- show required / optional fields\n- show API docs as Python docstrings\n- full api coverage\n- support for boto3 clients, e.g `type: botostubs.ACM`\n- support for service-level resources, e.g `type: botostubs.S3.S3Resource`\n- support for paginators, e.g `type: botostubs.EC2.DescribeInstancesPaginator`\n- support for waiters, e.g `type: botostubs.EC2.InstanceRunningWaiter`\n\n# How it works\nWe look for all boto3 clients by running boto itself. Then loop over each of them to find what operations and classes are used. These are all dumped in a new python script, packaged in this project. This way, `botostubs` can offer comprehensive API coverage.\n\nThe deployment pipeline on AWS checks for boto3 releases every 3 days, installs it, generate new stubs and pushes them to PyPI. Looking for a new API released a few days ago? Just upgrade the package with `pip install --upgrade botostubs` and you're good to go.\n\nFor an in-depth account, see the blog post [Code assistance for boto3, always up to date and in any IDE](https://www.awsadvent.com/2018/12/21/code-assistance-for-boto3-always-up-to-date-and-in-any-ide/)\n\n# Notes\n- This package requires that your IDE already supports getting type hints from PyPI packages. It has been tested with Intellij and Visual Studio Code.\n- If you are not seeing code completion in Intellij-based ones, please increase the intellisense filesize limit e.g `idea.max.intellisense.filesize=30000` in IDE custom properties (Help \u003e Edit Custom Properties), then restart\n- For other IDEs, you may have some luck by installing [jedi](https://github.com/davidhalter/jedi), which provides code completion for Vim, Emacs, Sublime, Atom, etc.\n\n# TODO\nSupport python versions before 3.6. Currently requires at least 3.6 due to use of type hints.\n\n# Credits\n`pyboto3` for inspiration behind this. It supported only legacy Python and not Python 3. Besides, it is no longer being maintained.\n\n# For forkers\n## Automated releasing on pypi\nDeploy the pipeline in your AWS account by clicking this button:\n\u003ca href=\"https://console.aws.amazon.com/cloudformation/home?#/stacks/new?\u0026templateURL=https://s3.amazonaws.com/jeshan-oss-public-files/deployment-pipeline.yaml\" target=\"_blank\"\u003e\u003cimg src=\"https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png\"\u003e\u003c/a\u003e\n\nThis is how it looks like:\n\n![stack](/stack.png)\n\n*Image automatically generated with [cfnbuddy](https://www.cfnbuddy.com)*\n\n## Manual Releasing on pypi\n- `docker-compose build`\n- `docker-compose run python`. Enter credentials when prompted\n","funding_links":[],"categories":["Python","Stub packages"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeshan%2Fbotostubs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeshan%2Fbotostubs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeshan%2Fbotostubs/lists"}