Re: [sphinx-users] Re: ANN: Sphinx-4.1.0 is out

2021-07-12 Thread Luc Saffre
On 13.07.21 00:40, jfbu wrote:
> pip install -U sphinxcontrib.serializinghtml
>>
>> and perhaps same with sphinxcontrib.htmlhelp as I see I updated both
>> on June 13
>>

Yes, this fixed my problems. Great! Thanks!

Luc

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sphinx-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/45ca7f2c-bd3f-5334-538a-1ed63ec27913%40gmail.com.


[sphinx-users] Re: ANN: Sphinx-4.1.0 is out

2021-07-12 Thread jfbu

Le 12/07/2021 à 23:25, jfbu a écrit :

Le 12/07/2021 à 23:20, jfbu a écrit :

Le 11/07/2021 à 20:40, Luc Saffre a écrit :

After upgrading, I have the following traceback and in all my doctrees,
and I have no idea why. Neither "epub3" nor "RemovedInSphinx40Warning"
occur in any of my source files. Any hints?

Luc


Hi Luc

can you try

pip install -U sphinxcontrib.serializinghtml

in your virtual env ?


and perhaps same with sphinxcontrib.htmlhelp as I see I updated both on June 13

Requirement already up-to-date: sphinxcontrib.htmlhelp in 
./Downloads/.venv38/lib/python3.8/site-packages (2.0.0)



And I can confirm looking at old virtual environment I had still on my disk 
that its sphinxcontrib.serializinghtml (version 1.1.4) and .htmlhelp (version 
1.0.3) __init.py each contain

from sphinx.deprecation import RemovedInSphinx40Warning

which triggers the error you see


I did not report it to Sphinx upstream because I felt I had messed around with 
my git clone based pip install -e approach to Sphinx installating in virtual env

so I don't know if something is wrong in handling of dependencies

hope it helps





I think I encountered at my locale the same or similar
issue as yours, after having remained inactive with sphinx
for a while and trying out Sphinx 4.0.0

it got fixed by the above step (after having wasted some time in vain
looking through Sphinx sources for the cause)

fwiw at my locale I get this currently

Requirement already up-to-date: sphinxcontrib.serializinghtml in 
./path/to/.venv38/lib/python3.8/site-packages (1.1.5)

Jean-François




Invoke sphinx-build -b html -T -d
/home/luc/mypy/lino_local/jsvv/docs/.build/.doctrees -W --keep-going .
/home/luc/mypy/lino_local/jsvv/docs/.build
Running Sphinx v4.1.0
loading translations [et]... done

Traceback (most recent call last):
   File
"/home/luc/virtualenvs/py3/lib/python3.6/site-packages/sphinx/registry.py",
line 429, in load_extension
 mod = import_module(extname)
   File "/home/luc/virtualenvs/py3/lib/python3.6/importlib/__init__.py",
line 126, in import_module
 return _bootstrap._gcd_import(name[level:], package, level)
   File "", line 994, in _gcd_import
   File "", line 971, in _find_and_load
   File "", line 955, in _find_and_load_unlocked
   File "", line 665, in _load_unlocked
   File "", line 678, in exec_module
   File "", line 219, in
_call_with_frames_removed
   File
"/home/luc/virtualenvs/py3/lib/python3.6/site-packages/sphinx/builders/epub3.py",
line 18, in 
 from sphinx.builders import _epub_base
   File
"/home/luc/virtualenvs/py3/lib/python3.6/site-packages/sphinx/builders/_epub_base.py",
line 23, in 
 from sphinx.builders.html import BuildInfo, StandaloneHTMLBuilder
   File
"/home/luc/virtualenvs/py3/lib/python3.6/site-packages/sphinx/builders/html/__init__.py",
line 1288, in 
 import sphinxcontrib.serializinghtml  # NOQA
   File
"/home/luc/virtualenvs/py3/lib/python3.6/site-packages/sphinxcontrib/serializinghtml/__init__.py",
line 16, in 
 from sphinx.deprecation import RemovedInSphinx40Warning,
deprecated_alias
ImportError: cannot import name 'RemovedInSphinx40Warning'

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
   File
"/home/luc/virtualenvs/py3/lib/python3.6/site-packages/sphinx/cmd/build.py",
line 279, in build_main
 args.tags, args.verbosity, args.jobs, args.keep_going)
   File
"/home/luc/virtualenvs/py3/lib/python3.6/site-packages/sphinx/application.py",
line 233, in __init__
 self.setup_extension(extension)
   File
"/home/luc/virtualenvs/py3/lib/python3.6/site-packages/sphinx/application.py",
line 393, in setup_extension
 self.registry.load_extension(self, extname)
   File
"/home/luc/virtualenvs/py3/lib/python3.6/site-packages/sphinx/registry.py",
line 433, in load_extension
 err) from err
sphinx.errors.ExtensionError: Could not import extension
sphinx.builders.epub3 (exception: cannot import name
'RemovedInSphinx40Warning')

Extension error:
Could not import extension sphinx.builders.epub3 (exception: cannot
import name 'RemovedInSphinx40Warning')
C


On 11.07.21 20:29, Komiya Takeshi wrote:

Hi all,

Today, we released Sphinx-4.1.0. It contains many improvements and
bug fixes.

