Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

docs: Update README using v1 tag and bump version to 1.4.2 #56

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

Merged
shenxianpeng merged 3 commits into master from update-readme
Apr 23, 2022

Conversation

@shenxianpeng
Copy link
Collaborator

@shenxianpeng shenxianpeng commented Apr 23, 2022
edited by 2bndy5
Loading

I assume to bump the version to 1.4.2 because

  1. The current version in setup.py is incorrect, it is 1.3.1
  2. update README based on suggestion in https://github.com/shenxianpeng/cpp-linter-action/issues/55#issuecomment-1106666257

Copy link
Collaborator Author

shenxianpeng commented Apr 23, 2022
edited
Loading

Tested looks good

python3 -m pip install git+https://github.com/shenxianpeng/cpp-linter-action@v1.4.2
gitpod /workspace/cpp-linter-action (update-readme) $ pip3 show cpp-linter
Name: cpp-linter
Version: 1.4.2
Summary: Bootstrapper for docker's ENTRYPOINT executable.
Home-page: https://github.com/2bndy5/cpp-linter-action
Author: Brendan Doherty
Author-email: 2bndy5@gmail.com
License: MIT
Location: /home/gitpod/.pyenv/versions/3.8.13/lib/python3.8/site-packages
Requires: pyyaml, requests
Required-by: 

Note: I created tag v1.4.2 from update-readme branch for testing, so it's a pre-release. I'll recreate the same tag and release if this PR is merged to the master branch

@shenxianpeng shenxianpeng added the documentation Improvements or additions to documentation label Apr 23, 2022
Copy link
Collaborator

2bndy5 commented Apr 23, 2022

I'm curious if using @v1 will allow us to only require future changes when bumping the major version.

According to the github docs, using v1 can be shorthand for v1.x.x. I think this means we would have to keep moving a separate tag named v1 to the latest released commit (which is currently tagged with v1.4.2). This would be easier than updating the README for every release.

shenxianpeng reacted with thumbs up emoji

Copy link
Collaborator

2bndy5 commented Apr 23, 2022

I think this means we would have to keep moving a separate tag named v1 to the latest released commit

Or we could create a branch named v1 and keep pushing deployment-ready commits to that branch (likely cherry-picked from master). But this seem like a bit more work than moving a tag around.

Copy link
Collaborator

2bndy5 commented Apr 23, 2022
edited
Loading

The current version in setup.py is incorrect, it is 1.3.1

Ideally we wouldn't need to keep updating this in setup.py if we use the setuptools_scm lib as a build dependency. However, I neglected to do this since it adds to the action setup time (setuptools_scm is only available via pip).

Alternatively, we could upload a wheel to pypi under the package name cpp-linter-action. This would allow for quicker pip installs, but using setuptools_scm would still affect the action setup (when using a docker on ubuntu runners)

Copy link
Collaborator Author

From the tests you run, v1 makes a lot of sense, and it also works with python3 -m pip install git+https://github.com/shenxianpeng/cpp-linter-action@v1

If every release needs to build and upload a wheel to be published to pypi seems to add a bit more work.

Copy link

Copy link
Collaborator Author

@shenxianpeng shenxianpeng left a comment

Choose a reason for hiding this comment

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

LGTM

"A python package that powers the github action named cpp-linter-action. "
+ f"See `the github repository README <{REPO}#readme>`_ for full details."
),
author="Brendan Doherty, Peter Shen",
Copy link
Collaborator Author

@shenxianpeng shenxianpeng Apr 23, 2022

Choose a reason for hiding this comment

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

Suggested change
author="Brendan Doherty, Peter Shen",
author="Brendan Doherty",

shenxianpeng reacted with heart emoji
Copy link
Collaborator

Choose a reason for hiding this comment

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

You don't want your name on this?! I didn't add you email to author_email field.

Copy link
Collaborator Author

@shenxianpeng shenxianpeng Apr 23, 2022

Choose a reason for hiding this comment

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

You are the author of the Python code, I may be a future contributor, shame, but thank you!

Copy link
Collaborator

Choose a reason for hiding this comment

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

I consider feedback, review, and testing as contributions.. You deserve it!

Copy link
Collaborator

2bndy5 commented Apr 23, 2022

If every release needs to build and upload a wheel to be published to pypi seems to add a bit more work.

I can easily automate this with CD workflow, but I'm not sure it is worth it right now. Maybe in the future when we have patched in support for other CI services...

shenxianpeng reacted with thumbs up emoji

Copy link
Collaborator Author

To save setup time or add a CI workflow for this? Yes, maybe in the future ...

Copy link
Collaborator

@2bndy5 2bndy5 left a comment

Choose a reason for hiding this comment

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

Since I pushed the v1 tag (and tested it on the test repo with success), I pushed a commit that updated the README to use v1 instead of the full tag v1.4.2.

Copy link
Collaborator

2bndy5 commented Apr 23, 2022

To save setup time

Recent tests (on the test repo) show that pip installing from the repo directly (instead of pypi) only takes about 12 seconds. So, I'm not sure how much time it would actually save (I'm guessing around 5 seconds).

Copy link
Collaborator

2bndy5 commented Apr 23, 2022

If you're ready to merge, I can move around the tags afterward (and remove the "pre-release" flag).

Copy link
Collaborator Author

5 seconds sounds good! OK, I. am going to merge

@shenxianpeng shenxianpeng merged commit fba6075 into master Apr 23, 2022
@shenxianpeng shenxianpeng deleted the update-readme branch April 23, 2022 15:25
Copy link
Collaborator

2bndy5 commented Apr 23, 2022

FYI, I had to

  1. delete the tags
  2. push the changes
  3. re-create the tags
  4. push the changes again

I think this is why the pre-release description of v1.4.2 got removed. BTW, having the tags on a branch that was not the master branch proved to be an additional obstacle.

Copy link
Collaborator Author

I did

  • deleted the pre-release
  • recreate a release v1.4.2 using the tag you created.

I added v1.4.2 to the update-readme branch for testing, it really cause some inconvenience.

Copy link
Collaborator

2bndy5 commented Apr 23, 2022

oh! In the future, I'll leave the releases in your capable hands.

Copy link
Collaborator Author

No problem, I am a release engineer in my other capacity 😆

2bndy5 reacted with laugh emoji

@shenxianpeng shenxianpeng changed the title (削除) docs: Update README and bump version to 1.4.2 (削除ここまで) (追記) docs: Update README using v1 tag and bump version to 1.4.2 (追記ここまで) Apr 23, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@2bndy5 2bndy5 2bndy5 approved these changes

Assignees

No one assigned

Labels

documentation Improvements or additions to documentation

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

AltStyle によって変換されたページ (->オリジナル) /