drf-to-mkdoc 0.1.0__tar.gz → 0.1.2__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of drf-to-mkdoc might be problematic. Click here for more details.
- drf_to_mkdoc-0.1.2/.github/workflows/publish.yaml +43 -0
- drf_to_mkdoc-0.1.2/CONTRIBUTING.md +127 -0
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/LICENSE +21 -21
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/MANIFEST.in +18 -18
- {drf_to_mkdoc-0.1.0/drf_to_mkdoc.egg-info → drf_to_mkdoc-0.1.2}/PKG-INFO +247 -247
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/README.md +197 -197
- drf_to_mkdoc-0.1.2/conf/defaults.py +10 -0
- drf_to_mkdoc-0.1.2/conf/settings.py +18 -0
- drf_to_mkdoc-0.1.2/docs/customizing_endpoints.md +106 -0
- drf_to_mkdoc-0.1.2/docs/serving_mkdocs_with_django.md +109 -0
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc/__init__.py +6 -6
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc/apps.py +14 -14
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc/conf/settings.py +44 -44
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc/management/commands/build_docs.py +76 -76
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc/management/commands/generate_doc_json.py +512 -512
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc/management/commands/generate_docs.py +138 -138
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc/management/commands/generate_model_docs.py +327 -327
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc/management/commands/update_doc_schema.py +53 -53
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc/utils/__init__.py +3 -3
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc/utils/endpoint_generator.py +945 -945
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc/utils/extractors/__init__.py +3 -3
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc/utils/extractors/query_parameter_extractors.py +229 -229
- drf_to_mkdoc-0.1.2/drf_to_mkdoc/utils/md_generators/__init__.py +0 -0
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc/utils/md_generators/query_parameters_generators.py +72 -72
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc/utils/model_generator.py +269 -269
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2/drf_to_mkdoc.egg-info}/PKG-INFO +247 -247
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc.egg-info/SOURCES.txt +7 -0
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/pyproject.toml +79 -75
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/setup.cfg +4 -4
- {drf_to_mkdoc-0.1.0/drf_to_mkdoc → drf_to_mkdoc-0.1.2}/conf/__init__.py +0 -0
- {drf_to_mkdoc-0.1.0/drf_to_mkdoc/management → drf_to_mkdoc-0.1.2/drf_to_mkdoc/conf}/__init__.py +0 -0
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc/conf/defaults.py +0 -0
- {drf_to_mkdoc-0.1.0/drf_to_mkdoc/management/commands → drf_to_mkdoc-0.1.2/drf_to_mkdoc/management}/__init__.py +0 -0
- {drf_to_mkdoc-0.1.0/drf_to_mkdoc/utils/md_generators → drf_to_mkdoc-0.1.2/drf_to_mkdoc/management/commands}/__init__.py +0 -0
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc/utils/common.py +0 -0
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc.egg-info/dependency_links.txt +0 -0
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc.egg-info/requires.txt +0 -0
- {drf_to_mkdoc-0.1.0 → drf_to_mkdoc-0.1.2}/drf_to_mkdoc.egg-info/top_level.txt +0 -0
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
name: Publish Python Package
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
tags:
|
|
6
|
+
- 'v*' # Trigger on tags like v1.0.0
|
|
7
|
+
|
|
8
|
+
jobs:
|
|
9
|
+
publish:
|
|
10
|
+
name: Publish to PyPI
|
|
11
|
+
runs-on: ubuntu-latest
|
|
12
|
+
environment: pypi # Make sure this environment exists in repo settings
|
|
13
|
+
|
|
14
|
+
permissions:
|
|
15
|
+
contents: read
|
|
16
|
+
id-token: write # Required for PyPI trusted publishing
|
|
17
|
+
|
|
18
|
+
steps:
|
|
19
|
+
- name: Checkout repository
|
|
20
|
+
uses: actions/checkout@v4
|
|
21
|
+
with:
|
|
22
|
+
fetch-depth: 0
|
|
23
|
+
|
|
24
|
+
- name: Set up Python
|
|
25
|
+
uses: actions/setup-python@v5
|
|
26
|
+
with:
|
|
27
|
+
python-version: '3.x'
|
|
28
|
+
|
|
29
|
+
- name: Install build tools and setuptools_scm
|
|
30
|
+
run: |
|
|
31
|
+
python -m pip install --upgrade pip
|
|
32
|
+
pip install build setuptools_scm[toml]
|
|
33
|
+
|
|
34
|
+
- name: Verify version detection
|
|
35
|
+
run: |
|
|
36
|
+
echo "Detected version: $(python -m setuptools_scm)"
|
|
37
|
+
echo "Git describe: $(git describe --tags)"
|
|
38
|
+
|
|
39
|
+
- name: Build package
|
|
40
|
+
run: python -m build
|
|
41
|
+
|
|
42
|
+
- name: Publish to PyPI
|
|
43
|
+
uses: pypa/gh-action-pypi-publish@release/v1
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
# Contributing to DRF to MkDocs
|
|
2
|
+
|
|
3
|
+
Thank you for your interest in contributing to DRF to MkDocs! This document provides guidelines and information for contributors.
|
|
4
|
+
|
|
5
|
+
## Getting Started
|
|
6
|
+
|
|
7
|
+
1. **Fork the repository**
|
|
8
|
+
- Go to the main repository page
|
|
9
|
+
- Click the "Fork" button to create your own copy
|
|
10
|
+
|
|
11
|
+
2. **Clone your fork**
|
|
12
|
+
```bash
|
|
13
|
+
git clone https://github.com/yourusername/drf-to-mkdoc.git
|
|
14
|
+
cd drf-to-mkdoc
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
3. **Set up development environment**
|
|
18
|
+
```bash
|
|
19
|
+
pip install -e ".[dev]"
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
4. **Create a feature branch**
|
|
23
|
+
```bash
|
|
24
|
+
git checkout -b feature/your-feature-name
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## Development Guidelines
|
|
28
|
+
|
|
29
|
+
### Code Style
|
|
30
|
+
|
|
31
|
+
- Follow PEP 8 style guidelines
|
|
32
|
+
- Use meaningful variable and function names
|
|
33
|
+
- Add docstrings to all public functions and classes
|
|
34
|
+
- Keep functions focused and single-purpose
|
|
35
|
+
|
|
36
|
+
### Documentation
|
|
37
|
+
|
|
38
|
+
- Update README.md if adding new features
|
|
39
|
+
- Add docstrings to new functions and classes
|
|
40
|
+
- Update inline comments for complex logic
|
|
41
|
+
- Consider adding examples for new functionality
|
|
42
|
+
|
|
43
|
+
## Making Changes
|
|
44
|
+
|
|
45
|
+
1. **Make your changes**
|
|
46
|
+
- Implement your feature or fix
|
|
47
|
+
- Follow the coding guidelines above
|
|
48
|
+
- Test your changes thoroughly
|
|
49
|
+
|
|
50
|
+
2. **Commit your changes**
|
|
51
|
+
```bash
|
|
52
|
+
git add .
|
|
53
|
+
git commit -m "Add feature: brief description of changes"
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
3. **Push to your fork**
|
|
57
|
+
```bash
|
|
58
|
+
git push origin feature/your-feature-name
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
4. **Create a pull request**
|
|
62
|
+
- Go to your fork on GitHub
|
|
63
|
+
- Click "New Pull Request"
|
|
64
|
+
- Select your feature branch
|
|
65
|
+
- Fill out the pull request template
|
|
66
|
+
|
|
67
|
+
## Pull Request Guidelines
|
|
68
|
+
|
|
69
|
+
### Before Submitting
|
|
70
|
+
|
|
71
|
+
- [ ] Code follows style guidelines
|
|
72
|
+
- [ ] Documentation is updated
|
|
73
|
+
- [ ] No breaking changes (or clearly documented)
|
|
74
|
+
- [ ] Feature is tested with multiple Django versions
|
|
75
|
+
|
|
76
|
+
### Pull Request Template
|
|
77
|
+
|
|
78
|
+
```markdown
|
|
79
|
+
## Description
|
|
80
|
+
Brief description of the changes made.
|
|
81
|
+
|
|
82
|
+
## Type of Change
|
|
83
|
+
- [ ] Bug fix
|
|
84
|
+
- [ ] New feature
|
|
85
|
+
- [ ] Documentation update
|
|
86
|
+
- [ ] Code refactoring
|
|
87
|
+
|
|
88
|
+
## Testing
|
|
89
|
+
Describe how you tested your changes.
|
|
90
|
+
|
|
91
|
+
## Checklist
|
|
92
|
+
- [ ] My code follows the style guidelines
|
|
93
|
+
- [ ] I have performed a self-review
|
|
94
|
+
- [ ] I have commented my code where necessary
|
|
95
|
+
- [ ] I have made corresponding changes to documentation
|
|
96
|
+
- [ ] My changes generate no new warnings
|
|
97
|
+
- [ ] I have added tests that prove my fix is effective
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
## Issue Reporting
|
|
101
|
+
|
|
102
|
+
When reporting issues, please include:
|
|
103
|
+
|
|
104
|
+
- **Django version**: The version you're using
|
|
105
|
+
- **DRF version**: Django REST Framework version
|
|
106
|
+
- **Python version**: Your Python version
|
|
107
|
+
- **Error message**: Full error traceback
|
|
108
|
+
- **Steps to reproduce**: Clear steps to reproduce the issue
|
|
109
|
+
- **Expected behavior**: What you expected to happen
|
|
110
|
+
- **Actual behavior**: What actually happened
|
|
111
|
+
|
|
112
|
+
## Code of Conduct
|
|
113
|
+
|
|
114
|
+
- Be respectful and inclusive
|
|
115
|
+
- Focus on the code and technical discussions
|
|
116
|
+
- Help others learn and improve
|
|
117
|
+
- Report any inappropriate behavior to maintainers
|
|
118
|
+
|
|
119
|
+
## Questions?
|
|
120
|
+
|
|
121
|
+
If you have questions about contributing, feel free to:
|
|
122
|
+
|
|
123
|
+
- Open an issue for general questions
|
|
124
|
+
- Ask in pull request comments
|
|
125
|
+
- Contact maintainers directly
|
|
126
|
+
|
|
127
|
+
Thank you for contributing to DRF to MkDocs!
|
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2025 ShayestehHs
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in
|
|
13
|
-
all copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
20
|
-
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
|
|
21
|
-
IN THE SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 ShayestehHs
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in
|
|
13
|
+
all copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
20
|
+
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
|
|
21
|
+
IN THE SOFTWARE.
|
|
@@ -1,18 +1,18 @@
|
|
|
1
|
-
include README.md
|
|
2
|
-
include LICENSE
|
|
3
|
-
include MANIFEST.in
|
|
4
|
-
include pyproject.toml
|
|
5
|
-
|
|
6
|
-
recursive-include drf_to_mkdoc/conf *.py
|
|
7
|
-
recursive-include drf_to_mkdoc/utils *.py
|
|
8
|
-
recursive-include drf_to_mkdoc/management *.py
|
|
9
|
-
|
|
10
|
-
global-exclude *.pyc
|
|
11
|
-
global-exclude *.pyo
|
|
12
|
-
global-exclude __pycache__
|
|
13
|
-
global-exclude .DS_Store
|
|
14
|
-
global-exclude .git*
|
|
15
|
-
global-exclude .idea
|
|
16
|
-
global-exclude .venv
|
|
17
|
-
global-exclude .env
|
|
18
|
-
global-exclude *.log
|
|
1
|
+
include README.md
|
|
2
|
+
include LICENSE
|
|
3
|
+
include MANIFEST.in
|
|
4
|
+
include pyproject.toml
|
|
5
|
+
|
|
6
|
+
recursive-include drf_to_mkdoc/conf *.py
|
|
7
|
+
recursive-include drf_to_mkdoc/utils *.py
|
|
8
|
+
recursive-include drf_to_mkdoc/management *.py
|
|
9
|
+
|
|
10
|
+
global-exclude *.pyc
|
|
11
|
+
global-exclude *.pyo
|
|
12
|
+
global-exclude __pycache__
|
|
13
|
+
global-exclude .DS_Store
|
|
14
|
+
global-exclude .git*
|
|
15
|
+
global-exclude .idea
|
|
16
|
+
global-exclude .venv
|
|
17
|
+
global-exclude .env
|
|
18
|
+
global-exclude *.log
|