Route trailing slash compliance: Add trailing slashes to subresource ID paths
Nobody has claimed this yet.
Assessment
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 72/100
Research direction
Start with the listed entry points in campus_python/api/v1/assignments.py, submissions.py, circles.py and campus_python/auth/v1/credentials.py, users.py, and vaults.py. Update the 19 specified path calls, then locate the tests that mock these API requests and update their expected URLs. Done means the affected tests pass and all listed ID-based paths include trailing slashes without changing verb or subresource routes.
Written by the indexing model from the issue text.
Description
Problem
Per campus API conventions, subresource paths with ID parameters should have trailing slashes (e.g., /assignments/{assignment_id}/ instead of /assignments/{assignment_id}). The campus server is being updated to match this convention, and this client library needs to be updated accordingly.
Related issue: nyjc-computing/campus#407
API Methods to Fix
The following client methods call API endpoints that need trailing slashes added. This requires updating the make_path() calls to pass end_slash=True.
campus_python/api/v1/assignments.py
Assignments.Assignment class:
get()- Line 73-76- Current:
self.client.get(self.make_path()) - Fix:
self.client.get(self.make_path(end_slash=True))
- Current:
delete()- Line 68-71- Current:
self.client.delete(self.make_path()) - Fix:
self.client.delete(self.make_path(end_slash=True))
- Current:
update()- Line 78-81- Current:
self.client.patch(self.make_path(), json=updates) - Fix:
self.client.patch(self.make_path(end_slash=True), json=updates)
- Current:
campus_python/api/v1/submissions.py
Submissions.Submission class:
get()- Line 137-141- Current:
self.client.get(self.make_path()) - Fix:
self.client.get(self.make_path(end_slash=True))
- Current:
delete()- Line 131-135- Current:
self.client.delete(self.make_path()) - Fix:
self.client.delete(self.make_path(end_slash=True))
- Current:
update()- Line 170- Current:
self.client.patch(self.make_path(), json=payload) - Fix:
self.client.patch(self.make_path(end_slash=True), json=payload)
- Current:
Submissions class:
by_assignment()- Line 62- Current:
path = f"{self.make_path()}/by-assignment/{assignment_id}" - Fix:
path = f"{self.make_path()}/by-assignment/{assignment_id}/"
- Current:
by_student()- Line 79- Current:
path = f"{self.make_path()}/by-student/{student_id}" - Fix:
path = f"{self.make_path()}/by-student/{student_id}/"
- Current:
campus_python/api/v1/circles.py
Circles.Circle class:
get()- Line 56-59- Current:
self.client.get(self.make_path()) - Fix:
self.client.get(self.make_path(end_slash=True))
- Current:
delete()- Line 51-54- Current:
self.client.delete(self.make_path()) - Fix:
self.client.delete(self.make_path(end_slash=True))
- Current:
update()- Line 61-64- Current:
self.client.patch(self.make_path(), json=updates) - Fix:
self.client.patch(self.make_path(end_slash=True), json=updates)
- Current:
campus_python/auth/v1/credentials.py
Credentials.Provider.User class:
delete()- Line 61-68- Current:
self.client.delete(self.make_path(), json={"client_id": client_id}) - Fix:
self.client.delete(self.make_path(end_slash=True), json={"client_id": client_id})
- Current:
get()- Line 70-78- Current:
self.client.get(self.make_path(), query={"client_id": client_id}) - Fix:
self.client.get(self.make_path(end_slash=True), query={"client_id": client_id})
- Current:
update()- Line 95- Current:
self.client.patch(self.make_path(), json=json_data) - Fix:
self.client.patch(self.make_path(end_slash=True), json=json_data)
- Current:
campus_python/auth/v1/users.py
Users.User class:
delete()- Line 48-50- Current:
self.client.delete(self.make_path()) - Fix:
self.client.delete(self.make_path(end_slash=True))
- Current:
get()- Line 52-55- Current:
self.client.get(self.make_path()) - Fix:
self.client.get(self.make_path(end_slash=True))
- Current:
campus_python/auth/v1/vaults.py
Vaults.Vault class (methods use make_path(key)):
__delitem__()- Line 33- Current:
self.client.delete(self.make_path(key)) - Fix:
self.client.delete(self.make_path(key, end_slash=True))
- Current:
__getitem__()- Line 40- Current:
self.client.get(self.make_path(key)) - Fix:
self.client.get(self.make_path(key, end_slash=True))
- Current:
__setitem__()- Line 50- Current:
self.client.post(self.make_path(key), json={"value": value}) - Fix:
self.client.post(self.make_path(key, end_slash=True), json={"value": value})
- Current:
Tasks
- Update all 19 method calls listed above to use
end_slash=True - Update any tests that mock these API calls to expect trailing slashes
- Verify compatibility with the updated campus server routes
Notes
- Routes ending in verbs (e.g.,
/activate,/submit) do NOT need trailing slashes - Routes ending in subresource names (e.g.,
/links,/responses,/metadata) do NOT need trailing slashes
- Dominant language
- Python
- Stars
- 0
- Forks
- 0
- PR merge metrics
- No merged PRs in 30d
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from nyjc-computing/campus-api-python
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
-
Difficulty 3/5 1-2 days Newbie friendliness 48/100
-
nyjc-computing/campus-api-python#2 · 1 assignee ·
All issues in nyjc-computing/campus-api-python
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100