database-sql-local 0.0.1b3455__tar.gz

database_sql_local-0.0.1b3455/PKG-INFO

@@ -0,0 +1,21 @@
+Metadata-Version: 2.4
+Name: database-sql-local
+Version: 0.0.1b3455
+Summary: PyPI database-sql-local Python Package owned by Circlez.ai
+Home-page: https://github.com/circles-zone/database-sql-local-python-package
+Author: Circles
+Author-email: info@circlez.ai
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Description-Content-Type: text/markdown
+Requires-Dist: python-sdk-remote>=0.0.158
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: summary
+
+PyPI database-sql-local Python Package owned by Circlez.ai

database_sql_local-0.0.1b3455/README.md

@@ -0,0 +1,34 @@
+# database-sql-local
+
+Functions based on ANSI SQL which we can use from MySQL, PostgreSQL and any
+other database the org reads.
+
+A function here builds SQL text and its parameters and nothing else: no
+connection, no cursor, no database-specific syntax. Placeholders are `%s`, the
+DB-API parameter style of both `mysql-connector` and `psycopg2`, so the same
+condition goes to `GenericCRUD` on MySQL or to a PostgreSQL cursor unchanged.
+
+## Date ranges
+
+`get_datetime_range_overlap_where_and_params` - the rows whose time overlaps a
+`DatetimeRange`. A row with no end is taken to end when it starts.
+
+```python
+from database_sql_local.datetime_range_sql import get_datetime_range_overlap_where_and_params
+
+where, params = get_datetime_range_overlap_where_and_params(
+    datetime_range=datetime_range,
+    start_datetime_column_name="start_timestamp",
+    end_datetime_column_name="end_timestamp")
+event_dicts = events_local.select_multi_dict_by_where(where=where, params=params)
+```
+
+## Versions
+
+[pub] 0.0.1 Initial version (the python-package-template filled for this package)
+
+## Install dependencies
+
+It's advised to use venv.
+
+Run `pip install -r requirements.txt -r requirements-dev.txt` from the bash terminal.

database_sql_local-0.0.1b3455/database_sql_local/src/datetime_range_sql.py

@@ -0,0 +1,26 @@
+"""SQL conditions over a range of dates, the same on MySQL and PostgreSQL.
+
+A function here returns a WHERE condition and its parameters, ready for
+GenericCRUD's select_multi_dict_by_where(where=..., params=...) or for any
+DB-API cursor.execute(). It uses only ANSI SQL - comparisons and COALESCE - and
+%s placeholders, the parameter style of both mysql-connector and psycopg2.
+
+Column names are written into the SQL text, so pass the table's own column
+constants, never a value that came from a user.
+"""
+from python_sdk_remote.datetime_range import DatetimeRange
+
+
+def get_datetime_range_overlap_where_and_params(*, datetime_range: DatetimeRange,
+                                                start_datetime_column_name: str,
+                                                end_datetime_column_name: str) -> tuple[str, tuple]:
+    """The rows whose time overlaps the range.
+
+    A row overlaps when it starts no later than the range ends and ends no
+    earlier than the range starts. A row whose end is NULL is taken to end when
+    it starts, so a range that contains its start finds it.
+    """
+    where = (f"{start_datetime_column_name} <= %s AND "
+             f"COALESCE({end_datetime_column_name}, {start_datetime_column_name}) >= %s")
+    params = (datetime_range.end_datetime, datetime_range.start_datetime)
+    return where, params

database_sql_local-0.0.1b3455/database_sql_local.egg-info/PKG-INFO

@@ -0,0 +1,21 @@
+Metadata-Version: 2.4
+Name: database-sql-local
+Version: 0.0.1b3455
+Summary: PyPI database-sql-local Python Package owned by Circlez.ai
+Home-page: https://github.com/circles-zone/database-sql-local-python-package
+Author: Circles
+Author-email: info@circlez.ai
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Description-Content-Type: text/markdown
+Requires-Dist: python-sdk-remote>=0.0.158
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: summary
+
+PyPI database-sql-local Python Package owned by Circlez.ai

database_sql_local-0.0.1b3455/database_sql_local.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+setup.py
+database_sql_local.egg-info/PKG-INFO
+database_sql_local.egg-info/SOURCES.txt
+database_sql_local.egg-info/dependency_links.txt
+database_sql_local.egg-info/requires.txt
+database_sql_local.egg-info/top_level.txt
+database_sql_local/src/__init__.py
+database_sql_local/src/datetime_range_sql.py
+database_sql_local/src/py.typed

database_sql_local-0.0.1b3455/database_sql_local.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

database_sql_local-0.0.1b3455/database_sql_local.egg-info/requires.txt

@@ -0,0 +1 @@
+python-sdk-remote>=0.0.158

database_sql_local-0.0.1b3455/database_sql_local.egg-info/top_level.txt

@@ -0,0 +1 @@
+database_sql_local

database_sql_local-0.0.1b3455/pyproject.toml

@@ -0,0 +1,26 @@
+# This file should be in the future instead of setup.py
+# https://python-poetry.org/docs/pyproject
+# https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#license
+
+# This file is mandatory for the `poetry version patch`
+
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.pytest.ini_options]
+pythonpath = ["."]
+
+[tool.poetry]
+name = "database-sql-local"
+# I believe we are still using the version from setup.py and not from here until Potery will work
+version = "0.0.1" # https://pypi.org/project/database-sql-local/
+description = "database-sql-local Python Package"
+readme = "README.md"
+authors = [
+    "Circlez.ai <info@circlez.ai>",
+]
+
+[tool.poetry.dev-dependencies]
+pytest = "^8.0"
+pytest-cov = "^5.0"

database_sql_local-0.0.1b3455/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

database_sql_local-0.0.1b3455/setup.py

@@ -0,0 +1,38 @@
+import setuptools
+
+# Used by pypa/gh-action-pypi-publish. Lowercase, no underlines, no "main",
+# without the -python-package suffix.
+PACKAGE_NAME = "database-sql-local"
+
+# The import name, i.e., "import database_sql_local". It matches PACKAGE_NAME and
+# the on-disk directory, as every other package does.
+package_dir = PACKAGE_NAME.replace("-", "_")
+
+PACKAGE_DESCRIPTION = f"PyPI {PACKAGE_NAME} Python Package owned by Circlez.ai"
+
+setuptools.setup(
+    name=PACKAGE_NAME,
+    # Beta tag suffixed with the Jira Work Item ID, otherwise the PR number, so a
+    # version traces back to the PR that generated it.
+    version='0.0.1b3455',  # https://pypi.org/project/database-sql-local#history
+    author="Circles",
+    author_email="info@circlez.ai",
+    description=PACKAGE_DESCRIPTION,
+    long_description=PACKAGE_DESCRIPTION,
+    long_description_content_type='text/markdown',
+    url=f"https://github.com/circles-zone/{PACKAGE_NAME}-python-package",
+    packages=[package_dir],
+    package_dir={package_dir: f'{package_dir}/src'},
+    # py.typed marks the package as typed (PEP 561), so mypy reads these
+    # annotations in every consumer instead of falling back to Any.
+    package_data={package_dir: ['*.py', 'py.typed']},
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "Operating System :: OS Independent",
+    ],
+    # Do not add packages needed only for tests.
+    install_requires=[
+        # DatetimeRange, the range every date-range condition here takes
+        'python-sdk-remote>=0.0.158',
+    ]
+)