Skip to content

Commit fade807

Browse files
committed
Last README.development.md fixes.
1 parent a5444a9 commit fade807

File tree

1 file changed

+13
-15
lines changed

1 file changed

+13
-15
lines changed

README.development.md

+13-15
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ choco install vscode -y
3535

3636
Clone this repository into a local folder on your computer and, from the root folder, run
3737

38-
```
38+
```powershell
3939
python -m venv .venv
4040
.venv/Scripts/activate
4141
pip install .[dev]
@@ -59,7 +59,7 @@ To activate the virtual environment on a command prompt instance (cmd or powersh
5959

6060
Clone this repository into a local folder on your computer and, from the root folder, run
6161

62-
```
62+
```bash
6363
python3 -m venv .venv
6464
. .venv/bin/activate
6565
pip install .[dev]
@@ -75,7 +75,9 @@ To activate the virtual environment use:
7575
```
7676

7777

78-
# Prepare the test infrastructure
78+
# Tests
79+
80+
## Preparing the tests infrastructure
7981

8082
With the virtual environment activated, run the following script
8183

@@ -92,17 +94,21 @@ This script will
9294
You may run this script whenever you need a clean database for your tests. It won't download the files again if they already exist.
9395

9496

95-
9697
## Running the tests
9798

9899
Run the following Powershell script
99100

100-
```
101+
```powershell
101102
.\run-all-tests.ps1
102103
```
103104

104105
This will start 5 different processes, each one running a different combination of driver/Firebird version supported.
105106

107+
To run only the tests for a specific database, use
108+
109+
```powershell
110+
.\run-tests.ps1 -Database 'firebird_fb50'
111+
```
106112

107113

108114
## Debugging the tests
@@ -120,21 +126,13 @@ E.g. to run the test `test_get_table_names` with `firebird-driver` and Firebird
120126
Now run the code (with `F5`) and the debugger should work as expected (e.g. set a breakpoint and it should stop).
121127

122128

123-
124129
## Debugging SQLAlchemy code
125130

126131
Sooner or later you probably will need to debug SQLAlchemy code. Fortunately, this is easy as
127132

128-
```powershell
129-
$sqlAlchemyFolder = '/temp/sqlalchemy' # Replace with your desired location for SQLAlchemy repository
130-
131-
# Clone SQLAlchemy repository
132-
git clone https://github.com/sqlalchemy/sqlalchemy.git $sqlAlchemyFolder
133-
133+
```bash
134134
# [From your 'sqlalchemy-firebird' root folder, inside virtual environment]
135-
pip install -e $sqlAlchemyFolder
135+
pip install -e $path_to_your_sqlalchemy_local_folder
136136
```
137137

138138
The `launch.json` file already has the required `"justMyCode": false` configuration which allows you to step into SQLAlchemy source files during debugging.
139-
140-

0 commit comments

Comments
 (0)