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

docs: adding README.md for how to write e2e tests #1769

Conversation

chatton
Copy link
Contributor

@chatton chatton commented Jul 22, 2022

Description

closes: #1683


Before we can merge this PR, please make sure that all the following items have been
checked off. If any of the checklist items are not applicable, please leave them but
write a little note why.

  • Targeted PR against correct branch (see CONTRIBUTING.md)
  • Linked to Github issue with discussion and accepted design OR link to spec that describes this work.
  • Code follows the module structure standards.
  • Wrote unit and integration tests
  • Updated relevant documentation (docs/) or specification (x/<module>/spec/)
  • Added relevant godoc comments.
  • Added a relevant changelog entry to the Unreleased section in CHANGELOG.md
  • Re-reviewed Files changed in the Github PR explorer
  • Review Codecov Report in the comment section below once CI passes

@chatton chatton changed the title chore: adding README.md for how to write e2e tests docs: adding README.md for how to write e2e tests Jul 25, 2022
Copy link
Contributor

@colin-axner colin-axner left a comment

Choose a reason for hiding this comment

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

Thank you, thank you, thank you! I really appreciate all the work you've been doing to push forward the e2e tests and I really love the touch of adding a readme ❤️

e2e/README.md Outdated Show resolved Hide resolved
e2e/README.md Show resolved Hide resolved
e2e/README.md Show resolved Hide resolved
e2e/README.md Show resolved Hide resolved
e2e/README.md Show resolved Hide resolved
e2e/README.md Show resolved Hide resolved
e2e/README.md Show resolved Hide resolved
Copy link
Member

@damiannolan damiannolan left a comment

Choose a reason for hiding this comment

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

Agree with all of @colin-axner's comments! Thank you so much for such a detailed guide. All of the work on e2e is extremely valuable and at an extremely high standard! I'm looking forward to working with it! ❤️

I think we have being trying to adhere to the google style guide in many of our docs and READMEs across the repo. The main thing that comes to mind is sentences for titles. E.g. "How To Write Tests" -> "How to write tests". cc. @crodriguezvega

t.Run("broadcast multi message transaction", func(t *testing.T){
payPacketFeeMsg := feetypes.NewMsgPayPacketFee(testFee, channelA.PortID, channelA.ChannelID, chainAWallet.Bech32Address(chainA.Config().Bech32Prefix), nil)
transferMsg := transfertypes.NewMsgTransfer(channelA.PortID, channelA.ChannelID, transferAmount, chainAWallet.Bech32Address(chainA.Config().Bech32Prefix), chainBWallet.Bech32Address(chainB.Config().Bech32Prefix), clienttypes.NewHeight(1, 1000), 0)
resp, err := s.BroadcastMessages(ctx, chainA, chainAWallet, payPacketFeeMsg, transferMsg)
Copy link
Member

@damiannolan damiannolan Jul 27, 2022

Choose a reason for hiding this comment

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

Love this, super clean API!

e2e/README.md Outdated

It is possible to send an IBC transfer in two ways.

Use the ibctest Chain interface (this ultimately does a docker exec)
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Use the ibctest Chain interface (this ultimately does a docker exec)
Use the ibctest `Chain` interface (this ultimately does a docker exec)

e2e/README.md Outdated
### How tests are run

The tests use the `matrix` feature of Github Actions. The matrix is
dynamically generated using [this script](https://github.com/cosmos/ibc-go/blob/main/.github/scripts/build_test_matrix.go).
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
dynamically generated using [this script](https://github.com/cosmos/ibc-go/blob/main/.github/scripts/build_test_matrix.go).
dynamically generated using [this command](https://github.com/cosmos/ibc-go/blob/main/cmd//build_test_matrix/main.go).

e2e/README.md Outdated Show resolved Hide resolved
@chatton
Copy link
Contributor Author

chatton commented Jul 28, 2022

@damiannolan @colin-axner in the rich preview the reference links seem broken, but if you go to view file they work okay.

@chatton chatton merged commit 045ab6f into main Jul 28, 2022
@chatton chatton deleted the cian/issue#1683-add-e2e-readme-which-outlines-how-to-write-e2e-tests branch July 28, 2022 11:37
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.

Add E2E README which outlines how to write E2E tests
3 participants