#1475 Add 'description' to datasource sample code

[jacalata]

Add code demonstrating datasource descriptions for #135

[bcantoni]

@jacalata change looks good but I'm curious about commenting out the tags code. Was that because it's not working, or you were just testing the description change?

[jacalata]

Oh, right, that was just for testing. I'll delete the commenting.

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
tableauserverclient
__init__.py	5	0	100%
_version.py	278	163	163	41%
config.py	13	0	100%
datetime_helpers.py	25	1	1	96%
exponential_backoff.py	20	0	100%
filesys_helpers.py	31	0	100%
namespace.py	26	3	3	88%
tableauserverclient/helpers
__init__.py	1	0	100%
headers.py	13	8	8	38%
logging.py	2	0	100%
strings.py	27	1	1	96%
tableauserverclient/models
__init__.py	41	0	100%
column_item.py	55	32	32	42%
connection_credentials.py	35	11	11	69%
connection_item.py	77	10	10	87%
custom_view_item.py	119	9	9	92%
data_acceleration_report_item.py	54	1	1	98%
data_alert_item.py	159	3	3	98%
data_freshness_policy_item.py	156	15	15	90%
database_item.py	207	36	36	83%
datasource_item.py	247	11	11	96%
dqw_item.py	104	5	5	95%
exceptions.py	4	0	100%
favorites_item.py	56	8	8	86%
fileupload_item.py	19	0	100%
flow_item.py	149	10	10	93%
flow_run_item.py	72	0	100%
group_item.py	81	3	3	96%
groupset_item.py	39	1	1	97%
interval_item.py	182	32	32	82%
job_item.py	187	10	10	95%
linked_tasks_item.py	80	1	1	99%
metric_item.py	130	12	12	91%
pagination_item.py	34	0	100%
permissions_item.py	108	12	12	89%
project_item.py	145	31	31	79%
property_decorators.py	100	18	18	82%
reference_item.py	23	1	1	96%
revision_item.py	60	0	100%
schedule_item.py	206	6	6	97%
server_info_item.py	39	5	5	87%
site_item.py	610	12	12	98%
subscription_item.py	103	3	3	97%
table_item.py	118	18	18	85%
tableau_auth.py	61	24	24	61%
tableau_types.py	25	1	1	96%
tag_item.py	15	0	100%
target.py	6	0	100%
task_item.py	57	2	2	96%
user_item.py	277	17	17	94%
view_item.py	179	15	15	92%
virtual_connection_item.py	64	8	8	88%
webhook_item.py	66	0	100%
workbook_item.py	275	16	16	94%
tableauserverclient/server
__init__.py	9	0	100%
exceptions.py	4	0	100%
filter.py	21	1	1	95%
pager.py	35	1	1	97%
query.py	139	15	15	89%
request_factory.py	1090	148	148	86%
request_options.py	269	4	4	99%
server.py	167	17	17	90%
sort.py	6	0	100%
tableauserverclient/server/endpoint
__init__.py	33	0	100%
auth_endpoint.py	76	12	12	84%
custom_views_endpoint.py	118	7	7	94%
data_acceleration_report_endpoint.py	21	0	100%
data_alert_endpoint.py	97	25	25	74%
databases_endpoint.py	110	30	30	73%
datasources_endpoint.py	311	36	36	88%
default_permissions_endpoint.py	47	5	5	89%
dqw_endpoint.py	43	16	16	63%
endpoint.py	181	20	20	89%
exceptions.py	60	6	6	90%
favorites_endpoint.py	95	22	22	77%
fileuploads_endpoint.py	51	0	100%
flow_runs_endpoint.py	65	11	11	83%
flow_task_endpoint.py	23	3	3	87%
flows_endpoint.py	216	58	58	73%
groups_endpoint.py	127	10	10	92%
groupsets_endpoint.py	74	8	8	89%
jobs_endpoint.py	71	12	12	83%
linked_tasks_endpoint.py	38	0	100%
metadata_endpoint.py	88	14	14	84%
metrics_endpoint.py	58	8	8	86%
permissions_endpoint.py	47	5	5	89%
projects_endpoint.py	125	20	20	84%
resource_tagger.py	135	43	43	68%
schedules_endpoint.py	100	11	11	89%
server_info_endpoint.py	35	10	10	71%
sites_endpoint.py	126	28	28	78%
subscriptions_endpoint.py	58	15	15	74%
tables_endpoint.py	108	36	36	67%
tasks_endpoint.py	65	7	7	89%
users_endpoint.py	130	16	16	88%
views_endpoint.py	138	10	10	93%
virtual_connections_endpoint.py	115	11	11	90%
webhooks_endpoint.py	57	11	11	81%
workbooks_endpoint.py	333	27	27	92%
TOTAL	10580	1314	88%

[raccoooonz]

@jacalata know this over a year old, but the demonstration of updating description doesn't actually seem to work for published datasources

# Demonstrate that description is editablesample_datasource.description="Description updated by TSC"server.datasources.update(sample_datasource)

Not sure if perhaps I missed something, but it looks like adding this in tableauserverclient/server/request_factory.py ->
‎DatasourceRequest.update_req seemed to get it to work:

defupdate_req(self, datasource_item): .... .... ifdatasource_item.description: datasource_element.attrib["description"] =str(datasource_item.description) .... ....