Running setup.py directly is deprecated

README.rst

@@ -253,7 +253,7 @@ To install using ``pip``:
 
 .. code-block:: bash
 
-        $ pip install -U django-celery-beat
+        $ pip install --upgrade django-celery-beat
 
 Downloading and installing from source
 --------------------------------------
@@ -265,14 +265,13 @@ You can install it by doing the following :
 
 .. code-block:: bash
 
+        $ python3 -m venv .venv
+        $ source .venv/bin/activate
+        $ pip install --upgrade build pip
         $ tar xvfz django-celery-beat-0.0.0.tar.gz
         $ cd django-celery-beat-0.0.0
-        $ python setup.py build
-        # python setup.py install
-
-The last command must be executed as a privileged user if
-you are not currently using a virtualenv.
-
+        $ python -m build
+        $ pip install --upgrade .
 
 After installation, add ``django_celery_beat`` to Django's settings module:
 

docker/base/Dockerfile

@@ -9,6 +9,7 @@ RUN apt-get update && apt-get install --yes --no-install-recommends \
         wait-for-it
 
 RUN pip3 install --user \
+        build \
         django-createsuperuserwithpassword \
         psycopg2-binary
 
@@ -19,7 +20,7 @@ COPY requirements/        /app/requirements/
 
 WORKDIR /app
 
-RUN python3 setup.py develop --user
+RUN pip3 install --editable --user ".[develop]"
 
 
 WORKDIR /

docs/includes/installation.txt

@@ -6,7 +6,15 @@ or from source.
 
 To install using `pip`,::
 
-    $ pip install -U django-celery-beat
+    $ pip install --upgrade django-celery-beat
+
+Installing the current default branch
+-------------------------------------
+
+    $ python3 -m venv .venv
+    $ source .venv/bin/activate
+    $ pip install --upgrade pip
+    $ pip install git+https://github.com/celery/django-celery-beat.git
 
 Downloading and installing from source
 --------------------------------------
@@ -16,13 +24,13 @@ http://pypi.python.org/pypi/django-celery-beat
 
 You can install it by doing the following,::
 
+    $ python3 -m venv .venv
+    $ source .venv/bin/activate
+    $ pip install --upgrade build pip
     $ tar xvfz django-celery-beat-0.0.0.tar.gz
     $ cd django-celery-beat-0.0.0
-    $ python setup.py build
-    # python setup.py install
-
-The last command must be executed as a privileged user if
-you are not currently using a virtualenv.
+    $ python -m build
+    $ pip install .
 
 Using the development version
 -----------------------------

t/unit/conftest.py

@@ -2,7 +2,7 @@
 
 import pytest
 # we have to import the pytest plugin fixtures here,
-# in case user did not do the `python setup.py develop` yet,
+# in case user did not yet `pip install ".[develop]"`,
 # that installs the pytest plugin into the setuptools registry.
 from celery.contrib.pytest import (celery_app, celery_config,
                                    celery_enable_logging, celery_parameters,