Add the pgwui_bulk_upload settings

diff --git a/examples/etc/pgwui.ini b/examples/etc/pgwui.ini
index d0b7ceae0498a8699a9d788a76241bac7a59b264..c911a69422c1a78ee3ea188c89d94c2cdea04c0b 100644 (file)
--- a/examples/etc/pgwui.ini
+++ b/examples/etc/pgwui.ini
@@ -221,6 +221,52 @@ pgwui.dry_run = False
 #    # menu_label = upload -- Upload File Into Database
 
 
+# pgwui_bulk_upload
+
+# pgwui_bulk_upload.literal_column_headings:
+#   Take uploaded column headings literally?
+#   See pgwui_upload above for details.
+
+# pgwui_bulk_upload.map_file = contents.yml
+#   Name of the file in the zip file that maps file names to table
+#   names.  The default name of the map file is `contents.yml`.
+#
+#   The map file is in YAML syntax, which for purposes of this document
+#   can be thought of as a superset of JSON.  It must contain a top-level
+#   tag, `map_list`, which itself contains a list of maps, each of which
+#   maps a file to a table or view.  The table (or view) names may,
+#   optionally, be schema qualified.  An example map file might be:
+#
+#   # This file is contents.yml
+#   map_list:
+#     # Load the foo.csv file into the foo_table table of the default schema.
+#     - file_map:
+#         file: foo.csv
+#         relation: foo_table
+#     # Load the bar.csv file into the bar_view uploadable-view of the default
+#     # schema.
+#     - file_map:
+#         file: bar.csv
+#         relation: bar_view
+#     # Load the baz.csv file into the baz_table table of the meta schema.
+#     - file_map:
+#         file: baz.csv
+#         relation: meta.baz_table
+#
+#   The files within each directory are uploaded in the order in which
+#   they are listed in the map file.  The directories in the zip file are
+#   processed in alphabetical order.
+#
+#   Top level tags, other than the `map_list` tag, are ignored.
+#
+#   It is recommended to enclose file names which contain spaces, or begin
+#   with a digit, in single quotes.  But any YAML syntax is valid.
+
+#pgwui.pgwui_bulk_upload =
+#    literal_column_headings = off
+#    map_file = contents.txt
+
+
 #
 # Pyramid configuration
 # https://docs.pylonsproject.org/projects/pyramid/en/latest/narr/environment.html

diff --git a/examples/misc/development.ini b/examples/misc/development.ini
index f2b29e0a2bbf3e64e4a4512ccfafa19a6a42611b..a2080d31380622e53d480a886de2a6dcc928889a 100644 (file)
--- a/examples/misc/development.ini
+++ b/examples/misc/development.ini
@@ -226,6 +226,52 @@ pgwui.validate_hmac = False
 #    # menu_label = upload -- Upload File Into Database
 
 
+# pgwui_bulk_upload
+
+# pgwui_bulk_upload.literal_column_headings:
+#   Take uploaded column headings literally?
+#   See pgwui_upload above for details.
+
+# pgwui_bulk_upload.map_file = contents.yml
+#   Name of the file in the zip file that maps file names to table
+#   names.  The default name of the map file is `contents.yml`.
+#
+#   The map file is in YAML syntax, which for purposes of this document
+#   can be thought of as a superset of JSON.  It must contain a top-level
+#   tag, `map_list`, which itself contains a list of maps, each of which
+#   maps a file to a table or view.  The table (or view) names may,
+#   optionally, be schema qualified.  An example map file might be:
+#
+#   # This file is contents.yml
+#   map_list:
+#     # Load the foo.csv file into the foo_table table of the default schema.
+#     - file_map:
+#         file: foo.csv
+#         relation: foo_table
+#     # Load the bar.csv file into the bar_view uploadable-view of the default
+#     # schema.
+#     - file_map:
+#         file: bar.csv
+#         relation: bar_view
+#     # Load the baz.csv file into the baz_table table of the meta schema.
+#     - file_map:
+#         file: baz.csv
+#         relation: meta.baz_table
+#
+#   The files within each directory are uploaded in the order in which
+#   they are listed in the map file.  The directories in the zip file are
+#   processed in alphabetical order.
+#
+#   Top level tags, other than the `map_list` tag, are ignored.
+#
+#   It is recommended to enclose file names which contain spaces, or begin
+#   with a digit, in single quotes.  But any YAML syntax is valid.
+
+#pgwui.pgwui_bulk_upload =
+#    literal_column_headings = off
+#    map_file = contents.txt
+
+
 #
 # Pyramid configuration
 # https://docs.pylonsproject.org/projects/pyramid/en/latest/narr/environment.html