Skip to content

Commit

Permalink
add autodoc
Browse files Browse the repository at this point in the history
  • Loading branch information
MAfarrag committed Mar 3, 2024
1 parent 2a4b14c commit 3f974ec
Show file tree
Hide file tree
Showing 3 changed files with 21 additions and 2 deletions.
6 changes: 6 additions & 0 deletions docs/source/aws.rst
Original file line number Diff line number Diff line change
Expand Up @@ -49,3 +49,9 @@ The ``AWS`` class provides methods to interact with Amazon Web Services (AWS) S3
aws_client = AWS('your-access-key-id', 'your-secret-access-key', 'us-east-1')
aws_client.download_data('my-s3-bucket', 'path/in/bucket/file.txt', '/local/path/to/save/file.txt')
.. automodule:: aws
:members:
:undoc-members:
:show-inheritance:
12 changes: 10 additions & 2 deletions docs/source/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,13 @@
# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
# import pydata_sphinx_theme

import os
import sys

# for the auto documentation to work
sys.path.insert(0, os.path.abspath("../../src/unicloud"))


project = "unicloud"
copyright = "2024, Mostafa Farrag"
author = "Mostafa Farrag"
Expand All @@ -15,14 +22,15 @@
# -- General configuration ---------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

extensions = []
extensions = [
"sphinx.ext.autodoc",
]

templates_path = ["_templates"]
exclude_patterns = []

root_doc = "index"


# -- Options for HTML output -------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output

Expand Down
5 changes: 5 additions & 0 deletions docs/source/gcs.rst
Original file line number Diff line number Diff line change
Expand Up @@ -43,3 +43,8 @@ The ``GCS`` class provides methods to interact with Google Cloud Storage (GCS),
gcs_client = GCS('my-gcp-project')
gcs_client.download_data('bucket-name/object-name.txt', '/local/path/to/save/file.txt')
.. automodule:: gcs
:members:
:undoc-members:
:show-inheritance:

0 comments on commit 3f974ec

Please sign in to comment.