How to setup neardevhub-contract locally and run

[Rishabhraghwendra18]

I am working on issue #11 for which I need to add get_posts_recursively function in the contract. I have installed all the dependencies of the repo locally in my machine by running cargo build. I want to know how can I test my new function. Do I need to install any more dependencies because neardevhub-contract doesn't have a setup guide and it looks like I need some mock PostId to test with?

[carina-akaia]

Hi @Rishabhraghwendra18.

The most efficient solution would be creating a new test module in the /tests directory of the contract repo and executing cargo test. You can use the migration test module as an example. It's worth mentioning that we encourage contributors to write tests for any update that adds new functionalities, so I would consider this step as mandatory.

Another option is to deploy your own contract instance on testnet, which will also act as a demo environment, that you can link in your PR's description in order to make the acceptance process easier for reviewers. Notice that in this case, you need to deploy the widgets as well.

[carina-akaia]

Given that at the moment, we don't have contract testing conventions mentioned in our contribution guideline, I would kindly ask @frol, @ailisp, and @petersalomonsen for any comments or suggestions on the topic.

[petersalomonsen]

I think your suggestion is fine @carina-akaia . Can also just add that unit tests also should be added. They run fast, and should also be used to cover most scenarios on the logic level. Then as you suggest looking at the migration test, which is using near-workspaces-rs, and simulating the full blockchain functionality. You can even write tests for the testnet, set up dev accounts with near-dev-deploy, but a local sandbox with near-workspaces-rs should be sufficient in most cases.