photor (Photos Repository)

Development

Start nix-shell to prepare the development environment. It'll bring rust, sqlite3 etc. (see shell.nix):

$ nix-shell
[nix-shell:~/code/photor]$

Build

$ nix-build

Installation

for an installation as a user, when sources are available locally:
```
$ nix-env -f default.nix -i
```

for an system wide installation in nixos:

create a file called photor.nix:

{ pkgs }:

let src = pkgs.fetchFromGitHub {
    owner  = "ybycode";
    repo   = "photor";
    rev    = "88ae4770c95c55a5adec7b07e12ae8d8137cbc19"; # the commit to install
    sha256 = "sha256-njGYM3SlM4VBI+gXlG8gGUIxCAnvil22jR+3UxhPIvQ="; # given in the error of a build tried with the fake hash
    # sha256 = pkgs.lib.fakeSha256;
  };
in
import "${src}/default.nix"

in configuration.nix:

environment.systemPackages = with pkgs; [

  # ...

  (import ./photor.nix { inherit pkgs; })
];

Troubleshooting

At some point the installation was failing with:

error: this derivation has bad 'meta.outputsToInstall'

Running $ nix-env -u --always solved the problem.

Database migrations

$ sqlx migrate add -r some_new_migration
$ # edit the created files, then:
$ sqlx migrate run
$ # or rollback:
$ sqlx migrate revert

Run the code in dev mode

cargo run -- --help

Features / TODO

General

show the CLI help when no arguments are given
clean code mess ¯_(ツ)_/¯

Database

integration of migrations files in the build
database initialization command
database migration command

To be added in the DB for each photo:

Maintenance

check if all photos in database have their corresponding file on disk
check that files on disk match the data in DB (+ checksum check)
command to rebuild / complete database entries missing data

Repository

command to output simple stats:
- size on disk
- number of files (photos / videos)
- last time since maintenance run

Disc burn utilities

FUSE mount of files listed after DB query
photos selection from start date / photo DB id that fits on a disc of some capacity
see xorriso integration or input generation

Web server

generate thumbnails of pictures
serve the repository for reading via HTTP
photos tournament to find the best ones

ybycode/photor