Refresh the development enviroment

When using Python 3.9, setting up the development environment croaked.
Because "bootstrap.py" was a workaround in pre-pip times, this patch
completely gets rid of it.

At the same time, it modernizes some more dependency definitions and
improves the developer guide.

Author: amotl

.github/workflows/main.yml

@@ -23,6 +23,7 @@ jobs:
         os: [ubuntu-latest]
         sqla-version: ['1.1.18', '1.2.19', '1.3.23']
         python-version: [3.5, 3.6, 3.7, 3.8, 3.9]
+      fail-fast: false
 
     steps:
       - uses: actions/checkout@master
@@ -34,7 +35,11 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          python bootstrap.py
+
+          # Workaround needed for Python 3.5
+          python -m pip install --upgrade "setuptools>=31,<51"
+
+          pip install zc.buildout==2.13.4
 
           # replace SQLAlchemy version
           sed -ir 's/SQLAlchemy.*/SQLAlchemy = ${{ matrix.sqla-version }}/g' versions.cfg
@@ -48,7 +53,7 @@ jobs:
             sed -ir 's/crate_server.*/crate_server = ${{ matrix.crate-version }}/g' versions.cfg
           fi
 
-          bin/buildout -n -c base.cfg
+          buildout -n -c base.cfg
 
       - name: Test
         run: |

.gitignore

@@ -1,4 +1,5 @@
-.coverage/
+.venv*
+.coverage
 .idea/
 .installed.cfg
 .tox/

DEVELOP.rst

@@ -1,46 +1,57 @@
 ===============
-Developer Guide
+Developer guide
 ===============
 
 Setup
 =====
 
 This project uses buildout_ to set up the development environment.
 
-To start things off, run::
+To start things off, create a Python virtualenv and install buildout::
 
-    $ python bootstrap.py
+    python3 -m venv .venv
+    source .venv/bin/activate
+
+    # Workaround for Python 3.9
+    python -m pip install --upgrade "setuptools>=31,<51"
+
+    pip install zc.buildout==2.13.4
 
 Then, run::
 
-    $ ./bin/buildout -N
+    buildout -N
 
-Running Tests
+Running tests
 =============
 
-The tests are run using the zope.testrunner_::
+All tests will be invoked using the Python interpreter that was used when
+creating the Python virtualenv. The test runner is zope.testrunner_.
+
+Run all tests::
+
+    ./bin/test
 
-    $ ./bin/test
+Run specific tests::
 
-This will run all tests using the Python interpreter that was used to
-bootstrap buildout.
+    # Ignore all tests below src/crate/testing
+    ./bin/test -vvvv --ignore_dir=testing
 
 You can run the tests against multiple Python interpreters with tox_::
 
-    $ ./bin/tox
+    ./bin/tox
 
-To do this, you will need ``python2.7``, ``python3.3``, and ``pypy`` on your
-``$PATH``.
+To do this, you will need the respective Python interpreter versions available
+on your ``$PATH``.
 
-To run against a single interpreter, you can also do::
+To run against a single interpreter, you can also invoke::
 
-    $ ./bin/tox -e py33
+    ./bin/tox -e py37
 
-*Note*: before running tests make sure to stop all CrateDB instances which
-listening on the default CrateDB transport port to avoid side effects with the
-test layer.
+*Note*: before running the tests, make sure to stop all CrateDB instances which
+are listening on the default CrateDB transport port to avoid side effects with
+the test layer.
 
-Preparing a Release
+Preparing a release
 ===================
 
 To create a new release, you must:
@@ -70,7 +81,7 @@ Next:
 
 - Archive docs for old releases (see section below)
 
-Archiving Docs Versions
+Archiving docs versions
 -----------------------
 
 Check the `versions hosted on ReadTheDocs`_.
@@ -81,7 +92,7 @@ patch versions for the last two minor releases.
 To make changes to the RTD configuration (e.g., to activate or deactivate a
 release version), please contact the `@crate/docs`_ team.
 
-Writing Documentation
+Writing documentation
 =====================
 
 The docs live under the ``docs`` directory.
@@ -90,7 +101,7 @@ The docs are written written with ReStructuredText_ and processed with Sphinx_.
 
 Build the docs by running::
 
-    $ bin/sphinx
+    ./bin/sphinx
 
 The output can then be found in the ``out/html`` directory.
 

LICENSE

@@ -203,61 +203,6 @@
    limitations under the License.
 
 
-===============================================================================
-
-For the `bootstrap.py` file:
-
-Buildout <http://www.buildout.org/>
-
-Copyright (c) 2006 Zope Foundation and Contributors.
-All Rights Reserved.
-
-Zope Public License (ZPL) Version 2.1
-
-A copyright notice accompanies this license document that identifies the
-copyright holders.
-
-This license has been certified as open source. It has also been designated as
-GPL compatible by the Free Software Foundation (FSF).
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
-
-1. Redistributions in source code must retain the accompanying copyright
-notice, this list of conditions, and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the accompanying copyright
-notice, this list of conditions, and the following disclaimer in the
-documentation and/or other materials provided with the distribution.
-
-3. Names of the copyright holders must not be used to endorse or promote
-products derived from this software without prior written permission from the
-copyright holders.
-
-4. The right to distribute this software or to use it for any purpose does not
-give you the right to use Servicemarks (sm) or Trademarks (tm) of the
-copyright
-holders. Use of them is covered by separate agreement with the copyright
-holders.
-
-5. If any files are modified, you must cause the modified files to carry
-prominent notices stating that you changed the files and the date of any
-change.
-
-Disclaimer
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ``AS IS'' AND ANY EXPRESSED
-OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
-OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
-EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY DIRECT, INDIRECT,
-INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
-PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
-NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
-EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
-
 ===============================================================================
 
 For the `docs` directory:

base.cfg

@@ -25,7 +25,7 @@ url = https://cdn.crate.io/downloads/releases/crate-${versions:crate_server}.tar
 strip-top-level-dir = true
 
 [test]
-relative-paths=true
+relative-paths = true
 recipe = zc.recipe.testrunner
 defaults = ['--auto-color']
 eggs = crate [test,sqlalchemy]