Metadata-Version: 2.1
Name: pdf-renamer
Version: 1.0rc2
Summary: A python library/command-line tool to automatically rename the pdf files of scientific publications by looking up the publication metadata on the web.
Home-page: https://github.com/MicheleCotrufo/pdf-renamer
Author: Michele Cotrufo
Author-email: michele.cotrufo@gmail.com
License: MIT
Description: # pdf-renamer
        pdf-renamer is a Python command-line tool to automatically rename the pdf files of a scientific paper, or in general any publication which can be associated to a [DOI](http://dx.doi.org) or
        other identifiers (e.g. [arXiv](https://arxiv.org)). It can be used to rename single files or to scan entire folders and sub-folders.
        The format of the filename can be specified by the user by choosing among several tags. Besides command-line operation, it can also be used as a library
        from your Python project. 
        
        ## Table of Contents
         - [Description](#description)
         - [Installation](#installation)
         - [Usage](#usage)
         - [Installing the shortcuts in the right-click context menu of Windows](#installing-the-shortcuts-in-the-right-click-context-menu-of-windows)
          - [Contributing](#contributing)
         - [License](#license)
        
        ## Description
        ```pdf-renamer``` uses the libraries [pdf2doi](https://github.com/MicheleCotrufo/pdf2doi) and [pdf2bib](https://github.com/MicheleCotrufo/pdf2bib) to extract 
        bibliographic data of a paper starting from a .pdf file. The retrieved data can then be used to automatically rename pdf files with a custom format (e.g. 'Year - Journal - Authors - Title').
        
        ## Installation
        [![Downloads](https://pepy.tech/badge/pdf-renamer)](https://pepy.tech/project/pdf-renamer)[![Downloads](https://pepy.tech/badge/pdf-renamer/month)](https://pepy.tech/project/pdf-renamer)
        [![Pip Package](https://img.shields.io/pypi/v/pdf-renamer?logo=PyPI)](https://pypi.org/project/pdf-renamer?versions=1.0rc2)
        
        Use the package manager pip to install ```pdf-renamer```.
        
        ```bash
        pip install pdfrenamer==1.0rc2
        ```
        This will install ```pdf-renamer``` as  Python package, but also as a stand-alone executable script. 
        The executable will be installed in a directory whose path depends on the type of Python installation and the operating system. 
        Make sure that this directory is in the ```PATH``` variable of your operating system (for standard python installations under Windows this should be already the case). 
        Check how to do add the folder to the ```PATH``` variable for [Windows](https://www.google.com/search?q=python+add+script+folder+to+path+windows), 
        [Mac](https://www.google.com/search?q=python+add+script+folder+to+path+mac) and [Linux](https://www.google.com/search?q=python+add+script+folder+to+path+linux).
        
        Under Windows, it is also possible to add [shortcuts to the right-click context menu](#installing-the-shortcuts-in-the-right-click-context-menu-of-windows).
        
        ## Usage
        
        ```pdf-renamer``` can be invoked directly from the command line, without having to open a python console.
        The simplest command-line invokation is
        
        ```
        $ pdfrenamer 'path/to/target'
        ```
        where ```target``` is either a valid pdf file or a directory containing pdf files. ```pdf-renamer``` will automatically rename the file(s) in ```path/to/target``` 
        (assuming that they are valid publications for which a DOI/arXiv ID can be found), by using the standard settings.
        
        A list of the standard settings, and additional commands, can be obtained by typing ```pdfrenamer --h```
        
        Type
        
        ```
        $ pdfrenamer --h
        usage: pdfrenamer [-h] [-s] [-f FORMAT] [-sf] [-max_length_authors MAX_LENGTH_AUTHORS] [-max_length_filename MAX_LENGTH_FILENAME] [-add_abbreviation_file PATH_ABBREVIATION_FILE] [-sd] [-install--right--click] [-uninstall--right--click]
                          [path [path ...]]
        
        Automatically renames pdf files of scientific publications by retrieving their identifiers (e.g. DOI or arxiv ID) and looking up their bibtex infos.
        
        positional arguments:
          path                  Relative path of the pdf file or of a folder.
        
        optional arguments:
          -h, --help            show this help message and exit
          -s, --decrease_verbose
                                Decrease verbosity. By default (i.e. when not using -s), all steps performed by pdf-renamer, pdf2dbib and pdf2doi are documented.
          -f FORMAT             Format of the new filename. Default = "{YYYY} - {Jabbr} - {A3etal} - {T}".
                                Valid tags:
                                {YYYY}          =        Year of publication
                                {MM}            =        Month of publication (in digits)
                                {DD}            =        Day of publication (in digits)
                                {J}             =        Full name of Journal
                                {Jabbr}         =        Abbreviated name of Journal, if any available (otherwise full name is used).
                                {Aall}          =        Last name of all authors (separated by comma)
                                {Aetal}         =        Last name of the first author, add 'et al.' if more authors are present
                                {A3etal}        =        Last name of the first three authors (separated by comma), add 'et al.' if more authors are present
                                {aAall}         =        First initial and last name of all authors (separated by comma)
                                {aAetal}        =        First initial and last name of the first author, add 'et al.' if more authors are present
                                {aA3etal}       =        First initial and last name of the first three authors (separated by comma), add 'et al.' if more authors are present
                                {T}             =        Title.
          -sf, --sub_folders    Rename also pdf files contained in subfolders of target folder. Default = "False".
          -max_length_authors MAX_LENGTH_AUTHORS
                                Sets the maximum length of any string related to authors (default=80).
          -max_length_filename MAX_LENGTH_FILENAME
                                Sets the maximum length of any generated filename. Any filename longer than this will be truncated (default=250).
          -add_abbreviation_file PATH_ABBREVIATION_FILE
                                The content of the text file specified by PATH_ABBREVIATION_FILE will be added to the user list of journal abbreviations.
                                Each row of the text file must have the format 'FULL NAME = ABBREVIATION'.
          -sd, --set_default    By adding this command, any value specified (in this same command) for the filename format (-f), max length of author string (-max_length_authors), max length of filename string (-max_length_filename) will be also stored as default value(s) for the future.
          -install--right--click
                                Add a shortcut to pdf-renamer in the right-click context menu of Windows. You can rename a single pdf file (or all pdf files in a folder) by just right clicking on it! NOTE: this feature is only available on Windows.
          -uninstall--right--click
                                Uninstall the right-click context menu functionalities. NOTE: this feature is only available on Windows.
        ```
        Several tags (as listed above) can be used to change the standard filename format, for example,
        ```
        $ pdfrenamer 'path/to/target' -f "{YYYY} - {Aetal} - {J} - {T}"
        ```
        will produce filenames which start with the year of publication, followed by first initial and full last name of first author + et al. (if more authors are present), followed by the full
        journal name and the paper title.  Note that **the tags are case sensitive**.
        Other useful settings are MAX_LENGTH_AUTHORS and MAX_LENGTH_FILENAME, which set the maximum lengths allowed for the author information and the overall filename, respectively. 
        The values of all these settings can be specified simultaneously, e.g.
        ```
        $ pdfrenamer 'path/to/target' -f "{YYYY} - {Aetal} - {J} - {T}" -max_length_authors 40 -max_length_filename 200
        ```
        The values set for FORMAT, MAX_LENGTH_AUTHORS and MAX_LENGTH_FILENAME, however, are not permanently changed, unless the optional command ```-sd``` (set default) is added,
        ```
        $ pdfrenamer 'path/to/target' -f "{YYYY} - {Aetal} - {J} - {T}" -max_length_authors 40 -max_length_filename 200 -sd
        ```
        In this case the new values are saved in a settings.ini file inside the ```pdf-renamer``` folder (as can be checked by typing ```pdfrenamer --h``` again).
        
        
        
        ## Contributing
        Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
        
        
        ## License
        [MIT](https://choosealicense.com/licenses/mit/)
        
Platform: UNKNOWN
Description-Content-Type: text/markdown
