config app_name for all url reverse lookups, allow url versioning

mwfarb · mwfarb · commit 3909baa9ba04 · 2024-08-07T14:38:26.000-04:00
diff --git a/arena_account/settings.py b/arena_account/settings.py
@@ -124,6 +124,7 @@
         "rest_framework.parsers.MultiPartParser",
         "rest_framework.parsers.JSONParser",
     ],
+    "DEFAULT_VERSIONING_CLASS": "rest_framework.versioning.NamespaceVersioning",
 }
 
 DEFAULT_AUTO_FIELD = 'django.db.models.AutoField'
diff --git a/arena_account/urls.py b/arena_account/urls.py
@@ -18,7 +18,11 @@
 from django.urls import include, path
 
 urlpatterns = [
-    path("user/", include("users.urls")),
+    # configure user api version based endpoints
+    path("user/", include("users.urls", namespace="v1")),
+    path("user/v2/", include("users.urls", namespace="v2")),
+
+    # include admin paths
     path("user/admin/", admin.site.urls),
     path("user/accounts/", include("allauth.urls")),
 ]
diff --git a/users/forms.py b/users/forms.py
@@ -44,7 +44,7 @@ class SceneForm(forms.ModelForm):
     editors = forms.ModelMultipleChoiceField(
         queryset=User.objects.all().order_by('username'),
         widget=autocomplete.ModelSelect2Multiple(
-            url='user-autocomplete',
+            url='users:user-autocomplete',
             forward=(forward.Self(), ),
             attrs={'data-minimum-input-length': 2},
         ), required=False)
diff --git a/users/templates/users/header.html b/users/templates/users/header.html
@@ -26,7 +26,7 @@
 </head>
 
 <body>
-    {% url 'login' as login_url %}
+    {% url 'users:login' as login_url %}
     <!-- avoid navbar for users who have not logged in on login form yet-->
     {% if user.is_authenticated or request.get_full_path != login_url %}
 
@@ -108,13 +108,13 @@
                             {{user.get_username}}</a>
                         <ul class="dropdown-menu dropdown-menu-end" aria-labelledby="navbarDropdown">
                             <li><a class="dropdown-item" href="{{request.scheme}}://{{request.get_host}}/conf/versions.html">Version</a></li>
-                            <li><a class="dropdown-item" href="{% url 'user_profile' %}">Profile</a></li>
-                            <li><a class="dropdown-item" href="{% url 'logout' %}">Logout</a></li>
+                            <li><a class="dropdown-item" href="{% url 'users:user_profile' %}">Profile</a></li>
+                            <li><a class="dropdown-item" href="{% url 'users:logout' %}">Logout</a></li>
                         </ul>
                     </li>
                     {% else %}
                     <li class="nav-item">
-                        <a class="nav-link" href="{% url 'login' %}">Login</a>
+                        <a class="nav-link" href="{% url 'users:login' %}">Login</a>
                     </li>
                     {% endif %}
                 </ul>
diff --git a/users/templates/users/social_signup.html b/users/templates/users/social_signup.html
@@ -16,7 +16,7 @@ <h3>Sign Up</h3>
             <p>You are about to use your
                 {{account.get_provider.name}} account to login. As a final step, please complete the
                 following form:</p>
-            <form class="signup" id="signup_form" method="post" action="{% url 'socialaccount_signup' %}"
+            <form class="signup" id="signup_form" method="post" action="{% url 'users:socialaccount_signup' %}"
                 enctype="multipart/form-data">
                 {% csrf_token %}
                 {% for field in form %}
diff --git a/users/templates/users/user_profile.html b/users/templates/users/user_profile.html
@@ -137,7 +137,7 @@ <h5>Scene Permissions <button id="button_expand_add_scene" type="button" title="
                     <form action="profile_update_scene" method="POST">
                         {% csrf_token %}
                         <tr>
-                            <td><a href="../../{{ scene.name }}"><b>{{ scene.name }}</b></a></td>
+                            <td><a href="{{ request.scheme }}://{{ request.META.HTTP_HOST }}/{{ scene.name }}"><b>{{ scene.name }}</b></a></td>
                             <!--public subscribe ok-->
                             <td>
                                 {% if scene.public_read %}
diff --git a/users/urls.py b/users/urls.py
@@ -12,7 +12,7 @@
         title="ARENA Users API",
         default_version="v1",
         description="ARENA Users Django site endpoints.",
-        terms_of_service="../terms.html",
+        terms_of_service=f"https://{os.environ['HOSTNAME']}/terms.html",
         contact=openapi.Contact(email=os.environ["EMAIL"]),
         license=openapi.License(
             name="BSD 3-Clause License",
@@ -24,6 +24,7 @@
     permission_classes=(permissions.AllowAny,),
 )
 
