Load authenticator and MapAdapter types from config

Author: DiamondJoseph

docs/source/explanations/access-control.md

@@ -78,13 +78,12 @@ from tiled.scopes import PUBLIC_SCOPES
 response_cache = cachetools.TTLCache(maxsize=10_000, ttl=60)
 
 
-class PASSAccessPolicy:
+class PASSAccessPolicy(AccessPolicy):
     """
     access_control:
-      access_policy: pass_access_policy:PASSAccessPolicy
-      args:
-        url: ...
-        beamline: ...
+      type: pass_access_policy:PASSAccessPolicy
+      url: ...
+      beamline: ...
     """
 
     def __init__(self, url, beamline, provider):

docs/source/explanations/security.md

@@ -280,7 +280,7 @@ authenticators:
       cara: ${CARA_PASSWORD}
 trees:
   - path: /
-    tree: 
+    tree:
       type: tiled.examples.generated_minimal:tree
 ```
 
@@ -298,7 +298,7 @@ authenticators:
     type: tiled.authenticators:DummyAuthenticator
 trees:
   - path: /
-    tree: 
+    tree:
       type: tiled.examples.generated_minimal:tree
 ```
 

docs/source/explanations/specialized-formats.md

@@ -85,14 +85,13 @@ Now take the following simple server configuration:
 # config.yml
 trees:
   - path: /
-    tree: 
+    tree:
       type: tiled.catalog:from_uri
-      args:
-        uri: ./catalog.db
-          readable_storage:
-            - ./data/
-        adapters_by_mimetype:
-          application/x-xdi: tiled.examples.xdi:read_xdi
+      uri: ./catalog.db
+      readable_storage:
+        - ./data/
+      adapters_by_mimetype:
+        application/x-xdi: tiled.examples.xdi:read_xdi
 ```
 
 and serve it:
@@ -207,12 +206,11 @@ Add new sections to the configuration as follows.
 ```yaml
 trees:
   - path: /
-    tree: 
+    tree:
       type: tiled.catalog:from_uri
-    args:
       uri: ./catalog.db
       readable_storage:
-        - ./data/
+      - ./data/
       adapters_by_mimetype:
         application/x-xdi: tiled.examples.xdi:read_xdi
 media_types:

docs/source/how-to/custom-export-formats.md

@@ -74,7 +74,7 @@ media_types:
 # And provide some example data to try it with....
 trees:
   - path: /
-    tree: 
+    tree:
       type: tiled.examples.generated_minimal:tree
 ```
 
@@ -175,7 +175,7 @@ media_types:
     image/jpeg: custom_exporters:to_jpeg
 trees:
   - path: /
-    tree: 
+    tree:
       type: tiled.examples.generated_minimal:tree
 ```
 

docs/source/how-to/direct-client.md

@@ -45,7 +45,7 @@ config = {
     "trees": [
         {
              "path": "/",
-             "tree": "tiled.examples.generated_minimal:tree",
+             "tree": {"type": "tiled.examples.generated_minimal:tree"},
         }
 }
 app = build_app_from_config(config)

docs/source/how-to/profiles.md

@@ -171,10 +171,9 @@ my_profile:
   direct:
      trees:
        - path: /
-         tree: 
+         tree:
             type: tiled.catalog:from_uri
-            args:
-               uri: "/path/to/catalog.db"
+            uri: "/path/to/catalog.db"
 ```
 
 This takes the place of the `uri:` parameter. A profile must contain
@@ -188,10 +187,9 @@ my_profile:
   direct:
     trees:
       - path: /
-        tree: 
-      type: tiled.catalog:from_uri
-        args:
-          directory: "/path/to/catalog.db"
+        tree:
+         type: tiled.catalog:from_uri
+         directory: "/path/to/catalog.db"
   cache:
     capacity: 2_000_000_000 # 2 GB
 ```

docs/source/how-to/read-custom-formats.md

@@ -244,14 +244,13 @@ needed.
 # config.yml
 trees:
 - path: /
-  tree: 
+  tree:
     type: catalog
-    args:
-      uri: ./catalog.db
-      readable_storage:
-        - path/to/directory
-      adapters_by_mimetype:
-        application/x-stuff: custom:read_custom_format
+    uri: ./catalog.db
+    readable_storage:
+      - path/to/directory
+    adapters_by_mimetype:
+      application/x-stuff: custom:read_custom_format
 ```
 
 We then use the configuration file like this:

example_configs/google_auth.yml

@@ -12,6 +12,6 @@ authenticators:
 trees:
  # Just some arbitrary example data...
  # The point of this example is the authentication above.
- - tree: 
+ - tree:
       type: tiled.examples.generated_minimal:tree
    path: /

example_configs/multiple_providers.yml

@@ -22,5 +22,5 @@ authenticators:
       cara: ${CARA_PASSWORD}
 trees:
   - path: /
-    tree: 
+    tree:
       type: tiled.examples.toy_authentication:tree

example_configs/orcid_auth.yml

@@ -12,6 +12,6 @@ authenticators:
 trees:
  # Just some arbitrary example data...
  # The point of this example is the authenticaiton above.
- - tree: 
+ - tree:
       type: tiled.examples.generated_minimal:tree
    path: /