Skip to main content

Backup PTT mail

Project description

https://travis-ci.com/eight04/ptt-mail-backup.svg?branch=master

一個用來備份 PTT 站內信的 CLI 工具。不會再因為站內信打包失敗而把信箱塞爆一整個禮拜。

Features

  • 使用 SSH 連上 PTT,再一頁頁爬
  • 下載回來的檔案為 Big5-UAO 編碼
  • 支援自動換行、寬度大於 80 的文章
  • 支援上色、閃爍、雙色字

Installation

From PYPI:

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 which supports blinking text. pyte is licensed under LGPL v3 and ptt_mail_backup itself is licensed under MIT.

Changelog

  • 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ptt-mail-backup, version 0.3.0
Filename, size File type Python version Upload date Hashes
Filename, size ptt_mail_backup-0.3.0-py3-none-any.whl (39.2 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size ptt-mail-backup-0.3.0.tar.gz (33.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page