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.
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
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:
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 <http://www.gnu.org/licenses/>.
Metadata
Release files for lesana 0.10.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| lesana-0.10.1.tar.gz | 61.9 kB | Without provenance | Details for lesana-0.10.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| lesana-0.10.1-py3-none-any.whl | Python 3 | none | any | Details for lesana-0.10.1-py3-none-any.whl |
Total release size: 78.7 kB
Release files / lesana-0.10.1.tar.gz
| Download URL | lesana-0.10.1.tar.gz |
|---|---|
| Size | 61.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7be10f6afef5571a6528d733f4d4d3dd542a73e7687048cb020710b96d37be8a
|
|
BLAKE2b-256 checksum How to use checksums |
e077509739c4e34fc04772b5a6cf0f7cad873d24520dac97f029d95f45f00825
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.11.8
|
Release files / lesana-0.10.1-py3-none-any.whl
| Download URL | lesana-0.10.1-py3-none-any.whl |
|---|---|
| Size | 16.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8e5d220aa5cdeb246c58d68af38d1598da50faf9f56ece646ad367c10349cec2
|
|
BLAKE2b-256 checksum How to use checksums |
2ec8453a68471d68df43e31efbeb6923b2f14ef3431ec75437ec72b912597239
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.11.8
|
Security for lesana 0.10.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.