projectmesa / mesa

Mesa is an open-source Python library for agent-based modeling, ideal for simulating complex systems and exploring emergent behaviors.
https://mesa.readthedocs.io
Apache License 2.0
2.43k stars 874 forks source link

Fix codespell build for tutorial docs #1661

Closed jackiekazil closed 1 year ago

jackiekazil commented 1 year ago

Not sure if this is possible, but codespell will pick up image text and try to suggest text edits and says the build is broken. Hoping there is a setting somewhere that we can add to ignore the image text.

Here is an example: https://github.com/projectmesa/mesa/pull/1656/files#diff-732a7eb31fbbd25075ee965837dc0092fb53c2cb64c068e60392d9bf69d9f9bbR877

Screenshot 2023-04-25 at 12 17 29 PM Screenshot 2023-04-25 at 12 26 06 PM
jackiekazil commented 1 year ago

Build is fixed... not ideal, but fixed. Codespell did not do what we wanted it to. Thank you @catherinedevlin @martin-martin @glnnlhmn for all scrubbing in.

@rht @tpike3 @wang-boyu - we should discuss during may meeting.

rht commented 1 year ago

I looked around if anyone had done this:

If the issue with ignoring png blobs is fixed, it would be a solution that can be applied to other repos containing Jupyter notebooks.

Also worth trying: https://github.com/crate-ci/typos, which is much faster than codespell.

jackiekazil commented 1 year ago

For tracking -- the ticket was moved here: https://github.com/codespell-project/actions-codespell/issues/42

rht commented 1 year ago

Since #1694, the .ipynb outputs are always cleared, not committed to the repo. As such, there should be no more base64-encoded pngs in the repo. We should be able to re-enable codespell again.

jackiekazil commented 1 year ago

@rht --- I have a test branch for another ticket and it looks like the fix for notebooks broke the build - https://github.com/projectmesa/mesa/pull/1696/files

rht commented 1 year ago

For some reason the output for intro_tutorial.ipynb hasn't been cleared. Will clear it now.

rht commented 1 year ago

I know why, it's because #1665 was merged into doc_builds instead of main.