Metadata-Version: 1.1
Name: ptt-mail-backup
Version: 0.4.0
Summary: Backup PTT mail
Home-page: https://github.com/eight04/ptt-mail-backup
Author: eight
Author-email: eight04@gmail.com
License: MIT
Description: ptt-mail-backup
        ===============
        
        .. image:: https://travis-ci.com/eight04/ptt-mail-backup.svg?branch=master
            :target: https://travis-ci.com/eight04/ptt-mail-backup
            
        一個用來備份 PTT 站內信的 CLI 工具。不會再因為站內信打包失敗而把信箱塞爆一整個禮拜。
        
        Features
        --------
        
        * 使用 SSH 連上 PTT，再一頁頁爬
        * 下載回來的檔案為 Big5-UAO 編碼
        * 支援自動換行、寬度大於 80 的文章
        * 支援上色、閃爍、雙色字
        
        Installation
        ------------
        
        From `PYPI <https://pypi.org/project/ptt-mail-backup/>`__:
        
        ::
        
          pip install ptt-mail-backup
          
        Usage
        -----
        
        執行 ``ptt-mail-backup ...``::
        
          usage: ptt-mail-backup [-h] [-u USER] [-p PASSWORD] [-d DEST] [-v]
                                 [-f FILENAME_FORMAT] (-r START END | --all)
        
          Backup PTT mail.
        
          optional arguments:
            -h, --help            show this help message and exit
            -u USER, --user USER  username, otherwise prompt for the value.
            -p PASSWORD, --pass PASSWORD
                                  password, otherwise prompt for the value.
            -d DEST, --dest DEST  save to dest. Default: '.'
            -v, --verbose         print verbose message.
            -f FILENAME_FORMAT, --filename-format FILENAME_FORMAT
                                  filename format. Default: '{index}. [{board}] {title}
                                  [{author}] ({time:%Y%m%d%H%M%S}).ans'
            -r START END, --range START END
                                  specify a range (inclusive). Negative values and zeros
                                  are allowed, they are treated as (last_index + value)
                                  i.e. --range 0 0 would download the last mail. This
                                  option could be used multiple times.
            --all                 download all
        
        或是 ``python -m ptt_mail_backup ...``。
        
        範例
        ~~~~
        
        下載所有信件到 2018-06-12 資料夾::
        
          ptt-mail-backup -d 2018-06-12 --all
          
        下載最新的十封信件::
        
          ptt-mail-backup -r -9 0
          
        從 CLI 傳入使用者名稱、密碼，並下載最舊的信件::
        
          ptt-mail-backup -u myusername -p mypassword -r 1 1
          
        License
        -------
        
        The distributed package `includes a branch of pyte <https://github.com/eight04/pyte/tree/dev-blink>`__ which supports blinking text. ``pyte`` is licensed under LGPL v3 and ``ptt_mail_backup`` itself is licensed under MIT.
              
        Changelog
        ---------
        
        * 0.4.0 (Jun 30, 2021)
        
          - Bump dependencies
          - Fix: hang while fetching index
        
        * 0.3.0 (Aug 26, 2019)
        
          - Breaking: stop relying on the footer information.
          - Fix: unable to download articles including ``**s`` or ``**n``.
        
        * 0.2.3 (Aug 21, 2019)
        
          - Fix: handle login views.
        
        * 0.2.2 (Nov 18, 2018)
        
          - Fix: Support Python 3.7.
        
        * 0.2.1 (Jul 25, 2018)
        
          - Fix: handle ``mailbox is full`` message.
          - Fix: handle ``add new board to favorite`` message.
        
        * 0.2.0 (Jun 22, 2018)
        
          - The distributed package now includes ``pyte`` with blinking text support.
          - Add: a better way to get full title.
          - Add: allow multiple ``--range``.
          - Fix: handle password error.
          - Fix: handle article recovery screen.
          - Fix: handle password attack alert screen.
        
        * 0.1.1 (Jun 12, 2018)
        
          - Fix: missing deps.
        
        * 0.1.0 (Jun 12, 2018)
        
          - First release.
        
Keywords: ptt,mail
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: Chinese (Traditional)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Communications :: BBS
