Merge pull request #810 from hugapi/develop

2.5.5 Release

Author: timothycrosley

.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 2.5.4
+current_version = 2.5.5
 
 [bumpversion:file:.env]
 

.editorconfig

@@ -1,10 +1,7 @@
 root = true
 
 [*.py]
-max_line_length = 120
+max_line_length = 100
 indent_style = space
 indent_size = 4
 ignore_frosted_errors = E103
-skip = runtests.py,build
-balanced_wrapping = true
-not_skip = __init__.py

.env

@@ -11,7 +11,7 @@ fi
 
 export PROJECT_NAME=$OPEN_PROJECT_NAME
 export PROJECT_DIR="$PWD"
-export PROJECT_VERSION="2.5.4"
+export PROJECT_VERSION="2.5.5"
 
 if [ ! -d "venv" ]; then
      if ! hash pyvenv 2>/dev/null; then

.gitignore

@@ -8,6 +8,7 @@
 *.egg-info
 build
 eggs
+.eggs
 parts
 var
 sdist
@@ -73,3 +74,6 @@ venv/
 
 # Emacs backup
 *~
+
+# VSCode
+/.vscode

.isort.cfg

@@ -0,0 +1,6 @@
+[settings]
+multi_line_output=3
+include_trailing_comma=True
+force_grid_wrap=0
+use_parentheses=True
+line_length=100

.travis.yml

@@ -20,7 +20,27 @@ matrix:
   - os: linux
     sudo: required
     python: 3.7
-    env: TOXENV=py37-marshmallow2
+    env: TOXENV=py37-marshmallow3
+  - os: linux
+    sudo: required
+    python: 3.7
+    env: TOXENV=py37-black
+  - os: linux
+    sudo: required
+    python: 3.7
+    env: TOXENV=py37-flake8
+  - os: linux
+    sudo: required
+    python: 3.7
+    env: TOXENV=py37-bandit
+  - os: linux
+    sudo: required
+    python: 3.7
+    env: TOXENV=py37-vulture
+  - os: linux
+    sudo: required
+    python: 3.7
+    env: TOXENV=py37-isort
   - os: linux
     sudo: required
     python: pypy3.5-6.0

ACKNOWLEDGEMENTS.md

@@ -84,6 +84,8 @@ Documenters
 - Joshua Crowgey (@jcrowgey)
 - Antti Kaihola (@akaihola)
 - Simon Ince (@Simon-Ince)
+- Edvard Majakari (@EdvardM)
+
 
 
 --------------------------------------------

CHANGELOG.md

@@ -11,6 +11,13 @@ Ideally, within a virtual environment.
 
 Changelog
 =========
