Skip to content

Commit

Permalink
add github workflow to build docs
Browse files Browse the repository at this point in the history
  • Loading branch information
Brady Endres committed Jul 26, 2024
1 parent 2526c22 commit dba651f
Show file tree
Hide file tree
Showing 23 changed files with 6,366 additions and 0 deletions.
27 changes: 27 additions & 0 deletions .github/workflows/documentation.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
name: documentation

on: [push, pull_request, workflow_dispatch]

permissions:
contents: write

jobs:
docs:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
- name: Install dependencies
run: |
pip install sphinx sphinx_rtd_theme myst_parser
- name: Sphinx build
run: |
sphinx-build doc _build
- name: Deploy to GitHub Pages
uses: peaceiris/actions-gh-pages@v3
if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
with:
publish_branch: gh-pages
github_token: ${{ secrets.GITHUB_TOKEN }}
publish_dir: _build/
force_orphan: true
4 changes: 4 additions & 0 deletions _build/.buildinfo
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
# Sphinx build info version 1
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
config: 92f8d6ac56ccab42ac73d860c02e5024
tags: 645f666f9bcd5a90fca523b33c5a78b7
Binary file added _build/.doctrees/environment.pickle
Binary file not shown.
Binary file added _build/.doctrees/index.doctree
Binary file not shown.
46 changes: 46 additions & 0 deletions _build/_sources/index.rst.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
.. SyncSketch Python API Library documentation master file, created by
sphinx-quickstart on Thu Jul 25 15:46:05 2024.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
SyncSketch Python API Library documentation
===========================================

autodoc_member_order = 'bysource'

.. toctree::
:maxdepth: 2
:caption: Contents:

.. class:: syncsketch.SyncSketchAPI
:no-index:

SyncSketchAPI is a class that provides a set of methods to interact with SyncSketch API.

.. method:: __init__(
auth,
api_key,
host="https://www.syncsketch.com",
useExpiringToken=False,
debug=False,
api_version="v1",
use_header_auth=False
)

Constructor for SyncSketchAPI class.

:param str auth: The username of the user.
:param str api_key: The api key of the user.
:param str host: The host of the SyncSketch API.
:param bool useExpiringToken: If True, the token will expire after 1 hour.
:param bool debug: If True, the debug mode will be enabled.
:param str api_version: The version of the SyncSketch API.
:param bool use_header_auth: If True, the authentication will be done using headers.
:return: SyncSketchAPI object.
:rtype: obj

.. autoclass:: syncsketch.SyncSketchAPI
:show-inheritance:
:members:
:exclude-members: isConnected,get_api_base_url,get_media_by_review_id,join_url_path,addComment,addItem,addMedia,addMediaByURL,addProject,addReview,addUsers,getProjectById,getProjects,getProjectsByName,get_shotgun_sync_review_notes_progress,updateItem,connectItemToReview,deleteItem,deleteProject,deleteReview,getAccounts,getAnnotations,getCurrentUser,getGreasePencilOverlays,getItem,getMedia,add_users,shotgrid_get_projects,getMediaByReviewId,getReviewById,getReviewByName,getReviewsByProjectId,getTree,getUserById,getUsersByName,getUsersByProjectId
:member-order: bysource
Loading

0 comments on commit dba651f

Please sign in to comment.