ptt-mail-backup
一個用來備份 PTT 站內信的 CLI 工具。不會再因為站內信打包失敗而把信箱塞爆一整個禮拜。
Features
使用 SSH 連上 PTT,再一頁頁爬
下載回來的檔案為 Big5-UAO 編碼
支援自動換行、寬度大於 80 的文章
支援上色、閃爍、雙色字
Installation
> NOTE: This package requires python 3.7+
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.6.0 (Feb 28, 2024)
Bump dependencies.
Change: require python 3.7+.
Fix: issues with wcwidth 0.2.13.
0.5.0 (Feb 3, 2024)
Bump dependencies.
Fix: hang while refreshing screen.
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.
Metadata
Release files for ptt-mail-backup 0.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ptt-mail-backup-0.6.0.tar.gz | 35.8 kB | Without provenance | Details for ptt-mail-backup-0.6.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ptt_mail_backup-0.6.0-py3-none-any.whl | Python 3 | none | any | Details for ptt_mail_backup-0.6.0-py3-none-any.whl |
Total release size: 74.1 kB
Release files / ptt-mail-backup-0.6.0.tar.gz
| Download URL | ptt-mail-backup-0.6.0.tar.gz |
|---|---|
| Size | 35.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
445c5b77040791e105258d329736d816b075f4f5d33ee55cad7c217e05709a3f
|
|
BLAKE2b-256 checksum How to use checksums |
d390cb06ae518ae4b6144520976b707aaba39c49489a0f784fc50378a8cc190e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.12.2
|
Release files / ptt_mail_backup-0.6.0-py3-none-any.whl
| Download URL | ptt_mail_backup-0.6.0-py3-none-any.whl |
|---|---|
| Size | 38.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
725128fffc477936782cc463f285307a8c530db4dcefc8ed4963a99d0e35f20d
|
|
BLAKE2b-256 checksum How to use checksums |
fba9770dce0e19f92e4469e2aef19f18ae587980fa4892be4dc8ff25ba79d9ef
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.12.2
|
Security for ptt-mail-backup 0.6.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.