jorwoods
diff --git a/‎.github/workflows/run-tests.yml‎
Lines changed: 7 additions & 1 deletion b/‎.github/workflows/run-tests.yml‎
Lines changed: 7 additions & 1 deletion
diff --git a/‎.github/workflows/slack.yml‎
Lines changed: 20 additions & 0 deletions b/‎.github/workflows/slack.yml‎
Lines changed: 20 additions & 0 deletions
diff --git a/‎CHANGELOG.md‎
Lines changed: 15 additions & 0 deletions b/‎CHANGELOG.md‎
Lines changed: 15 additions & 0 deletions
diff --git a/‎CONTRIBUTORS.md‎
Lines changed: 1 addition & 0 deletions b/‎CONTRIBUTORS.md‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎contributing.md‎
Lines changed: 5 additions & 0 deletions b/‎contributing.md‎
Lines changed: 5 additions & 0 deletions
diff --git a/‎samples/add_default_permission.py‎
Lines changed: 18 additions & 14 deletions b/‎samples/add_default_permission.py‎
Lines changed: 18 additions & 14 deletions
diff --git a/‎samples/create_group.py‎
Lines changed: 18 additions & 11 deletions b/‎samples/create_group.py‎
Lines changed: 18 additions & 11 deletions
diff --git a/‎samples/create_project.py‎
Lines changed: 30 additions & 19 deletions b/‎samples/create_project.py‎
Lines changed: 30 additions & 19 deletions
diff --git a/‎samples/create_schedules.py‎
Lines changed: 51 additions & 28 deletions b/‎samples/create_schedules.py‎
Lines changed: 51 additions & 28 deletions
@@ -8,7 +8,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        python-version: [3.6, 3.7, 3.8, 3.9, 3.10.0-rc.2]
+        python-version: ['3.6', '3.7', '3.8', '3.9', '3.10']
 
     runs-on: ${{ matrix.os }}
 
@@ -25,10 +25,16 @@ jobs:
         python -m pip install --upgrade pip
         pip install -e .[test]
 
+    - name: Format with black
+      run: |
+        black --check --line-length 120 tableauserverclient samples test
+
     - name: Test with pytest
+      if: always()
       run: |
         pytest test
 
     - name: Run Mypy tests
+      if: always()
       run: |
         mypy --show-error-codes --disable-error-code misc --disable-error-code import tableauserverclient test
