django-pfx 1.2.dev97__tar.gz → 1.2.dev99__tar.gz

{django-pfx-1.2.dev97 → django-pfx-1.2.dev99}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: django-pfx
-Version: 1.2.dev97
+Version: 1.2.dev99
 Summary: Django PFX is a toolkit to build web APIs dedicated to be used by React progressive web app.
 Author: Hervé Martinet
 Author-email: herve.martinet@gmail.com

{django-pfx-1.2.dev97 → django-pfx-1.2.dev99}/django_pfx.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: django-pfx
-Version: 1.2.dev97
+Version: 1.2.dev99
 Summary: Django PFX is a toolkit to build web APIs dedicated to be used by React progressive web app.
 Author: Hervé Martinet
 Author-email: herve.martinet@gmail.com

{django-pfx-1.2.dev97 → django-pfx-1.2.dev99}/doc/source/testing.md

@@ -18,12 +18,12 @@ so that each request header contains
 the HTTP_X_CUSTOM_LANGUAGE attribute with the locale.
 
 Example :
-```
+```python
 client = APIClient(default_locale='en_GB')
 ```
 Each request to a service can also override the locale.
 Example :
-```
+```python
 client = APIClient()
 response = client.get('/api/authors', locale='fr_CH')
 ```
@@ -33,7 +33,7 @@ response = client.get('/api/authors', locale='fr_CH')
 Send a get request.
 
 Example :
-```
+```python
 client = APIClient()
 response = client.get('/api/authors')
 ```
@@ -42,7 +42,7 @@ response = client.get('/api/authors')
 Send a post request with content type 'application/json'.
 
 Example :
-```
+```python
 client = APIClient()
 response = client.post(
     '/api/authors', {
@@ -54,7 +54,7 @@ response = client.post(
 Send a put request with content type 'application/json'.
 
 Example :
-```
+```python
 client = APIClient()
 response = self.client.put(
     f'/api/authors/{author_pk}',
@@ -67,13 +67,12 @@ response = self.client.put(
 Send a delete request with content type 'application/json'.
 
 Example :
-```
+```python
 client = APIClient()
 response = client.delete(
     f'/api/authors/{author_pk}')
 ```
 
-
 ### Login
 If you use PFX authentication views you can use this login method.
 
@@ -81,7 +80,7 @@ Once you called login, you can call any other method
 listed above, the authentication token will be sent with the requests.
 
 Example :
-```
+```python
 client = APIClient()
 client.login(
     username='jrr.tolkien',
@@ -98,7 +97,7 @@ Test the response code of a response.
 It takes two parameters, the response and the expected status code.
 
 Example :
-```
+```python
 class ATestClass(TestAssertMixin, TransactionTestCase):
 
     def a_test(self):
@@ -110,12 +109,12 @@ class ATestClass(TestAssertMixin, TransactionTestCase):
         self.assertRC(response, 200)
 ```
 
-### assertJE
-Test the value of a json property in the json_content of the response.
-It takes 3 parameters, the response, the key and the expected value.
-It allows you to specify the path to reach an element in the json structure.
+### get_val
+
+Get a value for a python dictionary or a json HTTP response by a string path key.
+The src parameter can be a Python dictionary or an object with `json_content` attribute.
 For instance if you have a response like
-```
+```python
 {
     "author": {
         "pk": 2,
@@ -125,32 +124,58 @@ For instance if you have a response like
     "pk": 6,
 }
 ```
-you can reach the author pk by providing "author.pk" as the key.
+you can reach the author pk by providing `"author.pk"` as the key.
 
-AssertJE also allows to specify the index in an array.
-The syntax is "@index".
+get_val also allows to specify the index in an array.
+The syntax is `"@index"`.
 
 For instance if you want the pk of the author of the
-third item in an array of books you can specify "items.@3.author.pk"
+third item in an array of books you can specify `"items.@3.author.pk"`
 
 Example :
+```python
+class ATestClass(TestAssertMixin, TransactionTestCase):
+
+    def a_test(self):
+        client = APIClient()
+        response = client.get('/api/books')
+        author_pk = self.get_val(response, 'items.@3.author.pk')
 ```
+
+### assertJE
+Test the value of a dictionary property (using `get_val`).
+It takes 3 parameters, the source, the key and the expected value.
+
+Example :
+```python
 class ATestClass(TestAssertMixin, TransactionTestCase):
 
     def a_test(self):
         client = APIClient()
         response = client.get('/api/books')
-        self.assertJE(response, 'items.@3.author.pk', 6)
+        author_pk = self.assertJE(response, 'items.@3.author.pk', 6)
 ```
 
 ### assertNJE
-Assert NJE is the same as AssertJE, but it tests that the value is not equal.
+`AssertNJE` is the same as `AssertJE`, but it tests that the value is not equal.
+
+### assertJEExists
+Assert the path exists in the source.
+
+### assertJENotExists
+Assert the path does not exists in the source.
+
+### assertSize
+Test the size of a value (if the value is a collection).
+
+### assertJIn
+Test that an element is part of a collection value.
 
 ## Print Response
 You can use the print_response helper to print a response in the console.
 
 Example :
-```
+```python
 client = APIClient()
 response = client.get('/api/books')
 print_response(response)
@@ -158,7 +183,7 @@ print_response(response)
 
 will produce
 
-```
+```plain
 *********************http response*********************
 Status :  200 OK
 Headers :
@@ -186,3 +211,54 @@ Content :
 }
 *******************************************************
 ```
+
+## PermsAPITest
+
+This test class can be used to test permissions on services with multiple users.
+
+Create multiple users in `setUpTestData` and add a method for each service
+you want to test.
+
+You can test the response status code or the response list count for items list responses.
+
+Example :
+```python
+class BookPermsAPITest(PermsAPITest):
+    def setUp(self):
+        self.client = APIClient(with_cookie=True)
+
+    @classmethod
+    def setUpTestData(cls):
+        # Create your users here
+
+    def list(self):
+        # Create a book
+        return self.client.get('/api/books?items=1&count=1')
+
+    def get(self):
+        # book = … (create a book)
+        return self.client.get(f'/api/books/{book.pk}')
+
+    def post(self):
+        return self.client.post('/api/books', dict(
+            name="Test new"))
+
+    def put(self):
+        return self.client.put(
+            f'/api/books/{self.organization.pk}', dict(
+                name="Updated"))
+
+    def delete(self):
+        # book = … (create a book)
+        return self.client.delete(f'/api/books/{book.pk}')
+
+    USER_TESTS = {
+        "admin@user.org": dict(
+            list=200, list__count=1, get=200
+            post=200, put=200, delete=200),
+        "user@user.org": dict(
+            list=200, list__count=1, get=200,
+            post=403, put=403, delete=403),
+    }
+
+```