Skip to content

Commit

Permalink
Clarify that SQLAlchemy is only okay if using its ORM
Browse files Browse the repository at this point in the history
  • Loading branch information
jpmckinney committed Sep 11, 2020
1 parent 948c0f9 commit b0d6255
Showing 1 changed file with 1 addition and 1 deletion.
2 changes: 1 addition & 1 deletion docs/python/code.rst
Original file line number Diff line number Diff line change
Expand Up @@ -219,7 +219,7 @@ Web framework
Command-line interface
`Click <https://click.palletsprojects.com/>`__, unless a framework provides its own, like `Django <https://docs.djangoproject.com/en/3.0/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>`__.
Object Relational Mapper (ORM)
Django. Do not use `SQLAlchemy <https://www.sqlalchemy.org/>`__, except in low-level libraries with limited scope.
Django. If you don't need an ORM, use `psycopg2 <https://www.psycopg.org/docs/>`__. Do not use `SQLAlchemy <https://www.sqlalchemy.org/>`__, except in low-level libraries with limited scope *where an ORM is needed*.
HTTP library
`Requests <https://requests.readthedocs.io/>`__, unless a framework uses another, like Scrapy (Twisted).
HTML parsing
Expand Down

0 comments on commit b0d6255

Please sign in to comment.