version 0.2.0 ready for release (#177)

Author: philipkiely-baseten

docs/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 Release notes for new versions of Truss, in reverse chronological order.
 
+### Version 0.2.0
+
+With this release, a minor version increment recognizes the overall progress made on Truss since its initial release in Summer 2022. And simplified naming for key functions improves Truss' developer experience, while carefully considered warnings and a long deprecation period ensure nothing breaks.
+
+#### Interface changes
+
+* In the Python client, `truss.create()` replaces `truss.mk_truss()`.
+* In the Python client, `truss.load()` replaces `truss.from_directory()`.
+* In the Truss handle, `truss.predict()` offers a shorter alternative to `truss.server_predict()`. To use in place of `truss.docker_predict()`, pass the optional kwarg `use_docker=True`.
+* In the command-line interface, the behavior of `truss predict` has been updated to match the Python client.
+  * Previously, `truss predict` ran on Docker by default, which could be overriden with `RUN_LOCAL=true`.
+  * Now, `truss predict` runs without Docker by default, which can be overriden with `USE_DOCKER=true`.
+
+These interface changes are intended to improve Truss' developer experience, not cause unnecessary trouble. As such, the old `mk_truss()` and `from_directory()` functions, while marked with a deprecation warning, will not be removed until the next major version update. And both `server_predict()` and `docker_predict()` will be supported in the Truss handle indefinitely.
+
 ### Version 0.1.5
 
 This release adds the `live_reload` option. This feature makes it faster to run a Truss in Docker in some situations, letting you develop your Truss without waiting for Docker to rebuild between changes.

docs/create/huggingface.md

@@ -44,7 +44,7 @@ Check the target directory to see your new Truss!
 To get a prediction from the Truss, try running:
 
 ```python
-tr.docker_predict({"inputs": ["Donatello is a teenage mutant [MASK] turtle"]})
+tr.predict({"inputs": ["Donatello is a teenage mutant [MASK] turtle"]})
 ```
 
 For more on running the Truss locally, see [local development](../develop/localhost.md).

docs/create/lightgbm.md

@@ -66,7 +66,7 @@ Check the target directory to see your new Truss!
 To get a prediction from the Truss, try running:
 
 ```python
-tr.docker_predict({"inputs": [[0, 0, 0, 0, 0, 0]]})
+tr.predict({"inputs": [[0, 0, 0, 0, 0, 0]]})
 ```
 
 For more on running the Truss locally, see [local development](../develop/localhost.md).

docs/create/sklearn.md

@@ -45,7 +45,7 @@ Check the target directory to see your new Truss!
 To get a prediction from the Truss, try running:
 
 ```python
-tr.docker_predict({"inputs": [[0, 0, 0, 0]]})
+tr.predict({"inputs": [[0, 0, 0, 0]]})
 ```
 
 For more on running the Truss locally, see [local development](../develop/localhost.md).

docs/create/xgboost.md

@@ -61,7 +61,7 @@ Check the target directory to see your new Truss!
 To get a prediction from the Truss, try running:
 
 ```python
-tr.docker_predict({"inputs": [[0, 0, 0, 0, 0, 0]]})
+tr.predict({"inputs": [[0, 0, 0, 0, 0, 0]]})
 ```
 
 For more on running the Truss locally, see [local development](../develop/localhost.md).

docs/develop/localhost.md

@@ -27,7 +27,7 @@ tr = truss.load("path_to_my_truss")
 From there, you can invoke the Truss to serve the model in your Python environment. Just run:
 
 ```python
-tr.docker_predict({"inputs": [[0, 0, 0, 0]]})
+tr.predict({"inputs": [[0, 0, 0, 0]]})
 ```
 
 ### Command line interface

docs/notebooks/huggingface_example.ipynb

@@ -1,12 +1,13 @@
 {
   "cells": [
     {
+      "attachments": {},
       "cell_type": "markdown",
       "metadata": {
         "id": "ndlSFJb7wCAU"
       },
       "source": [
-        "# Truss TensorFlow example\n",
+        "# Truss HuggingFace example\n",
         "\n",
         "<a href=\"https://colab.research.google.com/github/basetenlabs/truss/blob/main/docs/notebooks/sklearn_example.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>"
       ]
@@ -69,10 +70,17 @@
     },
     "kernelspec": {
       "display_name": "Python 3",
+      "language": "python",
       "name": "python3"
     },
     "language_info": {
-      "name": "python"
+      "name": "python",
+      "version": "3.8.9 (default, Apr 13 2022, 08:48:06) \n[Clang 13.1.6 (clang-1316.0.21.2.5)]"
+    },
+    "vscode": {
+      "interpreter": {
+        "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
+      }
     }
   },
   "nbformat": 4,

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "truss"
-version = "0.2.0rc0"
+version = "0.2.0"
 description = "A seamless bridge from model development to model delivery"
 license = "MIT"
 readme = "README.md"