Document how `--plugin` works, features, and how/why to implement custom plugins
See original GitHub issueI noticed that the CDK CLI help makes reference to a --plugin
option, but beyond this description, couldn’t find much more documentation about it:
--plugin, -p Name or path of a node package that extend the CDK
features. Can be specified multiple times [array]
When searching the repo, I found the following references:
- https://github.com/awslabs/aws-cdk/blob/master/packages/aws-cdk/bin/cdk.ts#L41
- https://github.com/awslabs/aws-cdk/blob/master/packages/aws-cdk/bin/cdk.ts#L132-L156
- https://github.com/awslabs/aws-cdk/blob/master/packages/aws-cdk/lib/plugin.ts#L6-L19
Based on the contract defined in plugins.ts
I can see what a plugin would have to look like, and how it is loaded. When a plugin is initialised it receives an instance of PluginHost
, but as best I can tell this only seems to give them access to registerCredentialProviderSource
.
So I guess my question at the moment is: is that all a plugin can do? Is it able to get access to/add/modify other things at the moment (or in the future will it be able to?)
Issue Analytics
- State:
- Created 5 years ago
- Comments:5 (3 by maintainers)
Top Results From Across the Web
plugin` works, features, and how/why to implement custom ...
Based on the contract defined in plugins.ts I can see what a plugin would have to look like, and how it is loaded....
Read more >Plugin Basics | Plugin Developer Handbook
To get started creating a new plugin, follow the steps below. Navigate to the WordPress installation's wp-content directory. Open the plugins directory. Create...
Read more >How to Create a Custom WordPress Plugin From Scratch
In this guide, I'll show you how to create a custom WordPress plugin. Also, you'll learn how to use best practices in WordPress...
Read more >Elgg Documentation - Read the Docs
Elgg Documentation, Release master the profile is for consumption by others, the dashboard is a space for users to use for their own...
Read more >The Ultimate Guide to Building a WordPress Plugin - Toptal
In this tutorial, you'll learn how to build a simple WordPress plugin the right ... We can do that by opening up our...
Read more >Top Related Medium Post
No results found
Top Related StackOverflow Question
No results found
Troubleshoot Live Code
Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start FreeTop Related Reddit Thread
No results found
Top Related Hackernoon Post
No results found
Top Related Tweet
No results found
Top Related Dev.to Post
No results found
Top Related Hashnode Post
No results found
Top GitHub Comments
Hi @RomainMuller, I think this got lost in the ether somewhere. 😦 Maybe when the docs moved from this repository to github.com/awsdocs/aws-cdk-guide?
I don’t see any documentation related to Plugins on the “main” CDK tools page: https://docs.aws.amazon.com/cdk/latest/guide/tools.html
Nor in the related GitHub repo: https://github.com/awsdocs/aws-cdk-guide/blob/master/doc_source/tools.md
A search for “plugin” on the CDK Docs site returns only the single mention on the Tools page for the CLI argument.
Yes, at the moment, the toolkit can only be extended around credential providers, but we are open to requests for other extensibility points. @Doug-AWS @RomainMuller, could you please add a little doc section on toolkit plugins in the tools topic?