glidepath 1.0.0__tar.gz → 1.0.2__tar.gz

{glidepath-1.0.0 → glidepath-1.0.2}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: glidepath
-Version: 1.0.0
+Version: 1.0.2
 Summary: Desktop retirement and investment planner (UK-first, region-extensible).
 Keywords: retirement,pension,financial-planning,investment,uk,sipp,isa,monte-carlo
 Author: James Williams
 License-Expression: MIT AND CC-BY-NC-SA-4.0
 License-File: LICENSE
 License-File: LICENSE-DATA
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Win32 (MS Windows)
 Classifier: Environment :: X11 Applications :: Qt
 Classifier: Intended Audience :: End Users/Desktop
@@ -130,19 +130,45 @@ It is not financial advice and is not regulated; its outputs depend on
 assumptions that will not match reality. Do not make financial decisions
 based solely on this tool.
 
-## Run
+## Install
 
-Requires only [uv](https://docs.astral.sh/uv/). Install the latest
-release [from PyPI](https://pypi.org/project/glidepath/) and launch it:
+Glidepath is installed from [PyPI](https://pypi.org/project/glidepath/)
+with [uv](https://docs.astral.sh/uv/), which also fetches the Python it
+needs — you do not need Python installed first.
 
-```sh
-uv tool install glidepath
-glidepath
-```
+1. **Install uv.** Windows (PowerShell):
+
+   ```powershell
+   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+   ```
+
+   macOS or Linux:
+
+   ```sh
+   curl -LsSf https://astral.sh/uv/install.sh | sh
+   ```
+
+   Close and reopen the terminal, then check `uv --version` prints a
+   version.
 
-(`pipx install glidepath` works too. Glidepath is a desktop app
-distributed through PyPI, not a library — importing `glidepath`
-modules is not a supported API.)
+2. **Install glidepath:**
+
+   ```sh
+   uv tool install glidepath
+   ```
+
+3. **Launch it:**
+
+   ```sh
+   glidepath
+   ```
+
+If the shell cannot find `glidepath` afterwards, run
+`uv tool update-shell` once and reopen the terminal. Upgrade to a new
+release later with `uv tool upgrade glidepath`. (`pipx install
+glidepath` works too. Glidepath is a desktop app distributed through
+PyPI, not a library — importing `glidepath` modules is not a supported
+API.)
 
 Or run straight from a checkout:
 
@@ -164,6 +190,15 @@ use glidepath" walks through every tab. Save your plan from the File
 menu as a `.glidepath.json` file you own, stored wherever you choose;
 the next launch reopens your last plan automatically.
 
+## User guide
+
+[`docs/getting-started.md`](https://github.com/williajm/glidepath/blob/main/docs/getting-started.md)
+walks through the app step by step: installing on a machine with
+nothing on it, what to gather before you start, entering it on the
+Facts tab, reading the projection, and changing the assumptions behind
+it — the growth rate, inflation, fees, the planning horizon — on the
+Stated vs assumed tab.
+
 ## Developing
 
 Development additionally requires GNU Make, which drives every workflow

{glidepath-1.0.0 → glidepath-1.0.2}/README.md

@@ -102,19 +102,45 @@ It is not financial advice and is not regulated; its outputs depend on
 assumptions that will not match reality. Do not make financial decisions
 based solely on this tool.
 
-## Run
+## Install
 
-Requires only [uv](https://docs.astral.sh/uv/). Install the latest
-release [from PyPI](https://pypi.org/project/glidepath/) and launch it:
+Glidepath is installed from [PyPI](https://pypi.org/project/glidepath/)
+with [uv](https://docs.astral.sh/uv/), which also fetches the Python it
+needs — you do not need Python installed first.
 
-```sh
-uv tool install glidepath
-glidepath
-```
+1. **Install uv.** Windows (PowerShell):
+
+   ```powershell
+   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+   ```
+
+   macOS or Linux:
+
+   ```sh
+   curl -LsSf https://astral.sh/uv/install.sh | sh
+   ```
+
+   Close and reopen the terminal, then check `uv --version` prints a
+   version.
 
-(`pipx install glidepath` works too. Glidepath is a desktop app
-distributed through PyPI, not a library — importing `glidepath`
-modules is not a supported API.)
+2. **Install glidepath:**
+
+   ```sh
+   uv tool install glidepath
+   ```
+
+3. **Launch it:**
+
+   ```sh
+   glidepath
+   ```
+
+If the shell cannot find `glidepath` afterwards, run
+`uv tool update-shell` once and reopen the terminal. Upgrade to a new
+release later with `uv tool upgrade glidepath`. (`pipx install
+glidepath` works too. Glidepath is a desktop app distributed through
+PyPI, not a library — importing `glidepath` modules is not a supported
+API.)
 
 Or run straight from a checkout:
 
@@ -136,6 +162,15 @@ use glidepath" walks through every tab. Save your plan from the File
 menu as a `.glidepath.json` file you own, stored wherever you choose;
 the next launch reopens your last plan automatically.
 
+## User guide
+
+[`docs/getting-started.md`](https://github.com/williajm/glidepath/blob/main/docs/getting-started.md)
+walks through the app step by step: installing on a machine with
+nothing on it, what to gather before you start, entering it on the
+Facts tab, reading the projection, and changing the assumptions behind
+it — the growth rate, inflation, fees, the planning horizon — on the
+Stated vs assumed tab.
+
 ## Developing
 
 Development additionally requires GNU Make, which drives every workflow

{glidepath-1.0.0 → glidepath-1.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "glidepath"
-version = "1.0.0"
+version = "1.0.2"
 description = "Desktop retirement and investment planner (UK-first, region-extensible)."
 readme = "README.md"
 # MIT code plus one CC BY-NC-SA 4.0 data file (returns_history.toml —
@@ -22,7 +22,7 @@ keywords = [
 # No License :: classifier — PEP 639: the SPDX expression above is the
 # license metadata, and mixing it with license classifiers is deprecated.
 classifiers = [
-    "Development Status :: 4 - Beta",
+    "Development Status :: 5 - Production/Stable",
     "Environment :: Win32 (MS Windows)",
     "Environment :: X11 Applications :: Qt",
     "Intended Audience :: End Users/Desktop",