Feat: Integrate python-dotenv for Secure API Credential Management

[turkalpmd]

This pull request enhances PyCap by integrating python-dotenv for more secure and flexible management of REDCap API credentials.

Changes:

• Added python-dotenv Dependency: The python-dotenv library is now a dependency, as specified in pyproject.toml. This allows users to load environment variables from a .env file.
• Updated Documentation for .env Usage:
  • docs/quickstart.md: Updated the initial setup instructions to guide users on creating a .env file for REDCAP_API_URL and REDCAP_API_KEY, and how to load them using python-dotenv.
  • docs/index.md: The installation section now includes guidance on setting up a .env file for credential management.

Benefits:

• Enhanced Security: Helps users avoid hardcoding sensitive API keys and URLs directly into their scripts, reducing the risk of accidental exposure.
• Improved Configuration: Simplifies managing different configurations (e.g., for development, staging, production environments) by using distinct .env files.
• Adherence to Best Practices: Promotes a standard and secure method for handling application secrets.

[pwildenhain]

👍🏻 to using .env for credential management. I think it's a great call out since most REDCap users don't typically have a programming background and might not know about safe credential management.

Thanks also for updating the documentation to showcase how to use this

My only request is remove python-dotenv as a direct dependency. I think it's good advice for them to install and use it alongside PyCap but it's not integral to how the package itself works

[turkalpmd]

Thanks for the feedback! I removed python-dotenv from the core dependencies and reverted the lockfile changes. The docs now just recommend installing it alongside PyCap, and I added a quickstart snippet plus a .env.example template so users can copy/paste their credentials. Let me know if anything else would help.

[turkalpmd]

Fix lint setup and ensure tests run clean

[pwildenhain]

Don't worry about the CI failures, I think it has something to do with how my integration tests are setup. Thanks for you work!