From 8c1f83ccfd3db509cc80d4b48f8c9c786757fe47 Mon Sep 17 00:00:00 2001
From: James McKinney <26463+jpmckinney@users.noreply.github.com>
Date: Sat, 28 Sep 2024 14:28:51 -0400
Subject: [PATCH] python/preferences: Add Polars and httpx

---
 docs/python/performance.rst | 5 +++++
 docs/python/preferences.rst | 6 ++++--
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/docs/python/performance.rst b/docs/python/performance.rst
index 937b8be..e4414f5 100644
--- a/docs/python/performance.rst
+++ b/docs/python/performance.rst
@@ -92,6 +92,11 @@ Optimizations
    .. Can search for class in:
       *.py,-commands/*,-migrations/*,-tests/*,-base_spiders/*,-spiders/*,-exceptions.py,-manage.py,-admin.py,-apps.py,-forms.py,-models.py,-routers.py,-views.py
 
+.. seealso::
+
+   -  `array — Efficient arrays of numeric values <https://docs.python.org/3/library/array.html>`__
+   -  `struct — Interpret bytes as packed binary data <https://docs.python.org/3/library/struct.html>`__
+
 Reference
 ---------
 
diff --git a/docs/python/preferences.rst b/docs/python/preferences.rst
index c7b4815..52f261f 100644
--- a/docs/python/preferences.rst
+++ b/docs/python/preferences.rst
@@ -23,9 +23,11 @@ Preferences
 Web framework
   `Django LTS <https://www.djangoproject.com/download/>`__, unless a newer version has desirable features. Do not use `Flask <https://flask.palletsprojects.com/>`__, except in limited circumstances like generating a static site with `Frozen-Flask <https://pythonhosted.org/Frozen-Flask/>`__.
 API
-  `Django REST Framework <https://www.django-rest-framework.org>`__ or `FastAPI <https://fastapi.tiangolo.com>`__. Do not use `Django Tastypie <https://django-tastypie.readthedocs.io/en/latest/>`__, which has fallen behind on Django and Python versions.
+  `Django REST Framework <https://www.django-rest-framework.org>`__ or `FastAPI <https://fastapi.tiangolo.com>`__. Do not use `Django Tastypie <https://django-tastypie.readthedocs.io/en/latest/>`__, which has at times fallen behind on Django and Python versions.
 Command-line interface
   `Click <https://click.palletsprojects.com/>`__, unless a framework provides its own, like `Django <https://docs.djangoproject.com/en/4.2/howto/custom-management-commands/>`__ or `Scrapy <https://docs.scrapy.org/en/latest/topics/commands.html#custom-project-commands>`__. Do not use `argparse <https://docs.python.org/3/library/argparse.html>`__.
+DataFrames
+  `Polars <https://pola.rs>`__, unless end-users are unfamiliar (`pandas <https://pandas.pydata.org/docs/>`__).
 Object Relational Mapper (ORM)
   Django. If you don't need an ORM, use `psycopg2 <https://www.psycopg.org/docs/>`__. Do not use `SQLAlchemy <https://www.sqlalchemy.org/>`__, except with FastAPI or in low-level libraries with limited scope *where an ORM is needed*.
 
@@ -34,7 +36,7 @@ Object Relational Mapper (ORM)
      Use ``psycopg2`` in production, not ``psycopg2-binary``, `as recommended <https://www.psycopg.org/docs/install.html#psycopg-vs-psycopg-binary>`__. :ref:`See instructions<requirements-psycopg2>`.
 
 HTTP client
-  `Requests <https://docs.python-requests.org/en/latest/>`__, unless a framework uses another, like Scrapy (Twisted).
+  `Requests <https://docs.python-requests.org/en/latest/>`__ for synchronous code and `httpx <https://www.python-httpx.org>`__ for asynchronous code, unless a framework uses another, like Scrapy (Twisted).
 HTML parsing
   `lxml <https://pypi.org/project/lxml/>`__. Do not use `BeautifulSoup <https://pypi.org/project/BeautifulSoup/>`__.
 Templating