[issue47138] Bump Sphinx or pin Jinja2 to fix docs build

2022-03-28 Thread Maciej Olko


Maciej Olko  added the comment:

I've update both PRs to contain the pin only.

--

___
Python tracker 
<https://bugs.python.org/issue47138>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue47138] Bump Sphinx or pin Jinja2 to fix docs build

2022-03-28 Thread Maciej Olko


Change by Maciej Olko :


--
pull_requests: +30232
pull_request: https://github.com/python/cpython/pull/32109

___
Python tracker 
<https://bugs.python.org/issue47138>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue47138] Bump Sphinx or pin Jinja2 to fix docs build

2022-03-28 Thread Maciej Olko


Change by Maciej Olko :


--
keywords: +patch
nosy: +Maciej Olko
nosy_count: 2.0 -> 3.0
pull_requests: +30231
stage:  -> patch review
pull_request: https://github.com/python/cpython/pull/32111

___
Python tracker 
<https://bugs.python.org/issue47138>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue45618] Documentation builds fail with Sphinx 3.2.1

2022-03-28 Thread Maciej Olko


Maciej Olko  added the comment:

> This really should be handled in a new issue since the original fixes for all 
> affected releases are already in the field.

Sorry, I got suggested too much with expected fix which is common for both of 
those issues. Shall I create a new issue?

> Moreover, we should be a bit careful about bumping the required Sphinx 
> version for older releases as this has caused problems for downstream 
> distributors of Python in the past. Can't we just pin the Jinja2 version for 
> current releases?

Didn't know about the problems for distributors. Definitely just pinning Jinja2 
is enough.

--

___
Python tracker 
<https://bugs.python.org/issue45618>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue45618] Documentation builds fail with Sphinx 3.2.1

2022-03-25 Thread Maciej Olko


Change by Maciej Olko :


--
pull_requests: +30194
pull_request: https://github.com/python/cpython/pull/32111

___
Python tracker 
<https://bugs.python.org/issue45618>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue45618] Documentation builds fail with Sphinx 3.2.1

2022-03-25 Thread Maciej Olko


Change by Maciej Olko :


--
pull_requests: +30186
stage: resolved -> patch review
pull_request: https://github.com/python/cpython/pull/32109

___
Python tracker 
<https://bugs.python.org/issue45618>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue45618] Documentation builds fail with Sphinx 3.2.1

2022-03-24 Thread Maciej Olko

Maciej Olko  added the comment:

After the Jinja version 3.1.0 release today [1], documentation builds fail for 
all stable branches. Sphinx in versions pinned on those branches fails with 
ImportError. [2]

