rdbpython 0.0.1__tar.gz → 0.2.1__tar.gz

rdbpython-0.2.1/LICENSE.md

@@ -0,0 +1,21 @@
+# The MIT License (MIT)
+
+Copyright (c) 2025 Gor Arakelyan
+
+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.

rdbpython-0.2.1/MANIFEST.in

@@ -0,0 +1,86 @@
+# ============================================================================
+# MANIFEST.in - Source Distribution File Inclusion
+# ============================================================================
+
+# ============================================================================
+# Documentation and Metadata
+# ============================================================================
+include README.md
+include LICENSE.md
+include pyproject.toml
+include setup.py
+
+# py.typed marker for PEP 561 compliance
+recursive-include src py.typed
+
+# ============================================================================
+# Build Scripts (for users building from source)
+# ============================================================================
+include scripts/build-rocksdb-linux.sh
+include scripts/build-rocksdb-macos.sh
+include scripts/rocksdb-cstdint.patch
+
+# ============================================================================
+# rdbpy Package Files
+# ============================================================================
+# Cython source files (.pyx, .pxd)
+recursive-include src/rdbpy *.pyx
+recursive-include src/rdbpy *.pxd
+
+# C++ wrapper headers
+recursive-include src/rdbpy/include *.hpp
+recursive-include src/rdbpy/include *.h
+
+# Python type stubs
+recursive-include src/rdbpy *.pyi
+
+# Python files
+recursive-include src/rdbpy *.py
+
+# ============================================================================
+# Tests
+# ============================================================================
+recursive-include tests *.py
+
+# ============================================================================
+# Exclusions
+# ============================================================================
+# Exclude compiled files
+global-exclude *.pyc
+global-exclude *.pyo
+global-exclude *.pyd
+global-exclude __pycache__
+
+# Exclude Cython-generated C/C++ files
+global-exclude *.c
+global-exclude *.cpp
+
+# Exclude build artifacts
+global-exclude *.so
+global-exclude *.dylib
+global-exclude *.dll
+prune build
+prune dist
+prune *.egg-info
+
+# Exclude IDE and editor files
+global-exclude .DS_Store
+global-exclude *.swp
+global-exclude *.swo
+global-exclude *~
+prune .vscode
+prune .idea
+
+# Exclude version control
+prune .git
+global-exclude .gitignore
+global-exclude .gitattributes
+
+# Exclude CI/CD that users don't need
+prune .github
+exclude .pre-commit-config.yaml
+
+# Exclude development files
+exclude .coveragerc
+exclude .ruff_cache
+prune htmlcov

