sql-impressao 1.0.0__cp313-cp313-win_amd64.whl

rust-toolchain.toml

@@ -0,0 +1,2 @@
+[toolchain]
+channel = "1.81"

sql_impressao/__init__.py

@@ -0,0 +1,5 @@
+from .sql_impressao import *
+
+__doc__ = sql_impressao.__doc__
+if hasattr(sql_impressao, "__all__"):
+    __all__ = sql_impressao.__all__

sql_impressao-1.0.0.dist-info/METADATA

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: sql-impressao
+Version: 1.0.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Framework :: Django
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+License-File: LICENSE
+Summary: A SQL fingerprinter.
+Keywords: SQL
+Author-email: Adam Johnson <me@adamj.eu>
+Requires-Python: >=3.9
+Description-Content-Type: text/x-rst; charset=UTF-8
+Project-URL: Changelog, https://github.com/adamchainz/sql-impressao/blob/main/CHANGELOG.rst
+Project-URL: Funding, https://adamj.eu/books/
+Project-URL: Repository, https://github.com/adamchainz/sql-impressao
+
+=============
+sql-impressao
+=============
+
+.. image:: https://img.shields.io/github/actions/workflow/status/adamchainz/sql-impressao/main.yml.svg?branch=main&style=for-the-badge
+   :target: https://github.com/adamchainz/sql-impressao/actions?workflow=CI
+
+.. image:: https://img.shields.io/pypi/v/sql-impressao.svg?style=for-the-badge
+   :target: https://pypi.org/project/sql-impressao/
+
+.. image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=for-the-badge
+   :target: https://github.com/pre-commit/pre-commit
+   :alt: pre-commit
+
+Python bindings for `sql-fingerprint <https://github.com/adamchainz/sql-fingerprint>`__, a SQL fingerprinter.
+(*Impressão digital* is Portuguese for “fingerprint”.)
+
+A quick example:
+
+.. code-block:: python-console
+
+    >>> from sql_impressao import fingerprint_one
+    >>> fingerprint_one('SELECT a, b FROM cheeses WHERE origin = "France" ORDER BY age DESC')
+    'SELECT ... FROM cheeses WHERE ... ORDER BY ...'
+
+----
+
+**Improve your Django and Git skills** with `my books <https://adamj.eu/books/>`__.
+
+----
+
+Installation
+============
+
+With **pip**:
+
+.. code-block:: sh
+
+    python -m pip install sql-impressao
+
+Python 3.9 to 3.13 supported.
+
+Usage
+=====
+
+``fingerprint_one(sql: str, *, dialect: str | None = None) -> str``
+-------------------------------------------------------------------
+
+Generate the fingerprint for a single SQL string.
+
+``sql`` is the SQL string to fingerprint.
+It may contain multiple statements separated by semicolons.
+
+``dialect`` is an optional string that specifies the SQL dialect to use.
+Supported names include:
+
+* ``generic`` - the default, a generic SQL dialect.
+* ``mysql`` - MySQL dialect.
+* ``postgresql`` or ``postgres`` - PostgreSQL dialect.
+* ``sqlite`` - SQLite dialect.
+
+See the `source of the underlying function <https://github.com/apache/datafusion-sqlparser-rs/blob/776b10afe608a88811b807ab795831d55f186ee3/src/dialect/mod.rs#L1038-L1059>`__ for a full list.
+
+Example:
+
+.. code-block:: python
+
+    from sql_impressao import fingerprint_one
+
+    sql = 'SELECT a, b FROM cheeses WHERE origin = "France" ORDER BY age DESC'
+    fingerprint = fingerprint_one(sql)
+    assert fingerprint == "SELECT ... FROM cheeses WHERE ... ORDER BY ..."
+
+``fingerprint_many(sql: list[str], *, dialect: str | None = None) -> list[str]``
+--------------------------------------------------------------------------------
+
+Generate the fingerprints for a list of SQL strings.
+Doing so for a batch of strings allows sharing some state, such as savepoint ID aliases.
+
+``sql`` is a list of SQL strings to fingerprint.
+Each string may contain multiple statements separated by semicolons.
+
+``dialect`` is an optional string that specifies the SQL dialect to use, as above.
+
+Example:
+
+.. code-block:: python
+
+    from sql_impressao import fingerprint_many
+
+    sqls = ["SELECT a, b FROM c", "SELECT b, c FROM d"]
+    fingerprints = fingerprint_many(sqls)
+    assert fingerprints == ["SELECT ... FROM c", "SELECT ... FROM d"]
+

sql_impressao-1.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+sql_impressao-1.0.0.dist-info/METADATA,sha256=u_W-jW4yjy3FCWXZ6pudI01FBjWMZ1bAKHBLNgsT74Q,4154
+sql_impressao-1.0.0.dist-info/WHEEL,sha256=6gg8M7kMeWmDzkhJuJzWLhBYdt7OGDF81wlSJjN85_E,96
+sql_impressao-1.0.0.dist-info/licenses/LICENSE,sha256=Y8m99VQIwLGhEysJgQo8isGs30MVhcrkOFklqK9C2ik,1090
+rust-toolchain.toml,sha256=feZgzJbUe2qE8vLd6V0CevHqfgLedEINmW2fBFdp0qk,31
+sql_impressao/__init__.py,sha256=P-j0dQhlhHg9uiny7r5GqlhTRNFwasYLGLA9kjAc0sU,135
+sql_impressao/sql_impressao.cp313-win_amd64.pyd,sha256=9mi9LUHNMyeq9cOSdc-RDHsi1U-xW69mE2ssXcSzkHE,4707328
+sql_impressao-1.0.0.dist-info/RECORD,,

sql_impressao-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.8.3)
+Root-Is-Purelib: false
+Tag: cp313-cp313-win_amd64

sql_impressao-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Adam Johnson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.