NotaBLE: add information about the project

NotaBLE és la col·laboració entre Gwido i el Workspace educatiu DD.

És un projecte de Xnet, IsardVDI, Gwido i Taller de Músics, guanyador
de la Ciutat Proactiva 2021, suport a la innovació urbana de la
Fundació BitHabitat.

dd-sso/admin/src/admin/views/ApiViews.py

@@ -18,6 +18,15 @@
 #   along with DD. If not, see <https://www.gnu.org/licenses/>.
 #
 # SPDX-License-Identifier: AGPL-3.0-or-later
+
+"""
+NotaBLE és la col·laboració entre Gwido i el Workspace educatiu DD.
+
+És un projecte de Xnet, IsardVDI, Gwido i Taller de Músics,
+guanyador de la Ciutat Proactiva 2021, suport a la innovació urbana de
+la Fundació BitHabitat.
+"""
+
 import copy
 import json
 import logging as log

dd-sso/admin/src/admin/views/api_docs/group_delete.yml

@@ -1,5 +1,11 @@
 Delete a registered group in DD
 ---
+# NotaBLE és la col·laboració entre Gwido i el Workspace educatiu DD.
+#
+# És un projecte de Xnet, IsardVDI, Gwido i Taller de Músics,
+# guanyador de la Ciutat Proactiva 2021, suport a la innovació urbana de
+# la Fundació BitHabitat.
+
 consumes:
   - application/json
 parameters:

dd-sso/admin/src/admin/views/api_docs/group_get.yml

@@ -1,5 +1,11 @@
 Get a registered group in DD
 ---
+# NotaBLE és la col·laboració entre Gwido i el Workspace educatiu DD.
+#
+# És un projecte de Xnet, IsardVDI, Gwido i Taller de Músics,
+# guanyador de la Ciutat Proactiva 2021, suport a la innovació urbana de
+# la Fundació BitHabitat.
+
 consumes:
   - application/json
 parameters:

dd-sso/admin/src/admin/views/api_docs/group_new.yml

@@ -1,5 +1,11 @@
 Register a new group in DD
 ---
+# NotaBLE és la col·laboració entre Gwido i el Workspace educatiu DD.
+#
+# És un projecte de Xnet, IsardVDI, Gwido i Taller de Músics,
+# guanyador de la Ciutat Proactiva 2021, suport a la innovació urbana de
+# la Fundació BitHabitat.
+
 consumes:
   - application/json
 parameters:

dd-sso/admin/src/admin/views/api_docs/groups.yml

@@ -1,5 +1,11 @@
 List all registered groups on DD.
 ---
+# NotaBLE és la col·laboració entre Gwido i el Workspace educatiu DD.
+#
+# És un projecte de Xnet, IsardVDI, Gwido i Taller de Músics,
+# guanyador de la Ciutat Proactiva 2021, suport a la innovació urbana de
+# la Fundació BitHabitat.
+
 definitions:
   Group:
     type: object

dd-sso/admin/src/admin/views/api_docs/role_users.yml

@@ -1,5 +1,11 @@
 List registered users on DD with a the given role.
 ---
+# NotaBLE és la col·laboració entre Gwido i el Workspace educatiu DD.
+#
+# És un projecte de Xnet, IsardVDI, Gwido i Taller de Músics,
+# guanyador de la Ciutat Proactiva 2021, suport a la innovació urbana de
+# la Fundació BitHabitat.
+
 consumes:
   - application/json
 parameters:

dd-sso/admin/src/admin/views/api_docs/roles.yml

@@ -1,5 +1,11 @@
 List all roles configured on DD.
 ---
+# NotaBLE és la col·laboració entre Gwido i el Workspace educatiu DD.
+#
+# És un projecte de Xnet, IsardVDI, Gwido i Taller de Músics,
+# guanyador de la Ciutat Proactiva 2021, suport a la innovació urbana de
+# la Fundació BitHabitat.
+
 definitions:
   Role:
     type: object

dd-sso/admin/src/admin/views/api_docs/user_delete.yml

@@ -1,5 +1,11 @@
 Delete a registered user in DD
 ---
+# NotaBLE és la col·laboració entre Gwido i el Workspace educatiu DD.
+#
+# És un projecte de Xnet, IsardVDI, Gwido i Taller de Músics,
+# guanyador de la Ciutat Proactiva 2021, suport a la innovació urbana de
+# la Fundació BitHabitat.
+
 consumes:
   - application/json
 parameters:

