Skip to content

Commit 854375f

Browse files
authored
Merge pull request #337 from yozachar/workshop
fix: packaging as well as `rST` & `md` document generation
2 parents 245bffd + 3a2c513 commit 854375f

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

71 files changed

+449
-669
lines changed

.github/workflows/docs.yaml.bkp

+5-5
Original file line numberDiff line numberDiff line change
@@ -15,10 +15,10 @@ jobs:
1515
steps:
1616
# checkout repository
1717
- name: Checkout repository
18-
uses: actions/checkout@v3
18+
uses: actions/checkout@v4
1919
# set up specific python version
2020
- name: Set up Python v3.12
21-
uses: actions/setup-python@v4
21+
uses: actions/setup-python@v5
2222
with:
2323
python-version: "3.12"
2424
# building
@@ -30,10 +30,10 @@ jobs:
3030
run: python package/export docs
3131
# set up Pages
3232
- name: Set up Pages
33-
uses: actions/configure-pages@v3
33+
uses: actions/configure-pages@v4
3434
# upload static page
3535
- name: Upload artifact
36-
uses: actions/upload-pages-artifact@v1
36+
uses: actions/upload-pages-artifact@v3
3737
with:
3838
path: ${{ env.BUILD_PATH }}/site
3939
deploy:
@@ -50,4 +50,4 @@ jobs:
5050
steps:
5151
- name: Deploy to GitHub Pages
5252
id: deployment
53-
uses: actions/deploy-pages@v2
53+
uses: actions/deploy-pages@v4

.github/workflows/package.yaml renamed to .github/workflows/package.yaml.bkp

+3-3
Original file line numberDiff line numberDiff line change
@@ -16,10 +16,10 @@ jobs:
1616
steps:
1717
# checkout repository
1818
- name: Checkout repository
19-
uses: actions/checkout@v3
19+
uses: actions/checkout@v4
2020
# set up specific python version
2121
- name: Set up Python v3.8
22-
uses: actions/setup-python@v4
22+
uses: actions/setup-python@v5
2323
with:
2424
python-version: "3.8"
2525
# install dependencies
@@ -38,7 +38,7 @@ jobs:
3838
deactivate
3939
# upload package as artifact
4040
- name: Upload artifact
41-
uses: actions/upload-pages-artifact@v1
41+
uses: actions/upload-pages-artifact@v3
4242
with:
4343
path: ${{ env.BUILD_PATH }}/dist
4444
publish:

.github/workflows/pycqa.yaml

+4-4
Original file line numberDiff line numberDiff line change
@@ -14,10 +14,10 @@ jobs:
1414
steps:
1515
# checkout repository
1616
- name: Checkout repository
17-
uses: actions/checkout@v3
17+
uses: actions/checkout@v4
1818
# set up specific python version
1919
- name: Set up Python v3.8
20-
uses: actions/setup-python@v4
20+
uses: actions/setup-python@v5
2121
with:
2222
python-version: "3.8"
2323
# tooling
@@ -41,10 +41,10 @@ jobs:
4141
# checkout repository again!
4242
# ref: https://github.com/actions/checkout/issues/19
4343
- name: Checkout repository
44-
uses: actions/checkout@v3
44+
uses: actions/checkout@v4
4545
# set up specific python version
4646
- name: Set up Python v${{ matrix.python-version }}
47-
uses: actions/setup-python@v4
47+
uses: actions/setup-python@v5
4848
with:
4949
python-version: ${{ matrix.python-version }}
5050
cache: "pip"

.github/workflows/sast.yaml

+1-1
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ jobs:
1616
actions: read # only required for a private repository by github/codeql-action/upload-sarif to get the Action run status
1717
runs-on: ubuntu-latest
1818
steps:
19-
- uses: actions/checkout@v2
19+
- uses: actions/checkout@v4
2020
- name: Bandit
2121
uses: mdegis/bandit-action@85fcc340c3b0bf5d86029abb49b9aac916d807b2
2222
with:

.gitignore

-4
Original file line numberDiff line numberDiff line change
@@ -69,11 +69,7 @@ instance/
6969
.scrapy
7070

7171
# Sphinx documentation
72-
# docs/references/
7372
docs/_build/
74-
# temporary
75-
docs/references/*.rst
76-
docs/*.rst
7773
docs/*.1
7874

7975
# PyBuilder

CHANGES.md

+20-3

MANIFEST.in

+14-4
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,31 @@
11
# MANIFEST.in stays as long as pyproject.toml does not officially support it
22
# https://packaging.python.org/en/latest/specifications/declaring-project-metadata/
33

4-
include docs/*
5-
include .gitignore
4+
# include
5+
include CHANGES.md
6+
include mkdocs.yaml
7+
68

79
# global-include
810

11+
12+
# recursive-include
913
recursive-include tests *
14+
recursive-include docs *
15+
1016

1117
# graft
1218

19+
1320
# exclude
1421

22+
1523
# global-exclude
1624

17-
recursive-exclude docs *.rst
18-
recursive-exclude docs/references *.md
1925

26+
# recursive-exclude
27+
28+
29+
# prune
2030
prune docs/_build
2131
prune **/__pycache__

SECURITY.md

+1-1

docs/api/between.rst

+5

docs/api/btc_address.rst

+5

docs/api/card.rst

+12

docs/api/country_code.rst

+5

docs/api/domain.rst

+5

docs/api/email.rst

+5

docs/api/hashes.rst

+9

docs/api/hostname.rst

+5

docs/api/i18n.rst

+12

docs/api/iban.rst

+5

docs/api/ip_address.rst

+6

docs/api/length.rst

+5

docs/api/mac_address.rst

+5

docs/api/slug.rst

+5

docs/api/url.rst

+5

docs/api/utils.rst

+6

docs/api/uuid.rst

+5

docs/conf.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@
2828
"sphinx.ext.napoleon",
2929
"myst_parser",
3030
]
31-
exclude_patterns = ["_build", "Thumbs.db", ".DS_Store", "*.md"]
31+
exclude_patterns = ["_build", "Thumbs.db", ".DS_Store", "**/*.md", "*.md"]
3232

3333

3434
# -- Options for HTML output -------------------------------------------------

docs/index.rst

+69

0 commit comments

Comments
 (0)