removes cursor lock

Author: David Erb

.dae-devops/docs/developing.rst

@@ -9,11 +9,12 @@ If you plan to make change to the code in this repository, you can use the steps
 
 Clone the repository::
 
+    $ cd <your development area>
     $ git clone https://gitlab.diamond.ac.uk/kbp43231/dls-normsql.git
 
 It is recommended that you install into a virtual environment so this
 installation will not interfere with any existing Python software.
-Make sure to have at least python version 3.9 then::
+Make sure to have at least python version 3.10 then::
 
     $ python3 -m venv /scratch/$USER/myvenv
     $ source /scratch/$USER/myvenv/bin/activate
@@ -22,17 +23,9 @@ Make sure to have at least python version 3.9 then::
 Install the package in edit mode which will also install all its dependencies::
 
     $ cd dls-normsql
-    $ pip install -e .[dev]
+    $ pip install -e .[dev,docs]
 
 Now you may begin modifying the code.
 
-|
 
-If you plan to modify the docs, you will need to::
-
-    $ pip install -e .[docs]
-
-    
-
-
-.. # dae_devops_fingerprint 7b83e003f8bbbf54c27b4bd8141fb0e5
+.. # dae_devops_fingerprint b23d73dd4de218c9524358cf343938e7

.dae-devops/docs/documenting.rst

@@ -0,0 +1,30 @@
+.. # ********** Please don't edit this file!
+.. # ********** It has been generated automatically by dae_devops version 0.5.3.
+.. # ********** For repository_name dls-normsql
+
+Documenting
+=======================================================================
+
+If you plan to make update the documentation in this repository, you can use the steps below.
+
+First, follow the steps in the Developing section to get a copy of the source code and install its dependencies.
+
+If you didn't do this already, make sure you have the documentation tools::
+
+    $ cd <your development area>/dls-normsql
+    $ pip install -e .[docs]
+
+To produce the documentation locally::
+
+    $ tox -q -e docs
+
+This writes the html into local directory build/html.  You can browse the local documentation by::
+
+    file:///<your development area>/dls-normsql/build/html/index.html
+
+When you push either the main branch or a tag to GitHub, the documents are built and published automatically to this url::
+
+    https://diamondlightsource.github.io/dls-normsql/main/index.html
+
+
+.. # dae_devops_fingerprint 2e96ce2e1701d5674aa92004b95cb6dd

.dae-devops/docs/installing.rst

@@ -6,11 +6,11 @@ Installing
 =======================================================================
 
 
-You will need python 3.9 or later. 
+You will need python 3.10 or later. 
 
-On a Diamond Light Source internal computer, you can achieve Python 3.9 by::
+On a Diamond Light Source internal computer, you can achieve Python 3.10 by::
 
-    $ module load python/3.9
+    $ module load python/3.10
 
 You can check your version of python by typing into a terminal::
 
@@ -24,19 +24,19 @@ installation will not interfere with any existing Python software::
     $ pip install --upgrade pip
 
 
-You can now use ``pip`` to install the library and its dependencies::
+You can now use ``pip`` to install the package and its dependencies::
 
     $ python3 -m pip install dls-normsql
 
-If you require a feature that is not currently released you can also install
+If you require a feature that is not currently released, you can also install
 from git::
 
     $ python3 -m pip install git+https://gitlab.diamond.ac.uk/kbp43231/dls-normsql.git
 
-The library should now be installed and the commandline should be available.
+The package should now be installed and the command line should be available.
 You can check the version that has been installed by typing::
 
     $ dls-normsql --version
     $ dls-normsql --version-json
 
-.. # dae_devops_fingerprint a2fe8dfbc79c151a5b899b244a529aa6
+.. # dae_devops_fingerprint d972d49fe32bcad19880f2817fed8fae

.dae-devops/docs/testing.rst

@@ -23,12 +23,12 @@ If you want to see more output of the test while it's running you can do::
 
 Each test will write files into its own directory::
 
-    /tmp/dls-normsql/tests/....
+    /tmp/dls-normsql/tests/*
 
 The tests clear their directory when they start, but not when they finish.
-This allows peeking in there to see what's been written by the test.
+This allows you to examine what's been written by the test.
 
 
 
 
-.. # dae_devops_fingerprint 1801aaf6bd998d192c9fb4cdd6c3e79f
+.. # dae_devops_fingerprint 69544ab25d1fea250e99af1cf0c84506

.github/workflows/code.yml

@@ -41,11 +41,6 @@ jobs:
         os: ["ubuntu-latest"] # can add windows-latest, macos-latest
         python: ["3.10"]
         install: ["-e .[dev,docs]"]
-        # Make one version be non-editable to test both paths of version code
-        include:
-          - os: "ubuntu-latest"
-            python: "3.9"
-            install: ".[dev,docs]"
 
     runs-on: ${{ matrix.os }}
     env:
@@ -216,4 +211,4 @@ jobs:
         with:
           password: ${{ secrets.PYPI_TOKEN }}
 
-# dae_devops_fingerprint d13e8289ca6252679ab7d9ae8db75617
+# dae_devops_fingerprint a23991a7d28e20d040902bf8d1aa4541

docs/conf.py

@@ -55,7 +55,7 @@
 
 # If true, Sphinx will warn about all references where the target cannot
 # be found.
-nitpicky = True
+nitpicky = False
 
 # A list of (type, target) tuples (by default empty) that should be ignored when
 # generating warnings in "nitpicky mode". Note that type should include the
@@ -188,7 +188,7 @@ def ultimateReplace(app, docname, source):
     "$" + "{repository_name}": "dls-normsql",
     "$" + "{package_name}": "dls_normsql",
     "$" + "{git_url}": "https://gitlab.diamond.ac.uk/kbp43231",
-    "$" + "{python_version_at_least}": "3.9",
+    "$" + "{python_version_at_least}": "3.10",
 }
 
 
@@ -197,4 +197,4 @@ def setup(app):
     app.connect("source-read", ultimateReplace)
 
 
-# dae_devops_fingerprint cd8b8b6c6077d960c9ed6af1579909b3
+# dae_devops_fingerprint 0afc2bceebf806891327ed822e2760a9

pyproject.toml

@@ -11,16 +11,14 @@ name = "dls-normsql"
 classifiers = [
     "Development Status :: 3 - Alpha",
     "License :: OSI Approved :: Apache Software License",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
 ]
 description = "Normalized API over various sql libraries."
 dependencies = ["dls-utilpack", "aiosqlite", "aiomysql", "cryptography"]
 dynamic = ["version"]
 license.file = "LICENSE"
-readme = "README.rst"
-requires-python = ">=3.9"
+readme = "README.md"
+requires-python = ">=3.10"
 
 [project.optional-dependencies]
 dev = [
@@ -102,4 +100,4 @@ source = ["src", "**/site-packages/"]
 [tool.tox]
 legacy_tox_ini = "[tox]\nskipsdist=True\n\n[testenv:{pre-commit,mypy,pytest,docs}]\n# Don't create a virtualenv for the command, requires tox-direct plugin\ndirect = True\npassenv = *\nallowlist_externals = \n    pytest \n    pre-commit\n    mypy\n    sphinx-build\n    sphinx-autobuild\ncommands =\n    pytest: pytest {posargs}\n    mypy: mypy src tests {posargs}\n    pre-commit: pre-commit run --all-files {posargs}\n    docs: sphinx-{posargs:build -EW --keep-going} -T docs build/html\n"
 
-# dae_devops_fingerprint ecc6232348dbe2bd0e46bde0c1961e3b
+# dae_devops_fingerprint df8767613c8b867ee1ddb91dd8b71fca