GitHub actions v2 (#10)

* Try tox

* Correct use of py310

* Try tox-gh

* Up docs

* Blackify

* Blackify

* Clean up

* Clean  up

* Up docs

Author: barseghyanartur

.github/workflows/test.yml

@@ -0,0 +1,48 @@
+name: test
+
+on: [push, pull_request]
+
+jobs:
+  test:
+
+    runs-on: ubuntu-latest
+    strategy:
+      max-parallel: 4
+      matrix:
+        python-version: ['3.6', '3.7', '3.8', '3.9', '3.10']
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v1
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install Dependencies
+      run: |
+        python -m pip install --upgrade pip
+    - name: Install tox-gh
+      run: python -m pip install tox-gh
+    - name: Setup test suite
+      run: tox4 r -vv --notest
+    - name: Run test suite
+      run: tox4 r --skip-pkg-install
+      env:
+        PYTEST_ADDOPTS: "-vv --durations=10"
+    - name: Coveralls
+      uses: AndreMiras/coveralls-python-action@develop
+      with:
+        parallel: true
+        flag-name: Run Tests
+
+  coveralls_finish:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+    - name: Coveralls Finished
+      env:
+        COVERALLS_REPO_TOKEN: ${{ secrets.COVERALLS_REPO_TOKEN }}
+        GITHUB_TOKEN: ${{ secrets.COVERALLS_REPO_TOKEN }}
+      uses: AndreMiras/coveralls-python-action@develop
+      with:
+        parallel-finished: true
+        debug: True

CHANGELOG.rst

@@ -17,15 +17,15 @@ are used for versioning (schema follows below):
 
 0.2.12
 ------
-2021-11-25
+2021-12-06
 
 - Tested against Django 3.1 and 3.2.
 - Tested against Python 3.9 and 3.10.
 - Tested against Django REST Framework 3.12.
 - Drop Python 2.x support.
 - Drop Python 3.5 support.
 - Drop Django < 2.2 support.
-- Drop Django REST Framework < 3.9.x support.
+- Drop Django REST Framework < 3.9 support.
 
 0.2.11
 ------

README.rst

@@ -34,7 +34,7 @@ Dependencies
 ============
 
 - djangorestframework: Initially written with 3.6.3, but nowadays tested
-  with >=3.9.2,<=3.11.0. May (still) work on earlier- or (even) support
+  with >=3.9,<3.13. May (still) work on earlier- or (even) support
   later- versions, although not guaranteed.
 
 Installation

docs/changelog.rst

@@ -15,6 +15,18 @@ are used for versioning (schema follows below):
   0.3.4 to 0.4).
 - All backwards incompatible changes are mentioned in this document.
 
+0.2.12
+------
+2021-12-06
+
+- Tested against Django 3.1 and 3.2.
+- Tested against Python 3.9 and 3.10.
+- Tested against Django REST Framework 3.12.
+- Drop Python 2.x support.
+- Drop Python 3.5 support.
+- Drop Django < 2.2 support.
+- Drop Django REST Framework < 3.9 support.
+
 0.2.11
 ------
 2019-12-27

docs/index.rst

@@ -27,14 +27,15 @@ Collection of various tricks for
 Prerequisites
 =============
 
-- Django 1.8, 1.9, 1.10, 1.11, 2.0, 2.1, 2.2 and 3.0.
-- Python 2.7, 3.5, 3.6, 3.7, 3.8
+- Django 2.2, 3.0, 3.1 and 3.2.
+- Python 3.6, 3.7, 3.8, 3.9 and 3.10.
 
 Dependencies
 ============
 
-- djangorestframework: Written with 3.6.3, tested with >=3.5.0,<=3.11.0. May
-  work on earlier versions, although not guaranteed.
+- djangorestframework: Initially written with 3.6.3, but nowadays tested
+  with >=3.9,<3.13. May (still) work on earlier- or (even) support
+  later- versions, although not guaranteed.
 
 Installation
 ============
@@ -45,17 +46,11 @@ Installation
 
         pip install django-rest-framework-tricks
 
-    or latest stable version from GitHub:
+    or latest development version from GitHub:
 
     .. code-block:: sh
 
