Add logger macros

Author: clrcrl

README.md

@@ -392,6 +392,38 @@ Usage:
 ```
 
 ---
+### Logger
+#### pretty_time ([source](macros/logger/pretty_output_msg.sql))
+This macro returns a string of the current timestamp, optionally taking a datestring format.
+```sql
+{#- This will return a string like '14:50:34' -#}
+{{ dbt_utils.pretty_time() }}
+
+{#- This will return a string like '2019-05-02 14:50:34' -#}
+{{ dbt_utils.pretty_time(format='%Y-%m-%d %H:%M:%S') }}
+```
+
+#### pretty_output_msg
+This macro formats the input in a way that will print nicely to the command line when you `log` it.
+```
+{#- This will return a string like:
+"         + 11:07:31 | my pretty message"
+-#}
+
+{{ dbt_utils.pretty_output_msg("my pretty message") }}
+```
+
+It is expected that this macro will be used in conjuction with the [log](https://docs.getdbt.com/reference#log) macro.
+```
+{{ log(dbt_utils.pretty_output_msg("my pretty message"), info=True) }}
+```
+
+```
+11:07:28 | 1 of 1 START table model analytics.fct_orders........................ [RUN]
+         + 11:07:31 | my pretty message
+```
+
+
 ### Materializations
 #### insert_by_period ([source](macros/materializations/insert_by_period_materialization.sql))
 `insert_by_period` allows dbt to insert records into a table one period (i.e. day, week) at a time.

integration_tests/tests/logger/assert_pretty_output_msg_is_string.sql

@@ -0,0 +1,7 @@
+{% if dbt_utils.pretty_output_msg() is string %}
+    {# Return 0 rows for the test to pass #}
+    select 1 where false
+{% else %}
+    {# Return >0 rows for the test to fail #}
+    select 1
+{% endif %}

integration_tests/tests/logger/assert_pretty_time_is_string.sql

@@ -0,0 +1,7 @@
+{% if dbt_utils.pretty_time() is string %}
+    {# Return 0 rows for the test to pass #}
+    select 1 where false
+{% else %}
+    {# Return >0 rows for the test to fail #}
+    select 1
+{% endif %}

macros/logger/pretty_output_msg.sql

@@ -0,0 +1,4 @@
+{% macro pretty_output_msg(message) %}
+{{ return( 10 * ' ' ~ '+ ' ~ dbt_utils.pretty_time() ~ ' | ' ~ message) }}
+
+{% endmacro %}

macros/logger/pretty_time.sql

@@ -0,0 +1,3 @@
+{% macro pretty_time(format='%H:%M:%S') %}
+    {{ return(modules.datetime.datetime.now().strftime(format)) }}
+{% endmacro %}