worblehat/README.md

45 lines
1.5 KiB
Markdown
Raw Normal View History

2023-05-04 17:13:47 +02:00
![worblehat](worblehat.png)
# 👉👁️👄👁️👈
2022-08-16 22:13:48 +02:00
# Worblehat
2023-04-01 20:40:41 +02:00
More information on <https://www.pvv.ntnu.no/pvv/Bokhyllen/Worblehat/>
2022-08-16 22:13:48 +02:00
## What?
2022-08-16 22:13:48 +02:00
Worblehat is a simple library management system written specifically for Programvareverkstedet.
## Why?
2022-08-16 22:13:48 +02:00
Programvareverkstedet is a small community with many books and games. A simple web platform is needed to manage the library. We need to know who owns each item, if we can loan it out and where it is.
Programvareverkstedet har en rekke bøker, og en konstant tilstrøm av nye.
Teoretisk sett skal disse ryddes og kategoriseres jevntlig, men da dette ikke gjøres ofte nok kan det være et varig strev å finne ut hvor bøker står til enhver tid.
Styret har derfor tatt initiativ til å opprette et biblioteksystem for å systematisere bøkene.
Prosjektet har fått navn Worblehat etter en bibliotekar i Terry Pratchetts discworld serie.
Worblehatt har vært påbegynnt flere ganger opp gjennom historien uten å komme i noen form for funksjonell tilstand enda.
# Technical details
## Setup
This project uses [poetry][poetry] as its buildtool as of May 2023.
```console
$ poetry install
$ poetry run alembic migrate
2023-05-12 02:58:45 +02:00
$ poetry run worblehat --help
```
## How to configure
2023-05-12 02:58:45 +02:00
See `config.template` for configurable settings.
Unless provided through the `--config` flag, program will automatically look for a config file in these locations:
- `./config.toml`
- `~/.config/worblehat/config.toml`
- `/var/lib/worblehat/config.toml`
Run `poetry run worblehat --help` for more info