-        pip install https://github.com/barseghyanartur/django-rest-framework-tricks/archive/stable.tar.gz
-
-    or latest stable version from BitBucket:
-
-    .. code-block:: sh
-
-        pip install https://bitbucket.org/barseghyanartur/django-rest-framework-tricks/get/stable.tar.gz
+        pip install https://github.com/barseghyanartur/django-rest-framework-tricks/archive/master.tar.gz
 
 (2) Add ``rest_framework`` and ``rest_framework_tricks`` to ``INSTALLED_APPS``:
 
@@ -81,7 +76,7 @@ Documentation is available on `Read the Docs
 Main features and highlights
 ============================
 
-- `Nested serializers`_: Nested serializers for non-relational fields.
+- `Nested serializers`_: Nested (writable) serializers for non-relational fields.
 - `Ordering filter`_: Developer friendly names for ordering options (for
   instance, for related field names).
 
@@ -705,28 +700,19 @@ To test against specific environment, type:
 
 .. code-block:: sh
 
-    tox -e py38-django30
+    tox -e py39-django32
 
 To test just your working environment type:
 
 .. code-block:: sh
 
-    ./runtests.py
+    pytest -vvv
 
 To run a single test in your working environment type:
 
 .. code-block:: sh
 
-    ./runtests.py src/rest_framework_tricks/tests/test_nested_proxy_field.py
-
-Or:
-
-.. code-block:: sh
-
-    ./manage.py test rest_framework_tricks.tests.test_nested_proxy_field
-
-It's assumed that you have all the requirements installed. If not, first
-install the test requirements:
+    pytest -vvv src/rest_framework_tricks/tests/test_nested_proxy_field.py
 
 .. code-block:: sh
 

examples/requirements/base.in

@@ -24,7 +24,9 @@ class Author(models.Model):
     phone_number = models.CharField(max_length=200, null=True, blank=True)
     website = models.URLField(null=True, blank=True)
     company = models.CharField(max_length=200, null=True, blank=True)
-    company_phone_number = models.CharField(max_length=200, null=True, blank=True)
+    company_phone_number = models.CharField(
+        max_length=200, null=True, blank=True
+    )
     company_email = models.EmailField(null=True, blank=True)
     company_website = models.URLField(null=True, blank=True)
 

examples/simple/books/models/author.py

@@ -42,7 +42,9 @@ class Book(models.Model):
     price = models.DecimalField(max_digits=10, decimal_places=2)
     pages = models.PositiveIntegerField(default=200)
     stock_count = models.PositiveIntegerField(default=30)
-    tags = models.ManyToManyField("books.Tag", related_name="books", blank=True)
+    tags = models.ManyToManyField(
+        "books.Tag", related_name="books", blank=True
+    )
 
     # This does not cause a model change
     publishing_information = NestedProxyField(

examples/simple/books/models/book.py

@@ -12,7 +12,9 @@
 class Order(models.Model):
     """Order."""
 
-    owner = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    owner = models.ForeignKey(
+        settings.AUTH_USER_MODEL, on_delete=models.CASCADE
+    )
     lines = models.ManyToManyField("books.OrderLine", blank=True)
     created = models.DateField(auto_now_add=True)
     updated = models.DateField(auto_now=True)

examples/simple/books/models/order.py

@@ -21,13 +21,17 @@ class Profile(models.Model):
     phone_number = models.CharField(max_length=200, null=True, blank=True)
     website = models.URLField(null=True, blank=True)
     company = models.CharField(max_length=200, null=True, blank=True)
-    company_phone_number = models.CharField(max_length=200, null=True, blank=True)
+    company_phone_number = models.CharField(
+        max_length=200, null=True, blank=True
+    )
     company_email = models.EmailField(null=True, blank=True)
     company_website = models.URLField(null=True, blank=True)
 
     bank_name = models.CharField(max_length=200, null=True, blank=True)
     bank_account_name = models.CharField(max_length=200, null=True, blank=True)
-    bank_account_number = models.CharField(max_length=200, null=True, blank=True)
+    bank_account_number = models.CharField(
+        max_length=200, null=True, blank=True
+    )
 
     # This does not cause a model change
     personal_information = NestedProxyField(