sam3360

A personal developer CLI — a live "about me" card for Sam3360, powered by the public GitHub API. No dependencies beyond the Python standard library, no authentication required, works on Windows, macOS, and Linux.

pip install sam3360
sam3360 --info

Commands

Examples

$ sam3360 --info
╭──────────────────────────────────╮
│           sam3360 CLI            │
╰──────────────────────────────────╯

Profile
────────────────────────────────────
Username      sam3360
Name          Sam3360
Bio           N/A
Public repos  12
Followers     34
Following     5
Joined        2019-03-14

Profile: https://github.com/sam3360

$ sam3360 --stats
╭──────────────────────────────────╮
│         Developer Stats          │
╰──────────────────────────────────╯

Summary
────────────────────────────────────
Public repos    12
Total stars     58
Total forks     9
Languages used  4
Top languages   Python (7), JavaScript (3)
Followers       34
Following       5

Note: language counts reflect each repo's primary language
only, not a byte-level breakdown.

Live data, not hard-coded stats

Everything GitHub can provide — profile info, repositories, stars, forks, languages, and recent activity — is fetched live from the public GitHub API (https://api.github.com) each time you run a command. Nothing that GitHub can report is stored or hard-coded in the package.

The --projects, --links, and --about commands are the exception by design: they show a small, manually maintained showcase and bio, kept separate from live GitHub data. Edit them in sam3360/config.py.

Error handling

• No internet connection → a plain, friendly message (no traceback).
• GitHub rate limit hit (60 unauthenticated requests/hour/IP) → a clear explanation, not a raw HTTP error.
• A missing field in the GitHub response → shown as N/A instead of crashing.

Project structure

sam3360/
├── __init__.py    # Package version metadata
├── cli.py         # Argument parsing and command orchestration
├── github.py      # GitHub API access (stdlib urllib only)
├── display.py     # Terminal formatting, no third-party libraries
└── config.py      # Username, about text, links, curated projects

Requirements

• Python 3.8+
• No third-party dependencies — only the standard library.

Author

Sam3360 — github.com/sam3360