docs: client_protocol_version missing from Connection Parameters table

Open Beginner friendly
#276 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
1-3 hours
Newbie friendliness
74/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Quiet
Tech stack
python
Domain
documentation

Research direction

Start in the README's Client Transfer Protocol section and Connection Parameters table, where client_protocol_version is referenced but not listed. Confirm the valid values with maintainers, then document the parameter's type, default, description, valid values, and Python connection example. Done means the table and usage documentation consistently cover the parameter.

Written by the indexing model from the issue text.

Description

The README references client_protocol_version under "Client Transfer Protocol," stating it can modify the protocol version. However, this parameter is:

  1. Absent from the Connection Parameters table
  2. Has no usage example or valid values documented

Suggested addition to the parameters table:

Parameter Type Default Description
client_protocol_version int 2 Controls the wire protocol version for data transfer

Example:

conn = redshift_connector.connect(
    host='cluster.abc123.us-east-1.redshift.amazonaws.com',
    database='dev',
    user='admin',
    password='***',
    client_protocol_version=2
)

Happy to open a PR if maintainers can confirm the valid values.

Dominant language
Python
Stars
220
Forks
86
PR merge metrics
No merged PRs in 30d

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from aws/amazon-redshift-python-driver

All issues in aws/amazon-redshift-python-driver

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.