summaryrefslogtreecommitdiff
path: root/www/cheps/2_import.rst
diff options
context:
space:
mode:
Diffstat (limited to 'www/cheps/2_import.rst')
-rw-r--r--www/cheps/2_import.rst18
1 files changed, 18 insertions, 0 deletions
diff --git a/www/cheps/2_import.rst b/www/cheps/2_import.rst
index 762d9b8..8f3a837 100644
--- a/www/cheps/2_import.rst
+++ b/www/cheps/2_import.rst
@@ -92,12 +92,30 @@ to the top of the generated module code (i.e. the module import)
Rationale
---------
+The concept of the "function import" was introduced in Cheetah v2.1.0
+and quickly retrofitted to "live" behind a compiler setting due to the
+regressions with older templates or templates that were designed to utilize
+module imports (through heavy #block/#end block use, etc). Through discussion
+with Tavis Rudd, this middle ground between the two styles of importing was
+concluded to be the most reasonable solution to providing "pythonic" import
+functionality (i.e. "function import" also known as "inline imports") while
+still providing the ability to have #from/#import directives declared at the
+module scope within the template (within the Cheetah templates, markup and most
+directives declared within the module scope are placed inside the default method).
+
Backwards Compatibility
-----------------------
+Changes proposed in this document should be *mostly* backwards
+compatible with current versions of Cheetah, Any unforeseen issues
+could arise from the use of #from/#import inside of a function
+expecting those symbols to be available outside of the function
+that they're declared in.
+
Reference Implementation
------------------------
+*still in development*
Copyright
---------