blog(post): python3 tools 2024 edition

_posts/2021-03-06-how-i-use-black-flake8-and-isort-to-format-python2-code.md

@@ -35,7 +35,7 @@ Let's explain each option.
 - `-l` or `--line-length`: How many characters per line to allow. [default: 88]
 - `-t` or `--target-version`: Python versions that should be supported by Black's output. [default: per-file auto-detection]
 
-Fairly simple. Allow `79` characters per line, and use `py27` as the targetted version.
+Fairly simple. Allow `79` characters per line, and use `py27` as the targeted version.
 
 ### isort
 

_posts/2024-03-01-python-3-tools-i-use-for-my-python-2-projects-2024-edition.md

@@ -0,0 +1,106 @@
+---
+layout: post
+title: Python 3 tools I use for my Python 2 projects - 2024 edition
+subtitle: Fighting to keep Python 2 alive
+tags:
+- coding standards
+- java
+- jython
+- python
+date: 2024-03-01 12:56 -0800
+---
+## TOC
+
+- [Introduction](#introduction)
+- [Background](#background)
+- [The Python 3 toolset](#the-python-3-toolset)
+- [Which Python 3?](#which-python-3)
+- [Packaging and publishing](#packaging-and-publishing)
+- [CI/CD](#cicd)
+- [Conclusion](#conclusion)
+
+## Introduction
+
+Welcome to part 5 on coding standards and code quality:
+
+- [79 characters]({{ site.url }}/2020/12/22/79-characters)
+- [How I use black, flake8 and isort to format Python2 code]({{ site.url }}/2021/03/06/how-i-use-black-flake8-and-isort-to-format-python2-code)
+- [pre-commit.ci and pydocstyle join the family]({{ site.url }}/2021/06/21/pre-commit-ci-and-pydocstyle-join-the-family/)
+- [Of camels and snakes]({{ site.url }}/2021/06/26/of-camels-and-snakes/)
+
+While I still use the same tools I listed [here]({{ site.url }}/2021/03/06/how-i-use-black-flake8-and-isort-to-format-python2-code), I will go over tools I am currently using.
+
+## Background
+
+I still actively work on multiple Python 2 packages because they're targeted at Ignition Developers, and Ignition relies on Jython 2.7 for scripting, and while some may find this a bit restricting, this has forced me to be more creative when I am not able to find a pure Python 2 module/library I can always look into Java 11 to assist. For example, I provided some feedback on a solution for monitoring remaining drive space where `java.io.File` and `java.net.InetAddress` have become very useful.
+
+>Eventhough we don't use the most recent version of Python, I believe that it is within these restrictions (especially because we're using Jython) that we have the opportunity to demonstrate that even being limited by it, we are capable of producing applications of the highest level.
+>
+>Anyone out there can just simply install `pandas` and `numpy`, but we have the opportunity to explore more options and even come up with our own.
+
+I've seen Python 3 projects where they use the `requests` library only for `POST`, while I was able to explore `urllib2` for doing exactly that.
+
+## The Python 3 toolset
+
+My tools can be grouped into the following categories:
+
+- Formatters
+  - `black`
+  - `docformatter`
+  - `isort`
+  - `sort-all`
+  - `ssort`
+- Linters
+  - `flake8==5.0.4`
+  - `pydocstyle`
+  - `pylint`
+  - `sourcery-cli`
+- Type checkers
+  - `mypy[python2]==0.971`
+- Automation
+  - `tox`
+    - With the following recommendation from tox.wiki on [testing end-of-life Python versions](https://tox.wiki/en/latest/faq.html#testing-end-of-life-python-versions)
+  - `nox`
+    - I tried it, but I couldn't make it work with private repositories in Azure DevOps. See: [wntrblm/nox#709](https://github.com/wntrblm/nox/issues/709).
+- Testing
+  - `pytest`
+- Packaging and publishing
+  - `build`
+  - `twine`
+- Package management
+  - `pip-tools`
+- Others
+  - `check-jsonschema`
+  - `commitizen`
+  - `pipx`
+  - `pre-commit`
+
+## Which Python 3?
+
+As of today, Python has five active releases: 3.8, 3.9, and 3.10 in the "security fixes only" where no binary installers are provided, 3.11, and 3.12.
+
+While in the past I have written about [typing]({{ site.url }}/tags/#typing), I have not clarified which Python 3 version I am using to install and run `mypy`; so let's clear that out.
+
+I had been using Python 3.10 for a while, and when 3.11 was released I ran into issues when I tried installing `mypy[python2]==0.971`, which I vaguely remember were related with `typed_ast`. So for the longest time I didn't go back and test 3.11, and I even started creating a Python 3.10 [installer](https://github.com/coatl-dev/cpython/releases) starting with 3.10.12, as no binary installer was provided.
+
+The same thing happened when Python 3.12 was released, but I have recently tested 3.12.2 and I am happy to say that my CI is running 3.12.
+
+As of the time of the posting of this article, `mypy[python2]==0.971` fails to install on 3.13.0a4.
+
+## Packaging and publishing
+
+On my previous [post]({{ site.url }}/2023/04/29/ci-cd-the-april-2023-python2-apocalypse/) I wrote about how I was expecting GitHub to keep Python 2.7.18 in their `ubuntu-20.04`'s tool cache until EOL, but they have decided to remove it on May 15, 2023.
+
+In all of my projects I depend on reusable workflows I have created under the `coatl-dev` GitHub organization, which can be found [here](https://github.com/coatl-dev/workflows), and I am using the [`pypi-upload`](https://github.com/coatl-dev/workflows#githubworkflowspypi-uploadyml) reusable workflow for my Python 2 and 3 packages.
+
+## CI/CD
+
+Finally, CI/CD. As previously mentioned, I have created reusable [workflows](https://github.com/coatl-dev/workflows) and GitHub [actions](https://github.com/coatl-dev/actions), which I am using accross multiple project in both the [ignition-api](https://github.com/ignition-api) and [ignition-incendium](https://github.com/ignition-incendium) GitHub organizations.
+
+But most importantly, I created a Docker image named [six](https://hub.docker.com/r/coatldev/six), based on Ubuntu 22.04 with Python 2.7 and 3 pre-installed, to overcome the Python 2 apocalypse.
+
+## Conclusion
+
+As you may have realized, necessity is the mother of invention. Feel free to use what I've created.
+
+Thanks for reading.