papis/papis v0.9

A new plugin architecture is in place. For more information please refer to the documentation

Now some usual commands have a --git flag that lets the command work alongside git. For instance if the --git flag is passed to papis-edit, it will add and commit the info.yaml file automatically. The same applies to papis-add, papis-addto, papis-update and papis-rm.

You can activate by default the --git flag using the use-git configuration option. For devs: The main functions to implement this interface are found in the papis module papis.git.

• The configuration settings file-name and folder-name are now

  add-file-name
  add-folder-name
  

  so that they become more readable and understandable. Also the flag --name is now --folder-name.
• The flag --commit now has the name --git.
• The flag --dir now has the more descriptive name --subfolder.
• The flag --no-document has been finally removed.

• The most notable update is that papis is now able to guess a doi or arxiv id from a pdf that is being added, so the following could work

  papis add --confirm arxiv-paper.pdf
  

  or

  papis add --confirm some-random-paper.pdf
  

  with the --confirm flag it will ask if we want to use the doi or arxivid retrieved.

• We can query crossref with --from-crossref in order to get information and add a paper.

• The configuration settings export-text-format has been removed along with the export --text command. papis now support plugins so you should write your own instead.
• The flags --bibtex/--json/--yaml of the export command have been replaced by export --format=bibtex/json/yaml
• The flag --file has been removed, if you want to export the related files then just either export the folder or write a small script for it.

• Change the flags for papis explore export to match the papis export command.

• Add -n, --notes flags to list notes.
• Remove the --pick flag and add the --all flag to be consistent with the behaviour of other commands.
• Remove the query argument in the run function for consistency with other commands.

• Add --all flag, improve tests and log.

• The default papis database is now caching the document objects instead of only the paths, which means that no yaml parsing is necessary every time, which makes it around 10x faster than in version v0.8. For a library of 1200 documents, the speed of the papis database backend is comparable with the whoosh backend.
• The query language for the default papis database has changed, now the setter character is : instead of = to better conform with other common database engines like whoosh or xapian. For instance, before

  papis open 'author=einstein year=1905'
  

  and now it will be

  papis open 'author:einstein year:1905'
  

• Libraries can have multiple directories defined.

• A ~/.config/papis/config.py python file has been added which is sourced after the ~/.config/papis/config file has been processed. This should enable some users to have more granularity in the customization.

• Some downloaders have been improved and a fallback downloader has been added. Now you will be able to retrieve information from many more websites by by virtue of the metadata of html websites.