|
1 | | -# Lightning Sample project/package |
| 1 | +# Lightning Models |
2 | 2 |
|
3 | | -This is starter project template which shall simplify initial steps for each new PL project... |
| 3 | +...TBD... |
4 | 4 |
|
5 | 5 | [](https://lightning.ai/) |
6 | 6 | [](https://github.com/Lightning-AI/models/actions/workflows/ci-testing.yml) |
7 | 7 | [](https://github.com/Lightning-AI/models/actions/workflows/ci-checks.yml) |
8 | 8 | [](https://models.readthedocs.io/en/latest/?badge=latest) |
9 | 9 | [](https://results.pre-commit.ci/latest/github/Lightning-AI/models/main?badge_token=mqheL1-cTn-280Vx4cJUdg) |
10 | | - |
11 | | -\* the Read-The-Docs is failing as this one leads to the public domain which requires the repo to be public too |
12 | | - |
13 | | -## Included |
14 | | - |
15 | | -Listing the implemented sections: |
16 | | - |
17 | | -- sample package named `litmodels` |
18 | | -- setting [CI](https://github.com/Lightning-AI/models/actions?query=workflow%3A%22CI+testing%22) for package and _tests_ folder |
19 | | -- setup/install package |
20 | | -- setting docs with Sphinx |
21 | | -- automatic PyPI release on GH release |
22 | | -- Docs deployed as [GH pages](https://Lightning-AI.github.io/models) |
23 | | -- Makefile for building docs with `make docs` and run all tests `make test` |
24 | | - |
25 | | -## To be Done aka cross-check |
26 | | - |
27 | | -You still need to enable some external integrations such as: |
28 | | - |
29 | | -- [ ] update path used in the badges to the repository |
30 | | -- [ ] lock the main breach in GH setting - no direct push without PR |
31 | | -- [ ] set `gh-pages` as website and _docs_ as source folder in GH setting |
32 | | -- [ ] init Read-The-Docs (add this new project) |
33 | | -- [ ] add credentials for releasing package to PyPI |
34 | | -- [ ] specify license in `LICENSE` file and package init |
35 | | - |
36 | | -## Tests / Docs notes |
37 | | - |
38 | | -- We are using [Napoleon style,](https://www.sphinx-doc.org/en/master/usage/extensions/napoleon.html) and we shall use static types... |
39 | | -- It is nice to se [doctest](https://docs.python.org/3/library/doctest.html) as they are also generated as examples in documentation |
40 | | -- For wider and edge cases testing use [pytest parametrization](https://docs.pytest.org/en/stable/parametrize.html) :\] |
0 commit comments