@@ -35,7 +35,7 @@ choco install vscode -y
35
35
36
36
Clone this repository into a local folder on your computer and, from the root folder, run
37
37
38
- ```
38
+ ``` powershell
39
39
python -m venv .venv
40
40
.venv/Scripts/activate
41
41
pip install .[dev]
@@ -59,7 +59,7 @@ To activate the virtual environment on a command prompt instance (cmd or powersh
59
59
60
60
Clone this repository into a local folder on your computer and, from the root folder, run
61
61
62
- ```
62
+ ``` bash
63
63
python3 -m venv .venv
64
64
. .venv/bin/activate
65
65
pip install .[dev]
@@ -75,7 +75,9 @@ To activate the virtual environment use:
75
75
```
76
76
77
77
78
- # Prepare the test infrastructure
78
+ # Tests
79
+
80
+ ## Preparing the tests infrastructure
79
81
80
82
With the virtual environment activated, run the following script
81
83
@@ -92,17 +94,21 @@ This script will
92
94
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.
93
95
94
96
95
-
96
97
## Running the tests
97
98
98
99
Run the following Powershell script
99
100
100
- ```
101
+ ``` powershell
101
102
.\run-all-tests.ps1
102
103
```
103
104
104
105
This will start 5 different processes, each one running a different combination of driver/Firebird version supported.
105
106
107
+ To run only the tests for a specific database, use
108
+
109
+ ``` powershell
110
+ .\run-tests.ps1 -Database 'firebird_fb50'
111
+ ```
106
112
107
113
108
114
## Debugging the tests
@@ -120,21 +126,13 @@ E.g. to run the test `test_get_table_names` with `firebird-driver` and Firebird
120
126
Now run the code (with ` F5 ` ) and the debugger should work as expected (e.g. set a breakpoint and it should stop).
121
127
122
128
123
-
124
129
## Debugging SQLAlchemy code
125
130
126
131
Sooner or later you probably will need to debug SQLAlchemy code. Fortunately, this is easy as
127
132
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
134
134
# [From your 'sqlalchemy-firebird' root folder, inside virtual environment]
135
- pip install -e $sqlAlchemyFolder
135
+ pip install -e $path_to_your_sqlalchemy_local_folder
136
136
```
137
137
138
138
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