Recent changes to Environments

WikiPage Environments modified by Bartek Wilczek

Bartek Wilczek — Sun, 29 Jan 2012 17:04:02 -0000

--- v2 
+++ v3 
@@ -37,7 +37,9 @@
     [ru_prod]
     start_url = "https://ru.site.com"
 
-
+### glob matching in CSV files
+
+
 In order to avoid creating multiple CSV file lines with same parameters, but differing only by \_\_ column the following glob expressions are supported:
 
 \_\_env | param_a | param_b
@@ -45,20 +47,45 @@
 pl_* | AAA | BBB
 de_* | DDD | EEE
 
 Table above is equivalent to:
 
 \_\_env | param_a | param_b
 --------|---------|--------
 pl_int | AAA | BBB
 pl_staging | AAA | BBB
 pl_prod | AAA | BBB
 de_int | DDD | EEE
 de_staging | DDD | EEE
 de_prod | DDD | EEE
 
+### glob matching in -e switch
+
 When executing tests however globs are not supported, and a full list of all environments that test should be ran on has to be provided:
 
     bubik -gregression -rconsole,db -ede_int,pl_int,ru_int
     # the line below won't work
     bubik -gregression -rconsole,db -e*.int
+
+### empty \_\_env column
+
+Let's consider a CSV file with few rows that have \_\_env column set to valid environment (const ini file section) and some with this column left empty:
+
+\_\_env | param_a | param_b
+--------|---------|--------
+pl_* | AAA | BBB
+de_* | DDD | EEE
+ | XXX | YYY
+
+With such CSV file the third row will be executed always, no matter what values will be passed to -e switch in bubik command. In such case const values for const() function calls in test body will be taken from 'common' section. Let's consider some examples:
+
+    bubik -tMyTest -rconsole
+    # with no -e switch all rows from CSV are executed
+    
+    bubik -tMyTest -rconsole -epl_prod
+    # first line from CSV will be used for environment pl_prod
+    # third line will be executed as well, [common] section used
+
+    bubik -tMyTest -rconsole -epl_prod,pl_int
+    # first line from CSV will be used twice for environments pl_prod and pl_int
+    # third line will be executed as well, [common] section used

WikiPage Environments modified by Bartek Wilczek

Bartek Wilczek — Sun, 29 Jan 2012 16:51:19 -0000

--- v1 
+++ v2 
@@ -4,3 +4,61 @@
 1. CSV files with test parameters
 1. execution command switch -e
 
+For complex projects with multiple environments and internationalization const.ini file may quickly grow to structure similar to this:
+
+    [common]
+    webdriver.reset_on = "exec"
+    reporter_db.dsn = "mysql://bubik:bubik@localhost/bubik"
+
+    [pl_int]
+    start_url = "http://pl.int.buildmachine.local"
+
+    [pl_staging]
+    start_url = "https://pl.stagingmachine.local"
+
+    [pl_prod]
+    start_url = "https://pl.site.com"
+
+    [de_int]
+    start_url = "http://de.int.buildmachine.local"
+
+    [de_staging]
+    start_url = "https://de.stagingmachine.local"
+
+    [de_prod]
+    start_url = "https://de.site.com"
+
+    [ru_int]
+    start_url = "http://ru.int.buildmachine.local"
+
+    [ru_staging]
+    start_url = "https://ru.stagingmachine.local"
+
+    [ru_prod]
+    start_url = "https://ru.site.com"
+
+
+In order to avoid creating multiple CSV file lines with same parameters, but differing only by \_\_ column the following glob expressions are supported:
+
+\_\_env | param_a | param_b
+--------|---------|--------
+pl_* | AAA | BBB
+de_* | DDD | EEE
+
+Table above is equivalent to:
+
+\_\_env | param_a | param_b
+--------|---------|--------
+pl_int | AAA | BBB
+pl_staging | AAA | BBB
+pl_prod | AAA | BBB
+de_int | DDD | EEE
+de_staging | DDD | EEE
+de_prod | DDD | EEE
+
+When executing tests however globs are not supported, and a full list of all environments that test should be ran on has to be provided:
+
+    bubik -gregression -rconsole,db -ede_int,pl_int,ru_int
+    # the line below won't work
+    bubik -gregression -rconsole,db -e*.int
+

WikiPage Environments modified by Bartek Wilczek

Bartek Wilczek — Sun, 29 Jan 2012 15:14:20 -0000

The concept of environments touches three areas of bubik: 1. const ini files 1. CSV files with test parameters 1. execution command switch -e