Metadata-Version: 2.1
Name: ppd
Version: 0.2.2
Summary: Download 'periodic' Jehovah's Witnesses publications from the command line
Home-page: https://github.com/mikiTesf/ppd
Author: Mikyas Tesfamichael
Author-email: mickyastesfamichael@gmail.com
License: UNKNOWN
Description: 
        ## PPD (Periodic Publication Downloader)
        ```
        usage: ppd [-h] [-m MONTH] [-y YEAR] [-l LANG] [-f FORMAT] [-o] [-r] [-c] [-v] pub
        
            Short for "Periodic Publication Downloader", ppd is a script written using Python 3.8 that downloads the
            "periodic" Jehovah's Witness publication specified. You can download Awakes, Watchtowers (Public and Study)
            or Meeting Workbooks in any format from the command line.
        
        positional arguments:
          pub                   The type of publication to download (w | wp | g | mwb)
        
        optional arguments:
          -h, --help            show this help message and exit
          -m MONTH, --month MONTH
                                The month of the issue (defaults to the current month)
          -y YEAR, --year YEAR  The year of the issue (defaults to the current year)
          -l LANG, --lang LANG  The short language code of the target language
                                (ex: AM for Amharic, E for English, etc. Defaults to AM)
          -f FORMAT, --format FORMAT
                                The file format of the download. PDF, JWPUB, EPUB, BRL or RTF (defaults to JWPUB)
          -o, --link-only       Only show download links (publications will not be downloaded)
          -r, --hierarchy       Create a directory hierarchy in the current working directory in which downloaded
                                publications will be saved. The hierarchy follows the following pattern:
                                        <publication-type>/<publication-language>/<publication-year>/
        
                                For example if you download all public Watchtowers of 2020 in the Amharic language,
                                this is what the file tree for the downloads will look like:
                                                wp/
                                                └── AM
                                                    └── 2020
                                                        ├── wp_AM_202001.extn
                                                        ├── wp_AM_202005.extn
                                                        └── wp_AM_202009.extn
          -c, --cont            Continue fetching links for releases of the specified publication
                                until the end of the year (see the last example below)
          -v, --version         show program's version number and exit
        
        examples:
            Executing the command below will not download any publication as the publication is not specified.
            % ppd --year=2010 --month=2 --format=pdf --lang=e
        
            This will download the Awake of September 2010 in the PDF format and the English language.
            % ppd g --year=2010 --month=9 --format=pdf --lang=e
        
            This will download the Public Watchtower of the current year and month in the EPUB format
            and the Arabic language.
            % ppd wp --format=epub --lang=a
        
            This will download all Meeting Workbook issues from January 2018 up to December 2018
            in the JWPUB format and the Amharic language (note that `--cont` is passed).
            % ppd mwb --year=2018 --month=1 --format=jwpub --lang=am --cont
        
        more on options:
            Short options can be used in place of long ones. Here is the short option equivalent of the
            last example above:
            % ppd mwb -y 2018 -m 1 -f jwpub -l am -c
        
        author:
            Mikyas Tesfamichael (mickyastesfamichael@gmail.com)
        ```
        
        It was written using Python 3.8 and the minimum version of Python 3 its compatible with is uncertain.
        
        #### Installation
        `ppd` is available on [PyPI](https://pypi.org/project/ppd/). You can install it with: `pip install ppd`.
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.6
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