dd-sso/admin/src/admin/views/api_docs/user_get.yml

@@ -1,5 +1,11 @@
 Get a registered user in DD
 ---
+# NotaBLE és la col·laboració entre Gwido i el Workspace educatiu DD.
+#
+# És un projecte de Xnet, IsardVDI, Gwido i Taller de Músics,
+# guanyador de la Ciutat Proactiva 2021, suport a la innovació urbana de
+# la Fundació BitHabitat.
+
 consumes:
   - application/json
 parameters:

dd-sso/admin/src/admin/views/api_docs/user_new.yml

@@ -1,5 +1,11 @@
 Register a new user in DD
 ---
+# NotaBLE és la col·laboració entre Gwido i el Workspace educatiu DD.
+#
+# És un projecte de Xnet, IsardVDI, Gwido i Taller de Músics,
+# guanyador de la Ciutat Proactiva 2021, suport a la innovació urbana de
+# la Fundació BitHabitat.
+
 definitions:
   KeycloakId:
     type: object

dd-sso/admin/src/admin/views/api_docs/user_put.yml

@@ -1,5 +1,11 @@
 Modify a user in DD
 ---
+# NotaBLE és la col·laboració entre Gwido i el Workspace educatiu DD.
+#
+# És un projecte de Xnet, IsardVDI, Gwido i Taller de Músics,
+# guanyador de la Ciutat Proactiva 2021, suport a la innovació urbana de
+# la Fundació BitHabitat.
+
 consumes:
   - application/json
 parameters:

dd-sso/admin/src/admin/views/api_docs/users.yml

@@ -1,5 +1,11 @@
 List all registered users on DD.
 ---
+# NotaBLE és la col·laboració entre Gwido i el Workspace educatiu DD.
+#
+# És un projecte de Xnet, IsardVDI, Gwido i Taller de Músics,
+# guanyador de la Ciutat Proactiva 2021, suport a la innovació urbana de
+# la Fundació BitHabitat.
+
 definitions:
   User:
     type: object

dd-sso/admin/src/admin/views/api_docs/users_filter.yml

@@ -1,5 +1,11 @@
 List registered users on DD with a filter applied.
 ---
+# NotaBLE és la col·laboració entre Gwido i el Workspace educatiu DD.
+#
+# És un projecte de Xnet, IsardVDI, Gwido i Taller de Músics,
+# guanyador de la Ciutat Proactiva 2021, suport a la innovació urbana de
+# la Fundació BitHabitat.
+
 consumes:
   - application/json
 parameters:

dd-sso/admin/src/admin/views/test/__init__.py

@@ -0,0 +1,9 @@
+"""
+Tests for admin.views, particularly the NotaBLE API.
+
+NotaBLE és la col·laboració entre Gwido i el Workspace educatiu DD.
+
+És un projecte de Xnet, IsardVDI, Gwido i Taller de Músics,
+guanyador de la Ciutat Proactiva 2021, suport a la innovació urbana de
+la Fundació BitHabitat.
+"""

dd-sso/admin/src/admin/views/test/mocks.py

@@ -1,5 +1,11 @@
 """
-Mocks to test API views.
+Mock classes to test NotaBLE API from a simple environment.
+
+NotaBLE és la col·laboració entre Gwido i el Workspace educatiu DD.
+
+És un projecte de Xnet, IsardVDI, Gwido i Taller de Músics,
+guanyador de la Ciutat Proactiva 2021, suport a la innovació urbana de
+la Fundació BitHabitat.
 """
 import copy
 from typing import Any, Dict, Iterable, List, Optional, cast

dd-sso/admin/src/admin/views/test/test_ApiViews.py

@@ -1,4 +1,22 @@
+#!/usr/bin/env python3
 """
+Tests and helper script for NotaBLE API.
+
+From the admin development environment:
+
+The API spec file can be generated with:
+    python -m admin.views.test.test_ApiViews --generate-spec
+
+
+A simple testing ground that serves the Swagger UI can also be started with:
+    python -m admin.views.test.test_ApiViews
+
+
+NotaBLE és la col·laboració entre Gwido i el Workspace educatiu DD.
+
+És un projecte de Xnet, IsardVDI, Gwido i Taller de Músics,
+guanyador de la Ciutat Proactiva 2021, suport a la innovació urbana de
+la Fundació BitHabitat.
 """
 
 import copy