feat: Add/test many tag, tags, and content item tags methods

[schloerke]

Fixes #345

• Related "view tags": https://github.com/rstudio/connect/issues/28829
• Related "create": https://github.com/rstudio/connect/issues/28832
• Related "delete": https://github.com/rstudio/connect/issues/28834
• Related "find content by tags": https://github.com/rstudio/connect/issues/28831
• Related "view content item's tags": https://github.com/rstudio/connect/issues/28830
• Related "assigning tags": https://github.com/rstudio/connect/issues/28833

Grab bag of python recipes using this PR

from posit.connect import Client
from posit.connect.tags import Tag
from posit.connect.content import ContentItem

client = Client()

# Get all tags

## Return all tags
tags: list[Tag] = client.tags.find()
some_tag: Tag = tags[0]

## Return all tags with name and parent
commonnametags: list[Tag] = client.tags.find(name="tag_name")
sibling_tags: list[Tag] = client.tags.find(parent_id="parent_tag_guid")
sibling_tags: list[Tag] = client.tags.find(parent=some_tag)
unique_tag: Tag = client.tags.find(name="tag_name", parent=some_tag)[0]


# Create Tag
mytag: Tag = client.tags.create(name="tag_name")
mytag: Tag = client.tags.create(name="tag_name", parent_id="parent_tag_guid")
mytag: Tag = client.tags.create(name="tag_name", parent=some_tag)

# Remove Tag
mytag.destroy()


# Content Item

## Find content using tags
mycontentitems: list[ContentItem] = mytag.content_items.find()
some_contentitem: ContentItem = mycontentitems[0]

## Get content item's tags
tags: list[Tag] = some_contentitem.tags.find()

## Add tags to content item
some_contentitem.tags.add(mytag)
some_contentitem.tags.add(mytag["id"])

## Remove tags from content item
some_contentitem.tags.delete(mytag)
some_contentitem.tags.delete(mytag["id"])



# Family Tree

## Get parent tag
parent_tag: Tag | None = mytag.parent_tag

## Find all children tags
children_tags: list[Tag] = mytag.children_tags.find()

## Find all descendant tags
descendant_tags: list[Tag] = mytag.descendant_tags.find()

## Find all unique content items for a tag and its descendant tags
my_tag.content_items.find()

[github-actions]

☂️ Python Coverage

current status: ✅

Overall Coverage

Lines	Covered	Coverage	Threshold	Status
2060	1913	93%	0%	🟢

New Files

File	Coverage	Status
src/posit/connect/tags.py	96%	🟢
TOTAL	96%	🟢

Modified Files

File	Coverage	Status
src/posit/connect/client.py	99%	🟢
src/posit/connect/content.py	96%	🟢
src/posit/connect/permissions.py	96%	🟢
TOTAL	97%	🟢

updated for commit: d705d92 by action🐍

[toph-allen]

Adding comments from our discussion

[schloerke]

Through the course of testing, I have realized that

tagA.content_items.find() is returning the same results as what I thought tagA.descendant_tags.content_items.find() + tagA.content_items.find() was suppose to do.

If a child tag is added to a content item, then all ancestor tags are also automatically added

Therefore... tagA.content_items.find() returns all content items that contain tagA or any of its descendant tags.

Therefore... I'm gutting tagA.child_tags.content_items and tagA.descendant_tags.content_items

[toph-allen]

LGTM! 🪼