Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Add exception docs#3490

Merged
asvetlov merged 5 commits into
aio-libs:masterfrom
dave-shawley:add-exception-docs
Jan 6, 2019
Merged

Add exception docs#3490
asvetlov merged 5 commits into
aio-libs:masterfrom
dave-shawley:add-exception-docs

Conversation

@dave-shawley
Copy link
Copy Markdown
Contributor

What do these changes do?

A few simple documentation changes to enable linking to aiohttp.web.Response and aiohttp.web.HTTPException using sphinx.ext.intersphinx. Previously the class documentation for Response was not indented properly so a link was not generated in objects.inv. I added class documentation for aiohttp.web.HTTPException that refers to the existing exception documentation.

Are there changes in behavior for the user?

Nope. No changes in behavior whatsoever.

Related issue number

Not that I am aware of.

Checklist

  • I think the code is well written (N/A)
  • Unit tests for the changes exist (N/A)
  • Documentation reflects the changes
  • If you provide code modification, please add yourself to CONTRIBUTORS.txt
    • The format is <Name> <Surname>.
    • Please keep alphabetical order, the file is sorted by names.
  • Add a new news fragment into the CHANGES folder
    • name it <issue_id>.<type> for example (588.bugfix)
    • if you don't have an issue_id change it to the pr id after creating the pr
    • ensure type is one of the following:
      • .feature: Signifying a new feature.
      • .bugfix: Signifying a bug fix.
      • .doc: Signifying a documentation improvement.
      • .removal: Signifying a deprecation or removal of public API.
      • .misc: A ticket has been closed, but it is not of interest to users.
    • Make sure to use full sentences with correct case and punctuation, for example: "Fix issue with non-ascii contents in doctest text files."

Indent the parameters for Response in the class documentation so that
the link to it is generated.
@codecov-io
Copy link
Copy Markdown

codecov-io commented Jan 6, 2019

Codecov Report

Merging #3490 into master will decrease coverage by 0.02%.
The diff coverage is n/a.

Impacted file tree graph

@@            Coverage Diff             @@
##           master    #3490      +/-   ##
==========================================
- Coverage   97.95%   97.93%   -0.03%     
==========================================
  Files          44       44              
  Lines        8554     8554              
  Branches     1377     1377              
==========================================
- Hits         8379     8377       -2     
- Misses         71       72       +1     
- Partials      104      105       +1
Impacted Files Coverage Δ
aiohttp/web_fileresponse.py 96.55% <0%> (-1.15%) ⬇️

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 c9dabcb...877b9b9. Read the comment docs.

@asvetlov asvetlov merged commit 3a0c7bf into aio-libs:master Jan 6, 2019
@asvetlov
Copy link
Copy Markdown
Member

asvetlov commented Jan 6, 2019

Thanks!

asvetlov pushed a commit that referenced this pull request Jan 6, 2019
* Fix aiohttp.web.Response docs.
* Adjust json_response TOC level.
* Add HTTPException class documentation.
(cherry picked from commit 3a0c7bf)

Co-authored-by: dave-shawley <[email protected]>
asvetlov added a commit that referenced this pull request Jan 6, 2019
* Fix aiohttp.web.Response docs.
* Adjust json_response TOC level.
* Add HTTPException class documentation.
(cherry picked from commit 3a0c7bf)

Co-authored-by: dave-shawley <[email protected]>
@dave-shawley dave-shawley deleted the add-exception-docs branch January 7, 2019 11:39
@lock
Copy link
Copy Markdown

lock Bot commented Jan 7, 2020

This thread has been automatically locked since there has not been
any recent activity after it was closed. Please open a new issue for
related bugs.

If you feel like there's important points made in this discussion,
please include those exceprts into that new issue.

@lock lock Bot added the outdated label Jan 7, 2020
@lock lock Bot locked as resolved and limited conversation to collaborators Jan 7, 2020
@psf-chronographer psf-chronographer Bot added the bot:chronographer:provided There is a change note present in this PR label Jan 7, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

bot:chronographer:provided There is a change note present in this PR outdated

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants