remote/sqlite-utils
1
0
Fork 0
mirror of https://github.com/simonw/sqlite-utils.git synced 2026-09-16 21:44:10 +02:00
Code Issues Projects Releases Packages Wiki Activity

Merge bcbda4a326 into a947dc6739

Browse source
This commit is contained in:
sh3ff 2026-07-14 07:34:28 +00:00 • committed by GitHub
commit b18796aea9
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 29 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

29
sqlite_utils/db.py
View file

@ -1018,6 +1018,16 @@ class Database:
) )
def quote_default_value(self, value: str) -> str: def quote_default_value(self, value: str) -> str:
"""
Return a SQL-safe representation of a column default value.
Already-quoted string literals and the SQLite special keywords
``CURRENT_TIME``, ``CURRENT_DATE``, and ``CURRENT_TIMESTAMP`` are
returned unchanged. Expressions that end in ``)`` are wrapped in
parentheses. All other values are passed through :meth:`quote`.
:param value: The default value to format.
"""
if any( if any(
[ [
str(value).startswith("'") and str(value).endswith("'"), str(value).startswith("'") and str(value).endswith("'"),
@ -1120,6 +1130,12 @@ class Database:
@property @property
def supports_on_conflict(self) -> bool: def supports_on_conflict(self) -> bool:
"""
Return ``True`` if the connected SQLite version supports upserts via
``INSERT INTO ... ON CONFLICT DO UPDATE`` (requires SQLite 3.24+).
The result is cached on the instance after the first call.
"""
# SQLite's upsert is implemented as INSERT INTO ... ON CONFLICT DO ... # SQLite's upsert is implemented as INSERT INTO ... ON CONFLICT DO ...
if not hasattr(self, "_supports_on_conflict"): if not hasattr(self, "_supports_on_conflict"):
table_name = "t{}".format(secrets.token_hex(16)) table_name = "t{}".format(secrets.token_hex(16))
@ -1243,6 +1259,12 @@ class Database:
def execute_returning_dicts( def execute_returning_dicts(
self, sql: str, params: Optional[Union[Sequence, Dict[str, Any]]] = None self, sql: str, params: Optional[Union[Sequence, Dict[str, Any]]] = None
) -> List[dict]: ) -> List[dict]:
"""
Execute a SQL query and return the results as a list of dictionaries.
:param sql: SQL query to execute.
:param params: Optional parameters to pass to the query.
"""
return list(self.query(sql, params)) return list(self.query(sql, params))
def resolve_foreign_keys( def resolve_foreign_keys(
@ -1996,6 +2018,13 @@ class Queryable:
return self.db.execute(sql, where_args or []).fetchone()[0] return self.db.execute(sql, where_args or []).fetchone()[0]
def execute_count(self) -> int: def execute_count(self) -> int:
"""
Return the total number of rows in this table or view.
.. deprecated::
Use :meth:`count_where` or the :attr:`count` property instead.
Kept for backwards compatibility only.
"""
# Backwards compatibility, see https://github.com/simonw/sqlite-utils/issues/305#issuecomment-890713185 # Backwards compatibility, see https://github.com/simonw/sqlite-utils/issues/305#issuecomment-890713185
return self.count_where() return self.count_where()