MRG: Merge pull request #595 from octue/remove-special-treatment-of-latest-tag

Remove special treatment of `latest` revision tag

Author: cortadocodes

.pre-commit-config.yaml

@@ -62,19 +62,7 @@ repos:
       - id: check-branch-name
         args:
           - "^main$"
-          - "^development$"
-          - "^devops/([a-z][a-z0-9]*)(-[a-z0-9]+)*$"
-          - "^doc/([a-z][a-z0-9]*)(-[a-z0-9]+)*$"
-          - "^feature/([a-z][a-z0-9]*)(-[a-z0-9]+)*$"
-          - "^enhancement/([a-z][a-z0-9]*)(-[a-z0-9]+)*$"
-          - "^fix/([a-z][a-z0-9]*)(-[a-z0-9]+)*$"
-          - "^hotfix/([a-z][a-z0-9]*)(-[a-z0-9]+)*$"
-          - "^review/([a-z][a-z0-9]*)(-[a-z0-9]+)*$"
-          - "^refactor/([a-z][a-z0-9]*)(-[a-z0-9]+)*$"
-          - "^test/([a-z][a-z0-9]*)(-[a-z0-9]+)*$"
-          - "^style/([a-z][a-z0-9]*)(-[a-z0-9]+)*$"
-          - "^deprecation/([a-z][a-z0-9]*)(-[a-z0-9]+)*$"
-          - "^dependencies/([a-z][a-z0-9]*)(-[a-z0-9]+)*$"
+          - "^([a-z][a-z0-9]*)(-[a-z0-9]+)*$"
 
   - repo: https://github.com/octue/conventional-commits
     rev: 0.9.0

docs/source/asking_questions.rst

@@ -15,7 +15,7 @@ and/or an input manifest.
     from octue.resources import Child
 
     child = Child(
-        id="my-organisation/my-service:latest",
+        id="my-organisation/my-service:2.1.7",
         backend={"name": "GCPPubSubBackend", "project_name": "my-project"},
     )
 
@@ -31,15 +31,15 @@ and/or an input manifest.
     >>> <FilterSet({<Datafile('my_file.csv')>, <Datafile('another_file.csv')>})>
 
 
-.. _using_latest_revision_tag:
+.. _using_default_revision_tag:
 
 .. note::
 
-    Using the ``latest`` service revision tag, or not including one at all, will cause your question to be sent to the
-    latest deployed revision of the service. This is determined by making a request to a `service registry
-    <https://django-twined.readthedocs.io/en/latest/>`_ if one or more :ref:`registries are defined
-    <using_service_registries>`. If none of the service registries contain an entry for this service, a specific service
-    revision tag must be used.
+    Not including a service revision tag will cause your question to be sent to the default revision of the service
+    (usually the latest deployed version). This is determined by making a request to a `service registry
+    <https://django-twined.readthedocs.io/en/latest/>`_ if one or more
+    :ref:`registries are defined <using_service_registries>`. If none of the service registries contain an entry for
+    this service, a specific service revision tag must be used.
 
 You can also set the following options when you call :mod:`Child.ask <octue.resources.child.Child.ask>`:
 
@@ -100,15 +100,15 @@ if your app configuration file is:
       "children": [
         {
           "key": "wind_speed",
-          "id": "template-child-services/wind-speed-service:latest",
+          "id": "template-child-services/wind-speed-service:2.1.1",
           "backend": {
             "name": "GCPPubSubBackend",
             "project_name": "my-project"
           }
         },
         {
           "key": "elevation",
-          "id": "template-child-services/elevation-service:latest",
+          "id": "template-child-services/elevation-service:3.1.9",
           "backend": {
             "name": "GCPPubSubBackend",
             "project_name": "my-project"
@@ -161,15 +161,15 @@ For example, if the child requires these children in its app configuration:
     [
         {
             "key": "wind_speed",
-            "id": "template-child-services/wind-speed-service:latest",
+            "id": "template-child-services/wind-speed-service:2.1.1",
             "backend": {
                 "name": "GCPPubSubBackend",
                 "project_name": "octue-sdk-python"
             },
         },
         {
             "key": "elevation",
-            "id": "template-child-services/elevation-service:latest",
+            "id": "template-child-services/elevation-service:3.1.9",
             "backend": {
                 "name": "GCPPubSubBackend",
                 "project_name": "octue-sdk-python"
@@ -186,15 +186,15 @@ then you can override them like this:
         children=[
             {
                 "key": "wind_speed",
-                "id": "my/own-service:latest",
+                "id": "my/own-service:1.0.0",
                 "backend": {
                     "name": "GCPPubSubBackend",
                     "project_name": "octue-sdk-python"
                 },
             },
             {
                 "key": "elevation",
-                "id": "organisation/another-service:latest",
+                "id": "organisation/another-service:0.1.0",
                 "backend": {
                     "name": "GCPPubSubBackend",
                     "project_name": "octue-sdk-python"
@@ -244,7 +244,7 @@ You can specify service registries in two ways:
     .. code-block:: python
 
         child = Child(
-            id="my-organisation/my-service:latest",
+            id="my-organisation/my-service:1.1.0",
             backend={"name": "GCPPubSubBackend", "project_name": "my-project"},
             service_registries=[
                 {"name": "my-registry", "endpoint": "blah.com/services"},