Include basic Poetry details in generated README

Closes #13
Also made a regen-golden-master.py in order to make updating easier.

Author: dbanty

openapi_python_client/templates/README.md

@@ -35,3 +35,18 @@ Things to know:
 1. If the API returns a response code that was not declared in the OpenAPI document, a 
     `{{ package_name }}.api.errors.ApiResponseError` wil be raised 
     with the `response` attribute set to the `httpx.Response` that was received.
+    
+
+## Building / publishing this Client
+This project uses [Poetry](https://python-poetry.org/) to manage dependencies  and packaging.  Here are the basics:
+1. Update the metadata in pyproject.toml (e.g. authors, version)
+1. If you're using a private repository, configure it with Poetry
+    1. `poetry config repositories.<your-repository-name> <url-to-your-repository>`
+    1. `poetry config http-basic.<your-repository-name> <username> <password>`
+1. Publish the client with `poetry publish --build -r <your-repository-name>` or, if for public PyPI, just `poetry publish --build`
+
+If you want to install this client into another project without publishing it (e.g. for development) then:
+1. If that project **is using Poetry**, you can simply do `poetry add <path-to-this-client>` from that project
+1. If that project is not using Poetry:
+    1. Build a wheel with `poetry build -f wheel`
+    1. Install that wheel from the other project `pip install <path-to-wheel>`

tests/test_end_to_end/golden-master/README.md

@@ -34,4 +34,19 @@ Things to know:
 1. Any endpoint which did not have a tag will be in `my_test_api_client.api.default`
 1. If the API returns a response code that was not declared in the OpenAPI document, a 
     `my_test_api_client.api.errors.ApiResponseError` wil be raised 
-    with the `response` attribute set to the `httpx.Response` that was received.
+    with the `response` attribute set to the `httpx.Response` that was received.
+    
+
+## Building / publishing this Client
+This project uses [Poetry](https://python-poetry.org/) to manage dependencies  and packaging.  Here are the basics:
+1. Update the metadata in pyproject.toml (e.g. authors, version)
+1. If you're using a private repository, configure it with Poetry
+    1. `poetry config repositories.<your-repository-name> <url-to-your-repository>`
+    1. `poetry config http-basic.<your-repository-name> <username> <password>`
+1. Publish the client with `poetry publish --build -r <your-repository-name>` or, if for public PyPI, just `poetry publish --build`
+
+If you want to install this client into another project without publishing it (e.g. for development) then:
+1. If that project **is using Poetry**, you can simply do `poetry add <path-to-this-client>` from that project
+1. If that project is not using Poetry:
+    1. Build a wheel with `poetry build -f wheel`
+    1. Install that wheel from the other project `pip install <path-to-wheel>`

tests/test_end_to_end/regen-golden-master.py

@@ -0,0 +1,19 @@
+""" Regenerate golden-master """
+import shutil
+from pathlib import Path
+
+from typer.testing import CliRunner
+
+from openapi_python_client.cli import app
+
+
+if __name__ == '__main__':
+    runner = CliRunner()
+    openapi_path = Path(__file__).parent / "fastapi" / "openapi.json"
+    gm_path = Path(__file__).parent / "golden-master"
+    shutil.rmtree(gm_path)
+    output_path = Path.cwd() / "my-test-api-client"
+
+    runner.invoke(app, ["generate", f"--path={openapi_path}"])
+
+    output_path.rename(gm_path)

tests/test_end_to_end/test_end_to_end.py

@@ -1,4 +1,3 @@
-import os
 import shutil
 from filecmp import cmpfiles, dircmp
 from pathlib import Path