Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Generate doxygen documentation and publish on github pages + code coverage published on coveralls.io #76

Merged
merged 9 commits into from
Jul 6, 2020

Conversation

prince-chrismc
Copy link
Collaborator

@prince-chrismc prince-chrismc commented Jul 1, 2020

Since this library is used as a part of API security I think its only fair to expect a high level of quality.

Having documentation more accessibly helps prevent implementation mistakes.
Code coverage will help highlight short comings where improvements can be made.

closes #41

  • add link to gp-pages in README.md or project
  • setup coveralls.io for upstream

@prince-chrismc
Copy link
Collaborator Author

https://prince-chrismc.github.io/jwt-cpp/ for a preview

* adding coverage testing

surprisingly:
Overall coverage rate:
  lines......: 80.6% (519 of 644 lines)
  functions..: 92.5% (235 of 254 functions)

* Update coverage.yml
@prince-chrismc
Copy link
Collaborator Author

My intention was to separate these two items but github was not liking my attempt...

One potential issue is this uses GitHub action (instead of continuing with travis) the integration with from the new actions makes all of this a lot easier.

@prince-chrismc prince-chrismc changed the title Generate doxygen documentation and publish on github pages Generate doxygen documentation and publish on github pages + code coverage published on coveralls.io Jul 6, 2020
@Thalhammer
Copy link
Owner

I think its fine to have them as one PR.
I haven't worked with github actions a lot before (mainly because I also use Gitlab a lot).
Taking a look at the code coverage report (which is definitly a good thing to have it looks like most of the untested lines is either error handling or unused code (like std::string overloads for exceptions).

A doxygen documentation is also good, but I think we might need to start documenting stuff for it to be trully usefull.

Sidenote: I do intend to rewrite most of the internals to use std::error_code instead of exceptions, as well as providing non throwing overloads for all public functions.

README.md Outdated
@@ -2,6 +2,7 @@

[![Codacy Badge](https://api.codacy.com/project/badge/Grade/5f7055e294744901991fd0a1620b231d)](https://app.codacy.com/app/Thalhammer/jwt-cpp?utm_source=github.com&utm_medium=referral&utm_content=Thalhammer/jwt-cpp&utm_campaign=Badge_Grade_Settings)
[![Build Status](https://travis-ci.com/Thalhammer/jwt-cpp.svg?branch=master)](https://travis-ci.com/Thalhammer/jwt-cpp)
[![Coverage Status](https://coveralls.io/repos/github/prince-chrismc/jwt-cpp/badge.svg?branch=master)](https://coveralls.io/github/prince-chrismc/jwt-cpp?branch=master)
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This needs to be changed to point to the original repo onve merged (or right before).

@Thalhammer Thalhammer merged commit 627c45b into Thalhammer:master Jul 6, 2020
@prince-chrismc
Copy link
Collaborator Author

I've only started using them recently, they have been a pleasure!

Error handling is certainly the big one, it might be worth looking into fuzzing to see how that goes.

I see your error_codes have been an idea for while, certainly useful 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Api referece - documentation
2 participants