+### 2.5.5 - June 13, 2019
+- Fixed issue #808: Problems with command line invocation via hug CLI
+- Fixed issue #647: Support for arbitrary URL complexity when using CORS middleware
+- Fixed issue #805: Added documentation for `map_params` feature
+- Added initial automated code cleaning and linting partially satisfying [HOPE-8 -- Style Guideline for Hug](https://github.com/hugapi/HOPE/blob/master/all/HOPE-8--Style-Guide-for-Hug-Code.md#hope-8----style-guide-for-hug-code)
+- Implemented [HOPE-20 -- The Zen of Hug](https://github.com/hugapi/HOPE/blob/master/all/HOPE-20--The-Zen-of-Hug.md)
+
 ### 2.5.4 hotfix - May 19, 2019
 - Fix issue #798 - Development runner `TypeError` when executing cli
 

Pipfile

@@ -0,0 +1,11 @@
+[[source]]
+url = "https://pypi.org/simple"
+verify_ssl = true
+name = "pypi"
+
+[packages]
+
+[dev-packages]
+
+[requires]
+python_version = "3.7"

README.md

@@ -25,7 +25,6 @@ As a result of these goals, hug is Python 3+ only and built upon [Falcon's](http
 
 [![HUG Hello World Example](https://raw.github.com/hugapi/hug/develop/artwork/example.gif)](https://github.com/hugapi/hug/blob/develop/examples/hello_world.py)
 
-
 Installing hug
 ===================
 
@@ -37,9 +36,9 @@ pip3 install hug --upgrade
 
 Ideally, within a [virtual environment](http://docs.python-guide.org/en/latest/dev/virtualenvs/).
 
-
 Getting Started
 ===================
+
 Build an example API with a simple endpoint in just a few lines.
 
 ```py
@@ -118,7 +117,6 @@ Then you can access the example from `localhost:8000/v1/echo?text=Hi` / `localho
 
 Note: versioning in hug automatically supports both the version header as well as direct URL based specification.
 
-
 Testing hug APIs
 ===================
 
@@ -141,7 +139,6 @@ def tests_happy_birthday():
     assert response.data is not None
 ```
 
-
 Running hug with other WSGI based servers
 ===================
 
@@ -155,7 +152,6 @@ uwsgi --http 0.0.0.0:8000 --wsgi-file examples/hello_world.py --callable __hug_w
 
 To run the hello world hug example API.
 
-
 Building Blocks of a hug API
 ===================
 
@@ -182,7 +178,6 @@ def math(number_1:int, number_2:int): #The :int after both arguments is the Type
 Type annotations also feed into `hug`'s automatic documentation
 generation to let users of your API know what data to supply.
 
-
 **Directives** functions that get executed with the request / response data based on being requested as an argument in your api_function.
 These apply as input parameters only, and can not be applied currently as output formats or transformations.
 
@@ -242,7 +237,6 @@ def hello():
 
 as shown, you can easily change the output format for both an entire API as well as an individual API call
 
-
 **Input Formatters** a function that takes the body of data given from a user of your API and formats it for handling.
 
 ```py
@@ -253,7 +247,6 @@ def my_input_formatter(data):
 
 Input formatters are mapped based on the `content_type` of the request data, and only perform basic parsing. More detailed parsing should be done by the Type Annotations present on your `api_function`
 
-
 **Middleware** functions that get called for every request a hug API processes
 
 ```py
@@ -272,6 +265,18 @@ You can also easily add any Falcon style middleware using:
 __hug__.http.add_middleware(MiddlewareObject())
 ```
 
+**Parameter mapping** can be used to override inferred parameter names, eg. for reserved keywords:
+
+```py
+import marshmallow.fields as fields
+...
+
+@hug.get('/foo', map_params={'from': 'from_date'})  # API call uses 'from'
+def get_foo_by_date(from_date: fields.DateTime()):
+    return find_foo(from_date)
+```
+
+Input formatters are mapped based on the `content_type` of the request data, and only perform basic parsing. More detailed parsing should be done by the Type Annotations present on your `api_function`
 
 Splitting APIs over multiple files
 ===================
@@ -314,7 +319,6 @@ Or alternatively - for cases like this - where only one module is being included
 hug.API(__name__).extend(something, '/something')
 ```
 
-
 Configuring hug 404
 ===================
 
@@ -346,14 +350,14 @@ def not_found_handler():
     return "Not Found"
 ```
 
-
 Asyncio support
 ===============
 
 When using the `get` and `cli` method decorator on coroutines, hug will schedule
 the execution of the coroutine.
 
 Using asyncio coroutine decorator
+
 ```py
 @hug.get()
 @asyncio.coroutine
@@ -362,6 +366,7 @@ def hello_world():
 ```
 
 Using Python 3.5 async keyword.
+
 ```py
 @hug.get()
 async def hello_world():
@@ -371,9 +376,9 @@ async def hello_world():
 NOTE: Hug is running on top Falcon which is not an asynchronous server. Even if using
 asyncio, requests will still be processed synchronously.
 
-
 Using Docker
 ===================
+
 If you like to develop in Docker and keep your system clean, you can do that but you'll need to first install [Docker Compose](https://docs.docker.com/compose/install/).
 
 Once you've done that, you'll need to `cd` into the `docker` directory and run the web server (Gunicorn) specified in `./docker/gunicorn/Dockerfile`, after which you can preview the output of your API in the browser on your host machine.
@@ -413,7 +418,6 @@ bash-4.3# tree
 1 directory, 3 files
 ```
 
-
 Why hug?
 ===================