-
Notifications
You must be signed in to change notification settings - Fork 296
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Final Sphinx documentation w/ ReadTheDocs #172
Changes from 9 commits
467de72
bfa51fc
89220a4
533b686
b2e750e
7e2d582
c444871
ad33a34
37f9655
4ccf2e5
2622219
44ebbee
bf23801
a5e1e08
ac73cef
a637f65
6080be9
9e3e99f
8b7d53a
633d4f7
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,32 @@ | ||
# .readthedocs.yaml | ||
# Read the Docs configuration file | ||
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details | ||
|
||
# Required | ||
version: 2 | ||
|
||
# Set the version of Python and other tools you might need | ||
build: | ||
os: ubuntu-20.04 | ||
apt_packages: | ||
- libsndfile1 | ||
- ffmpeg | ||
tools: | ||
python: "3.9" | ||
# You can also specify other tool versions: | ||
# nodejs: "16" | ||
# rust: "1.55" | ||
# golang: "1.17" | ||
|
||
# Build documentation in the docs/ directory with Sphinx | ||
sphinx: | ||
configuration: docs/source/conf.py | ||
|
||
# If using Sphinx, optionally build your docs in additional formats such as PDF | ||
# formats: | ||
|
||
# Optionally declare the Python requirements required to build your docs | ||
python: | ||
install: | ||
- requirements: docs/requirements.txt |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,20 @@ | ||
# Minimal makefile for Sphinx documentation | ||
# | ||
|
||
# You can set these variables from the command line, and also | ||
# from the environment for the first two. | ||
SPHINXOPTS ?= | ||
SPHINXBUILD ?= sphinx-build | ||
SOURCEDIR = source | ||
BUILDDIR = build | ||
|
||
# Put it first so that "make" without argument is like "make help". | ||
help: | ||
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) | ||
|
||
.PHONY: help Makefile | ||
|
||
# Catch-all target: route all unknown targets to Sphinx using the new | ||
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). | ||
%: Makefile | ||
@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,35 @@ | ||
@ECHO OFF | ||
|
||
pushd %~dp0 | ||
|
||
REM Command file for Sphinx documentation | ||
|
||
if "%SPHINXBUILD%" == "" ( | ||
set SPHINXBUILD=sphinx-build | ||
) | ||
set SOURCEDIR=source | ||
set BUILDDIR=build | ||
|
||
if "%1" == "" goto help | ||
|
||
%SPHINXBUILD% >NUL 2>NUL | ||
if errorlevel 9009 ( | ||
echo. | ||
echo.The 'sphinx-build' command was not found. Make sure you have Sphinx | ||
echo.installed, then set the SPHINXBUILD environment variable to point | ||
echo.to the full path of the 'sphinx-build' executable. Alternatively you | ||
echo.may add the Sphinx directory to PATH. | ||
echo. | ||
echo.If you don't have Sphinx installed, grab it from | ||
echo.https://www.sphinx-doc.org/ | ||
exit /b 1 | ||
) | ||
|
||
%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% | ||
goto end | ||
|
||
:help | ||
%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% | ||
|
||
:end | ||
popd |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,18 @@ | ||
iopath>=0.1.8 | ||
nlpaug==1.1.3 | ||
numpy>=1.19.5 | ||
Pillow>=8.2.0 | ||
python-magic>=0.4.22 | ||
regex>=2021.4.4 | ||
vidgear>=0.2.4 | ||
audioread>=2.1.9 | ||
ffmpeg-python>=0.2.0 | ||
librosa>=0.8.1 | ||
opencv-python>=4.5.2.54 | ||
SoundFile>=0.10.3.post1 | ||
torch>=1.9.0 | ||
torchaudio>=0.9.0 | ||
sphinx | ||
sphinx-epytext | ||
sphinx-autodoc-typehints | ||
myst-parser | ||
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
# Get Started | ||
|
||
```{include} ../../README.md | ||
``` |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,2 @@ | ||
```{include} ../../augly/audio/README.md | ||
``` |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,2 @@ | ||
```{include} ../../augly/image/README.md | ||
``` |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,2 @@ | ||
```{include} ../../augly/text/README.md | ||
``` |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,2 @@ | ||
```{include} ../../augly/video/README.md | ||
``` |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,53 @@ | ||
augly.audio package | ||
=================== | ||
|
||
Submodules | ||
---------- | ||
|
||
augly.audio.composition module | ||
------------------------------ | ||
|
||
.. automodule:: augly.audio.composition | ||
:members: | ||
:undoc-members: | ||
:show-inheritance: | ||
|
||
augly.audio.functional module | ||
----------------------------- | ||
|
||
.. automodule:: augly.audio.functional | ||
:members: | ||
:undoc-members: | ||
:show-inheritance: | ||
|
||
augly.audio.intensity module | ||
---------------------------- | ||
|
||
.. automodule:: augly.audio.intensity | ||
:members: | ||
:undoc-members: | ||
:show-inheritance: | ||
|
||
augly.audio.transforms module | ||
----------------------------- | ||
|
||
.. automodule:: augly.audio.transforms | ||
:members: | ||
:undoc-members: | ||
:show-inheritance: | ||
|
||
augly.audio.utils module | ||
------------------------ | ||
|
||
.. automodule:: augly.audio.utils | ||
:members: | ||
:undoc-members: | ||
:show-inheritance: | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. i don't think it's needed to publicize the |
||
|
||
Module contents | ||
--------------- | ||
|
||
.. automodule:: augly.audio | ||
:members: | ||
:undoc-members: | ||
:show-inheritance: |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,61 @@ | ||
augly.image package | ||
=================== | ||
|
||
Subpackages | ||
----------- | ||
|
||
.. toctree:: | ||
:maxdepth: 4 | ||
|
||
augly.image.utils | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. since augly.image.utils doesn't exist anymore as an .rst file, should this be deleted too? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. @jbitton Yep I'll delete that |
||
|
||
Submodules | ||
---------- | ||
|
||
augly.image.composition module | ||
------------------------------ | ||
|
||
.. automodule:: augly.image.composition | ||
:members: | ||
:undoc-members: | ||
:show-inheritance: | ||
|
||
augly.image.functional module | ||
----------------------------- | ||
|
||
.. automodule:: augly.image.functional | ||
:members: | ||
:undoc-members: | ||
:show-inheritance: | ||
|
||
augly.image.helpers module | ||
-------------------------- | ||
|
||
.. automodule:: augly.image.helpers | ||
:members: | ||
:undoc-members: | ||
:show-inheritance: | ||
|
||
augly.image.intensity module | ||
---------------------------- | ||
|
||
.. automodule:: augly.image.intensity | ||
:members: | ||
:undoc-members: | ||
:show-inheritance: | ||
|
||
augly.image.transforms module | ||
----------------------------- | ||
|
||
.. automodule:: augly.image.transforms | ||
:members: | ||
:undoc-members: | ||
:show-inheritance: | ||
|
||
Module contents | ||
--------------- | ||
|
||
.. automodule:: augly.image | ||
:members: | ||
:undoc-members: | ||
:show-inheritance: |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,37 @@ | ||
augly.image.utils package | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. same comment as audio lib -- i don't think we need to publicize this, as it's for internal development not external use (cc: @zpapakipos) |
||
========================= | ||
|
||
Submodules | ||
---------- | ||
|
||
augly.image.utils.bboxes module | ||
------------------------------- | ||
|
||
.. automodule:: augly.image.utils.bboxes | ||
:members: | ||
:undoc-members: | ||
:show-inheritance: | ||
|
||
augly.image.utils.metadata module | ||
--------------------------------- | ||
|
||
.. automodule:: augly.image.utils.metadata | ||
:members: | ||
:undoc-members: | ||
:show-inheritance: | ||
|
||
augly.image.utils.utils module | ||
------------------------------ | ||
|
||
.. automodule:: augly.image.utils.utils | ||
:members: | ||
:undoc-members: | ||
:show-inheritance: | ||
|
||
Module contents | ||
--------------- | ||
|
||
.. automodule:: augly.image.utils | ||
:members: | ||
:undoc-members: | ||
:show-inheritance: |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,23 @@ | ||
augly package | ||
============= | ||
|
||
Subpackages | ||
----------- | ||
|
||
.. toctree:: | ||
:maxdepth: 4 | ||
|
||
augly.audio | ||
augly.image | ||
augly.tests | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. i dont think we need to publicize |
||
augly.text | ||
augly.utils | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. im borderline about |
||
augly.video | ||
|
||
Module contents | ||
--------------- | ||
|
||
.. automodule:: augly | ||
:members: | ||
:undoc-members: | ||
:show-inheritance: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
instead of copying/pasting this from the
requirements.txt
on the base level of this repo, is there any way we could populate this dynamically from the original requirements?this will allow for less human error/forgetting to update dependencies in both locations
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
+1 strongly agree!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@jbitton There is a possible route but I'm not too sure if it will work. So basically we could require the ReadTheDocs build to run
setup.py
and within that file, thedocs/requirements.txt
is dynamically generated.There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm personally okay with that. As long as we only do this for readthedocs builds :)