Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Enable CI checkers #3160

Open
wants to merge 3 commits into
base: master
Choose a base branch
from

Conversation

electrocucaracha
Copy link

PySpelling and rstcheck are tools that can be useful to detect spelling and syntax issues in documentation. This PR enables them as part of the docs Tox environment.

Copy link
Collaborator

@collivier collivier left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi Victor,

Could u switch to :ref:`ref_arch_openstack:chapters/chapter08:conformance` ?
RC1 is merged into RA1 for next GSMA update.

@collivier
Copy link
Collaborator

@electrocucaracha we use jenkins to do that (see verification here). The issue is the main doc tox is far too permissive...

Copy link
Collaborator

@CsatariGergely CsatariGergely left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, I think we pretty match need something like this in all of the docs.

I've just blindly ran a tox -re docs on this branch and I got this error:

docs run-test: commands[0] | bash -c 'find /home/csatari/work/anuket/CNTT -not -path /home/csatari/work/anuket/CNTT/.tox/\* -name \*.rst -type f -print0 | xargs -0 rstcheck'
Traceback (most recent call last):
  File "/home/csatari/work/anuket/CNTT/.tox/docs/bin/rstcheck", line 5, in <module>
    from rstcheck._cli import main
  File "/home/csatari/work/anuket/CNTT/.tox/docs/lib/python3.9/site-packages/rstcheck/_cli.py", line 7, in <module>
    from rstcheck_core import _extras, config as config_mod, runner
  File "/home/csatari/work/anuket/CNTT/.tox/docs/lib/python3.9/site-packages/rstcheck_core/config.py", line 10, in <module>
    import pydantic
  File "pydantic/__init__.py", line 2, in init pydantic.__init__
  File "pydantic/dataclasses.py", line 52, in init pydantic.dataclasses
    #   +--- init= parameter
ImportError: cannot import name dataclass_transform
ERROR: InvocationError for command /usr/bin/bash -c 'find /home/csatari/work/anuket/CNTT -not -path /home/csatari/work/anuket/CNTT/.tox/\* -name \*.rst -type f -print0 | xargs -0 rstcheck' (exited with code 123)

Is this something in my environment or some more generic issue?

Kubernetes
Lakelse
OpenStack
sexualized
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I do not know what is the use of this file, but this word is a bit strange here. ..

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's part of the code of conduct document

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That is clear. I just do not know if .worldlist.txt contains words what we would like to allow, like Baraque or words what we would like to avoid.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, that list contains the additional words not included in the standard English Aspell dictionary.

tox.ini Show resolved Hide resolved
@collivier
Copy link
Collaborator

collivier commented Dec 16, 2022

If the community asks to merge the duplicated PR fixing the same refs as here. This PR can be safely closed.
The CI part is already done via Jenkins and LFN resources.

PySpelling is a python module for spell checking. It consumes Aspell or
Hunspell checking tools to catch misspelled words. This can be useful
during the core review.

Signed-off-by: Victor Morales <[email protected]>
This tool checks reStructuredText syntax helping to detect non-trivial
documentation issues.

Signed-off-by: Victor Morales <[email protected]>
Signed-off-by: Victor Morales <[email protected]>
@electrocucaracha
Copy link
Author

Thanks, I think we pretty match need something like this in all of the docs.

I've just blindly ran a tox -re docs on this branch and I got this error:

docs run-test: commands[0] | bash -c 'find /home/csatari/work/anuket/CNTT -not -path /home/csatari/work/anuket/CNTT/.tox/\* -name \*.rst -type f -print0 | xargs -0 rstcheck'
Traceback (most recent call last):
  File "/home/csatari/work/anuket/CNTT/.tox/docs/bin/rstcheck", line 5, in <module>
    from rstcheck._cli import main
  File "/home/csatari/work/anuket/CNTT/.tox/docs/lib/python3.9/site-packages/rstcheck/_cli.py", line 7, in <module>
    from rstcheck_core import _extras, config as config_mod, runner
  File "/home/csatari/work/anuket/CNTT/.tox/docs/lib/python3.9/site-packages/rstcheck_core/config.py", line 10, in <module>
    import pydantic
  File "pydantic/__init__.py", line 2, in init pydantic.__init__
  File "pydantic/dataclasses.py", line 52, in init pydantic.dataclasses
    #   +--- init= parameter
ImportError: cannot import name dataclass_transform
ERROR: InvocationError for command /usr/bin/bash -c 'find /home/csatari/work/anuket/CNTT -not -path /home/csatari/work/anuket/CNTT/.tox/\* -name \*.rst -type f -print0 | xargs -0 rstcheck' (exited with code 123)

Is this something in my environment or some more generic issue?

Maybe it's only in your environment, not sure if you have to upgrade your tox package version.

Copy link
Collaborator

@collivier collivier left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Because of RTD forcing the use of .readthedocs.yaml, we don't have another choice than splitting the git repository per stream. This PR must be applied on next RM's git repository and not here.

Everything is already ready on my own repositories but sadly I don't have the rights needed on anuket-project organization. Please give me them to complete the migration.

Be free to ask for any detail about the migration during a Weekly Technical meeting.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants