pboy

Paperboy est un petit utilitaire de gestion .pdf.

Si vous téléchargez des papiers et d'autres documents PDF, vous avez peut-être remarqué que des noms de fichiers comme 1412.4880.pdf ne sont pas très utiles pour trouver quoi que ce soit plus tard. Surtout si votre dossier de téléchargement contient également environ quatre-vingts fichiers de catloaf.jpg , David_Lynch_Teaches_Typing.zip et 160502_0001.wav .

Cet outil aide à cela. Il offrira de renommer et de déplacer des fichiers dans un dossier spécifié, et il donne même quelques suggestions de noms de fichiers en regardant le contenu et les métadonnées PDF.

Paperboy garde son stupide gestion des fichiers (pas de maintien de fichiers dans une base de données ou un dossier de bibliothèque caché), vous pouvez donc le désinstaller à tout moment et vos fichiers resteront parfaitement accessibles.

Usage

• Ouvrez une nouvelle boîte de dialogue d'importation de fichiers avec Entrée ou Space .
• Communiquez entre la boîte de réception et la bibliothèque avec l'onglet .
• Ouvrez un fichier de la bibliothèque avec Entrée ou Space .
• Renommez un fichier déjà importé avec r .
• Quittez l'application avec ESC ou Q ou abandonnez avec Ctrl + c .

Installer

Homebrew sur macOS

Si vous êtes un utilisateur Homebrew, vous pouvez installer la dernière version et ses dépendances à partir du TAP du repo:

 $ brew install 2mol/tools/pboy

Version binaire Linux / Mac

Téléchargez l'archive de votre système d'exploitation à partir de https://github.com/2mol/pboy/releases. Extraire et l'installer avec

 $ tar zxvf pboy*.tar.gz
$ mv pboy ~/.local/bin/

Pour que ce dernier fonctionne, ~/.local/bin/ doit exister et être sur votre PATH . Alternativement, mettez-le dans /usr/local/bin .

Linux, n'importe quelle distribution

Je cherche toujours à emballer Paperboy pour Debian / Ubuntu, Arch / Manjaro, Fedora, Doge Linux, ou tout ce que les gens installent de nos jours.

Tous les pointeurs ou aides en ce qui concerne la génération .deb , .rpm , aur PKGBUILD , etc. est apprécié. Idéalement, cela pourrait être principalement automatisé en CI, à la fin Paperboy n'est qu'un seul binaire avec une dépendance ou deux. Comment les autres packages le font-ils? Si vous avez un bon exemple ou un bon lien, ouvrez un problème GitHub!

Cabale / pile

Assurez-vous que poppler , qui fournira à la fois pdftotext et pdfinfo . Sur Linux, installez poppler avec votre gestionnaire de packages de choix. Si vous êtes sur Mac et que vous utilisez Homebrew, vous pouvez faire brew install poppler .

En supposant que vous avez Cabal ou Stack, ce qui suit se compilera, puis installez l'exécutable pboy dans votre .local/bin :

 $ git clone [email protected]:2mol/pboy.git
$ cd pboy
$ stack install

Remplacez stack install par cabal new-install à votre guise.

Rien

Si vous avez NIX, vous pouvez installer pboy avec une seule commande:

 $ nix-env -if https://github.com/2mol/pboy/tarball/main

Configurer

Paperboy crée un pboy.ini dans votre répertoire de configuration XDG. Ceci est probablement dans ~/.config/pboy/pboy.ini , l'écran d'accueil ou d'aide vous le dira. Utilisez-le pour modifier votre bibliothèque et vos dossiers entrants, ainsi que pour spécifier si vous souhaitez déplacer les fichiers importés ou simplement les copier.

Limitations actuelles

Paperboy ne fait rien de fantaisie pour fournir encore des modèles de renommage. Par exemple, certaines personnes ont demandé à pouvoir spécifier un format comme author-document_name-date.pdf , d'autres ont demandé s'ils pouvaient composer plusieurs suggestions en une seule. Je n'ai pas trouvé un moyen de le faire tout en gardant l'interface utilisateur simple et simple, donc l'idée a besoin d'un peu de travail de conception en premier.

Contribuer

Vous êtes très bien invité à suggérer de nouvelles fonctionnalités ou des problèmes ouverts. Voir la feuille de route https://github.com/2mol/pboy/blob/main/roadmap.md pour avoir une idée de ce qui est prévu pour les futures versions.

Les versions peuvent être créées en poussant une nouvelle balise:

git tag -a 1.99rc1 -m " release candidate 1.99 "
git push --follow-tags

Cela publiera des actifs compilés pour OSX et Linux, mais créera uniquement un préreasage. Une fois que vous êtes convaincu que l'exécutable n'est pas rompu, un contributeur Repo peut marquer la version en tant que version.

Enfin, pour publier la nouvelle version via Homebrew, le repo des outils doit être mis à jour avec le SHA256 de pboy-osx.tar.gz . Vous pouvez le trouver dans les journaux CI, ou vous pouvez exécuter shasum -a 256 pboy-osx.tar.gz manuellement.

Merci

• La brique est une belle façon d'écrire une interface utilisateur de ligne de commande.
• Nmattia a fait le travail pour faire construire Paperboy avec Nix et m'a patiemment expliqué certaines des bases.
• Osugisakae et Bri-An sur Reddit m'ont aidé avec un problème de performance ennuyeux!
• Nils Steinger pour les contributions des fonctionnalités.
• Adrian Sieber pour avoir contribué.

Le nom «Paperboy» est une référence à ce jeu, que j'avais pour les NES et jamais tout à fait maîtrisé.