mirror of
https://github.com/modelscope/modelscope.git
synced 2026-02-24 12:10:09 +01:00
[to #41669377] docs and tools refinement and release
1. add build_doc linter script 2. add sphinx-docs support 3. add development doc and api doc 4. change version to 0.1.0 for the first internal release version Link: https://code.aone.alibaba-inc.com/Ali-MaaS/MaaS-lib/codereview/8775307
This commit is contained in:
48
docs/source/develop.md
Normal file
48
docs/source/develop.md
Normal file
@@ -0,0 +1,48 @@
|
||||
# Develop
|
||||
|
||||
## 1. Code Style
|
||||
We adopt [PEP8](https://www.python.org/dev/peps/pep-0008/) as the preferred code style.
|
||||
|
||||
We use the following toolsseed isortseed isortseed isort for linting and formatting:
|
||||
- [flake8](http://flake8.pycqa.org/en/latest/): linter
|
||||
- [yapf](https://github.com/google/yapf): formatter
|
||||
- [isort](https://github.com/timothycrosley/isort): sort imports
|
||||
|
||||
Style configurations of yapf and isort can be found in [setup.cfg](../../setup.cfg).
|
||||
We use [pre-commit hook](https://pre-commit.com/) that checks and formats for `flake8`, `yapf`, `seed-isort-config`, `isort`, `trailing whitespaces`,
|
||||
fixes `end-of-files`, sorts `requirments.txt` automatically on every commit.
|
||||
The config for a pre-commit hook is stored in [.pre-commit-config](../../.pre-commit-config.yaml).
|
||||
After you clone the repository, you will need to install initialize pre-commit hook.
|
||||
```bash
|
||||
pip install -r requirements/tests.txt
|
||||
```
|
||||
From the repository folder
|
||||
```bash
|
||||
pre-commit install
|
||||
```
|
||||
|
||||
After this on every commit check code linters and formatter will be enforced.
|
||||
|
||||
If you want to use pre-commit to check all the files, you can run
|
||||
```bash
|
||||
pre-commit run --all-files
|
||||
```
|
||||
|
||||
If you only want to format and lint your code, you can run
|
||||
```bash
|
||||
make linter
|
||||
```
|
||||
|
||||
## 2. Test
|
||||
### 2.1 Unit test
|
||||
```bash
|
||||
make test
|
||||
```
|
||||
|
||||
### 2.2 Test data
|
||||
TODO
|
||||
|
||||
## 3. Build pip package
|
||||
```bash
|
||||
make whl
|
||||
```
|
||||
Reference in New Issue
Block a user