Consistency: apply codestyle formatting to docstring code snippets

[jayaddison]

Description

This is a pedantic/consistency follow-up from #1219: that change applied some black formatting to two code snippets, and this change applies that formatting to the remaining snippets in the codebase.

For each snippet, I extracted the code and applied formatting using black v23.1.0, then placed the results back into the source.

In one case there was an associated 'output' block, and in that case I re-ran the snippet code to update the results of that output too (this included a change-in-output thanks to a bugfix since the snippet was written, by the looks of it).

Checklist

This pull request is:

• A documentation / typographical error fix

[CaselIT]

thanks for the effort!

[sqla-tester]

OK, this is sqla-tester setting up my work on behalf of CaselIT to try to get revision cd65a45 of this pull request into gerrit so we can run tests and reviews and stuff

[sqla-tester]

New Gerrit review created for change cd65a45: https://gerrit.sqlalchemy.org/c/sqlalchemy/alembic/+/4566

[sqla-tester]

Federico Caselli (CaselIT) wrote:

only formatting of code inside the docs.

should be good to go once it passes the pipeline

View this in Gerrit at https://gerrit.sqlalchemy.org/c/sqlalchemy/alembic/+/4566

[CaselIT]

In one case there was an associated 'output' block, and in that case I re-ran the snippet code to update the results of that output too (this included a change-in-output thanks to a bugfix since the snippet was written, by the looks of it).

judging by the u there it seems the last time it was run was on python 2!

Thanks for updating it

[jayaddison]

You're welcome, and thanks - funny the things we notice and the things we don't :)

[jayaddison]

(if that was ambiguous: I didn't mean that there is anything else hidden in the changes - I was only surprised that I noticed the missing object reference and yet didn't notice the u prefix at all.. probably a result of seeing so many changesets where that exact difference occurs, often repetitively)

[sqla-tester]

Gerrit review https://gerrit.sqlalchemy.org/c/sqlalchemy/alembic/+/4566 has been merged. Congratulations! :)

[jayaddison]

Thank you, @CaselIT!

[CaselIT]

Thanks you for doing most of the work!

[jayaddison]

Thanks you for doing most of the work!

I'm fairly sure that you didn't intend this meaning, but the word 'most' made me double-check.. and I found that I missed a snippet within Operations.create_table.

(and, a smaller detail than that: one of the create_primary_key snippets could be simplified onto a single-line)

Is that worth a follow-up pull request?

[CaselIT]

I'm fairly sure that you didn't intend this meaning

sorry if I gave you that impression, with most I just meant that I though I added a changelog but apparently not, so I didn't do much here at all here :)

Is that worth a follow-up pull request?

Sure, if you have time it would be appreciated

[jayaddison]

I'm fairly sure that you didn't intend this meaning

sorry if I gave you that impression, with most I just meant that I though I added a changelog but apparently not, so I didn't do much here at all here :)

It's OK - I didn't read it that way, although am glad that it was worth checking. It would have been better for me to have noticed it myself before the first PR, of course!

Is that worth a follow-up pull request?

Sure, if you have time it would be appreciated

Great - yep, I'll provide a pull request in a few moments.