tableau · jacalata · Oct 23, 2021 · Oct 19, 2021 · Oct 19, 2021 · Oct 19, 2021
diff --git a/contributing.md b/contributing.md
@@ -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.

diff --git a/samples/create_project.py b/samples/create_project.py
@@ -14,9 +14,9 @@
 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)
+        project_item = server.projects.create(project_item, samples)
         print('Created a new project called: %s' % project_item.name)
         return project_item
     except TSC.ServerResponseError:
@@ -45,7 +45,8 @@ 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()
@@ -56,12 +57,15 @@ def main():
 
         # 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 = 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 = create_project(server, grand_child_project)
 
+        # Projects can be updated
+        changed_project = server.projects.update(grand_child_project, samples=True)
+
 
 if __name__ == '__main__':
     main()
diff --git a/tableauserverclient/server/endpoint/endpoint.py b/tableauserverclient/server/endpoint/endpoint.py
@@ -18,6 +18,8 @@
 
 Success_codes = [200, 201, 202, 204]
 
+XML_CONTENT_TYPE = "text/xml"
+JSON_CONTENT_TYPE = "application/json"
 
 class Endpoint(object):
     def __init__(self, parent_srv):

diff --git a/tableauserverclient/server/endpoint/projects_endpoint.py b/tableauserverclient/server/endpoint/projects_endpoint.py
@@ -1,9 +1,9 @@
-from .endpoint import api, Endpoint
+from .endpoint import api, Endpoint, XML_CONTENT_TYPE
 from .exceptions import MissingRequiredFieldError
 from .permissions_endpoint import _PermissionsEndpoint
 from .default_permissions_endpoint import _DefaultPermissionsEndpoint
 
-from .. import RequestFactory, ProjectItem, PaginationItem, Permission
+from .. import RequestFactory, RequestOptions, ProjectItem, PaginationItem, Permission
 
 import logging
 
@@ -40,23 +40,25 @@ def delete(self, project_id):
         logger.info("Deleted single project (ID: {0})".format(project_id))
 
     @api(version="2.0")
-    def update(self, project_item):
+    def update(self, project_item, samples=False):
         if not project_item.id:
             error = "Project item missing ID."
             raise MissingRequiredFieldError(error)
 
+        params = {"params": {RequestOptions.Field.PublishSamples: samples }}
         url = "{0}/{1}".format(self.baseurl, project_item.id)
         update_req = RequestFactory.Project.update_req(project_item)
-        server_response = self.put_request(url, update_req)
+        server_response = self.put_request(url, update_req, XML_CONTENT_TYPE, params)
         logger.info("Updated project item (ID: {0})".format(project_item.id))
         updated_project = ProjectItem.from_response(server_response.content, self.parent_srv.namespace)[0]
         return updated_project
 
     @api(version="2.0")
-    def create(self, project_item):
+    def create(self, project_item, samples=False):
+        params = {"params": {RequestOptions.Field.PublishSamples: samples }}
         url = self.baseurl
         create_req = RequestFactory.Project.create_req(project_item)
-        server_response = self.post_request(url, create_req)
+        server_response = self.post_request(url, create_req, XML_CONTENT_TYPE, params)
         new_project = ProjectItem.from_response(server_response.content, self.parent_srv.namespace)[0]
         logger.info("Created new project (ID: {0})".format(new_project.id))
         return new_project

diff --git a/tableauserverclient/server/request_options.py b/tableauserverclient/server/request_options.py
@@ -48,6 +48,7 @@ class Field:
         OwnerName = "ownerName"
         Progress = "progress"
         ProjectName = "projectName"
+        PublishSamples = "publishSamples"
         SiteRole = "siteRole"
         Subtitle = "subtitle"
         Tags = "tags"