📝 Docs: Build Sphinx (#329)

Zerohertz · Oct 31, 2024 · d59b126 · d59b126
1 parent b2fb14f
commit d59b126
Show file tree

Hide file tree

Showing 78 changed files with 273 additions and 374 deletions.
diff --git a/docs/.buildinfo b/docs/.buildinfo
@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file records the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 38126a12737db6fdb7c01199eeb0addf
+config: 7d15437a7f3e461a8768769431b0ef39
 tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/docs/_images/monitoring.storage.png b/docs/_images/monitoring.storage.png
diff --git a/docs/_images/plot.candle.png b/docs/_images/plot.candle.png
diff --git a/docs/_images/plot.hist.png b/docs/_images/plot.hist.png
diff --git a/docs/_images/plot.plot.1.png b/docs/_images/plot.plot.1.png
diff --git a/docs/_images/plot.plot.2.png b/docs/_images/plot.plot.2.png
diff --git a/docs/_images/plot.scatter.png b/docs/_images/plot.scatter.png
diff --git a/docs/_images/quant.bollinger_bands.png b/docs/_images/quant.bollinger_bands.png
diff --git a/docs/_images/quant.macd.png b/docs/_images/quant.macd.png
diff --git a/docs/_images/quant.momentum.png b/docs/_images/quant.momentum.png
diff --git a/docs/_images/quant.moving_average.png b/docs/_images/quant.moving_average.png
diff --git a/docs/_images/quant.rsi.png b/docs/_images/quant.rsi.png
diff --git a/docs/_images/vision.grid.png b/docs/_images/vision.grid.png
diff --git a/docs/_images/vision.mask.png b/docs/_images/vision.mask.png
diff --git a/docs/_images/vision.vert.png b/docs/_images/vision.vert.png
diff --git a/docs/_sources/cicd.md.txt b/docs/_sources/cicd.md.txt
@@ -34,7 +34,8 @@ The `dev` branch is used when there are functional changes resulting in differen
    6. `merge-from-docs`: If merge PR from `docs`, can merge `dev-*` → `master`
 3. `master` push
    1. `build`: Install dependencies & build package
-   2. `deploy`
+   2. `test`: Do PyTest
+   3. `deploy`
       1. `GitHub`: Deploy to GitHub
       2. `PyPI`: Deploy to PyPI
 
@@ -59,30 +60,32 @@ The `chore` branch is utilized when the build result is not different, but there
    5. `docs`: Create PR (`docs` → `dev-*`) including the build results generated by Sphinx
    6. `merge-from-docs`: If merge PR from `docs`, can merge `dev-*` → `master`
 3. `master` push
+   1. `build`: Install dependencies & build package
+   2. `test`: Do PyTest
 
 ## Managing Labels for Issues and Pull Requests in GitHub
 
-+ [Issue](https://github.com/Zerohertz/zerohertzLib/blob/master/.github/workflows/issue-controller.yaml)
-  + `assignees: ['Zerohertz']`
-  + `contains(github.event.issue.title, '[Bug]')` → `labels: ['fix']`
-  + `contains(github.event.issue.title, '[Chore]')` → `labels: ['chore']`
-  + `contains(github.event.issue.title, '[Style]')` → `labels: ['style']`
-  + `contains(github.event.issue.title, '[Docs]')` → `labels: ['docs']`
-+ [Pull Request](https://github.com/Zerohertz/zerohertzLib/blob/master/.github/workflows/pr-controller.yaml)
-  + `assignees: ['Zerohertz']`
-  + `body.includes('bug') || body.includes('fix') || body.includes('수정')` → `labelsToAdd.push('fix')`
-  + `body.includes('style')` → `labelsToAdd.push('style')`
-  + `baseBranch === 'master' && headBranch.startsWith('dev')`
-    + `labelsToAdd.push('release')`
-    + `(file.filename.startsWith('Jenkins') || file.filename.startsWith('.github/workflows'))` → `labelsToAdd.push('chore')`
-    + `(file.filename.startsWith('sphinx') && !file.filename.includes('release'))` → `labelsToAdd.push('docs')`
-    + `(file.filename.startsWith('zerohertzLib/{MODULE_NAME}/__init__') || body.includes('{MODULE_NAME}'))` → `labelsToAdd.push('feat/{MODULE_NAME}')`
-  + `baseBranch === 'master' && headBranch.startsWith('chore')`
-    + `labelsToAdd.push('release/chore')`
-    + `(file.filename.startsWith('Jenkins') || file.filename.startsWith('.github/workflows'))` → `labelsToAdd.push('chore')`
-    + `(file.filename.startsWith('sphinx') && !file.filename.includes('release'))` → `labelsToAdd.push('docs')`
-  + `baseBranch.startsWith('dev') || baseBranch.startsWith('chore')) && headBranch === 'docs'`
-    + `labelsToAdd.push('docs')`
+- [Issue](https://github.com/Zerohertz/zerohertzLib/blob/master/.github/workflows/issue-controller.yaml)
+  - `assignees: ['Zerohertz']`
+  - `contains(github.event.issue.title, '[Bug]')` → `labels: ['fix']`
+  - `contains(github.event.issue.title, '[Chore]')` → `labels: ['chore']`
+  - `contains(github.event.issue.title, '[Style]')` → `labels: ['style']`
+  - `contains(github.event.issue.title, '[Docs]')` → `labels: ['docs']`
+- [Pull Request](https://github.com/Zerohertz/zerohertzLib/blob/master/.github/workflows/pr-controller.yaml)
+  - `assignees: ['Zerohertz']`
+  - `body.includes('bug') || body.includes('fix') || body.includes('수정')` → `labelsToAdd.push('fix')`
+  - `body.includes('style')` → `labelsToAdd.push('style')`
+  - `baseBranch === 'master' && headBranch.startsWith('dev')`
+    - `labelsToAdd.push('release')`
+    - `(file.filename.startsWith('Jenkins') || file.filename.startsWith('.github/workflows'))` → `labelsToAdd.push('chore')`
+    - `(file.filename.startsWith('sphinx') && !file.filename.includes('release'))` → `labelsToAdd.push('docs')`
+    - `(file.filename.startsWith('zerohertzLib/{MODULE_NAME}/__init__') || body.includes('{MODULE_NAME}'))` → `labelsToAdd.push('feat/{MODULE_NAME}')`
+  - `baseBranch === 'master' && headBranch.startsWith('chore')`
+    - `labelsToAdd.push('release/chore')`
+    - `(file.filename.startsWith('Jenkins') || file.filename.startsWith('.github/workflows'))` → `labelsToAdd.push('chore')`
+    - `(file.filename.startsWith('sphinx') && !file.filename.includes('release'))` → `labelsToAdd.push('docs')`
+  - `baseBranch.startsWith('dev') || baseBranch.startsWith('chore')) && headBranch === 'docs'`
+    - `labelsToAdd.push('docs')`
 
 ## Sphinx Documentation Deployment
 
@@ -115,15 +118,15 @@ Jenkins (Black, flake8, Pylint, Setuptools, PyTest, Sphinx)
 
 <h2>Jenkins</h2>
 
-|Stage|Condition|
-|:-:|-|
-|1. `Setup`|⭕ [`*` Push]|
-|2. `Merge From Docs`|⭕ [`*` Push] "Merge pull request\*/docs"</br>⭕ [`*` Push] "Merge pull request*[Docs] Build by Sphinx for GitHub Pages"|
-|3. `1. Lint`|⭕ [`dev*` Push]<br>⭕ [`master` PR] (Except "Merge pull request\*/docs" && "Merge pull request\*[Docs] Build by Sphinx for GitHub Pages")|
-|4. `2. Build`|⭕ [`master` Push] (Except "Merge pull request\*/chore\*")</br>⭕ [`dev*` Push]<br>⭕ [`master` PR] (Except "Merge pull request\*/docs" && "Merge pull request\*[Docs] Build by Sphinx for GitHub Pages")|
-|5. `3. Test`|⭕ [`dev*` Push]<br>⭕ [`master` PR] (Except "Merge pull request\*/docs" && "Merge pull request\*[Docs] Build by Sphinx for GitHub Pages")|
-|6. `4. Docs`|⭕ [`master` PR] (Except "Merge pull request\*/docs" && "Merge pull request\*[Docs] Build by Sphinx for GitHub Pages")|
-|7. `Deploy`|⭕ [`master` Push] "Merge pull request\*from Zerohertz/dev\*" (Except "\*from Zerohertz/chore\*")|
+|        Stage         | Condition                                                                                                                                                                                                 |
+| :------------------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+|      1. `Setup`      | ⭕ [`*` Push]                                                                                                                                                                                             |
+| 2. `Merge From Docs` | ⭕ [`*` Push] "Merge pull request\*/docs"</br>⭕ [`*` Push] "Merge pull request\*[Docs] Build by Sphinx for GitHub Pages"                                                                                 |
+|     3. `1. Lint`     | ⭕ [`dev*` Push]<br>⭕ [`master` PR] (Except "Merge pull request\*/docs" && "Merge pull request\*[Docs] Build by Sphinx for GitHub Pages")                                                                |
+|    4. `2. Build`     | ⭕ [`master` Push] (Except "Merge pull request\*/chore\*")</br>⭕ [`dev*` Push]<br>⭕ [`master` PR] (Except "Merge pull request\*/docs" && "Merge pull request\*[Docs] Build by Sphinx for GitHub Pages") |
+|     5. `3. Test`     | ⭕ [`dev*` Push]<br>⭕ [`master` PR] (Except "Merge pull request\*/docs" && "Merge pull request\*[Docs] Build by Sphinx for GitHub Pages")                                                                |
+|     6. `4. Docs`     | ⭕ [`master` PR] (Except "Merge pull request\*/docs" && "Merge pull request\*[Docs] Build by Sphinx for GitHub Pages")                                                                                    |
+|     7. `Deploy`      | ⭕ [`master` Push] "Merge pull request\*from Zerohertz/dev\*" (Except "\*from Zerohertz/chore\*")                                                                                                         |
 
 <h3>Dev Branch</h3>
 

diff --git a/docs/_sources/release/v0.1.md.txt b/docs/_sources/release/v0.1.md.txt
@@ -285,24 +285,3 @@
 
 + GitHub `README.md` update
 
-## v0.1.2
-
-<h3>[v0.1.2] Docs Update (<a href=https://github.com/Zerohertz/zerohertzLib/pull/8>#8</a>)</h3>
-
-```{admonition} Release Date
-:class: tip
-
-2023/11/03
-```
-
-<p align="center">
-<a href="https://github.com/Zerohertz/zerohertzLib/pulls?q=is:pr label:fix"><img src="https://img.shields.io/badge/fix-d73a4a?style=flat-square&logo=github" alt="fix"/></a>
-<a href="https://github.com/Zerohertz/zerohertzLib/pulls?q=is:pr label:docs"><img src="https://img.shields.io/badge/docs-E1B40A?style=flat-square&logo=github" alt="docs"/></a>
-<a href="https://github.com/Zerohertz/zerohertzLib/pulls?q=is:pr label:release"><img src="https://img.shields.io/badge/release-00FF00?style=flat-square&logo=github" alt="release"/></a>
-</p>
-
-
-<h4>Docs</h4>
-
-+ `__init__.py`의 버전 수동 업데이트
-
diff --git a/docs/_sources/release/v1.1.md.txt b/docs/_sources/release/v1.1.md.txt
@@ -1,8 +1,8 @@
 # v1.1
 
-## v1.1.6
+## v1.1.7
 
-<h3>[v1.1.6] Docs update (<a href=https://github.com/Zerohertz/zerohertzLib/pull/327>#327</a>)</h3>
+<h3>[v1.1.7] Release (<a href=https://github.com/Zerohertz/zerohertzLib/pull/329>#329</a>)</h3>
 
 ```{admonition} Release Date
 :class: tip
@@ -11,16 +11,29 @@
 ```
 
 <p align="center">
+<a href="https://github.com/Zerohertz/zerohertzLib/pulls?q=is:pr label:fix"><img src="https://img.shields.io/badge/fix-d73a4a?style=flat-square&logo=github" alt="fix"/></a>
+<a href="https://github.com/Zerohertz/zerohertzLib/pulls?q=is:pr label:feat/api"><img src="https://img.shields.io/badge/feat/api-541B9A?style=flat-square&logo=github" alt="feat/api"/></a>
 <a href="https://github.com/Zerohertz/zerohertzLib/pulls?q=is:pr label:docs"><img src="https://img.shields.io/badge/docs-E1B40A?style=flat-square&logo=github" alt="docs"/></a>
-<a href="https://github.com/Zerohertz/zerohertzLib/pulls?q=is:pr label:release/chore"><img src="https://img.shields.io/badge/release/chore-22FD7F?style=flat-square&logo=github" alt="release/chore"/></a>
+<a href="https://github.com/Zerohertz/zerohertzLib/pulls?q=is:pr label:release"><img src="https://img.shields.io/badge/release-00FF00?style=flat-square&logo=github" alt="release"/></a>
 </p>
 
 
+<h4>Features</h4>
+
+- `api`
+  - Pagination을 통해 100건 이상의 GitHub API 조회 가능하도록 수정
+  - `GitHub` class의 release note 생성 시 100건 이상의 pull request를 불러올 수 있도록 수정
+
+<h4>Chore</h4>
+
+- `actions/cache@v4` 사용으로 인해 이전 SHA의 code 사용 → build 전 `pip uninstall` 수행
+
 <h4>Docs</h4>
 
-- 변경된 CI/CD pipeline image update
+- CI/CD 문서 변경점 추가
+## v1.1.6
 
-<h3>[v1.1.6] Docs update (<a href=https://github.com/Zerohertz/zerohertzLib/pull/326>#326</a>)</h3>
+<h3>[v1.1.6] Docs update (<a href=https://github.com/Zerohertz/zerohertzLib/pull/327>#327</a>)</h3>
 
 ```{admonition} Release Date
 :class: tip
@@ -30,7 +43,7 @@
 
 <p align="center">
 <a href="https://github.com/Zerohertz/zerohertzLib/pulls?q=is:pr label:docs"><img src="https://img.shields.io/badge/docs-E1B40A?style=flat-square&logo=github" alt="docs"/></a>
-<a href="https://github.com/Zerohertz/zerohertzLib/pulls?q=is:pr label:release"><img src="https://img.shields.io/badge/release-00FF00?style=flat-square&logo=github" alt="release"/></a>
+<a href="https://github.com/Zerohertz/zerohertzLib/pulls?q=is:pr label:release/chore"><img src="https://img.shields.io/badge/release/chore-22FD7F?style=flat-square&logo=github" alt="release/chore"/></a>
 </p>
 
 
@@ -56,40 +69,7 @@
 <h4>Features</h4>
 
 - `api`
-  - `GitHub` class의 release note 생성 시 merged가 아닌 closed 상태의 pull request를 제외하도록 수정
-<h3>[v1.1.6] Release (<a href=https://github.com/Zerohertz/zerohertzLib/pull/315>#315</a>)</h3>
-
-```{admonition} Release Date
-:class: tip
-
-2024/10/31
-```
-
-<p align="center">
-<a href="https://github.com/Zerohertz/zerohertzLib/pulls?q=is:pr label:feat/api"><img src="https://img.shields.io/badge/feat/api-541B9A?style=flat-square&logo=github" alt="feat/api"/></a>
-<a href="https://github.com/Zerohertz/zerohertzLib/pulls?q=is:pr label:chore"><img src="https://img.shields.io/badge/chore-fef2c0?style=flat-square&logo=github" alt="chore"/></a>
-<a href="https://github.com/Zerohertz/zerohertzLib/pulls?q=is:pr label:docs"><img src="https://img.shields.io/badge/docs-E1B40A?style=flat-square&logo=github" alt="docs"/></a>
-<a href="https://github.com/Zerohertz/zerohertzLib/pulls?q=is:pr label:style"><img src="https://img.shields.io/badge/style-03A17F?style=flat-square&logo=github" alt="style"/></a>
-<a href="https://github.com/Zerohertz/zerohertzLib/pulls?q=is:pr label:release"><img src="https://img.shields.io/badge/release-00FF00?style=flat-square&logo=github" alt="release"/></a>
-</p>
-
-
-<h4>Features</h4>
-
-+ `api`
-  + OpenAI API의 정책 변경으로 인해 `pytest` 생략
-
-<h4>Chore</h4>
-
-- [Codecov](https://app.codecov.io/github/Zerohertz/zerohertzLib)를 통한 pytest report 생성
-
-<h4>Style</h4>
-
-- `pylint` update에 따른 설정 변경
-
-<h4>Docs</h4>
-
-- Codecov badge 추가
+  - `GitHub` class의 release note 생성 시 merged가 아닌 closed 상태의 pull request를 제외하도록 수정 (→ <s></s>오류로 누락<s></s> → `git rebase`로 복구 완료)
 ## v1.1.5
 
 <h3>[v1.1.5] Chore update (<a href=https://github.com/Zerohertz/zerohertzLib/pull/321>#321</a>)</h3>

diff --git a/docs/_static/documentation_options.js b/docs/_static/documentation_options.js
@@ -1,5 +1,5 @@
 const DOCUMENTATION_OPTIONS = {
-    VERSION: 'v1.1.6',
+    VERSION: 'v1.1.7',
     LANGUAGE: 'en',
     COLLAPSE_INDEX: false,
     BUILDER: 'html',

diff --git a/docs/_static/examples/dynamic/monitoring.storage.png b/docs/_static/examples/dynamic/monitoring.storage.png
diff --git a/docs/_static/examples/dynamic/plot.candle.png b/docs/_static/examples/dynamic/plot.candle.png
diff --git a/docs/_static/examples/dynamic/plot.hist.png b/docs/_static/examples/dynamic/plot.hist.png
diff --git a/docs/_static/examples/dynamic/plot.plot.1.png b/docs/_static/examples/dynamic/plot.plot.1.png
diff --git a/docs/_static/examples/dynamic/plot.plot.2.png b/docs/_static/examples/dynamic/plot.plot.2.png
diff --git a/docs/_static/examples/dynamic/plot.scatter.png b/docs/_static/examples/dynamic/plot.scatter.png
diff --git a/docs/_static/examples/dynamic/quant.bollinger_bands.png b/docs/_static/examples/dynamic/quant.bollinger_bands.png
diff --git a/docs/_static/examples/dynamic/quant.macd.png b/docs/_static/examples/dynamic/quant.macd.png
diff --git a/docs/_static/examples/dynamic/quant.momentum.png b/docs/_static/examples/dynamic/quant.momentum.png
diff --git a/docs/_static/examples/dynamic/quant.moving_average.png b/docs/_static/examples/dynamic/quant.moving_average.png
diff --git a/docs/_static/examples/dynamic/quant.rsi.png b/docs/_static/examples/dynamic/quant.rsi.png
diff --git a/docs/_static/examples/dynamic/vision.grid.png b/docs/_static/examples/dynamic/vision.grid.png
diff --git a/docs/_static/examples/dynamic/vision.mask.png b/docs/_static/examples/dynamic/vision.mask.png
diff --git a/docs/_static/examples/dynamic/vision.vert.png b/docs/_static/examples/dynamic/vision.vert.png
diff --git a/docs/cicd.html b/docs/cicd.html
@@ -16,10 +16,10 @@
     <meta property="og:title" content="CI/CD Pipelines" />
 <meta property="og:type" content="website" />
 <meta property="og:url" content="https://zerohertz.github.io/zerohertzLib/cicd.html" />
-<meta property="og:site_name" content="Zerohertz's Library v1.1.6 Documents" />
+<meta property="og:site_name" content="Zerohertz's Library v1.1.7 Documents" />
 <meta property="og:description" content="Branch Rules: Dev Branch: dev-* push- check-pr: Check if a PR is open for the dev-* branch, build: Install dependencies & build package, lint: Check format of python codes, test: Do PyTest., dev-* ..." />
 <meta property="og:image" content="https://zerohertz.github.io/zerohertzLib/_static/og.png" />
-<meta property="og:image:alt" content="Zerohertz's Library v1.1.6 Documents" />
+<meta property="og:image:alt" content="Zerohertz's Library v1.1.7 Documents" />
 <meta name="description" content="Branch Rules: Dev Branch: dev-* push- check-pr: Check if a PR is open for the dev-* branch, build: Install dependencies & build package, lint: Check format of python codes, test: Do PyTest., dev-* ..." />
     <link href="_static/favicon.png" sizes="802x802" rel="icon" type="image/png">
     <link href="_static/favicon-16x16.png" sizes="16x16" rel="icon" type="image/png">
@@ -28,7 +28,7 @@
         <link rel="canonical" href="https://zerohertz.github.io/zerohertzLib/cicd.html" />
 
     <!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
-        <title>CI/CD Pipelines - zerohertzLib v1.1.6 documentation</title>
+        <title>CI/CD Pipelines - zerohertzLib v1.1.7 documentation</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=354aac6f" />
     <link rel="stylesheet" type="text/css" href="_static/copybutton.css?v=76b2166b" />
@@ -199,7 +199,7 @@
       </label>
     </div>
     <div class="header-center">
-      <a href="index.html"><div class="brand">zerohertzLib v1.1.6 documentation</div></a>
+      <a href="index.html"><div class="brand">zerohertzLib v1.1.7 documentation</div></a>
     </div>
     <div class="header-right">
       <div class="theme-toggle-container theme-toggle-header">
@@ -226,7 +226,7 @@
     <img class="sidebar-logo" src="_static/logo.png" alt="Logo"/>
   </div>
 
-  <span class="sidebar-brand-text">zerohertzLib v1.1.6 documentation</span>
+  <span class="sidebar-brand-text">zerohertzLib v1.1.7 documentation</span>
 
 </a><form class="sidebar-search-container" method="get" action="search.html" role="search">
   <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
@@ -347,6 +347,7 @@ <h3>Dev Branch<a class="headerlink" href="#dev-branch" title="Link to this headi
 <li><p><code class="docutils literal notranslate"><span class="pre">master</span></code> push</p>
 <ol class="arabic simple">
 <li><p><code class="docutils literal notranslate"><span class="pre">build</span></code>: Install dependencies &amp; build package</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">test</span></code>: Do PyTest</p></li>
 <li><p><code class="docutils literal notranslate"><span class="pre">deploy</span></code></p>
 <ol class="arabic simple">
 <li><p><code class="docutils literal notranslate"><span class="pre">GitHub</span></code>: Deploy to GitHub</p></li>
@@ -378,7 +379,12 @@ <h3>Chore Branch<a class="headerlink" href="#chore-branch" title="Link to this h
 <li><p><code class="docutils literal notranslate"><span class="pre">merge-from-docs</span></code>: If merge PR from <code class="docutils literal notranslate"><span class="pre">docs</span></code>, can merge <code class="docutils literal notranslate"><span class="pre">dev-*</span></code> → <code class="docutils literal notranslate"><span class="pre">master</span></code></p></li>
 </ol>
 </li>
-<li><p><code class="docutils literal notranslate"><span class="pre">master</span></code> push</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">master</span></code> push</p>
+<ol class="arabic simple">
+<li><p><code class="docutils literal notranslate"><span class="pre">build</span></code>: Install dependencies &amp; build package</p></li>
+<li><p><code class="docutils literal notranslate"><span class="pre">test</span></code>: Do PyTest</p></li>
+</ol>
+</li>
 </ol>
 </section>
 </section>
@@ -622,7 +628,7 @@ <h3>Chore Branch</h3>
   </div>
 </div><script src="_static/jquery.js?v=5d32c60e"></script>
     <script src="_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-    <script src="_static/documentation_options.js?v=68c6869a"></script>
+    <script src="_static/documentation_options.js?v=ccbe0283"></script>
     <script src="_static/doctools.js?v=9bcbadda"></script>
     <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/scripts/furo.js?v=5fa4622c"></script>