Drop py-pandoc as a default dependency

We're finding that pre-commit-docx-plain can't reliably install
py-pandoc from within a pre-commit environment (it can be pip-installed
fine on its own). Thus we're reluctantly dropping py-pandoc and instead
recommending that users install pandoc separately through apt-get or
homebrew.

Author: jonathansick

CHANGELOG.rst

@@ -1,10 +1,14 @@
 Change log
 ==========
 
-Unreleased
-----------
+0.3.0 (2021-05-12)
+------------------
 
 - Trim trailing whitespace from the output.
+- Drop ``py-pandoc`` as a default dependency.
+  To get pandoc, you can install it with your system's package manager (such as homebrew or apt-get).
+  Alternatively, you can directly install pre-commit-docx-plain using the ``[pandoc]`` extra to install pandoc through the ``py-pandoc`` PyPI package.
+  However, we've found that py-pandoc cannot be installed reliably as a dependency of a pre-commit hook.
 
 0.2.0 (2021-03-23)
 ------------------

README.rst

@@ -15,7 +15,7 @@ At the root of your document's Git repository, add a file named ``.pre-commit-co
 
    repos:
      - repo: https://github.com/jsickcodes/pre-commit-docx-plain
-       rev: 0.1.0
+       rev: 0.3.0
        hooks:
          - id: docxplain
 
@@ -65,6 +65,9 @@ If the repository does not already have a GitHub Actions workflow, create a file
          - name: Set up Python
            uses: actions/setup-python@v2
 
+         - name: Install pandoc
+           run: brew install pandoc
+
          - name: Run pre-commit hooks
            uses: pre-commit/action@v2.0.0
 
@@ -92,6 +95,9 @@ The ``.github/workflows/ci.yaml`` file::
          - name: Set up Python
            uses: actions/setup-python@v2
 
+         - name: Install pandoc
+           run: brew install pandoc
+
          - name: Run pre-commit hooks
            uses: pre-commit/action@v2.0.0
            with:
@@ -115,7 +121,7 @@ However, you can customize the suffix of the file name by setting a ``--suffix``
 
    repos:
      - repo: https://github.com/jsickcodes/pre-commit-docx-plain
-       rev: 0.2.0
+       rev: 0.3.0
        hooks:
          - id: docxplain
            args:
@@ -130,7 +136,7 @@ This is useful for explaining that the file is autogenerated::
 
    repos:
      - repo: https://github.com/jsickcodes/pre-commit-docx-plain
-       rev: 0.2.0
+       rev: 0.3.0
        hooks:
          - id: docxplain
            args:
@@ -141,7 +147,7 @@ You can also insert the name of the source docx file using Python format string
 
    repos:
      - repo: https://github.com/jsickcodes/pre-commit-docx-plain
-       rev: 0.2.0
+       rev: 0.3.0
        hooks:
          - id: docxplain
            args:

setup.cfg

@@ -1,5 +1,6 @@
 [metadata]
 name = docxplain
+version = 0.3.0
 description = Convert Office (docx) files to plain text using pandoc.
 author = Jonathan Sick
 author_email = hi@jsick.codes
@@ -33,7 +34,6 @@ setup_requires =
 install_requires =
     importlib_metadata; python_version < "3.8"
     pypandoc
-    py-pandoc
 
 [options.packages.find]
 where = src
@@ -43,6 +43,8 @@ console_scripts =
     docxplain = docxplain.cli:main
 
 [options.extras_require]
+pandoc =
+    py-pandoc
 dev =
     pytest
 

tox.ini

@@ -11,6 +11,7 @@ skip_missing_interpreters = True
 description = Run unit tests
 extras =
     dev
+    pandoc
 commands=
     pytest {posargs}