add permissions to docstrings #946

	name: main build and publish workflow

	on: push

	jobs:
	build:
	name: Build distribution
	runs-on: ubuntu-latest

	steps:
	- uses: actions/checkout@v4
	- name: Set up Python
	uses: actions/setup-python@v4
	with:
	python-version: "3.10"
	- name: Install pypa/build
	run: >-
	python3 -m
	pip install
	build
	--user
	- name: Build a binary wheel and a source tarball
	run: python3 -m build
	- name: Store the distribution packages
	uses: actions/upload-artifact@v4
	with:
	name: python-package-distributions
	path: dist/
	retention-days: 30

	unit-test:
	name: Run unit tests
	runs-on: ubuntu-latest

	steps:
	- uses: actions/checkout@v4
	- uses: actions/setup-python@v4
	with:
	python-version: "3.10"
	cache: "pip"
	- run: pip install .[test]
	- run: pytest test/

	publish-to-pypi:
	name: Publish to PyPI
	runs-on: ubuntu-latest
	if: startsWith(github.ref, 'refs/tags/')
	needs:
	- build
	environment:
	name: pypi
	url: https://pypi.org/p/answerrocket-client
	permissions:
	id-token: write
	steps:
	- name: Download all the dists
	uses: actions/download-artifact@v4
	with:
	name: python-package-distributions
	path: dist/
	- name: Publish distribution to PyPI
	uses: pypa/gh-action-pypi-publish@release/v1

Provide feedback