For more detail, please check the CHANGES file:
https://github.com/sphinx-doc/sphinx/blob/4.1.x/CHANGES

Enjoy documentation!

Thanks,
Takeshi KOMIYA












--
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sphinx-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/scics8%248kj%241%40ciao.gmane.io.


[sphinx-users] Re: ANN: Sphinx-4.1.0 is out

2021-07-12 Thread jfbu

Le 12/07/2021 à 23:20, jfbu a écrit :

Le 11/07/2021 à 20:40, Luc Saffre a écrit :

After upgrading, I have the following traceback and in all my doctrees,
and I have no idea why. Neither "epub3" nor "RemovedInSphinx40Warning"
occur in any of my source files. Any hints?

Luc


Hi Luc

can you try

pip install -U sphinxcontrib.serializinghtml

in your virtual env ?


and perhaps same with sphinxcontrib.htmlhelp as I see I updated both on June 13

Requirement already up-to-date: sphinxcontrib.htmlhelp in 
./Downloads/.venv38/lib/python3.8/site-packages (2.0.0)



I think I encountered at my locale the same or similar
issue as yours, after having remained inactive with sphinx
for a while and trying out Sphinx 4.0.0

it got fixed by the above step (after having wasted some time in vain
looking through Sphinx sources for the cause)

fwiw at my locale I get this currently

Requirement already up-to-date: sphinxcontrib.serializinghtml in 
./path/to/.venv38/lib/python3.8/site-packages (1.1.5)

Jean-François




Invoke sphinx-build -b html -T -d
/home/luc/mypy/lino_local/jsvv/docs/.build/.doctrees -W --keep-going .
/home/luc/mypy/lino_local/jsvv/docs/.build
Running Sphinx v4.1.0
loading translations [et]... done

Traceback (most recent call last):
   File
"/home/luc/virtualenvs/py3/lib/python3.6/site-packages/sphinx/registry.py",
line 429, in load_extension
 mod = import_module(extname)
   File "/home/luc/virtualenvs/py3/lib/python3.6/importlib/__init__.py",
line 126, in import_module
 return _bootstrap._gcd_import(name[level:], package, level)
   File "", line 994, in _gcd_import
   File "", line 971, in _find_and_load
   File "", line 955, in _find_and_load_unlocked
   File "", line 665, in _load_unlocked
   File "", line 678, in exec_module
   File "", line 219, in
_call_with_frames_removed
   File
"/home/luc/virtualenvs/py3/lib/python3.6/site-packages/sphinx/builders/epub3.py",
line 18, in 
 from sphinx.builders import _epub_base
   File
"/home/luc/virtualenvs/py3/lib/python3.6/site-packages/sphinx/builders/_epub_base.py",
line 23, in 
 from sphinx.builders.html import BuildInfo, StandaloneHTMLBuilder
   File
"/home/luc/virtualenvs/py3/lib/python3.6/site-packages/sphinx/builders/html/__init__.py",
line 1288, in 
 import sphinxcontrib.serializinghtml  # NOQA
   File
"/home/luc/virtualenvs/py3/lib/python3.6/site-packages/sphinxcontrib/serializinghtml/__init__.py",
line 16, in 
 from sphinx.deprecation import RemovedInSphinx40Warning,
deprecated_alias
ImportError: cannot import name 'RemovedInSphinx40Warning'

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
   File
"/home/luc/virtualenvs/py3/lib/python3.6/site-packages/sphinx/cmd/build.py",
line 279, in build_main
 args.tags, args.verbosity, args.jobs, args.keep_going)
   File
"/home/luc/virtualenvs/py3/lib/python3.6/site-packages/sphinx/application.py",
line 233, in __init__
 self.setup_extension(extension)
   File
"/home/luc/virtualenvs/py3/lib/python3.6/site-packages/sphinx/application.py",
line 393, in setup_extension
 self.registry.load_extension(self, extname)
   File
"/home/luc/virtualenvs/py3/lib/python3.6/site-packages/sphinx/registry.py",
line 433, in load_extension
 err) from err
sphinx.errors.ExtensionError: Could not import extension
sphinx.builders.epub3 (exception: cannot import name
'RemovedInSphinx40Warning')

Extension error:
Could not import extension sphinx.builders.epub3 (exception: cannot
import name 'RemovedInSphinx40Warning')
C


On 11.07.21 20:29, Komiya Takeshi wrote:

Hi all,

Today, we released Sphinx-4.1.0. It contains many improvements and
bug fixes.

For more detail, please check the CHANGES file:
https://github.com/sphinx-doc/sphinx/blob/4.1.x/CHANGES

Enjoy documentation!

Thanks,
Takeshi KOMIYA









--
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sphinx-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/scic00%24g5p%241%40ciao.gmane.io.


[sphinx-users] Decorators

2021-07-12 Thread Sambid Wasti
Hi all, 

I have been trying to find help in trying to document a decorated function. 
I cant seem to find a way to document the function. Looking online or 
search through email, I am unable to find solution to this. Can anyone 
guide me in the right direction. 

I am working with dash, that has various callback decorators.

@decorator()
def working_function(..):
   """ Working function
  
  """
 functional stuff.

Here it skips the working_function.

Best,
Sam

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sphinx-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/58c6ecab-d2ec-40b2-9e1b-101017613523n%40googlegroups.com.