add and test URL.__str__, which enables URLs to be passed directly to…

[mahmoud]

This URL.__str__() enables URLs to be passed directly to libaries which stringify (like requests), as brought up by issue #49.

I've opted to keep it simple and have Python 2's __str__ (Py3's __bytes__()) return the UTF-8 encoded version of URL.to_text(). This means that when printed on terminals configured to display UTF-8, the user will get a copy-and-pastable URL.

I also considered making __str__ return the ASCII-encoded URL.to_url().to_text(), but this would have the property of obscuring special characters and possibly falsely-equating URIs and IRIs, contrary to hyperlink's longstanding design.

[codecov-io]

Codecov Report

Merging #55 into master will increase coverage by 0.03%.
The diff coverage is 100%.

@@            Coverage Diff            @@
##           master     #55      +/-   ##
=========================================
+ Coverage   97.76%   97.8%   +0.03%     
=========================================
  Files           6       6              
  Lines        1118    1137      +19     
  Branches      135     137       +2     
=========================================
+ Hits         1093    1112      +19     
  Misses         13      13              
  Partials       12      12

Impacted Files	Coverage Δ
hyperlink/test/test_url.py	99.8% <100%> (ø)	⬆️
hyperlink/_url.py	95.72% <100%> (+0.05%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 5810649...04694a0. Read the comment docs.

[glyph]

Rather than adding the "some libraries are bad at IRIs" in a private docstring that I guarantee you no one will ever read, if the goal here is requests compatibility, perhaps we should apply the as_url() transformation unconditionally here? A higher-fidelity representation is always available via to_text if desired.

[mahmoud]

The "some libraries are bad at IRIs" is just a hint of a glimmer of something I remember, combined with general suspicion. I'm fine with the always as_url() if you are, btw.

[glyph]

Please file a follow-up ticket to add documentation showing that this is an intentional integration point with Requests.

(And we should probably make sure it works with Treq too, although I'm not sure if it does right now.)

[markrwilliams]

@glyph twisted/treq#212