Skip to content

docs: document hub aliases in README - #12

Merged
transfix merged 2 commits into
masterfrom
docs-hub-aliases
Jul 3, 2026
Merged

transfix merged 2 commits into
masterfrom
docs-hub-aliases

Conversation

@transfix

@transfix transfix commented Jul 3, 2026

Copy link
Copy Markdown
Owner

Summary

Documents the existing hub aliases feature (eispy hub alias) in the README, which is also the PyPI long description (readme = "README.md").

The feature — short names for hub URLs stored in ~/.config/eispy/hubs.json (overridable via EISPY_HUBS_FILE) — was fully implemented and tested but never documented, so it was invisible on both GitHub and the PyPI project page. Users had no way to discover it.

Changes

  • Features list: added a one-line bullet for discoverability.
  • New CLI subsection #### Hub aliases (eispy hub alias):
    • add / ls / rm commands
    • storage location + EISPY_HUBS_FILE override
    • supported URL schemes (dchub://, nmdcs://, adc://, adcs://)
    • examples showing an alias used across connect / users / chat / search / up

Docs-only change; no code or behavior changes.

Notes

PyPI descriptions are frozen per-release, so this will surface on the PyPI page with the next version upload (not on the current live 2.6.0.0 page).

transfix added 2 commits July 3, 2026 17:36
The `eispy hub alias` feature (short names for hub URLs, stored in
~/.config/eispy/hubs.json) was fully implemented but undocumented, so it
never surfaced on GitHub or the PyPI project page. Add:

- a Features bullet for discoverability
- a "Hub aliases (eispy hub alias)" CLI subsection covering
  add/ls/rm, storage + EISPY_HUBS_FILE override, supported URL
  schemes, and usage across connect/users/chat/search/up
The client is built with LUA_SCRIPT=ON, so source builds need Lua dev
headers to match the core ABI. Add liblua5.4-dev plus the other
FetchContent build deps (pcre2, miniupnpc, idn2, gettext) to the
Ubuntu/Debian apt list, with a note about the ABI requirement.
@transfix
transfix merged commit c30a10e into master Jul 3, 2026
@transfix
transfix deleted the docs-hub-aliases branch July 3, 2026 22:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant