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

test: automation script for local Dokka testing #3432

Merged
merged 7 commits into from Jan 30, 2024
Merged

Conversation

berezinant
Copy link
Contributor

@berezinant berezinant commented Dec 20, 2023

.testDokka.sh makes Dokka development and testing a bit faster

It compiles current Dokka version from the source code,
publishes it to the local Maven repository,
then runs the Dokka documentation generation against the specified project
and finally runs a webserver to open the generated documentation in the browser.

Demo of usage: https://monosnap.com/file/m1xuNF7IVlHXtYUZWovOBduYY3GsER

PS this is a prototype based on the most frequent things I've to do while testing Dokka, it could be improved or done in some other way, let's discuss

testDokka.sh Outdated Show resolved Hide resolved
testDokka.sh.md Outdated
### All together

```bash
./testDokka.sh -d './examples/gradle/dokka-gradle-example' -v "1.9.20-SNAPSHOT" -p 8001
Copy link
Contributor

Choose a reason for hiding this comment

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

I think, it would be nice use for default not real version (for ex. 1.9.10-my-fix-SNAPSHOT like CONTRIBUTING.md)

Copy link
Contributor

Choose a reason for hiding this comment

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

And may be do link in contribution.md.
/cc @IgnatBeresnev

testDokka.sh Outdated Show resolved Hide resolved
testDokka.sh Outdated Show resolved Hide resolved
testDokka.sh Outdated Show resolved Hide resolved
testDokka.sh Outdated Show resolved Hide resolved
@berezinant berezinant force-pushed the test-dokka branch 2 times, most recently from ee8c593 to 3511bf9 Compare January 17, 2024 10:16
@berezinant berezinant changed the title Some automation for Dokka testing test: automation script for local Dokka testing Jan 17, 2024
Copy link
Contributor

@whyoleg whyoleg left a comment

Choose a reason for hiding this comment

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

LGTM.
@IgnatBeresnev WDYT regarding mavenLocal in examples?

testDokka.sh Outdated Show resolved Hide resolved
Copy link
Member

@IgnatBeresnev IgnatBeresnev left a comment

Choose a reason for hiding this comment

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

Oleg pretty much already left the two comments that I had :))

@berezinant berezinant merged commit 052a5d7 into master Jan 30, 2024
12 checks passed
@berezinant berezinant deleted the test-dokka branch January 30, 2024 11:30
vmishenev pushed a commit that referenced this pull request Mar 20, 2024
* test: added script for faster dokka testing

* docs: added readme for testDokka.sh

* test: improved testDokka.sh after review

* test: made testDokka start server event with option set -e

* test: support multimodule projects

* test: add docs

* test: move testDokka to /scripts dir
@IgnatBeresnev IgnatBeresnev removed this from the Dokka 2.0.0 milestone Apr 25, 2024
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.

None yet

4 participants