Upstream master changes to Test-Automation branch

.github/ISSUE_TEMPLATE/blank.md

@@ -0,0 +1,8 @@
+---
+name: 📝 Blank Issue 
+about: Blank Issue
+title: 📝 <Insert Title>
+labels: 
+assignees: ''
+
+---

.github/ISSUE_TEMPLATE/bug.md

@@ -0,0 +1,77 @@
+---
+name: 🐞 Bug Report
+about: File a bug report
+title: 🐞 <Insert Title>
+labels: bug
+assignees: ''
+
+---
+
+### Checklist
+In order to improve the time, how long a bugfix does take, please make sure you address as much as possible of the following checklist.
+
+- [ ] I have reproduced the issue with at least the latest released version of \<PROJECT-NAME\>.
+- [ ] I have added references to issues that sound similar in section _Related Issues_.
+
+**Tip: Adding screenshots, outputs and logs might help to improve clarity.**
+
+# Summary
+<!---
+Describe the bug: A clear and concise description of what the bug is.
+-->
+
+## Reproducing the Issue
+Reproducibility: <pick one of> sporadic, regularly, always
+<!---
+Describe how to reproduce the bug, e.g.:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+-->
+### Steps to reproduce the behavior:
+1. <step 1>
+2. <step 2>
+3. ....
+
+## Expected Behaviour
+<!---
+Describe the expected behaviour: A clear and concise description of what you expected to happen.
+-->
+
+## Actual Behaviour
+<!---
+Describe the actual observed behaviour: A clear and concise description of what actually happened.
+Screenshot: If applicable, add screenshots to help explaining your problem.
+-->
+
+## Root Cause (optional)
+<!---
+If known
+-->
+
+
+## Context
+<!---
+Describe the actual observed behaviour: A clear and concise description of what you observed.
+Screenshot: If applicable, add screenshots to help explaining your problem.
+-->
+
+### System
+<!---
+Describe the system and the used configuration.
+-->
+**Desktop:**
+ - OS: [e.g. Linux (Fedora 35), Linux (Ubuntu 20.01), MacOs (...), Windows (...)]
+ - Python Version [e.g. Python 3.8.0]
+ - Package Version [e.g. 22]
+
+### Additional Context (optional)
+<!---
+Add any additional context about the problem here.
+-->
+
+#### Related Issues (optional)
+<!---
+Link related issues form the issue tracker here.
+-->

.github/ISSUE_TEMPLATE/documentation.md

@@ -0,0 +1,41 @@
+---
+name: 📚 Documentation
+about: Add/Improve Documentation
+title: 📚 <Insert Title>
+labels: documentation
+assignees: ''
+
+---
+
+# Summary
+<!---
+A short summary on what of what needs to be documented or updated.
+--->
+
+# Details
+<!---
+A detailed description about what kind of documentation should be added and/or updated.
+--->
+
+## Background & Context
+<!---
+Why should this documentation be added/updated?
+
+E.g.: Users are struggling to use this API and have repeatedly asked for some example code.
+--->
+
+## References
+<!---
+Further references to e.g. other information resources like links to specification(s), api docs etc.
+--->
+
+# Task(s)
+<!---
+A task list containing common tasks associated with this kind of issue, but also tasks specific to this issue.
+
+e.g.:
+- [ ] Update documentation of XYZ
+- [ ] Bump version number
+- [ ] Update changelog
+- [ ] ...
+--->

.github/ISSUE_TEMPLATE/feature.md

@@ -0,0 +1,47 @@
+---
+name: ✨ Feature
+about: Add/Implement Feature
+title: ✨ <Insert Title>
+labels: feature
+assignees: ''
+
+---
+
+# Summary
+<!---
+A short description of the feature (TL;DR)
+--->
+
+# Details
+<!---
+A detailed description about what should be added, background, links, context information
+and usage example(s) of the feature.
+--->
+
+## Background & Context
+<!---
+What is the motivation for the feature?
+Assessment of the feature. Pros & cons, solutions and decisions concerning the feature (reasoning).
+--->
+
+## Examples
+<!---
+Example usage(s) of the feature.
+--->
+
+## References
+<!---
+Further references to e.g. other information resources like links to specification(s) etc.
+--->
+
+# Task(s)
+<!---
+A task list containing common tasks associated with this kind of issue, but also tasks specific to this issue.
+
+e.g.:
+- [ ] Add feature XYZ
+- [ ] Bump version number
+- [ ] Update documentation
+- [ ] Update changelog
+- [ ] ...
+--->

.github/ISSUE_TEMPLATE/refactoring.md

