https://github.com/octelly/relationdb

https://github.com/octelly/relationdb

Last synced: 11 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/octelly/relationdb
• Owner: Octelly
• License: gpl-3.0
• Created: 2021-11-07T21:07:40.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2022-05-31T12:39:04.000Z (about 4 years ago)
• Last Synced: 2025-06-13T17:49:24.922Z (12 months ago)
• Language: Python
• Size: 129 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# RelationDB

A database wrapper providing an interface for working with taggable objects and relations.

## Dependencies

[This project uses ``poetry`` for dependency management.](./pyproject.toml)

## Goal

Tree structures are rather limiting, yet for practical reasons, they are being used everywhere (filesystems, shelves in real life). Tags allow us to describe every object we're keeping track of with a set of tags that then allow us to filter our objects by those same tags. Tags must be matched exactly, which allows for better reliability and predictability.

Relations allow us to describe how different objects are related to each other as well. Relations should be allowed to be directional, which is for example necessary for parent-child relations.

### Tag filtering

![Before filtering](./readme-res/filter1.png)

![When filtered](./readme-res/filter2.png)

## Usage examples

- keeping track of documents

- keeping track of media

- a searchable contact book

- boorus