mdbkit 0.5.2__tar.gz → 0.5.4__tar.gz

{mdbkit-0.5.2 → mdbkit-0.5.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mdbkit
-Version: 0.5.2
+Version: 0.5.4
 Summary: Offline toolkit for MongoDB 4.4+ structured logs: log analysis, slow-query shapes, connection churn, and deterministic index advice. A spiritual successor to mtools' log tools.
 Author: Saqib Ameen Subhan
 License: MIT
@@ -135,6 +135,25 @@ Full detail: [SECURITY.md](SECURITY.md).
 
 ## Install
 
+### Linux
+
+**Most distributions:**
+```bash
+pip install mdbkit
+```
+
+**Ubuntu 20.04 / Debian / Amazon Linux 2 (Python 3.8 hosts):**
+```bash
+sudo apt install pipx        # or: sudo dnf install pipx
+pipx install mdbkit
+pipx ensurepath && source ~/.bashrc
+```
+
+**Modern Ubuntu/Debian complaining about "externally-managed-environment":**
+```bash
+pip install mdbkit --break-system-packages
+```
+
 ### macOS
 
 macOS ships no `pip` and no `pipx`, so `pip install` fails out of the box.
@@ -173,25 +192,6 @@ problem entirely.
 Do not install with `sudo`. mdbkit is a user-level CLI and needs no
 elevated privileges — not to install, and not to run.
 
-### Linux
-
-**Most distributions:**
-```bash
-pip install mdbkit
-```
-
-**Ubuntu 20.04 / Debian / Amazon Linux 2 (Python 3.8 hosts):**
-```bash
-sudo apt install pipx        # or: sudo dnf install pipx
-pipx install mdbkit
-pipx ensurepath && source ~/.bashrc
-```
-
-**Modern Ubuntu/Debian complaining about "externally-managed-environment":**
-```bash
-pip install mdbkit --break-system-packages
-```
-
 ### Windows
 
 ```powershell
@@ -215,11 +215,41 @@ resolve.
 
 ### Upgrading
 
+Use whichever matches how you installed it.
+
+```bash
+# Linux — installed with pip
+pip install --upgrade mdbkit
+
+# Linux — installed with pipx
+pipx upgrade mdbkit
+
+# macOS — installed with pipx (Homebrew route)
+pipx upgrade mdbkit
+
+# macOS — installed with python3 -m pip --user
+python3 -m pip install --user --upgrade mdbkit
+
+# macOS / Linux — installed with uv
+uv tool upgrade mdbkit
+
+# Windows
+py -m pip install --upgrade mdbkit
+```
+
+Then confirm:
 ```bash
-pip install --upgrade mdbkit             # or: pipx upgrade mdbkit
 mdbkit --version
 ```
 
+**If the version has not changed**, pip is serving a cached index. Force it:
+
+```bash
+pipx install --force mdbkit                          # pipx
+pip install --upgrade --no-cache-dir mdbkit          # pip
+py -m pip install --upgrade --no-cache-dir mdbkit    # Windows
+```
+
 Requires Python 3.8+. mdbkit never updates itself and never checks for
 updates — upgrades are always explicit.
 

{mdbkit-0.5.2 → mdbkit-0.5.4}/README.md

@@ -108,6 +108,25 @@ Full detail: [SECURITY.md](SECURITY.md).
 
 ## Install
 
+### Linux
+
+**Most distributions:**
+```bash
+pip install mdbkit
+```
+
+**Ubuntu 20.04 / Debian / Amazon Linux 2 (Python 3.8 hosts):**
+```bash
+sudo apt install pipx        # or: sudo dnf install pipx
+pipx install mdbkit
+pipx ensurepath && source ~/.bashrc
+```
+
+**Modern Ubuntu/Debian complaining about "externally-managed-environment":**
+```bash
+pip install mdbkit --break-system-packages
+```
+
 ### macOS
 
 macOS ships no `pip` and no `pipx`, so `pip install` fails out of the box.
@@ -146,25 +165,6 @@ problem entirely.
 Do not install with `sudo`. mdbkit is a user-level CLI and needs no
 elevated privileges — not to install, and not to run.
 
-### Linux
-
-**Most distributions:**
-```bash
-pip install mdbkit
-```
-
-**Ubuntu 20.04 / Debian / Amazon Linux 2 (Python 3.8 hosts):**
-```bash
-sudo apt install pipx        # or: sudo dnf install pipx
-pipx install mdbkit
-pipx ensurepath && source ~/.bashrc
-```
-
-**Modern Ubuntu/Debian complaining about "externally-managed-environment":**
-```bash
-pip install mdbkit --break-system-packages
-```
-
 ### Windows
 
 ```powershell
@@ -188,11 +188,41 @@ resolve.
 
 ### Upgrading
 
+Use whichever matches how you installed it.
+
+```bash
+# Linux — installed with pip
+pip install --upgrade mdbkit
+
+# Linux — installed with pipx
+pipx upgrade mdbkit
+
+# macOS — installed with pipx (Homebrew route)
+pipx upgrade mdbkit
+
+# macOS — installed with python3 -m pip --user
+python3 -m pip install --user --upgrade mdbkit
+
+# macOS / Linux — installed with uv
+uv tool upgrade mdbkit
+
+# Windows
+py -m pip install --upgrade mdbkit
+```
+
+Then confirm:
 ```bash
-pip install --upgrade mdbkit             # or: pipx upgrade mdbkit
 mdbkit --version
 ```
 
+**If the version has not changed**, pip is serving a cached index. Force it:
+
+```bash
+pipx install --force mdbkit                          # pipx
+pip install --upgrade --no-cache-dir mdbkit          # pip
+py -m pip install --upgrade --no-cache-dir mdbkit    # Windows
+```
+
 Requires Python 3.8+. mdbkit never updates itself and never checks for
 updates — upgrades are always explicit.
 

{mdbkit-0.5.2 → mdbkit-0.5.4}/mdbkit/__init__.py

@@ -1,3 +1,3 @@
 """mdbkit — an offline toolkit for MongoDB structured logs and index advice."""
 
-__version__ = "0.5.2"
+__version__ = "0.5.4"

{mdbkit-0.5.2 → mdbkit-0.5.4}/mdbkit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mdbkit
-Version: 0.5.2
+Version: 0.5.4
 Summary: Offline toolkit for MongoDB 4.4+ structured logs: log analysis, slow-query shapes, connection churn, and deterministic index advice. A spiritual successor to mtools' log tools.
 Author: Saqib Ameen Subhan
 License: MIT
@@ -135,6 +135,25 @@ Full detail: [SECURITY.md](SECURITY.md).
 
 ## Install
 
+### Linux
+
+**Most distributions:**
+```bash
+pip install mdbkit
+```
+
+**Ubuntu 20.04 / Debian / Amazon Linux 2 (Python 3.8 hosts):**
+```bash
+sudo apt install pipx        # or: sudo dnf install pipx
+pipx install mdbkit
+pipx ensurepath && source ~/.bashrc
+```
+
+**Modern Ubuntu/Debian complaining about "externally-managed-environment":**
+```bash
+pip install mdbkit --break-system-packages
+```
+
 ### macOS
 
 macOS ships no `pip` and no `pipx`, so `pip install` fails out of the box.
@@ -173,25 +192,6 @@ problem entirely.
 Do not install with `sudo`. mdbkit is a user-level CLI and needs no
 elevated privileges — not to install, and not to run.
 
-### Linux
-
-**Most distributions:**
-```bash
-pip install mdbkit
-```
-
-**Ubuntu 20.04 / Debian / Amazon Linux 2 (Python 3.8 hosts):**
-```bash
-sudo apt install pipx        # or: sudo dnf install pipx
-pipx install mdbkit
-pipx ensurepath && source ~/.bashrc
-```
-
-**Modern Ubuntu/Debian complaining about "externally-managed-environment":**
-```bash
-pip install mdbkit --break-system-packages
-```
-
 ### Windows
 
 ```powershell
@@ -215,11 +215,41 @@ resolve.
 
 ### Upgrading
 
+Use whichever matches how you installed it.
+
+```bash
+# Linux — installed with pip
+pip install --upgrade mdbkit
+
+# Linux — installed with pipx
+pipx upgrade mdbkit
+
+# macOS — installed with pipx (Homebrew route)
+pipx upgrade mdbkit
+
+# macOS — installed with python3 -m pip --user
+python3 -m pip install --user --upgrade mdbkit
+
+# macOS / Linux — installed with uv
+uv tool upgrade mdbkit
+
+# Windows
+py -m pip install --upgrade mdbkit
+```
+
+Then confirm:
 ```bash
-pip install --upgrade mdbkit             # or: pipx upgrade mdbkit
 mdbkit --version
 ```
 
+**If the version has not changed**, pip is serving a cached index. Force it:
+
+```bash
+pipx install --force mdbkit                          # pipx
+pip install --upgrade --no-cache-dir mdbkit          # pip
+py -m pip install --upgrade --no-cache-dir mdbkit    # Windows
+```
+
 Requires Python 3.8+. mdbkit never updates itself and never checks for
 updates — upgrades are always explicit.
 

{mdbkit-0.5.2 → mdbkit-0.5.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mdbkit"
-version = "0.5.2"
+version = "0.5.4"
 description = "Offline toolkit for MongoDB 4.4+ structured logs: log analysis, slow-query shapes, connection churn, and deterministic index advice. A spiritual successor to mtools' log tools."
 readme = "README.md"
 requires-python = ">=3.8"