Metadata-Version: 2.4
Name: sam3360
Version: 0.2.0
Summary: A personal developer CLI — a live 'about me' card powered by the public GitHub API.
Author: Sam3360
Project-URL: Homepage, https://github.com/sam3360
Project-URL: PyPI, https://pypi.org/project/sam3360/
Keywords: cli,github,portfolio,developer-tools
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# 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.

```bash
pip install sam3360
sam3360 --info
```

## Commands

| Command             | Description                                  |
|----------------------|-----------------------------------------------|
| `sam3360 --info`      | Basic profile summary                         |
| `sam3360 --github`    | GitHub stats + profile dashboard              |
| `sam3360 --repos`     | List public repositories (top by stars)       |
| `sam3360 --projects`  | Curated project showcase                      |
| `sam3360 --stats`     | Developer statistics (stars, forks, languages)|
| `sam3360 --activity`  | Recent public GitHub activity                 |
| `sam3360 --languages` | Languages used across repos                   |
| `sam3360 --links`     | Developer links (GitHub, PyPI, etc.)          |
| `sam3360 --about`     | Short developer bio                           |
| `sam3360 --version`   | Show the installed CLI version                |
| `sam3360 --help`      | Show the command overview                     |

### Examples

```text
$ 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
```

```text
$ 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

```text
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](https://github.com/sam3360)
