Tested against Django 4.0. Added FileField with restricted size (#16)

* Test against Django 4.0
* Add contrained file field
* Add docs
* Blackify
* Drop DRF 3.9 support
* Prepare 0.2.13
* Drop Python 3.6 support
* Up reqs

Author: barseghyanartur

.github/workflows/test.yml

@@ -4,12 +4,21 @@ on: [push, pull_request]
 
 jobs:
   test:
-
-    runs-on: ubuntu-latest
+    name: test ${{ matrix.py }} - ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}-latest
     strategy:
+      fail-fast: true
       max-parallel: 4
       matrix:
-        python-version: ['3.6', '3.7', '3.8', '3.9', '3.10']
+        os:
+          - Ubuntu
+#          - Windows
+#          - MacOs
+        py:
+          - "3.10"
+          - "3.9"
+          - "3.8"
+          - "3.7"
 
     steps:
     - uses: actions/checkout@v2
@@ -20,12 +29,14 @@ jobs:
     - 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: Install tox
+      run: python -m pip install tox-gh-actions
+#    - name: Setup test suite
+#      run: tox r -vv --notest
+#    - name: Run test suite
+#      run: tox r --skip-pkg-install
     - name: Run test suite
-      run: tox4 r --skip-pkg-install
+      run: tox -r
       env:
         PYTEST_ADDOPTS: "-vv --durations=10"
     - name: Coveralls

CHANGELOG.rst

@@ -15,6 +15,15 @@ are used for versioning (schema follows below):
   0.3.4 to 0.4).
 - All backwards incompatible changes are mentioned in this document.
 
+0.2.13
+------
+2022-11-20
+
+- Tested against Django 4.0.
+- Drop Python 3.6 support.
+- Drop Django REST Framework 3.9.x support.
+- Add `ConstrainedFileField` (for limiting size of file uploads).
+
 0.2.12
 ------
 2021-12-06

README.rst

@@ -12,6 +12,10 @@ Collection of various tricks for
     :target: https://pypi.python.org/pypi/django-rest-framework-tricks/
     :alt: Supported Python versions
 
+.. image:: https://img.shields.io/pypi/djversions/django-rest-framework-tricks.svg
+    :target: https://pypi.python.org/pypi/django-rest-framework-tricks/
+    :alt: Supported Django versions
+
 .. image:: https://github.com/barseghyanartur/django-rest-framework-tricks/workflows/test/badge.svg
    :target: https://github.com/barseghyanartur/django-rest-framework-tricks/actions
    :alt: Build Status
@@ -193,7 +197,7 @@ Model definition
             'state',
         )
 
-        class Meta(object):
+        class Meta:
             """Meta options."""
 
             ordering = ["isbn"]
@@ -246,7 +250,7 @@ Defining the serializers
         isbn = serializers.CharField(required=False)
         pages = serializers.IntegerField(required=False)
 
-        class Meta(object):
+        class Meta:
             """Meta options."""
 
             model = Book
@@ -266,7 +270,7 @@ Defining the serializers
     class StockInformationSerializer(serializers.ModelSerializer):
         """Stock information serializer."""
 
-        class Meta(object):
+        class Meta:
             """Meta options."""
 
             model = Book
@@ -293,7 +297,7 @@ Defining the serializers
         publishing_information = PublishingInformationSerializer(required=False)
         stock_information = StockInformationSerializer(required=False)
 
-        class Meta(object):
+        class Meta:
             """Meta options."""
 
             model = Book
@@ -667,6 +671,68 @@ serializer (JSON response). API becomes easier to use/understand that way.
     GET /api/profile/?ordering=full_name
     GET /api/profile/?ordering=-full_name
 
+File field with restrictions
+----------------------------
+
+Sample model
+~~~~~~~~~~~~
+
+Absolutely no variations from standard implementation here.
+
+Required imports
+^^^^^^^^^^^^^^^^
+
+.. code-block:: python
+
+    from django.db import models
+
+
+Model definition
+^^^^^^^^^^^^^^^^
+
+.. code-block:: python
+
+    class Profile(models.Model):
+        """Upload."""
+
+        username = models.CharField(max_length=255)
+        resume = models.FileField()
+
+
+Sample serializer
+~~~~~~~~~~~~~~~~~
+
+Required imports
+^^^^^^^^^^^^^^^^
+
+.. code-block:: python
+
+    from rest_framework import serializers
+    from rest_framework_tricks.fields import ConstrainedFileField
+
+    from .models import Upload
+
+Defining the serializers
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. code-block:: python
+
+    class ProfileSerializer(serializers.ModelSerializer):
+        """Profile serializer."""
+
+        username = serializers.CharField()
+        # Restrict resume to 5Mb
+        resume = ConstrainedFileField(max_upload_size=5_242_880)
+
+        class Meta(object):
+
+        model = Profile
+        fields = (
+            'id',
+            'username',
+            'resume',
+        )
+
 Demo
 ====
 Run demo locally