Metadata-Version: 2.1
Name: litestash
Version: 0.1.0b2
Summary: The LiteStash Python project offers a lightning-fast, lightweight key-value storage solution.  LiteStash provides a NoSQL API for seamless integration into your applications.  The LiteStash database handles the data with SQLite transparently.  Optimal use for caching, session management, and other high-performance use cases.
Author-email: Jonathan Cain <mail@mesotron.dev>
License: # Copyright 2024 Mesotron Machine Company LLC & the authors
        #
        # Licensed under the Apache License, Version 2.0 (the "License");
        # you may not use this file except in compliance with the License.
        # You may obtain a copy of the License at
        #
        #     http://www.apache.org/licenses/LICENSE-2.0
        #
        # Unless required by applicable law or agreed to in writing, software
        # distributed under the License is distributed on an "AS IS" BASIS,
        # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
        # See the License for the specific language governing permissions and
        # limitations under the License.
        
        
Project-URL: Homepage, https://github.com/nortosem/LiteStash
Project-URL: Documentation, https://github.com/nortosem/LiteStash/blob/master/README.md
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Database
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: sqlalchemy >=2.0
Requires-Dist: annotated-types ==0.7.0
Requires-Dist: astroid ==3.2.3
Requires-Dist: coverage ==7.6.0
Requires-Dist: dill ==0.3.8
Requires-Dist: greenlet ==3.0.3
Requires-Dist: iniconfig ==2.0.0
Requires-Dist: isort ==5.13.2
Requires-Dist: mccabe ==0.7.0
Requires-Dist: orjson ==3.10.6
Requires-Dist: packaging ==24.1
Requires-Dist: platformdirs ==4.2.2
Requires-Dist: pluggy ==1.5.0
Requires-Dist: pydantic ==2.8.2
Requires-Dist: pydantic-core ==2.20.1
Requires-Dist: pylint ==3.2.5
Requires-Dist: pytest ==8.2.2
Requires-Dist: pytest-mock ==3.14.0
Requires-Dist: python-dotenv ==1.0.1
Requires-Dist: SQLAlchemy ==2.0.31
Requires-Dist: sqlmodel ==0.0.19
Requires-Dist: tomlkit ==0.13.0
Requires-Dist: typing-extensions ==4.12.2

# LiteStash

A key-value store for Python, built on SQLite with a NoSQL api and speed.

## Overview

The LiteStash Python project offers a lightning-fast, lightweight key-value storage for Python applications.  LiteStash provides a NoSQL API for seamless integration into your applications.  Optimal use for caching, session management, and other high-performance use cases.  LiteStash is for high-performance storage of key-value data that leverages SQLite's reliability and speed, optimized for scenarios where you need quick access to data.

## Key-Value Store
    
With a simple, NoSQL-like API, LiteStash is easy to integrate into your Python applications, especially web frameworks like FastAPI and Django.
Keys are hashed and indexed by Sqlite in the background.  Each database handles at most four tables across sixteen distinct database files.

## Features

* **Performance:** Stores data in memory for near-instantaneous access.
* **Pydantic Data Validation:** Ensures type safety and data integrity using Pydantic models.
* **Distributed Hash Table:** Organizes data across multiple SQLite databases for scalability.
* **Pythonic API:**  Offers a simple and intuitive API for interacting with the key-value store. 
* **Lightweight and Easy to Use:**  Minimal dependencies and straightforward setup.
* **Flexible Data Types:**  Supports string keys and various value types, including strings, numbers, booleans, lists, and dictionaries (serialized as JSON).

## Use Cases

* **Caching:** Store frequently accessed data, such as API responses, database query results, or computed values.
* **Session Management:**  Manage user sessions in web applications.
* **Temporary Data Storage:** Store transient data for short-lived tasks or calculations.


## Project
Thanks for checking out the beta release of LiteStash.  More features are in the works.  The Github is a mirror of the project at this time.  LiteStash is under active development and working towards the first release.

Contact mail@mesotron.dev with questions & requests.
