README.rst 2.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576
  1. Lakesuperior
  2. ============
  3. |build status| |docs| |pypi| |codecov|
  4. Lakesuperior is an alternative `Fedora
  5. Repository <http://fedorarepository.org>`__ implementation.
  6. Fedora is a mature repository software system historically adopted by
  7. major cultural heritage institutions. It exposes an
  8. `LDP <https://www.w3.org/TR/ldp-primer/>`__ endpoint to manage
  9. any type of binary files and their metadata in Linked Data format.
  10. Guiding Principles
  11. ------------------
  12. Lakesuperior aims at being an uncomplicated, efficient Fedora 4
  13. implementation.
  14. Its main goals are:
  15. - **Reliability:** Based on solid technologies with stability in mind.
  16. - **Efficiency:** Small memory and CPU footprint, high scalability.
  17. - **Ease of management:** Tools to perform monitoring and maintenance
  18. included.
  19. - **Simplicity of design:** Straight-forward architecture, robustness
  20. over features.
  21. Key features
  22. ------------
  23. - Drop-in replacement for Fedora4
  24. - Very stable persistence layer based on
  25. `LMDB <https://symas.com/lmdb/>`__ and filesystem. Fully
  26. ACID-compliant writes guarantee consistency of data.
  27. - Term-based search and SPARQL Query API + UI
  28. - No performance penalty for storing many resources under the same
  29. container, or having one resource link to many URIs
  30. - Extensible provenance metadata tracking
  31. - Multi-modal access: HTTP (REST), command line interface and native Python
  32. API.
  33. - Fits in a pocket: you can carry 50M triples in an 8Gb memory stick.
  34. Installation & Documentation
  35. ----------------------------
  36. With Docker::
  37. git clone https://github.com/scossu/lakesuperior.git
  38. cd lakesuperior
  39. docker-compose up
  40. With pip (assuming you are familiar with it)::
  41. pip install lakesuperior
  42. The full, current documentation is maintained in `Read The Docs
  43. <http://lakesuperior.readthedocs.io/>`__. Please refer to that for more info,
  44. including installation instructions.
  45. .. |build status| image:: http://img.shields.io/travis/scossu/lakesuperior/master.svg?style=flat
  46. :alt: Build Status
  47. :target: https://travis-ci.org/username/repo
  48. .. |docs| image:: https://readthedocs.org/projects/lakesuperior/badge/
  49. :alt: Documentation Status
  50. :target: https://lakesuperior.readthedocs.io/en/latest/?badge=latest
  51. .. |pypi| image:: https://badge.fury.io/py/lakesuperior.svg
  52. :alt: PyPI Package
  53. :target: https://badge.fury.io/py/lakesuperior
  54. .. |codecov| image:: https://codecov.io/gh/scossu/lakesuperior/branch/master/graph/badge.svg
  55. :alt: Code coverage
  56. :target: https://codecov.io/gh/scossu/lakesuperior