Improve parse error readability

[Chandana098-learn]

Closes #4820
Closes #4992

I updated the parse error message while still keeping it in readable format.
New Change: Now it shows the error in multiple lines , points to the error position with ^.

[cobaltt7]

Thanks for the PR! Can you add an entry to CHANGES.md and run Black on itself?

[github-actions]

diff-shades results comparing this PR (3e181f2) to main (9e969dd):

--preview style: no changes

--stable style: no changes

---

What is this? | Workflow run | diff-shades documentation

[cobaltt7]

Should be the last things:

Please update the sample error messages in the docs
https://github.com/psf/black/blob/813924367f45592723fa9a2e217c07477822094a/docs/usage_and_configuration/the_basics.md#L356
https://github.com/psf/black/blob/813924367f45592723fa9a2e217c07477822094a/docs/usage_and_configuration/the_basics.md#L371
https://github.com/psf/black/blob/813924367f45592723fa9a2e217c07477822094a/docs/usage_and_configuration/the_basics.md#L446

Please update the tests:
https://github.com/psf/black/blob/813924367f45592723fa9a2e217c07477822094a/tests/test_black.py#L1028
https://github.com/psf/black/blob/813924367f45592723fa9a2e217c07477822094a/tests/test_black.py#L1988
https://github.com/psf/black/blob/813924367f45592723fa9a2e217c07477822094a/tests/test_format.py#L92

[Chandana098-learn]

Thanks for the review! I’ll complete the remaining changes you mentioned (docs and tests) by today. Apologies for the delay , I’ll update everything by tonight.

[cobaltt7]

Hey @Chandana098-learn, are able to make those changes?

[Chandana098-learn]

Hey! I’ve been working on the changes, but I’m currently facing issues with passing the flake8 and pytest checks. I’m still in my 1st year and learning, so I’d appreciate any guidance you can share. I’ll keep working on it and update you soon. Thanks!

[cobaltt7]

Those issues should be fixed by my previous review comments, so focus on those first

[Chandana098-learn]

hello, i have reviewed the changes. please look into it.

[Chandana098-learn]

Please check the changes you asked for

[Chandana098-learn]

is there anything i need to do right now?

[cobaltt7]

Nope! It looks like some things were messed up with the markdown formatting, but I fixed them. Just waiting for CI to pass and I can merge. Thanks for the contribution!

[Chandana098-learn]

Thank you for the review and guidance!