amber/tumblr-stats

Go to file

Amber a23bd35001 Complete rewrite with Polars. No more single loop to fetch all data; posts, queued posts, drafts, and activity are all fetched separately. Extra caution when querying API to prevent HTTP 429

2026-10-21 22:14:15 -04:00

.gitignore

build_draft_stats, total_original_post_notes_by_qtr_and_year, other minor improvements

2026-04-04 02:07:19 -04:00

build_deep_stats_model.py

Added build_deep_stats_model, made other small tweaks

2026-08-17 21:28:15 -04:00

build_draft_stats_model.py

build_draft_stats, total_original_post_notes_by_qtr_and_year, other minor improvements

2026-04-04 02:07:19 -04:00

build_queue_stats_model.py

Added operation for calculating stats on queued posts, improved loop handling

2026-01-03 23:08:01 -05:00

build_tag_stats_model.py

Greatly cleaned up and simplified core logic

2025-12-31 00:54:36 -05:00

build_total_stats_model.py

Making the outputs a bit more organized, adding some more stats to them

2025-12-30 19:52:34 -05:00

fetcher.py

Complete rewrite with Polars. No more single loop to fetch all data; posts, queued posts, drafts, and activity are all fetched separately. Extra caution when querying API to prevent HTTP 429

2026-10-21 22:14:15 -04:00

model.py

Complete rewrite with Polars. No more single loop to fetch all data; posts, queued posts, drafts, and activity are all fetched separately. Extra caution when querying API to prevent HTTP 429

2026-10-21 22:14:15 -04:00

pdm.lock

Refactored to use specific classes for different operations

2025-12-30 00:21:28 -05:00

pyproject.toml

Complete rewrite with Polars. No more single loop to fetch all data; posts, queued posts, drafts, and activity are all fetched separately. Extra caution when querying API to prevent HTTP 429

2026-10-21 22:14:15 -04:00

README.md

Complete rewrite with Polars. No more single loop to fetch all data; posts, queued posts, drafts, and activity are all fetched separately. Extra caution when querying API to prevent HTTP 429

2026-10-21 22:14:15 -04:00

stats_model.py

Added build_deep_stats_model, made other small tweaks

2026-08-17 21:28:15 -04:00

tumblr_stats.py

Complete rewrite with Polars. No more single loop to fetch all data; posts, queued posts, drafts, and activity are all fetched separately. Extra caution when querying API to prevent HTTP 429

2026-10-21 22:14:15 -04:00

uv.lock

Complete rewrite with Polars. No more single loop to fetch all data; posts, queued posts, drafts, and activity are all fetched separately. Extra caution when querying API to prevent HTTP 429

2026-10-21 22:14:15 -04:00

README.md

tumblr-stats

Usage

usage: tumblr_stats.py [-h] -b BLOG [-t TAGS [TAGS ...]]
                       [-s {none,posts,queued,drafts,activity} [{none,posts,queued,drafts,activity} ...]] [--until UNTIL]
                       [--since SINCE] [--queued-file QUEUED_FILE] [--drafts-file DRAFTS_FILE] [--posts-file POSTS_FILE]
                       [--activity-file ACTIVITY_FILE]

Use pytumblr and Polars to calculate stats after setting these enviroment variables: $TUMBLR_CONSUMER_KEY,
$TUMBLR_CONSUMER_SECRET, $TUMBLR_OAUTH_TOKEN, and $TUMBLR_OAUTH_SECRET

options:
  -h, --help            show this help message and exit
  -b, --blog BLOG       blog name for which to calculate stats
  -t, --tags TAGS [TAGS ...]
                        tag(s) on which to filter (only affects posts)
  -s, --suppress {none,posts,queued,drafts,activity} [{none,posts,queued,drafts,activity} ...]
                        objects to skip when aggregating data; will render some stats empty
  --until UNTIL         only gather posts and activity until YYYY-MM-DD
  --since SINCE         only fetch posts and activity since YYYY-MM-DD
  --queued-file QUEUED_FILE
                        read queued posts from this path instead of fetching them from APIs
  --drafts-file DRAFTS_FILE
                        read drafts from this path instead of fetching them from APIs
  --posts-file POSTS_FILE
                        read posts from this path instead of fetching them from APIs
  --activity-file ACTIVITY_FILE
                        read activity from this path instead of fetching it from APIs

— Be gay and do crime