Merge pull request #836 from hugapi/develop

2.6.1 Release

Author: timothycrosley

.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 2.6.0
+current_version = 2.6.1
 
 [bumpversion:file:.env]
 

.env

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

.travis.yml

@@ -9,6 +9,9 @@ matrix:
   - os: linux
     sudo: required
     python: 3.6
+  - os: linux
+    sudo: required
+    python: 3.8
   - os: linux
     sudo: required
     python: 3.7

ACKNOWLEDGEMENTS.md

@@ -52,6 +52,7 @@ Code Contributors
 - Lordran (@xzycn)
 - Stephan Fitzpatrick (@knowsuchagency)
 - Edvard Majakari (@EdvardM)
+- Sai Charan (@mrsaicharan1)
 
 Documenters
 ===================

CHANGELOG.md

@@ -11,6 +11,9 @@ Ideally, within a virtual environment.
 
 Changelog
 =========
+### 2.6.1 - February 6, 2019
+- Fixed issue #834: Bug in some cases when introspecting local documentation.
+
 ### 2.6.0 - August 29, 2019
 - Improved CLI multiple behaviour with empty defaults
 - Improved CLI type output for built-in types

FAQ.md

@@ -6,13 +6,13 @@ For more examples, check out Hug's [documentation](https://github.com/timothycro
 
 Q: *Can I use Hug with a web framework -- Django for example?*
 
-A: You can use Hug alongside Django or the web framework of your choice, but it does have drawbacks. You would need to run hug on a separate, hug-exclusive server. You can also [mount Hug as a WSGI app](https://pythonhosted.org/django-wsgi/embedded-apps.html), embedded within your normal Django app. 
+A: You can use Hug alongside Django or the web framework of your choice, but it does have drawbacks. You would need to run hug on a separate, hug-exclusive server. You can also [mount Hug as a WSGI app](https://pythonhosted.org/django-wsgi/embedded-apps.html), embedded within your normal Django app.
 
 Q: *Is Hug compatabile with Python 2?*
 
-A: Python 2 is not supported by Hug. However, if you need to account for backwards compatability, there are workarounds. For example, you can wrap the decorators: 
+A: Python 2 is not supported by Hug. However, if you need to account for backwards compatability, there are workarounds. For example, you can wrap the decorators:
 
-```Python 
+```Python
 def my_get_fn(func, *args, **kwargs):
     if 'hug' in globals():
         return hug.get(func, *args, **kwargs)
@@ -29,7 +29,7 @@ Q:  *How can I serve static files from a directory using Hug?*
 
 A: For a static HTML page, you can just set the proper output format as: `output=hug.output_format.html`. To see other examples, check out the [html_serve](https://github.com/timothycrosley/hug/blob/develop/examples/html_serve.py) example, the [image_serve](https://github.com/timothycrosley/hug/blob/develop/examples/image_serve.py) example, and the more general [static_serve](https://github.com/timothycrosley/hug/blob/develop/examples/static_serve.py) example within `hug/examples`.
 
-Most basic examples will use a format that looks something like this: 
+Most basic examples will use a format that looks something like this:
 
 ```Python
 @hug.static('/static')
@@ -50,15 +50,15 @@ A: You can access a list of your routes by using the routes object on the HTTP A
 
 `__hug_wsgi__.http.routes`
 
-It will return to you a structure of "base_url -> url -> HTTP method -> Version -> Python Handler". Therefore, for example, if you have no base_url set and you want to see the list of all URLS, you could run: 
+It will return to you a structure of "base_url -> url -> HTTP method -> Version -> Python Handler". Therefore, for example, if you have no base_url set and you want to see the list of all URLS, you could run:
 
 `__hug_wsgi__.http.routes[''].keys()`
 
 Q: *How can I configure a unique 404 route?*
 
 A: By default, Hug will call `documentation_404()` if no HTTP route is found. However, if you want to configure other options (such as routing to a directiory, or routing everything else to a landing page) you can use the `@hug.sink('/')` decorator to create a "catch-all" route:
 
-```Python 
+```Python
 import hug
 
 @hug.sink('/all')
@@ -67,3 +67,23 @@ def my_sink(request):
 ```
 
 For more information, check out the ROUTING.md file within the `hug/documentation` directory.
+
+Q: *How can I enable CORS*
+
+A: There are many solutions depending on the specifics of your application.
+For most applications, you can use the included cors middleware:
+
+```
+import hug
+
+api = hug.API(__name__)
+api.http.add_middleware(hug.middleware.CORSMiddleware(api, max_age=10))
+
+
+@hug.get("/demo")
+def get_demo():
+    return {"result": "Hello World"}
+```
+For cases that are more complex then the middleware handles
+
+[This comment](https://github.com/hugapi/hug/issues/114#issuecomment-342493165) (and the discussion around it) give a good starting off point.

README.md

@@ -8,7 +8,10 @@
 [![License](https://img.shields.io/github/license/mashape/apistatus.svg)](https://pypi.python.org/pypi/hug/)
 [![Join the chat at https://gitter.im/timothycrosley/hug](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/timothycrosley/hug?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
-NOTE: For more in-depth documentation visit [hug's website](http://www.hug.rest)
+_________________
+
+[Read Latest Documentation](https://hugapi.github.io/hug/) - [Browse GitHub Code Repository](https://github.com/hugapi/hug)
+_________________
 
 hug aims to make developing Python driven APIs as simple as possible, but no simpler. As a result, it drastically simplifies Python API development.
 

examples/cli_multiple.py

@@ -1,7 +1,8 @@
 import hug
 
+
 @hug.cli()
-def add(numbers: list=None):
+def add(numbers: list = None):
     return sum([int(number) for number in numbers])
 
 

examples/matplotlib/plot.py

@@ -7,9 +7,9 @@
 @hug.get(output=hug.output_format.png_image)
 def plot():
     pyplot.plot([1, 2, 3, 4])
-    pyplot.ylabel('some numbers')
+    pyplot.ylabel("some numbers")
 
     image_output = io.BytesIO()
-    pyplot.savefig(image_output, format='png')
+    pyplot.savefig(image_output, format="png")
     image_output.seek(0)
     return image_output

examples/pil_example/additional_requirements.txt

@@ -1 +1 @@
-Pillow==6.0.0
+Pillow==6.2.0