Metadata-Version: 2.1
Name: labinform-datasafe
Version: 0.1.0b1
Summary: A local repository for warm research data
Home-page: https://www.labinform.de/
Author: Mirjam Schröder, Till Biskup
Author-email: till@till-biskup.de
Project-URL: Documentation, https://datasafe.docs.labinform.de/
Project-URL: Source, https://github.com/tillbiskup/labinform-datasafe
Keywords: Reproducible research,data storage,repository,warm research data,checksums
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: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Development Status :: 4 - Beta
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.7
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: flask
Requires-Dist: oyaml
Provides-Extra: dev
Requires-Dist: prospector; extra == "dev"
Requires-Dist: bandit; extra == "dev"
Requires-Dist: pyroma; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: flask-unittest; extra == "dev"
Provides-Extra: docs
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: sphinx-rtd-theme; extra == "docs"
Provides-Extra: deployment
Requires-Dist: build; extra == "deployment"
Requires-Dist: twine; extra == "deployment"

LabInform Datasafe
==================

*A local repository for "warm" research data.*

The LabInform datasafe is the **data store for "warm" research data** that is part of the `LabInform laboratory information and management system <https://www.labinform.de/>`_ (LIMS). One key aspect of handling data is to store them in one place and access them via unique identifiers (here: a *Lab Object Identifier*, LOI).



Features
========

A list of features, not all implemented yet but aimed at for the first public release:

* Client-server architecture

* Local install as well as network install possible

* Automatic generation of unique LOIs


And to make it even more convenient for users and future-proof:

* Open source project written in Python (>= 3.7)

* Developed fully test-driven

* Extensive user and API documentation


Warning

The dataset component of the LabInform project is currently under active development and still considered in Alpha development state. Therefore, expect frequent changes in features and public APIs that may break your own code. Nevertheless, feedback as well as feature requests are highly welcome.


Requirements
============

The LabInform datasafe package comes with a rather minimal set of requirements:

* Python >= 3.7
* flask and oyaml packages


Installation
============

To install the LabInform datasafe package on your computer (sensibly within a Python virtual environment), open a terminal (activate your virtual environment), and type in the following:

.. code-block:: bash

    pip install labinform-datasafe


License
=======

This program is free software: you can redistribute it and/or modify it under the terms of the **BSD License**.


Contributing
============

If you would like to contribute, the easiest may be to clone the repository. In this case, don't forget to add the version incrementer residing in ``./bin/incrementVersion.sh`` to your git pre-commit hook in `./.git/hooks/pre-commit`` (or create this file if it doesn't exist yet)::

    #!/usr/bin/env bash
    ./bin/incrementVersion.sh

In case you needed to create the file ``pre-commit``, don't forget to make it executable (using ``chmod +x <file>``).
