Metadata-Version: 2.1 Name: lesana Version: 0.10.1 Summary: Manage collection inventories throught yaml files. Author-email: Elena ``of Valhalla'' Grandi License: AGPLv3+ Project-URL: Homepage, https://lesana.trueelena.org/ Project-URL: Documentation, https://lesana.trueelena.org/ Project-URL: Repository, https://git.sr.ht/~valhalla/lesana Project-URL: Source, https://git.sr.ht/~valhalla/lesana Project-URL: Issues, https://todo.sr.ht/~valhalla/lesana Project-URL: Tracker, https://todo.sr.ht/~valhalla/lesana Project-URL: Changelog, https://git.sr.ht/~valhalla/lesana/tree/master/item/CHANGELOG.rst Project-URL: Mailing lists, https://sr.ht/~valhalla/lesana/lists Keywords: collection,inventory Classifier: Development Status :: 3 - Alpha Classifier: Environment :: Console Classifier: Intended Audience :: Developers Classifier: Intended Audience :: End Users/Desktop Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+) Classifier: Operating System :: POSIX Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3.8 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: Topic :: Software Development :: Libraries :: Python Modules Classifier: Topic :: Utilities Requires-Python: >=3.8 Description-Content-Type: text/x-rst Requires-Dist: ruamel.yaml Requires-Dist: jinja2 Requires-Dist: python-dateutil Provides-Extra: cli Requires-Dist: hazwaz; extra == "cli" =============================== lesana - a collection manager =============================== lesana is a python3 library to organize collections of various kinds. It is designed to have a data storage / serialization format that is friendly to git and other VCSs, but decent performances. To reach this aim it uses yaml_ as its serialization format, which is easy to store in a VCS, share between people and syncronize between different computers, but it also keeps an index of this data in a local xapian_ database in order to allow for fast searches. .. _yaml: http://yaml.org/ .. _xapian: https://xapian.org/ lesana supports collections of any kind, as long as their entries can be described with a mostly flat dictionary of fields of the types described in the documentation file ``field_types``. Some example collection schemas are provided, but one big strenght of lesana is the ability to customize your collection with custom fields by simply writing a personalized ``settings.yaml``. Installation ------------ The recommended way to install lesana is to use the packages available for your distribution; see e.g. the `list of distributions that provide lesana on repology `_. Alternatively, the source code for lesana can be downloaded from the git repository at https://git.sr.ht/~valhalla/lesana; and releases are made on `pypi `_. lesana expects to run on a POSIX-like system and requires the following dependencies: * python3 * xapian_ * `ruamel.yaml `_ * `jinja2 `_ * `dateutil `_ * `GitPython `_ optional, to add git support. Under debian (and derivatives), the packages to install are:: apt install python3-jinja2 python3-ruamel.yaml python3-xapian \ python3-dateutil python3-git lesana can be run in place from the git checkout / extracted tarball; to use ``setup.py`` you will also need setuptools (e.g. from the ``python3-setuptools`` package under debian and derivatives). Contributing ------------ Lesana is `hosted on sourcehut `_: * `bug tracker `_ * `mailing lists `_ * `git repository `_ * `CI `_ License ------- Copyright (C) 2016-2024 Elena Grandi This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program. If not, see .