Wishlist for "1.0" release

[dgw]

These are things that would be nice to support/fix before declaring the plugin "stable" and releasing it on PyPI.

• [x] Meta: Switch from setup.py-style build/install to pyproject.toml
  • Done in #10
• [x] Indicate "Dead comment" vs. just plain "Comment" when a comment is "dead": true in Firebase JSON
  • "text" may be "[dead]", "[flagged]", possibly other values—but the original text is hidden if a comment is dead
  • Sample items: 37114623, 37115010
  • Implemented in #4
• [x] Handle null items (e.g. mistyped or otherwise mangled ID, nuked beyond dead status, etc.)
  • Quick test of json.loads("null") says this should mean the item/user will satisfy is None, which is an easy sanity check to add at runtime and give a friendly error message if the object doesn't exist
  • Current code already does this, actually; only relevant to not-yet-handled stuff like users, which mentions the possibility of null separately
• [x] Show story submitter
  • Stories/links, like comments, have a by field showing who submitted them
  • Implemented in #7
• [x] Handle/differentiate "job" post type
  • Can have text or url, but seemingly not both (like a regular "story" item)
  • Sample items: 37111755, 37037224
  • Implemented in #6
• [ ] Handle(/differentiate?) "poll" post type
  • Sample items: 126809 ("poll" type example from HN API docs)
  • [ ] Handle "pollopt" item type? Listed under "parts" field of a "type": "poll" item Can't imagine people will ever link directly to a poll option, so maybe summarizing the poll options when a "poll" gets linked is better? (Lot of extra API hits, though.)
• [ ] Handle/differentiate items from "ask" & "show" tabs
  • Also of "type": "story", but will have text instead of url and usually a category-specific prefix on the title ("Ask HN:"/"Tell HN:" for "ask" tab; "Show HN:" for "show" tab)
  • Sample items:
  • 37111256 – "story" type with text only, found under "ask" tab
  • 37119235 – text post that does NOT start with "Ask HN" but was discovered near the top of the "ask" tab anyway, somehow
• [x] Handle stories of any type with no url field (current state as of 88c39cbcdc6df8127edd7b9ba09691846285b9d4: KeyError: 'url')
  • Sample items: 37111755 ("job" type with text only), 37111256 ("story" type with text only)
  • Implemented in #9
• [x] Handle deleted items (only deleted: true, id, time, and type fields present)
  • Sample: 38344153
  • Implemented in #8
• [ ] Handle user profiles
  • Samples:
  • voyagerfan5761 – me! …until I can get a username change
    • about field contains ", so make sure to decode HTML entities in user bios
  • pg – founder/developer? lots of activity, submitted item 1 😮
  • dgw – not me! (at least not yet.)
    • as of writing this, has no public activity; such users are just null in the API, making users who've never posted/commented indistinguishable from nonexistent users (which should also be handled)
• [ ] Deal with useless (on IRC) HTML tags, to avoid cases such as described in https://github.com/sopel-irc/sopel-hackernews/issues/3#issuecomment-1826808016
• [ ] Maybe handle oddball links someone might copy by accident, like /edit?id=NNNNNN

I'll add to this if I think of more after submitting the issue.

[ghost]

One to not forget: double links because of <a href> tags.

\<user> https://news.ycombinator.com/item?id=38421121

\<bot> [Hacker News] Comment by Ringz (2 hours, 28 minutes ago): My perfect bookmark manager is Markdownload \https://github.com/deathau/markdownload</a> ⏎ Just save the complete page, only selected text or only the link to a markdown file or Obsidian. With downloaded, linked or without pictures. My OS and Obsidian can search those files, they have more (automatically added) metadata. ⏎ I can even edit them […]

---

Edit: another example:

\ https://news.ycombinator.com/item?id=38472130

\ [Hacker News] Comment by i13e (2 hours, 8 minutes ago): This matches your requirements:\https://maps.google.com/</a>

[dgw]

v0.1.0 cut today with all the important functionality available. Submissions and comments work, and common edge cases like deleted items are handled.

In descending order of precedence, what's missing:

• User profile handling
• Stripping useless HTML, as mentioned in a comment above
• Differentiating/displaying polls and their options/results
• Handling "Ask/Show HN" items specially (maybe? just regular items with a specific title prefix, except when they're not)
• Support oddball HN links that happen to include an item ID anyway, like /edit (maybe?)