rdbpython-0.2.1/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: rdbpython
+Version: 0.2.1
+Summary: Python bindings for RocksDB with Cython
+Author-email: Gor Arakelyan <gorarkln@gmail.com>
+Maintainer-email: Gor Arakelyan <gorarkln@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/everyabc/rdbpy
+Project-URL: Documentation, https://github.com/everyabc/rdbpy#readme
+Project-URL: Repository, https://github.com/everyabc/rdbpy
+Project-URL: Issues, https://github.com/everyabc/rdbpy/issues
+Project-URL: PyPI, https://pypi.org/project/rdbpython/
+Keywords: rocksdb,database,key-value,storage,embedded,cython
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Cython
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Database
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: attrs
+Provides-Extra: dev
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: pre-commit>=3.0.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0.0; extra == "test"
+Requires-Dist: pytest-xdist>=3.0.0; extra == "test"
+Requires-Dist: pytest-timeout>=2.1.0; extra == "test"
+Requires-Dist: pytest-benchmark>=4.0.0; extra == "test"
+Requires-Dist: hypothesis>=6.0.0; extra == "test"
+Provides-Extra: cython
+Requires-Dist: Cython>=3.0.0; extra == "cython"
+Requires-Dist: setuptools>=68.0; extra == "cython"
+Provides-Extra: all
+Requires-Dist: rdbpy[cython,dev,test]; extra == "all"
+Dynamic: license-file
+
+# rdbpy
+
+[![Build Wheels](https://github.com/everyabc/rdbpy/actions/workflows/build.yml/badge.svg)](https://github.com/everyabc/rdbpy/actions/workflows/build.yml)
+[![Tests](https://github.com/everyabc/rdbpy/actions/workflows/test.yml/badge.svg)](https://github.com/everyabc/rdbpy/actions/workflows/test.yml)
+[![PyPI version](https://badge.fury.io/py/rdbpython.svg)](https://pypi.org/project/rdbpython/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/rdbpython.svg)](https://pypi.org/project/rdbpython/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Python bindings for RocksDB with Cython - **batteries included!**
+
+**No RocksDB installation required** - everything is bundled in the wheel for Linux and macOS (Intel + Apple Silicon).
+
+## Installation
+
+```bash
+pip install rdbpython
+```
+
+That's it! No need to install RocksDB or any compression libraries manually.
+
+## Usage
+
+```python
+import rdbpy
+
+# Open database
+options = rdbpy.Options(create_if_missing=True)
+db = rdbpy.DB('/path/to/db', options)
+
+# Put/Get
+db.put(b'key', b'value')
+value = db.get(b'key')
+
+# Iterate
+it = db.iterkeys()
+it.seek_to_first()
+while it.valid():
+    print(it.key())
+    it.next()
+```
+
+## Development
+
+```bash
+# Setup
+make install
+
+# Build
+make build
+
+# Test
+make test
+```
+
+## License
+
+MIT

rdbpython-0.2.1/README.md

@@ -0,0 +1,57 @@
+# rdbpy
+
+[![Build Wheels](https://github.com/everyabc/rdbpy/actions/workflows/build.yml/badge.svg)](https://github.com/everyabc/rdbpy/actions/workflows/build.yml)
+[![Tests](https://github.com/everyabc/rdbpy/actions/workflows/test.yml/badge.svg)](https://github.com/everyabc/rdbpy/actions/workflows/test.yml)
+[![PyPI version](https://badge.fury.io/py/rdbpython.svg)](https://pypi.org/project/rdbpython/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/rdbpython.svg)](https://pypi.org/project/rdbpython/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Python bindings for RocksDB with Cython - **batteries included!**
+
+**No RocksDB installation required** - everything is bundled in the wheel for Linux and macOS (Intel + Apple Silicon).
+
+## Installation
+
+```bash
+pip install rdbpython
+```
+
+That's it! No need to install RocksDB or any compression libraries manually.
+
+## Usage
+
+```python
+import rdbpy
+
+# Open database
+options = rdbpy.Options(create_if_missing=True)
+db = rdbpy.DB('/path/to/db', options)
+
+# Put/Get
+db.put(b'key', b'value')
+value = db.get(b'key')
+
+# Iterate
+it = db.iterkeys()
+it.seek_to_first()
+while it.valid():
+    print(it.key())
+    it.next()
+```
+
+## Development
+
+```bash
+# Setup
+make install
+
+# Build
+make build
+
+# Test
+make test
+```
+
+## License
+
+MIT

rdbpython-0.2.1/pyproject.toml

@@ -0,0 +1,330 @@
+# ============================================================================
+# Build System
+# ============================================================================
+[build-system]
+requires = ["setuptools>=68.0", "wheel", "Cython>=3.0"]
+build-backend = "setuptools.build_meta"
+
+# ============================================================================
+# Project Metadata (PEP 621)
+# ============================================================================
+[project]
+name = "rdbpython"
+version = "0.2.1"
+description = "Python bindings for RocksDB with Cython"
+readme = "README.md"
+license = "MIT"
+authors = [
+    {name = "Gor Arakelyan", email = "gorarkln@gmail.com"}
+]
+maintainers = [
+    {name = "Gor Arakelyan", email = "gorarkln@gmail.com"}
+]
+keywords = [
+    "rocksdb",
+    "database",
+    "key-value",
+    "storage",
+    "embedded",
+    "cython"
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Cython",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Database",
+]
+requires-python = ">=3.9"
+dependencies = [
+    "attrs",
+]
+
+[project.urls]
+Homepage = "https://github.com/everyabc/rdbpy"
+Documentation = "https://github.com/everyabc/rdbpy#readme"
+Repository = "https://github.com/everyabc/rdbpy"
+Issues = "https://github.com/everyabc/rdbpy/issues"
+PyPI = "https://pypi.org/project/rdbpython/"
+
+[project.optional-dependencies]
+# Development tools
+dev = [
+    "ruff>=0.1.0",
+    "pre-commit>=3.0.0",
+]
+
+# Testing
+test = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "pytest-xdist>=3.0.0",
+    "pytest-timeout>=2.1.0",
+    "pytest-benchmark>=4.0.0",
+    "hypothesis>=6.0.0",
+]
+
+# Cython build dependencies (for building from source)
+cython = [
+    "Cython>=3.0.0",
+    "setuptools>=68.0",
+]
+
+# All development dependencies
+all = [
+    "rdbpy[dev,test,cython]",
+]
+
+# ============================================================================
+# Package Discovery
+# ============================================================================
+[tool.setuptools]
+zip-safe = false
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["rdbpy*"]
+namespaces = false
+
+[tool.setuptools.package-data]
+rdbpy = [
+    "**/*.pyx",
+    "**/*.pxd",
+    "**/*.hpp",
+    "py.typed",
+]
+
+[tool.setuptools.exclude-package-data]
+"*" = ["*.c", "*.cpp"]
+
+# ============================================================================
+# CI/CD - cibuildwheel configuration
+# ============================================================================
+[tool.cibuildwheel]
+build = ["cp39-*", "cp310-*", "cp311-*", "cp312-*", "cp313-*"]
+
+skip = [
+    "*-musllinux_*",
+    "*-win32",
+    "*-manylinux_i686",
+]
+
+build-verbosity = 1
+
+test-command = "python -c \"import rdbpy; print('rdbpy imported successfully')\""
+test-requires = ["pytest"]
+
+# ============================================================================
+# Linux-specific cibuildwheel settings
+# ============================================================================
+[tool.cibuildwheel.linux]
+manylinux-x86_64-image = "manylinux2014"
+manylinux-aarch64-image = "manylinux2014"
+
+before-all = [
+    "yum install -y wget gcc gcc-c++ make",
+    "bash {project}/scripts/build-rocksdb-linux.sh"
+]
+
+environment = { RDBPY_DEP_DIR="/tmp/rdbpy_deps", LD_LIBRARY_PATH="/tmp/rdbpy_deps/lib", LIBRARY_PATH="/tmp/rdbpy_deps/lib", PKG_CONFIG_PATH="/tmp/rdbpy_deps/lib/pkgconfig" }
+
+repair-wheel-command = "LD_LIBRARY_PATH=/tmp/rdbpy_deps/lib:$LD_LIBRARY_PATH auditwheel repair -w {dest_dir} {wheel} --lib-sdir .libs"
+
+test-command = [
+    "python -c \"import rdbpy; print('rdbpy imported successfully')\"",
+    "python -c \"import rdbpy; db = rdbpy.DB('/tmp/test.db', rdbpy.Options(create_if_missing=True)); db.put(b'key', b'value'); assert db.get(b'key') == b'value'; print('RocksDB basic test passed')\""
+]
+
+# ============================================================================
+# macOS-specific cibuildwheel settings
+# ============================================================================
+[tool.cibuildwheel.macos]
+archs = ["x86_64", "arm64"]
+
+environment = { MACOSX_DEPLOYMENT_TARGET="10.14", RDBPY_DEP_DIR="/tmp/rdbpy_deps", DYLD_LIBRARY_PATH="/tmp/rdbpy_deps/lib:$DYLD_LIBRARY_PATH" }
+
+before-all = [
+    "bash {project}/scripts/build-rocksdb-macos.sh"
+]
+
+repair-wheel-command = "delocate-wheel --require-archs {delocate_archs} -w {dest_dir} -v {wheel}"
+
+test-command = [
+    "python -c \"import rdbpy; print('rdbpy imported successfully')\"",
+    "python -c \"import rdbpy; db = rdbpy.DB('/tmp/test_macos.db', rdbpy.Options(create_if_missing=True)); db.put(b'key', b'value'); assert db.get(b'key') == b'value'; print('RocksDB basic test passed')\""
+]
+
+# ============================================================================
+# Windows-specific cibuildwheel settings
+# ============================================================================
+[tool.cibuildwheel.windows]
+before-all = [
+    "powershell -File {project}/scripts/build-rocksdb-windows.ps1"
+]
+
+environment = { RDBPY_DEP_DIR="C:\\rdbpy_deps" }
+
+test-command = [
+    "python -c \"import rdbpy; print('rdbpy imported successfully')\"",
+]
+
+# ============================================================================
+# Testing - pytest
+# ============================================================================
+[tool.pytest.ini_options]
+minversion = "7.0"
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "--strict-markers",
+    "--strict-config",
+    "--tb=short",
+    "--durations=10",
+]
+markers = [
+    "unit: Unit tests - fast, isolated",
+    "functional: Functional end-to-end tests",
+    "integration: Integration tests - cross-component",
+    "performance: Performance benchmarks",
+    "rocksdb: RocksDB tests",
+    "slow: Slow-running tests",
+]
+filterwarnings = [
+    "error",
+    "ignore::UserWarning",
+    "ignore::DeprecationWarning",
+]
+
+# ============================================================================
+# Coverage
+# ============================================================================
+[tool.coverage.run]
+source = ["src"]
+omit = [
+    "*/tests/*",
+    "*/test_*",
+    "*/__pycache__/*",
+    "*/site-packages/*",
+]
+branch = true
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "def __str__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+    "if typing.TYPE_CHECKING:",
+    "@abstractmethod",
+    "@abc.abstractmethod",
+]
+precision = 2
+show_missing = true
+
+[tool.coverage.html]
+directory = "tests/reports/coverage"
+
+# ============================================================================
+# Linting & Formatting - Ruff
+# ============================================================================
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+src = ["src", "tests"]
+extend-exclude = [
+    ".venv",
+    "build",
+    "dist",
+    "*.egg-info",
+    "*.c",
+    "*.cpp",
+    "*.so",
+]
+
+[tool.ruff.lint]
+select = [
+    "E",      # pycodestyle errors
+    "W",      # pycodestyle warnings
+    "F",      # pyflakes
+    "I",      # isort
+    "B",      # flake8-bugbear
+    "C4",     # flake8-comprehensions
+    "UP",     # pyupgrade
+    "N",      # pep8-naming
+    "YTT",    # flake8-2020
+    "S",      # flake8-bandit (security)
+    "T20",    # flake8-print
+    "D",      # pydocstyle
+    "ANN",    # flake8-annotations
+    "TC",     # flake8-type-checking
+    "RUF",    # ruff-specific rules
+    "PTH",    # flake8-pathlib
+]
+ignore = [
+    "E501",   # Line too long (handled by formatter)
+    "D105",   # Missing docstring in magic method
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = [
+    "S101",   # assert allowed in tests
+    "T20",    # print allowed in tests
+    "D",      # docstrings not required in tests
+    "ANN",    # type annotations not required in tests
+]
+"setup.py" = [
+    "T20",    # print allowed in setup
+    "D",      # docstrings not required in setup
+]
+"src/rdbpy/**/*.py" = [
+    "D",      # Some docstrings may be in .pyx files
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["rdbpy"]
+force-single-line = false
+lines-after-imports = 2
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+docstring-code-format = true
+docstring-code-line-length = 80
+
+# ============================================================================
+# Type Checking - mypy
+# ============================================================================
+[tool.mypy]
+python_version = "3.12"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false
+ignore_missing_imports = true
+exclude = [
+    "build/",
+    "dist/",
+    ".venv/",
+    ".*\\.pyx$",
+]
+
+[[tool.mypy.overrides]]
+module = "rdbpy.*"
+ignore_errors = true