Merge pull request #359 from OpenDataServices/306-titles-sheet-names

flatten: Use titles for sheet names

Author: Bjwebb

CHANGELOG.md

@@ -6,6 +6,12 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [Unreleased]
 
+## [0.13.0] - 2020-09-09
+
+### Changed
+
+- When `--use-titles` is specified, also use the titles for sheet names (ie. Excel tabs and CSV filenames)
+
 ## [0.12.0] - 2020-08-25
 
 ### Added

docs/create-template.rst

@@ -40,11 +40,11 @@ CSV files for you:
 .. csv-table:: sheet: cafe.csv
    :file: ../examples/create-template/simple/expected/cafe.csv
 
-.. csv-table:: sheet: table.csv
-   :file: ../examples/create-template/simple/expected/table.csv
+.. csv-table:: sheet: Table.csv
+   :file: ../examples/create-template/simple/expected/Table.csv
 
-.. csv-table:: sheet: tab_dish.csv
-   :file: ../examples/create-template/simple/expected/tab_dish.csv
+.. csv-table:: sheet: Tab_Dish.csv
+   :file: ../examples/create-template/simple/expected/Tab_Dish.csv
 
 As you can see, by default Flatten Tool puts each item with an Identifier in
 its own sheet.
@@ -81,14 +81,14 @@ Here are the resulting sheets:
 .. csv-table:: sheet: cafe.csv
    :file: ../examples/create-template/rollup/expected/cafe.csv
 
-.. csv-table:: sheet: table.csv
-   :file: ../examples/create-template/rollup/expected/table.csv
+.. csv-table:: sheet: Table.csv
+   :file: ../examples/create-template/rollup/expected/Table.csv
 
-.. csv-table:: sheet: tab_dish.csv
-   :file: ../examples/create-template/rollup/expected/tab_dish.csv
+.. csv-table:: sheet: Tab_Dish.csv
+   :file: ../examples/create-template/rollup/expected/Tab_Dish.csv
 
 
-Notice how ``Table: Number`` now appears in both the ``cafe.csv`` and ``table.csv`` files.
+Notice how ``Table: Number`` now appears in both the ``Cafe.csv`` and ``Table.csv`` files.
 
 ``rollup`` can also be used to rollup actual data with ``flatten``, with or 
 without a schema: :ref:`flattening`

docs/flatten.rst

@@ -221,11 +221,11 @@ Here are the resulting sheets:
 .. csv-table:: sheet: cafe.csv
    :file: ../examples/flatten/rollup/schema/expected/cafe.csv
 
-.. csv-table:: sheet: owners.csv
-   :file: ../examples/flatten/rollup/schema/expected/owners.csv
+.. csv-table:: sheet: Owners.csv
+   :file: ../examples/flatten/rollup/schema/expected/Owner.csv
 
 Notice how ``Owner: First name``, ``Owner: Last name`` and ``Owner: Email`` now 
-appear in both the ``cafe.csv`` and ``owners.csv`` files.
+appear in both the ``cafe.csv`` and ``Owner.csv`` files.
 
 .. caution ::
 
@@ -265,7 +265,7 @@ Run this command to rollup all properties of the ``owners`` object:
 
 Where the file contains:
 
-.. literalinclude:: ../examples/flatten/rollup/file/fields_to_rollup.xt
+.. literalinclude:: ../examples/flatten/rollup/file/fields_to_rollup.txt
    :language: bash
 
 You can include multiple fields to rollup by passing ``--rollup`` multiple times: