Skip to content

Commit 9cae82b

Browse files
authored
Merge pull request #59 from ydb-platform/remove-experimental-client
add build.md
2 parents 63dab41 + c8eee41 commit 9cae82b

File tree

1 file changed

+47
-0
lines changed

1 file changed

+47
-0
lines changed

BUILD.md

+47
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
## How to build and test ydb-python-sdk
2+
3+
This document has detailed instructions on how to build ydb-python-sdk from source and run style and unit tests.
4+
5+
### Pre-requisites
6+
7+
- Install [Docker](https://docs.docker.com/engine/install/).
8+
- Install [Python 3.8](https://www.python.org/downloads/release/python-38/)
9+
- Install [pip](https://pip.pypa.io/en/latest/installation/)
10+
- Install [Tox](https://tox.wiki/en/latest/install.html)
11+
12+
### Clone the repository
13+
14+
```sh
15+
git clone https://github.com/ydb-platform/ydb-python-sdk
16+
```
17+
18+
### Run style tests
19+
20+
Use the command below to prepare `virtualenv` and to run style tests using `flake8`.
21+
22+
```sh
23+
tox -estyle
24+
```
25+
26+
### Run formatting checks
27+
28+
Use the command below to prepare `virtualenv` and to run style tests using `black`.
29+
See [documentation](https://black.readthedocs.io/en/stable/) about Black project.
30+
31+
```sh
32+
tox -eblack
33+
```
34+
35+
To automatically format code using the `black` formatting style, use the command below.
36+
37+
```sh
38+
tox -eblack-format
39+
```
40+
41+
### Run unit tests
42+
43+
Use the command below to run unit tests.
44+
45+
```sh
46+
tox -epy310
47+
```

0 commit comments

Comments
 (0)