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

Remove non-code files from release archive #25

Merged
merged 7 commits into from
Sep 27, 2023

Conversation

sanmai
Copy link
Member

@sanmai sanmai commented Sep 20, 2023

See: #24

What and why? 🤔

To avoid problems such as in #24 let's exclude all non-library files (examples, tests, plumbing) from the final release archive.

Testing Steps ✍️

git archive --format=tar HEAD | tar t should get you a list of included files, which should not include tests and examples.

For a summary, see:

$ git archive --format=tar HEAD | tar t | cut -f1 -d/ | sort | uniq
composer.json
config
docs
lib
LICENSE
README.md

You're it! 👑

@Automattic/stream-builders

@coveralls
Copy link

coveralls commented Sep 20, 2023

Coverage Status

coverage: 79.4%. remained the same when pulling f35d82f on sanmai:pr/gitattributes into 0b3b6a3 on Automattic:main.

@sanmai sanmai marked this pull request as ready for review September 20, 2023 11:30
Copy link
Contributor

@markbiek markbiek left a comment

Choose a reason for hiding this comment

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

Good idea! LGTM!

@cyle
Copy link
Contributor

cyle commented Sep 20, 2023

final release archive

how is this created? the literal releases that are generated? if so, we should make it clear somewhere, like the README, that the release doesn't include these things. otherwise, folks may download the latest release, hoping to try out the example, and get confused about why it's not there.

@sanmai
Copy link
Member Author

sanmai commented Sep 23, 2023

@cyle Good point: I updated the documentation to mention that.

@sanmai sanmai requested a review from cyle September 23, 2023 14:26
@@ -54,7 +54,7 @@ As an example of how to use StreamBuilder, we will implement an endpoint to retr

Let's also assume the returned array is a simple `string[]` which contains trending topics as strings.

We also have an example demo application in the `example/` folder which implements a lot of what we're going to discuss here -- so check that out!
We also have an example demo application in the `example/` folder which implements a lot of what we're going to discuss here -- so check that out! You must clone the Git repository to work with the example, as released archives do not include example code.
Copy link
Contributor

Choose a reason for hiding this comment

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

awesome. mind adding this somewhere prominent in the example/README.md file as well?

Copy link
Member Author

Choose a reason for hiding this comment

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

Added in both places 👍

@sanmai sanmai requested a review from cyle September 26, 2023 05:53
@sanmai sanmai merged commit 5333df2 into Automattic:main Sep 27, 2023
8 checks passed
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.

4 participants