Metadata-Version: 2.4
Name: pysqlitefs
Version: 1.4.1
Summary: Python bindings for SQLiteFS - Simulate a local filesystem inside a SQLite database
Author: P34ch
License: MIT
Project-URL: Homepage, https://gitlab.com/p34ch-main/sqlitefs
Project-URL: Bug Reports, https://gitlab.com/p34ch-main/sqlitefs/-/issues
Project-URL: Source, https://gitlab.com/p34ch-main/sqlitefs
Project-URL: Documentation, https://gitlab.com/p34ch-main/sqlitefs/-/blob/main/README.md
Keywords: sqlite,filesystem,database,file,storage,compression,encryption
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
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 :: C++
Classifier: Topic :: Database
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Filesystems
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# PySQLiteFS Bindings

This project provide bindigs for sqlitefs project. You can create a file system inside sqlite database. With key you can encript the whole database including sqlite headers.

## Supported functions

* pwd - print working directory
* mkdir - create a new folder
* cd - change wirking directory
* ls - list files and folders
* cp - copy file. (Works with files only)
* mv - move node (file or folder)
* rm - remove node
* write - write file to the db. (1 GB max size for one file)
* read - read file from the db
* stats - recursively gets the count of all files in a directory, indicating the total size in compressed and raw form.

## Built-in algorithms

You can use `bzip`, `lzma`, `zlib` or `zstd` as write algorithm. To add your own modifications check `Custom save and load functions` section below. You can modify your data as you want, for example you can encrypt and decrypt in save and load respectively.

## Examples

A simple example

```python
from pysqlitefs import SQLiteFS

fs = SQLiteFS("test.db", "secret")
raw_content = "Raw data content"
fs.write("file.txt", raw_content.encode())
content = fs.read("file.txt")
print(f"Content of file.txt: {content}")
assert content.decode() == raw_content, "Content mismatch after save and load"
```

### Custom save and load functions

> NOTE: you can specify only one of them if you want to read or write only. So you can write data at your own pc with registered write function and send file with load function only. In this case user can read the data, but cannot modify it (only remove).

```python
from pysqlitefs import SQLiteFS


def save(data: bytes) -> bytes:
    return data[-1::-1]


def load(data: bytes) -> bytes:
    return data[-1::-1]


with open("file.dat", "rb") as f:
    raw_content = f.read()

fs = SQLiteFS("test.db")
fs.register_save_func("reverse", save)
fs.register_load_func("reverse", load)

for name in fs.getSaveFuncs():
    print(f"Test function: {name}")
    fs.write(f"{name}.dat", raw_content, name)
    content = fs.read(f"{name}.dat")
    assert content == raw_content, "Content mismatch after save and load"
```
