conan-io / docs

conan.io reStructuredText documentation
http://docs.conan.io
MIT License
104 stars 352 forks source link

[bug] core.net.http:proxies format is unclear #3678

Open andrey-zherikov opened 4 months ago

andrey-zherikov commented 4 months ago

Describe the bug

Conan version: 2.2.2

Documentation says core.net.http:proxies: Dictionary containing the proxy configuration without clarification the format of dictionary.

After some experiments I found that the key is a hostname and the value is port. So:

  1. Please confirm that this is the expected format.
  2. Update documentation to make this clear.
  3. Ideally enforce the validation of the format of global.conf to ensure that it's always valid.
memsharded commented 4 months ago

yeah, the expected format is like:

core.net.http:proxies = {"http": "value"}

This is basically a forward to python-requests with: https://requests.readthedocs.io/en/latest/user/advanced/#proxies

I'll move this ticket to the docs repo for trying to improve them. Contributions are also welcome there.

Thanks for reporting this!