#513 error installing v0.22.1 on MacOS

[Daeho Ro]

Hello, when I install docutil v0.22.1, I got an error

  docutils-0.22.1/docutils/__init__.py: Failed to restore metadata: File exists
  tar: Error exit delayed from previous errors.
  Error: Failure while executing; `/usr/bin/env tar --extract --no-same-owner --file /Users/brew/Library/Caches/Homebrew/downloads/88b03c744685105eccb97d4a6655d840b7fed55a81342d1432838845ab291c6f--docutils-0.22.1.tar.gz --directory /private/tmp/homebrew-unpack-20250917-6599-dbea5b` exited with 1. Here's the output:

Some other package depending on this also occur same error.
Can you check?

Thanks,

[Xinyi Xu]

Hi, echo on this thread - there also seem to be another issue with 0.22.1 wheel, it ships an swp file that should ideally not be there.

$ python -m venv venv
$ . venv/bin/activate
(venv) $ pip install docutils --no-cache-dir
Collecting docutils
  Downloading docutils-0.22.1-py3-none-any.whl.metadata (15 kB)
Downloading docutils-0.22.1-py3-none-any.whl (638 kB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 638.5/638.5 kB 38.1 MB/s eta 0:00:00
Installing collected packages: docutils
Successfully installed docutils-0.22.1

[notice] A new release of pip is available: 24.2 -> 25.2
[notice] To update, run: pip install --upgrade pip
(venv) $ ls ./venv/lib/python3.12/site-packages/docutils -ltra
total 340
-rwxrwxrwx 1 maggie maggie  24576 Sep 19 10:53 .__init__.py.swp
-rwxrwxrwx 1 maggie maggie  12482 Sep 19 10:53 __init__.py
... removed unrelated logs

[Günter Milde]

The .__init__.py.swp file should definitely not be there...

... it seems this is not just another problem but the culprit.

[Günter Milde]

I cannot reproduce the install problem here. Installing Docutils 0.22.1 with pip into a
new created venv worked without problem, despite the spurious file.

What is the OS?
Which command was used for the install?
Was there any output after Here's the output:?
If you used pip, run it with increased verbosity and share the details:

pip install <package-name> --verbose

You may consider removing the spurious file

/docutils-0.22.1/docutils/.__init__.py.swp

from the wheel or tar.gz archive (or manually unpacking and then removing) and trying again.

[Daeho Ro]

MacOS with homebrew, during update some of packages.

1. snakemake depends on this docutils and the ci build error is here.

https://github.com/Homebrew/homebrew-core/actions/runs/17826985501/job/50682694634#step:3:4128

In this case, we keep the previous version and it passed the CI.

1. docutils itself

https://github.com/Homebrew/homebrew-core/actions/runs/17809144055/job/50651494614?pr=244510#step:3:51

Not sure how can I implement the patch.

[Günter Milde]

Thanks for the additional info.
It seems that install on MacOS (or just homebrew or snakemake, ...) trips over the spurious file while with Python's standard "pip" installment program or installing "by hand" the spurious file is just ignored.
We will release a new version without the spurious file ASAP.

[Günter Milde]

Docutils 0.22.2 is out (without the *.swp file).
@daeho-ro: Could you please try whether this solves the install problem?

[Daeho Ro]

Now it looks fine, thank you!

https://github.com/Homebrew/homebrew-core/pull/245109

[Günter Milde]

Fixed with release 0.22.2.
Thank you for report, analysis, and testing.