From 65654282a98cb0590d498e4ed9c924f97646f1dc Mon Sep 17 00:00:00 2001
From: Aylur <k.demeter@protonmail.com>
Date: Wed, 25 Sep 2024 23:22:01 +0000
Subject: docs: restructure

---
 docs/libraries/auth.md | 118 -------------------------------------------------
 1 file changed, 118 deletions(-)
 delete mode 100644 docs/libraries/auth.md

(limited to 'docs/libraries/auth.md')

diff --git a/docs/libraries/auth.md b/docs/libraries/auth.md
deleted file mode 100644
index 1f07a17..0000000
--- a/docs/libraries/auth.md
+++ /dev/null
@@ -1,118 +0,0 @@
-# Auth
-
-Library and CLI tool for authentication using [pam](https://github.com/linux-pam/linux-pam).
-
-## Installation
-
-1. install dependencies
-
-:::code-group
-
-```sh [<i class="devicon-archlinux-plain"></i> Arch]
-sudo pacman -Syu meson pam gobject-introspection
-```
-
-```sh [<i class="devicon-fedora-plain"></i> Fedora]
-sudo dnf install meson pam-devel gobject-introspection-devel
-```
-
-```sh [<i class="devicon-ubuntu-plain"></i> Ubuntu]
-# Not yet documented
-```
-
-:::
-
-::: warning On NixOS you have to add `astal-auth` to `security.pam`.
-::: code-group
-
-```nix [configuration.nix]
-{
-  security.pam.services.astal-auth = {}
-}
-```
-
-:::
-
-2. clone repo
-
-```sh
-git clone https://github.com/aylur/astal.git
-cd astal/lib/auth
-```
-
-3. install
-
-```sh
-meson setup build
-meson install -C build
-```
-
-:::tip
-Most distros recommend manual installs in `/usr/local`,
-which is what `meson` defaults to. If you want to install to `/usr`
-instead which most package managers do, set the `prefix` option:
-
-```sh
-meson setup --prefix /usr build
-```
-
-:::
-
-## Usage
-
-You can browse the [Auth reference](https://aylur.github.io/libastal/auth).
-
-### CLI
-
-```sh
-astal-auth --password my-password
-```
-
-### Library
-
-:::code-group
-
-```js [<i class="devicon-javascript-plain"></i> JavaScript]
-import Auth from "gi://AstalAuth"
-
-Auth.Pam.authenticate("password", (_, task) => {
-    try {
-        AstalAuth.Pam.authenticate_finish(task)
-        print("authentication sucessful")
-    } catch (error) {
-        print(error)
-    }
-})
-```
-
-```py [<i class="devicon-python-plain"></i> Python]
-from gi.repository import AstalAuth as Auth
-
-def callback(_, task) -> None:
-    try:
-        Auth.Pam.authenticate_finish(task)
-        print("success")
-    except Exception as e:
-        print(e)
-
-Auth.Pam.authenticate("password", callback)
-```
-
-```lua [<i class="devicon-lua-plain"></i> Lua]
-local Auth = require("lgi").require("AstalAuth")
-
-Auth.Pam.authenticate("password", function(_, task)
-    local status, err = Auth.Pam.authenticate_finish(task)
-    if err ~= nil then
-        print(err)
-    else
-        print("success")
-    end
-end)
-```
-
-```vala [<i class="devicon-vala-plain"></i> Vala]
-// Not yet documented
-```
-
-:::
-- 
cgit v1.2.3