@@ -0,0 +1,20 @@
+name: 💬 Send Message to Slack 🚀
+
+on: [push, pull_request, issues]
+
+jobs:
+  slack-notifications:
+    continue-on-error: true
+    runs-on: ubuntu-20.04
+    name: Sends a message to Slack when a push, a pull request or an issue is made
+    steps:
+      - name: Send message to Slack API
+        continue-on-error: true
+        uses: archive/[email protected]
+        id: notify
+        with:
+          slack-bot-user-oauth-access-token: ${{ secrets.SLACK_BOT_USER_OAUTH_ACCESS_TOKEN }}
+          slack-channel: C019HCX84L9
+          slack-text: Hello! Event "${{ github.event_name }}" in "${{ github.repository }}" 🤓
+      - name: Result from "Send Message"
+        run: echo "The result was ${{ steps.notify.outputs.slack-result }}"
@@ -1,3 +1,18 @@
+## 0.17.0 (20 October 2021)
+* Added support for accepting parameters for post request of the metadata api (#850)
+* Fixed jobs.get_by_id(job_id) example & reference docs (#867, #868) 
+* Fixed handling for workbooks in personal spaces which do not have projectID or Name  (#875) 
+* Updated links to Data Source Methods page in REST API docs (#879)
+* Unified arguments of sample scripts (#889)
+* Updated docs for - links to Datasource API (#879) ,  sample scripts (#892) & metadata query (#896)
+* Added support for scheduling DataUpdate Jobs (#891)
+* Exposed the fileuploads API endpoint (#894)
+* Added a new sample & documentation for metadata API (#895, #896)
+* Added support to the package for getting flow run status, as well as the ability to cancel flow runs. (#884)
+* Added jobs.wait_for_job method (#903)
+* Added description support for datasources item (#912) 
+* Dropped support for Python 3.5 (#911)
+
 ## 0.16.0 (15 July 2021)
 * Documentation updates (#800, #818, #839, #842)
 * Fixed data alert repr in subscription item (#821)
 
@@ -59,3 +59,4 @@ The following people have contributed to this project to make it possible, and w
 * [Dan Zucker](https://github.com/dzucker-tab)
 * [Brian Cantoni](https://github.com/bcantoni)
 * [Ovini Nanayakkara](https://github.com/ovinis)
+* [Manish Muttreja](https://github.com/mmuttreja-tableau)
@@ -62,6 +62,11 @@ python setup.py build
 python setup.py test
 ```
 
+### To use your locally built version
+```shell
+pip install .
+```
+
 ### Before Committing
 
 Our CI runs include a Python lint run, so you should run this locally and fix complaints before committing as this will fail your checkin.
 
@@ -16,16 +16,23 @@
 
 
 def main():
-    parser = argparse.ArgumentParser(description='Add workbook default permissions for a given project.')
+    parser = argparse.ArgumentParser(description="Add workbook default permissions for a given project.")
     # Common options; please keep those in sync across all samples
-    parser.add_argument('--server', '-s', required=True, help='server address')
-    parser.add_argument('--site', '-S', help='site name')
-    parser.add_argument('--token-name', '-p', required=True,
-                        help='name of the personal access token used to sign into the server')
-    parser.add_argument('--token-value', '-v', required=True,
-                        help='value of the personal access token used to sign into the server')
-    parser.add_argument('--logging-level', '-l', choices=['debug', 'info', 'error'], default='error',
-                        help='desired logging level (set to error by default)')
+    parser.add_argument("--server", "-s", required=True, help="server address")
+    parser.add_argument("--site", "-S", help="site name")
+    parser.add_argument(
+        "--token-name", "-p", required=True, help="name of the personal access token used to sign into the server"
+    )
+    parser.add_argument(
+        "--token-value", "-v", required=True, help="value of the personal access token used to sign into the server"
+    )
+    parser.add_argument(
+        "--logging-level",
+        "-l",
+        choices=["debug", "info", "error"],
+        default="error",
+        help="desired logging level (set to error by default)",
+    )
     # Options specific to this sample
     # This sample has no additional options, yet. If you add some, please add them here
 
@@ -53,10 +60,7 @@ def main():
             new_capabilities = {TSC.Permission.Capability.ExportXml: TSC.Permission.Mode.Allow}
 
             # Each PermissionRule in the list contains a grantee and a dict of capabilities
-            new_rules = [TSC.PermissionsRule(
-                grantee=default_permissions.grantee,
-                capabilities=new_capabilities
-            )]
+            new_rules = [TSC.PermissionsRule(grantee=default_permissions.grantee, capabilities=new_capabilities)]
 
             new_default_permissions = server.projects.update_workbook_default_permissions(project, new_rules)
 
@@ -78,5 +82,5 @@ def main():
         # server.projects.delete(project.id)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     main()
@@ -16,16 +16,23 @@
 
 def main():
 
-    parser = argparse.ArgumentParser(description='Creates a sample user group.')
+    parser = argparse.ArgumentParser(description="Creates a sample user group.")
     # Common options; please keep those in sync across all samples
-    parser.add_argument('--server', '-s', required=True, help='server address')
-    parser.add_argument('--site', '-S', help='site name')
-    parser.add_argument('--token-name', '-p', required=True,
-                        help='name of the personal access token used to sign into the server')
-    parser.add_argument('--token-value', '-v', required=True,
-                        help='value of the personal access token used to sign into the server')
-    parser.add_argument('--logging-level', '-l', choices=['debug', 'info', 'error'], default='error',
-                        help='desired logging level (set to error by default)')
+    parser.add_argument("--server", "-s", required=True, help="server address")
+    parser.add_argument("--site", "-S", help="site name")
+    parser.add_argument(
+        "--token-name", "-p", required=True, help="name of the personal access token used to sign into the server"
+    )
+    parser.add_argument(
+        "--token-value", "-v", required=True, help="value of the personal access token used to sign into the server"
+    )
+    parser.add_argument(
+        "--logging-level",
+        "-l",
+        choices=["debug", "info", "error"],
+        default="error",
+        help="desired logging level (set to error by default)",
+    )
     # Options specific to this sample
     # This sample has no additional options, yet. If you add some, please add them here
 
@@ -38,10 +45,10 @@ def main():
     tableau_auth = TSC.PersonalAccessTokenAuth(args.token_name, args.token_value, site_id=args.site)
     server = TSC.Server(args.server, use_server_version=True)
     with server.auth.sign_in(tableau_auth):
-        group = TSC.GroupItem('test')
+        group = TSC.GroupItem("test")
         group = server.groups.create(group)
         print(group)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     main()
@@ -14,27 +14,34 @@
 import tableauserverclient as TSC
 
 
-def create_project(server, project_item):
+def create_project(server, project_item, samples=False):
     try:
-        project_item = server.projects.create(project_item)
-        print('Created a new project called: %s' % project_item.name)
+        project_item = server.projects.create(project_item, samples)
+        print("Created a new project called: %s" % project_item.name)
         return project_item
     except TSC.ServerResponseError:
-        print('We have already created this project: %s' % project_item.name)
+        print("We have already created this project: %s" % project_item.name)
         sys.exit(1)
 
 
 def main():
-    parser = argparse.ArgumentParser(description='Create new projects.')
+    parser = argparse.ArgumentParser(description="Create new projects.")
     # Common options; please keep those in sync across all samples
-    parser.add_argument('--server', '-s', required=True, help='server address')
-    parser.add_argument('--site', '-S', help='site name')
-    parser.add_argument('--token-name', '-p', required=True,
-                        help='name of the personal access token used to sign into the server')
-    parser.add_argument('--token-value', '-v', required=True,
-                        help='value of the personal access token used to sign into the server')
-    parser.add_argument('--logging-level', '-l', choices=['debug', 'info', 'error'], default='error',
-                        help='desired logging level (set to error by default)')
+    parser.add_argument("--server", "-s", required=True, help="server address")
+    parser.add_argument("--site", "-S", help="site name")
+    parser.add_argument(
+        "--token-name", "-p", required=True, help="name of the personal access token used to sign into the server"
+    )
+    parser.add_argument(
+        "--token-value", "-v", required=True, help="value of the personal access token used to sign into the server"
+    )
+    parser.add_argument(
+        "--logging-level",
+        "-l",
+        choices=["debug", "info", "error"],
+        default="error",
+        help="desired logging level (set to error by default)",
+    )
     # Options specific to this sample
     # This sample has no additional options, yet. If you add some, please add them here
 
@@ -45,23 +52,27 @@ def main():
     logging.basicConfig(level=logging_level)
 
     tableau_auth = TSC.PersonalAccessTokenAuth(args.token_name, args.token_value, site_id=args.site)
-    server = TSC.Server(args.server, use_server_version=True)
+    server = TSC.Server(args.server)
+    server.use_server_version()
     with server.auth.sign_in(tableau_auth):
         # Use highest Server REST API version available
         server.use_server_version()
 
         # Without parent_id specified, projects are created at the top level.
-        top_level_project = TSC.ProjectItem(name='Top Level Project')
+        top_level_project = TSC.ProjectItem(name="Top Level Project")
         top_level_project = create_project(server, top_level_project)
 
         # Specifying parent_id creates a nested projects.
-        child_project = TSC.ProjectItem(name='Child Project', parent_id=top_level_project.id)
-        child_project = create_project(server, child_project)
+        child_project = TSC.ProjectItem(name="Child Project", parent_id=top_level_project.id)
+        child_project = create_project(server, child_project, samples=True)
 
         # Projects can be nested at any level.
-        grand_child_project = TSC.ProjectItem(name='Grand Child Project', parent_id=child_project.id)
+        grand_child_project = TSC.ProjectItem(name="Grand Child Project", parent_id=child_project.id)
         grand_child_project = create_project(server, grand_child_project)
 
+        # Projects can be updated
+        changed_project = server.projects.update(grand_child_project, samples=True)
 
-if __name__ == '__main__':
+
+if __name__ == "__main__":
     main()
@@ -16,16 +16,23 @@
 
 def main():
 
-    parser = argparse.ArgumentParser(description='Creates sample schedules for each type of frequency.')
+    parser = argparse.ArgumentParser(description="Creates sample schedules for each type of frequency.")
     # Common options; please keep those in sync across all samples
-    parser.add_argument('--server', '-s', required=True, help='server address')
-    parser.add_argument('--site', '-S', help='site name')
-    parser.add_argument('--token-name', '-p', required=True,
-                        help='name of the personal access token used to sign into the server')
-    parser.add_argument('--token-value', '-v', required=True,
-                        help='value of the personal access token used to sign into the server')
-    parser.add_argument('--logging-level', '-l', choices=['debug', 'info', 'error'], default='error',
-                        help='desired logging level (set to error by default)')
+    parser.add_argument("--server", "-s", required=True, help="server address")
+    parser.add_argument("--site", "-S", help="site name")
+    parser.add_argument(
+        "--token-name", "-p", required=True, help="name of the personal access token used to sign into the server"
+    )
+    parser.add_argument(
+        "--token-value", "-v", required=True, help="value of the personal access token used to sign into the server"
+    )
+    parser.add_argument(
+        "--logging-level",
+        "-l",
+        choices=["debug", "info", "error"],
+        default="error",
+        help="desired logging level (set to error by default)",
+    )
     # Options specific to this sample
     # This sample has no additional options, yet. If you add some, please add them here
 
@@ -40,43 +47,59 @@ def main():
     with server.auth.sign_in(tableau_auth):
         # Hourly Schedule
         # This schedule will run every 2 hours between 2:30AM and 11:00PM
-        hourly_interval = TSC.HourlyInterval(start_time=time(2, 30),
-                                             end_time=time(23, 0),
-                                             interval_value=2)
-
-        hourly_schedule = TSC.ScheduleItem("Hourly-Schedule", 50, TSC.ScheduleItem.Type.Extract,
-                                           TSC.ScheduleItem.ExecutionOrder.Parallel, hourly_interval)
+        hourly_interval = TSC.HourlyInterval(start_time=time(2, 30), end_time=time(23, 0), interval_value=2)
+
+        hourly_schedule = TSC.ScheduleItem(
+            "Hourly-Schedule",
+            50,
+            TSC.ScheduleItem.Type.Extract,
+            TSC.ScheduleItem.ExecutionOrder.Parallel,
+            hourly_interval,
+        )
         hourly_schedule = server.schedules.create(hourly_schedule)
         print("Hourly schedule created (ID: {}).".format(hourly_schedule.id))
 
         # Daily Schedule
         # This schedule will run every day at 5AM
         daily_interval = TSC.DailyInterval(start_time=time(5))
-        daily_schedule = TSC.ScheduleItem("Daily-Schedule", 60, TSC.ScheduleItem.Type.Subscription,
-                                          TSC.ScheduleItem.ExecutionOrder.Serial, daily_interval)
+        daily_schedule = TSC.ScheduleItem(
+            "Daily-Schedule",
+            60,
+            TSC.ScheduleItem.Type.Subscription,
+            TSC.ScheduleItem.ExecutionOrder.Serial,
+            daily_interval,
+        )
         daily_schedule = server.schedules.create(daily_schedule)
         print("Daily schedule created (ID: {}).".format(daily_schedule.id))
 
         # Weekly Schedule
         # This schedule will wun every Monday, Wednesday, and Friday at 7:15PM
-        weekly_interval = TSC.WeeklyInterval(time(19, 15),
-                                             TSC.IntervalItem.Day.Monday,
-                                             TSC.IntervalItem.Day.Wednesday,
-                                             TSC.IntervalItem.Day.Friday)
-        weekly_schedule = TSC.ScheduleItem("Weekly-Schedule", 70, TSC.ScheduleItem.Type.Extract,
-                                           TSC.ScheduleItem.ExecutionOrder.Serial, weekly_interval)
+        weekly_interval = TSC.WeeklyInterval(
+            time(19, 15), TSC.IntervalItem.Day.Monday, TSC.IntervalItem.Day.Wednesday, TSC.IntervalItem.Day.Friday
+        )
+        weekly_schedule = TSC.ScheduleItem(
+            "Weekly-Schedule",
+            70,
+            TSC.ScheduleItem.Type.Extract,
+            TSC.ScheduleItem.ExecutionOrder.Serial,
+            weekly_interval,
+        )
         weekly_schedule = server.schedules.create(weekly_schedule)
         print("Weekly schedule created (ID: {}).".format(weekly_schedule.id))
 
         # Monthly Schedule
         # This schedule will run on the 15th of every month at 11:30PM
-        monthly_interval = TSC.MonthlyInterval(start_time=time(23, 30),
-                                               interval_value=15)
-        monthly_schedule = TSC.ScheduleItem("Monthly-Schedule", 80, TSC.ScheduleItem.Type.Subscription,
-                                            TSC.ScheduleItem.ExecutionOrder.Parallel, monthly_interval)
+        monthly_interval = TSC.MonthlyInterval(start_time=time(23, 30), interval_value=15)
+        monthly_schedule = TSC.ScheduleItem(
+            "Monthly-Schedule",
+            80,
+            TSC.ScheduleItem.Type.Subscription,
+            TSC.ScheduleItem.ExecutionOrder.Parallel,
+            monthly_interval,
+        )
         monthly_schedule = server.schedules.create(monthly_schedule)
         print("Monthly schedule created (ID: {}).".format(monthly_schedule.id))
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     main()