+app_name = "users"
 urlpatterns = [
     # pages
     path("", views.index, name="index"),
diff --git a/users/views.py b/users/views.py
@@ -43,7 +43,7 @@ def index(request):
     """
     Root page load, index is treated as Login page.
     """
-    return redirect("login")
+    return redirect("users:login")
 
 
 def login_request(request):
@@ -63,7 +63,7 @@ def login_request(request):
                     login(request, user)
                     messages.info(
                         request, f"You are now logged in as {username}.")
-                    return redirect("login_callback")
+                    return redirect("users:login_callback")
                 else:
                     messages.error(request, "Invalid username or password.")
             else:
@@ -79,7 +79,7 @@ def logout_request(request):
     Removes ID and flushes session data, shows login page.
     """
     logout(request)  # revoke django auth
-    response = redirect("login")
+    response = redirect("users:login")
     response.delete_cookie("auth")  # revoke fs auth
     return response
 
@@ -98,7 +98,7 @@ def profile_update_scene(request):
     form = UpdateSceneForm(request.POST)
     if not form.is_valid():
         messages.error(request, "Invalid parameters")
-        return redirect("user_profile")
+        return redirect("users:user_profile")
     if "add" in request.POST:
         scenename = request.POST.get("scenename", None)
         s = Scene(
@@ -108,12 +108,12 @@ def profile_update_scene(request):
         s.save()
         messages.success(
             request, f"Created scene {request.user.username}/{scenename}")
-        return redirect("user_profile")
+        return redirect("users:user_profile")
     elif "edit" in request.POST:
         name = form.cleaned_data["edit"]
         return redirect(f"profile/scenes/{name}")
 
-    return redirect("user_profile")
+    return redirect("users:user_profile")
 
 
 @ permission_classes([permissions.IsAuthenticated])
@@ -130,7 +130,7 @@ def profile_update_device(request):
     form = UpdateDeviceForm(request.POST)
     if not form.is_valid():
         messages.error(request, "Invalid parameters")
-        return redirect("user_profile")
+        return redirect("users:user_profile")
     if "add" in request.POST:
         devicename = request.POST.get("devicename", None)
         s = Device(
@@ -139,12 +139,12 @@ def profile_update_device(request):
         s.save()
         messages.success(
             request, f"Created device {request.user.username}/{devicename}")
-        return redirect("user_profile")
+        return redirect("users:user_profile")
     elif "edit" in request.POST:
         name = form.cleaned_data["edit"]
         return redirect(f"profile/devices/{name}")
 
-    return redirect("user_profile")
+    return redirect("users:user_profile")
 
 
 def scene_perm_detail(request, pk):
@@ -154,19 +154,19 @@ def scene_perm_detail(request, pk):
     """
     if not scene_permission(user=request.user, scene=pk):
         messages.error(request, f"User does not have permission for: {pk}.")
-        return redirect("user_profile")
+        return redirect("users:user_profile")
     # now, make sure scene exists before the other commands are tried
     try:
         scene = Scene.objects.get(name=pk)
     except Scene.DoesNotExist:
         messages.error(request, "The scene does not exist")
-        return redirect("user_profile")
+        return redirect("users:user_profile")
     if request.method == 'POST':
         if "save" in request.POST:
             form = SceneForm(instance=scene, data=request.POST)
             if form.is_valid():
                 form.save()
-                return redirect("user_profile")
+                return redirect("users:user_profile")
         elif "delete" in request.POST:
             token = generate_arena_token_v1(
                 user=request.user, username=request.user.username)
@@ -177,7 +177,7 @@ def scene_perm_detail(request, pk):
                 messages.error(
                     request, f"Unable to delete {pk} objects from persistance database.")
 
-            return redirect("user_profile")
+            return redirect("users:user_profile")
     else:
         form = SceneForm(instance=scene)
 
@@ -192,24 +192,24 @@ def device_perm_detail(request, pk):
     """
     if not device_permission(user=request.user, device=pk):
         messages.error(request, f"User does not have permission for: {pk}.")
-        return redirect("user_profile")
+        return redirect("users:user_profile")
     # now, make sure device exists before the other commands are tried
     try:
         device = Device.objects.get(name=pk)
     except Device.DoesNotExist:
         messages.error(request, "The device does not exist")
-        return redirect("user_profile")
+        return redirect("users:user_profile")
     token = None
     if request.method == 'POST':
         if "save" in request.POST:
             form = DeviceForm(instance=device, data=request.POST)
             if form.is_valid():
                 form.save()
-                return redirect("user_profile")
+                return redirect("users:user_profile")
         elif "delete" in request.POST:
             # delete account device data
             device.delete()
-            return redirect("user_profile")
+            return redirect("users:user_profile")
         elif "token" in request.POST:
             token = generate_arena_token_v1(
                 user=request.user,
@@ -336,9 +336,9 @@ def profile_update_staff(request):
         if not set_filestore_scope(user):
             messages.error(
                 request, "Unable to update user's filestore status.")
-            return redirect("user_profile")
+            return redirect("users:user_profile")
 
-    return redirect("user_profile")
+    return redirect("users:user_profile")
 
 
 @ api_view(["GET"])
@@ -486,13 +486,13 @@ def user_profile(request):
                 if not delete_scene_objects(scene.name, token):
                     messages.error(
                         request, f"Unable to delete {scene.name} objects from persistance database.")
-                    return redirect("user_profile")
+                    return redirect("users:user_profile")
 
             # delete filestore files/account
             if not delete_filestore_user(request.user):
                 messages.error(
                     request, "Unable to delete account/files from the filestore.")
-                return redirect("user_profile")
+                return redirect("users:user_profile")
 
             # Be careful of foreign keys, in that case this is suggested:
             # user.is_active = False

Original file line number	Diff line number	Diff line change
`@@ -124,6 +124,7 @@`
`124`	`124`	`"rest_framework.parsers.MultiPartParser",`
`125`	`125`	`"rest_framework.parsers.JSONParser",`
`126`	`126`	`],`
	`127`	`+ "DEFAULT_VERSIONING_CLASS": "rest_framework.versioning.NamespaceVersioning",`
`127`	`128`	`}`
`128`	`129`
`129`	`130`	`DEFAULT_AUTO_FIELD = 'django.db.models.AutoField'`