Backporting 14a4fce457033412278ca9a056787db424310dc3 to 3.10 and 3.9 fixes the 
problem for them (build is successful with 4.2.0). For 3.8 and 3.7 pinning down 
Jinja is required (docs don't build smoothly with 4.2.0 for those branches).

Could some core developer help with the backports?

I am starting to work on PRs with pins for 3.8 and 3.7.


[1] https://jinja.palletsprojects.com/en/3.1.x/changes/#version-3-1-0
[2] % sphinx-build --version  
Traceback (most recent call last):
  File "…/cpython/Doc/./venv/bin/sphinx-build", line 5, in 
from sphinx.cmd.build import main
  File "…/cpython/Doc/venv/lib/python3.9/site-packages/sphinx/cmd/build.py", 
line 25, in 
from sphinx.application import Sphinx
  File "…/cpython/Doc/venv/lib/python3.9/site-packages/sphinx/application.py", 
line 42, in 
from sphinx.registry import SphinxComponentRegistry
  File "…/cpython/Doc/venv/lib/python3.9/site-packages/sphinx/registry.py", 
line 24, in 
from sphinx.builders import Builder
  File 
"…/cpython/Doc/venv/lib/python3.9/site-packages/sphinx/builders/__init__.py", 
line 26, in 
from sphinx.util import import_object, logging, rst, progress_message, 
status_iterator
  File "…/cpython/Doc/venv/lib/python3.9/site-packages/sphinx/util/rst.py", 
line 22, in 
from jinja2 import environmentfilter
ImportError: cannot import name 'environmentfilter' from 'jinja2' 
(…/cpython/Doc/venv/lib/python3.9/site-packages/jinja2/__init__.py)

--
resolution: fixed -> 
status: closed -> open
versions:  -Python 3.11, Python 3.6

___
Python tracker 
<https://bugs.python.org/issue45618>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue45618] Documentation builds fail with Sphinx 3.2.1

2021-10-27 Thread Maciej Olko


Change by Maciej Olko :


--
pull_requests: +27520
pull_request: https://github.com/python/cpython/pull/29256

___
Python tracker 
<https://bugs.python.org/issue45618>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue45618] Documentation builds fail with Sphinx 3.2.1

2021-10-27 Thread Maciej Olko


Maciej Olko  added the comment:

It occurs that the documentation builds without warnings on most recent Sphinx 
-- version 4.2.0. Probably we should bump the version in 3.11, 3.10 and 3.9 to 
4.2.0. That would enable us to remove the pin on docutils.

--

___
Python tracker 
<https://bugs.python.org/issue45618>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue45618] Documentation builds fail with Sphinx 3.2.1

2021-10-27 Thread Maciej Olko


Maciej Olko  added the comment:

I'm sorry for the confusion. I might have make more checking on my side before 
proposing a fix.

--

___
Python tracker 
<https://bugs.python.org/issue45618>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue45618] Documentation builds fail with Sphinx 3.2.1

2021-10-27 Thread Maciej Olko

Maciej Olko  added the comment:

For what it's worth I have just successfully built documentation on 3.7 and 3.6 
branches locally.  It looks like Sphinx 2.3.1 used there doesn't use this part 
of docutils API that have changed recently.

Sphinx 2.3.1 has requirement of "docutils>=0.12", just like 3.2.1.

We can pin docutils version to current (0.18) "just in case" to prevent a 
breakage in the future or do nothing – maybe it won't break – maybe the 
docutils API used is narrow enough.

--

___
Python tracker 
<https://bugs.python.org/issue45618>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue45618] Documentation builds fail with Sphinx 3.2.1

2021-10-26 Thread Maciej Olko


Change by Maciej Olko :


--
keywords: +patch
pull_requests: +27493
stage:  -> patch review
pull_request: https://github.com/python/cpython/pull/29230

___
Python tracker 
<https://bugs.python.org/issue45618>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue45618] Documentation builds fail with Sphinx 3.2.1

2021-10-26 Thread Maciej Olko


Maciej Olko  added the comment:

The pin can be removed after bumping Sphinx to at least 3.5.4, which introduced 
upper limit for docutils version.

https://github.com/sphinx-doc/sphinx/commit/9263eea38379822e053c67ad1d17036d724c5e41

--

___
Python tracker 
<https://bugs.python.org/issue45618>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue45618] Documentation builds fail with Sphinx 3.2.1

2021-10-26 Thread Maciej Olko


Change by Maciej Olko :


--
versions: +Python 3.11

___
Python tracker 
<https://bugs.python.org/issue45618>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue45618] Documentation builds fail with Sphinx 3.2.1

2021-10-26 Thread Maciej Olko


Change by Maciej Olko :


--
versions:  -Python 3.11, Python 3.6, Python 3.7, Python 3.8, Python 3.9

___
Python tracker 
<https://bugs.python.org/issue45618>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue45618] Documentation builds fail with Sphinx 3.2.1

2021-10-26 Thread Maciej Olko

New submission from Maciej Olko :

Since the release of Docutils 0.18 today building Python documentation fails.

In CPython repository we have Sphinx pinned to 3.2.1, which has too loose 
requirement for Docutils version in install_requires – docutils>=0.12.

Example of failing build: 
https://github.com/python/python-docs-pl/runs/4009459257.

My suggestion is to pin down docutils in docs requirements.

--
assignee: docs@python
components: Documentation
messages: 405060
nosy: Maciej Olko, docs@python
priority: normal
severity: normal
status: open
title: Documentation builds fail with Sphinx 3.2.1
type: crash
versions: Python 3.10, Python 3.11, Python 3.6, Python 3.7, Python 3.8, Python 
3.9

___
Python tracker 
<https://bugs.python.org/issue45618>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue42481] Add to pathlib function to check permission similar to os.access

2020-11-27 Thread Maciej Olko


Change by Maciej Olko :


--
nosy: +Maciej Olko

___
Python tracker 
<https://bugs.python.org/issue42481>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue41510] Mentions of pdb.set_trace() in library/functions and library/sys incorrectly states that set_trace expects no arguments

2020-08-08 Thread Maciej Olko


Change by Maciej Olko :


--
title: Mentions of pdb.set_trace() in library/functions and library/sys 
uncorrectly states that set_trace expects no arguments -> Mentions of 
pdb.set_trace() in library/functions and library/sys incorrectly states that 
set_trace expects no arguments

___
Python tracker 
<https://bugs.python.org/issue41510>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue41510] Mentions of pdb.set_trace() in library/functions and library/sys uncorrectly states that set_trace expects no arguments

2020-08-08 Thread Maciej Olko


New submission from Maciej Olko :

An argument was added to pdb.set_trace() in Python 3.7 and those fragments of 
documentation should have been updated:

library/functions.rst:120
> By default, sys.breakpointhook() calls pdb.set_trace() expecting no arguments.

library/sys.rst
> For example, the default binding (e.g. pdb.set_trace()) expects no arguments, 
> but you might bind it to a function that expects additional arguments 
> (positional and/or keyword).

--
assignee: docs@python
components: Documentation
messages: 375064
nosy: Maciej Olko, docs@python
priority: normal
severity: normal
status: open
title: Mentions of pdb.set_trace() in library/functions and library/sys 
uncorrectly states that set_trace expects no arguments
versions: Python 3.10, Python 3.7, Python 3.8, Python 3.9

___
Python tracker 
<https://bugs.python.org/issue41510>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

2020-04-07 Thread Maciej Olko


Change by Maciej Olko :


--
nosy: +Maciej Olko

___
Python tracker 
<https://bugs.python.org/issue40204>
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com