BurrowTS
The BurrowTS is a Python library that provides a simple and efficient time series database for storing and retrieving time-stamped values.
Features
- Insert values into the time series database with an associated timestamp.
- Retrieve time series data for a given series name.
- Retrieve time series data for a given series name by timestamp range.
- Thread-safe operations using a lock.
- Data persistence using pickle.
Installation
You can install the BurrowTS using pip:
pip install burrowts
Usage
Here's an example of how to use the BurrowTS:
from burrowts import BurrowTS
db = BurrowTS()
# Insert values
db.insert("cpu", 12.3)
db.insert("cpu", 14.9)
db.insert("mem", 20.4)
# Retrieve time series data
cpu_data = db.get_series("cpu")
print("CPU Data:", cpu_data)Data Persistence
The BurrowTS uses pickle for data persistence. The database data is stored in a pickle file specified by the file_path parameter. The data is automatically saved to the file after each insertion operation.
Thread Safety
The BurrowTS ensures thread safety by using a lock. This allows for concurrent access from multiple threads while maintaining data integrity.
Contributing
Contributions are welcome! If you have any ideas, suggestions, or bug reports, please open an issue or submit a pull request.
License
This project is licensed under the MIT License.