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

Use a standard license file format #126

Open
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

patgarz
Copy link

@patgarz patgarz commented Jan 17, 2023

This PR adds a file named LICENSE, which is the standard format that both GitHub and many code scanners use to autodetect and categorize licenses in projects. The added LICENSE file uses the autogenerated GitHub format for the BSD 3-Clause license, which is differs in mostly semantics from the current COPYRIGHT file. The one significant change is the third clause now restricts endorsements that use the copyright holder or contributors, rather than just the copyright holder, which I believe is the intended language anyways.

The benefits of using a standard license in the expected format can be seen in this example repository, where the license name is listed in the sidebar and also in detail when clicked. It will also allow the package to show up with the proper license in enterprise code scan tools, which increases the likelihood it will be used by enterprise programmers.

Possible variations on this PR:

  • Update the current COPYRIGHT file to match the proposed LICENSE file (two duplicate files, new text)
  • Create the LICENSE file, but have it match the current COPYRIGHT file (two duplicate files, current text)
  • Retain the current COPYRIGHT file as a separate, slightly different file (two files, different text)

Let me know if you'd prefer any of the above over the current proposition. I recommend this state (remove COPYRIGHT, add LICENSE in standard format) as it matches GitHub recommendations with all the benefits of auto-license-categorization and does not cause confusion or later errors in future copyright updates by having two separate files indicating the same information. However, I can understand wanting to keep backwards compatibility, so my second recommendation would be variation 1, where we update COPYRIGHT to have the new text as well.

closes #116

@dvarrazzo
Copy link
Owner

Thank you

Can you squash the commits so we can see it as a rename and get the diff, instead of being two files without any related history?

Thank you :)

@patgarz
Copy link
Author

patgarz commented Jan 18, 2023

My org is blocking the squashed commit from being pushed so there might be a few days delay while I get that worked out, but I will comment here when it's done.

@patgarz patgarz force-pushed the standard-license-file branch from 82760d3 to e37b70f Compare January 25, 2023 16:12
@patgarz patgarz marked this pull request as draft January 25, 2023 16:19
@patgarz patgarz closed this Jan 25, 2023
@patgarz patgarz force-pushed the standard-license-file branch from e37b70f to e174a15 Compare January 25, 2023 16:20
@patgarz patgarz reopened this Jan 25, 2023
@patgarz patgarz marked this pull request as ready for review January 25, 2023 16:28
@patgarz
Copy link
Author

patgarz commented Jan 25, 2023

Alright! Finally.

Sorry for the delay, I think this looks good now:

image

@dvarrazzo
Copy link
Owner

This MR is reported closing #1116, which was requesting to include the license in the package - I assume the sdist.

This MR changes the name and some wording in the file. Does the file changed this way get included in the sdist?

@patgarz
Copy link
Author

patgarz commented Feb 6, 2023

Apologies for the late reply, I've been out of the country for a few weeks ---

Yes, I can confirm that LICENSE is included in the sdist:

python setup.py sdist --formats gztar
tar -xvf dist/setproctitle-1.3.2.tar.gz -C dist

image

@patgarz
Copy link
Author

patgarz commented Mar 3, 2023

Hey @dvarrazzo , just pinging to ensure this didn't get lost. If there are any other questions pending let me know. Thanks!

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.

Include the license file in the distribution
2 participants