Python documentation

[Doug-AWS]

To support the addition of Python to the CDK, we need the following information for the guide:

• The prerequisites (Python version, pip version)
• The installation command (pip install cdk?)
• The update command (pip install --upgrade cdk?)
• Porting the "Hello World" tutorial, https://docs.aws.amazon.com/CDK/latest/userguide/hello_world_tutorial.html, to Python

[Doug-AWS]

Depends on #2009

[dstufft]

It depends on Python 3.6+, pip version is uh, well pretty much any version that anyone is likely to have.

The installation command depends on which libraries you need to install, the CDK itself is pip install aws-cdk.cdk. You can get a list of all of our libraries at https://pypi.org/user/aws-cdk/.

Upgrading is the same command, but with the `--upgrade`` flag.

I don't think we have the init templates done to port the hello world tutorial over.

[cmclaughlin]

I don't think we have the init templates done to port the hello world tutorial over.

Trying out the newly added Python support and hit that:

$ cdk --version
0.27.0 (build 7638a58)

$ cdk init --language python
/usr/local/bin/cdk init [TEMPLATE]

Options:
  --app, -a             REQUIRED: Command-line for executing your CDK app (e.g.
                        "node bin/my-app.js")                           [string]
  --context, -c         Add contextual string parameter.                 [array]
  --plugin, -p          Name or path of a node package that extend the CDK
                        features. Can be specified multiple times        [array]
  --rename              Rename stack name if different from the one defined in
                        the cloud executable                            [string]
  --trace               Print trace for stack warnings                 [boolean]
  --strict              Do not construct stacks with warnings          [boolean]
  --ignore-errors       Ignores synthesis errors, which will likely produce an
                        invalid output                [boolean] [default: false]
  --json, -j            Use JSON output instead of YAML                [boolean]
  --verbose, -v         Show debug logs                                [boolean]
  --profile             Use the indicated AWS profile as the default environment
                                                                        [string]
  --proxy               Use the indicated proxy. Will read from HTTPS_PROXY
                        environment variable if not specified.          [string]
  --ec2creds, -i        Force trying to fetch EC2 instance credentials. Default:
                        guess EC2 instance status.                     [boolean]
  --version-reporting   Include the "AWS::CDK::Metadata" resource in synthesized
                        templates (enabled by default)                 [boolean]
  --path-metadata       Include "aws:cdk:path" CloudFormation metadata for each
                        resource (enabled by default)  [boolean] [default: true]
  --asset-metadata      Include "aws:asset:*" CloudFormation metadata for
                        resources that user assets (enabled by default)
                                                       [boolean] [default: true]
  --role-arn, -r        ARN of Role to use when invoking CloudFormation [string]
  --toolkit-stack-name  The name of the CDK toolkit stack               [string]
  --ci                  Force CI detection. Use --no-ci to disable CI
                        autodetection.                [boolean] [default: false]
  --version             Show version number                            [boolean]
  --language, -l        the language to be used for the new project (default can
                        be configured in ~/.cdk.json)
                    [string] [choices: "csharp", "fsharp", "java", "typescript"]
  --list                list the available templates                   [boolean]
  -h, --help            Show help                                      [boolean]

Invalid values:
  Argument: language, Given: "python", Choices: "csharp", "fsharp", "java", "typescript"

[Graham-Beer]

To use Python make sure you update to CDK version 0.28.0

[Doug-AWS]

Be aware that Python support in 0.28.0 on Windows has issues. We'll have a fix out shortly.

[Doug-AWS]

Python is fully supported in CDK 0.30.0.