@@ -0,0 +1,47 @@
+---
+name: 🔧 Refactoring
+about: Refactor
+title: 🔧 <Insert Title>
+labels: refactoring
+assignees: ''
+
+---
+
+# Summary
+<!---
+A short description of the planed refactoring (TL;DR)
+--->
+
+# Details
+<!---
+A detailed description about what and how it should be refactored, background, links, context information
+and example(s) of how "the refactoring should look".
+--->
+
+## Background & Context
+<!---
+What is the motivation for the refactoring?
+Assessment of the refactoring. Pros & cons, solutions and decisions concerning (reasoning) the refactoring.
+--->
+
+## Examples
+<!---
+Examples of how "the refactoring should look".
+--->
+
+## References
+<!---
+Further references to e.g. other information resources like links to specification(s) etc.
+--->
+
+# Task(s)
+<!---
+A task list containing common tasks associated with this kind of issue, but also tasks specific to this issue.
+
+e.g.:
+- [ ] Implement/Refactor XYZ
+- [ ] Add tests for XYZ
+- [ ] Bump version number
+- [ ] Update changelog
+- [ ] ...
+--->

.github/ISSUE_TEMPLATE/security.md

@@ -0,0 +1,58 @@
+---
+name: 🔐 Security Issue
+about: Fix Security Issue
+title: 🔐 <Insert Title>
+labels: security
+assignees: ''
+
+---
+
+# Summary
+<!---
+A short summary of the security issue.
+--->
+
+|            |     |
+|------------|-----|
+| Class/Type | -   |
+| Version(s) | -   |
+| Severity   | -   |
+| CVE Number | -   |
+
+<!---
+A quick table based overview, containing the most important details.
+
+Class/Type: Of vulnerability, e.g. xss, buffer-overflow, ... (see https://cwe.mitre.org/
+Versions: Affected software versions
+Severity: Of the vulnerability (Low, Medium, High, Critical)
+CVE Number: number and link to the cve if available
+-->
+
+
+# Details
+
+### Description
+<!---
+If no detailed information is available through references or CVE, an extensive
+description of the vulnerability should be added here.
+--->
+
+### Impact
+<!---
+Describe the impact of the vulnerability.
+--->
+
+### References
+<!---
+Links to related issues or other sources like link to CVE.
+--->
+
+# Solutions
+<!--
+Describe possible solution(s), how to address this issue.
+--->
+
+# Credit
+<!--
+Whom to thank, kudos for the reporter(s)
+-->

docs/KNOWN_ISSUES.md

@@ -0,0 +1,25 @@
+# Known Issues
+
+
+## `ssl.SSLError: Underlying socket connection gone (_ssl.c:...)`
+
+This error can occur in rare cases, for additional details see [GH-Issue #108](https://github.com/exasol/pyexasol/issues/108)
+and `pyexasol.connection.ExaConnection:__del__`. 
+The root cause of this issue usually stems from a connection not being properly closed before program exit (interpreter shutdown).
+
+
+Example Output:
+```python
+Exception ignored in: <function ConnectionWrapper.__del__ at 0x7fa7c9799990>
+Traceback (most recent call last):
+  File ".../test_case.py", line 14, in __del__
+  File ".../lib/python3.10/site-packages/pyexasol/connection.py", line 456, in close
+  File ".../lib/python3.10/site-packages/pyexasol/connection.py", line 524, in req
+  File ".../lib/python3.10/site-packages/websocket/_core.py", line 285, in send
+  File ".../lib/python3.10/site-packages/websocket/_core.py", line 313, in send_frame
+  File ".../lib/python3.10/site-packages/websocket/_core.py", line 527, in _send
+  File ".../lib/python3.10/site-packages/websocket/_socket.py", line 172, in send
+  File ".../lib/python3.10/site-packages/websocket/_socket.py", line 149, in _send
+  File "/usr/lib/python3.10/ssl.py", line 1206, in send
+ssl.SSLError: Underlying socket connection gone (_ssl.c:2326)`
+```

docs/REFERENCE.md

@@ -567,7 +567,7 @@ Return `True` if view exists, `False` otherwise. If schema name was not specifie
 
 ### list_schemas()
 
-Return list of schemas from [EXA_SCHEMAS](https://docs.exasol.com/sql_references/metadata/metadata_system_tables.htm#EXA_SCHEMAS) system view matching LIKE-pattern.
+Return list of schemas from [EXA_SCHEMAS](https://docs.exasol.com/db/latest/sql_references/system_tables/metadata/exa_schemas.htm) system view matching LIKE-pattern.
 
 | Argument | Example | Description |
 | --- | --- | --- |
@@ -577,7 +577,7 @@ Patterns are case-sensitive. You may escape LIKE-patterns using [.format.escape_
 
 ### list_tables()
 
-Return list of tables from [EXA_ALL_TABLES](https://docs.exasol.com/sql_references/metadata/metadata_system_tables.htm#EXA_ALL_TABLES) system view matching LIKE-pattern.
+Return list of tables from [EXA_ALL_TABLES](https://docs.exasol.com/db/latest/sql_references/system_tables/metadata/exa_all_tables.htm) system view matching LIKE-pattern.
 
 | Argument | Example | Description |
 | --- | --- | --- |
@@ -588,7 +588,7 @@ Patterns are case-sensitive. You may escape LIKE-patterns using [.format.escape_
 
 ### list_views()
 
-Return list of views from [EXA_ALL_VIEWS](https://docs.exasol.com/sql_references/metadata/metadata_system_tables.htm#EXA_ALL_VIEWS) system view matching LIKE-pattern.
+Return list of views from [EXA_ALL_VIEWS](https://docs.exasol.com/db/latest/sql_references/system_tables/metadata/exa_all_views.htm) system view matching LIKE-pattern.
 
 | Argument | Example | Description |
 | --- | --- | --- |
@@ -599,7 +599,7 @@ Patterns are case-sensitive. You may escape LIKE-patterns using [.format.escape_
 
 ### list_columns()
 
-Return list of columns from [EXA_ALL_COLUMNS](https://docs.exasol.com/sql_references/metadata/metadata_system_tables.htm#EXA_ALL_COLUMNS) system view matching LIKE-pattern.
+Return list of columns from [EXA_ALL_COLUMNS](https://docs.exasol.com/db/latest/sql_references/system_tables/metadata/exa_all_columns.htm) system view matching LIKE-pattern.
 
 | Argument | Example | Description |
 | --- | --- | --- |
@@ -612,7 +612,7 @@ Patterns are case-sensitive. You may escape LIKE-patterns using [.format.escape_
 
 ### list_objects()
 
-Return list of objects from [EXA_ALL_OBJECTS](https://docs.exasol.com/sql_references/metadata/metadata_system_tables.htm#EXA_ALL_OBJECTS) system view matching LIKE-pattern.
+Return list of objects from [EXA_ALL_OBJECTS](https://docs.exasol.com/db/latest/sql_references/system_tables/metadata/exa_all_objects.htm) system view matching LIKE-pattern.
 
 | Argument | Example | Description |
 | --- | --- | --- |
@@ -625,7 +625,7 @@ Patterns are case-sensitive. You may escape LIKE-patterns using [.format.escape_
 
 ### list_object_sizes()
 
-Return list of objects with sizes from [EXA_ALL_OBJECT_SIZES](https://docs.exasol.com/sql_references/metadata/metadata_system_tables.htm#EXA_ALL_OBJECT_SIZES) system view matching LIKE-pattern.
+Return list of objects with sizes from [EXA_ALL_OBJECT_SIZES](https://docs.exasol.com/db/latest/sql_references/system_tables/metadata/exa_all_object_sizes.htm) system view matching LIKE-pattern.
 
 Please note: object sizes do not include indices and statistics!
 
@@ -640,7 +640,7 @@ Patterns are case-sensitive. You may escape LIKE-patterns using [.format.escape_
 
 ### list_indices()
 
-Return list of indices with sizes from [EXA_ALL_INDICES](https://docs.exasol.com/sql_references/metadata/metadata_system_tables.htm#EXA_ALL_INDICES) system view matching LIKE-pattern.
+Return list of indices with sizes from [EXA_ALL_INDICES](https://docs.exasol.com/db/latest/sql_references/system_tables/metadata/exa_all_indices.htm) system view matching LIKE-pattern.
 
 | Argument | Example | Description |
 | --- | --- | --- |
@@ -652,7 +652,7 @@ Patterns are case-sensitive. You may escape LIKE-patterns using [.format.escape_
 
 ### list_sql_keywords()
 
-Return list of SQL keywords from [EXA_SQL_KEYWORDS](https://docs.exasol.com/sql_references/metadata/metadata_system_tables.htm#EXA_SQL_KEYWORDS) system view.
+Return list of SQL keywords from [EXA_SQL_KEYWORDS](https://docs.exasol.com/db/latest/sql_references/system_tables/metadata/exa_sql_keywords.htm) system view.
 
 These keywords cannot be used as identifiers without double quotes.
 
@@ -775,4 +775,4 @@ Import chunk of data using callback function. You may use exactly the same callb
 | `src` | `anything` | (optional) Import source for callback function |
 | `callback_params` | `{'a': 'b'}` | (optional) Dict with additional parameters for callback function |
 
-Return result of callback function
+Return result of callback function