drf-smart-nested-parser 0.1.0__tar.gz

drf_smart_nested_parser-0.1.0/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: drf_smart_nested_parser
+Version: 0.1.0
+Summary: Smart nested parser for DRF (JSON + multipart + files)
+Home-page: https://github.com/AmirHosseinDonyaei/drf_smart_nested_parser
+Author: AmirHosseinDonyaei
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: djangorestframework>=3.14
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# DRF Smart Nested Parser
+
+A simple parser for Django REST Framework that converts `form-data` and `application/x-www-form-urlencoded` inputs into nested structures (dict / list). For JSON, it uses the default DRF JSON parser without additional conversion.
+
+## Installation
+
+If you're using this package locally, ensure it is importable from your project. If published on PyPI, install it by the package name.
+
+## Usage
+
+### Add to DRF settings
+
+```python
+# settings.py
+REST_FRAMEWORK = {
+    "DEFAULT_PARSER_CLASSES": [
+        "drf_smart_nested_parser.SmartNestedParser",
+    ]
+}
+```
+
+### Or only for a single view
+
+```python
+from rest_framework.views import APIView
+from drf_smart_nested_parser import SmartNestedParser
+
+class MyView(APIView):
+    parser_classes = [SmartNestedParser]
+```
+
+## Input and Output
+
+### Example for `multipart/form-data` or `application/x-www-form-urlencoded`
+
+Form keys with bracket notation (`[]`) are converted to nested structures:
+
+```
+user[name] = Amir
+user[age] = 30
+items[0][title] = Book
+items[0][price] = 120
+items[1][title] = Pen
+```
+
+Output:
+
+```json
+{
+  "user": {
+    "name": "Amir",
+    "age": 30
+  },
+  "items": [
+    {"title": "Book", "price": 120},
+    {"title": "Pen"}
+  ]
+}
+```
+
+Note: If a value can be converted to a number, it will be cast to `int`.
+
+## Parser Behavior
+
+- If `Content-Type` includes `application/json`, DRF's `JSONParser` is used.
+- If `Content-Type` includes `multipart/form-data`, data is parsed and keys are converted to nested structures.
+- Otherwise (e.g. `application/x-www-form-urlencoded`), `FormParser` is used and the same conversion applies.
+
+## Limitations and Notes
+
+- Keys should start with a string root (e.g. `items[0]` should be used as part of a root like `items[0][name]` or at least `items[0]` alongside a textual root). A valid example: `items[0][name]`.
+- File values in `multipart/form-data` are kept in `files` and are not modified.
+
+## Development
+
+Code layout:
+
+- `parsers.py`: `SmartNestedParser` implementation
+- `utils.py`: `parse_nested_keys` helper
+
+## License
+
+MIT

drf_smart_nested_parser-0.1.0/README.md

@@ -0,0 +1,83 @@
+# DRF Smart Nested Parser
+
+A simple parser for Django REST Framework that converts `form-data` and `application/x-www-form-urlencoded` inputs into nested structures (dict / list). For JSON, it uses the default DRF JSON parser without additional conversion.
+
+## Installation
+
+If you're using this package locally, ensure it is importable from your project. If published on PyPI, install it by the package name.
+
+## Usage
+
+### Add to DRF settings
+
+```python
+# settings.py
+REST_FRAMEWORK = {
+    "DEFAULT_PARSER_CLASSES": [
+        "drf_smart_nested_parser.SmartNestedParser",
+    ]
+}
+```
+
+### Or only for a single view
+
+```python
+from rest_framework.views import APIView
+from drf_smart_nested_parser import SmartNestedParser
+
+class MyView(APIView):
+    parser_classes = [SmartNestedParser]
+```
+
+## Input and Output
+
+### Example for `multipart/form-data` or `application/x-www-form-urlencoded`
+
+Form keys with bracket notation (`[]`) are converted to nested structures:
+
+```
+user[name] = Amir
+user[age] = 30
+items[0][title] = Book
+items[0][price] = 120
+items[1][title] = Pen
+```
+
+Output:
+
+```json
+{
+  "user": {
+    "name": "Amir",
+    "age": 30
+  },
+  "items": [
+    {"title": "Book", "price": 120},
+    {"title": "Pen"}
+  ]
+}
+```
+
+Note: If a value can be converted to a number, it will be cast to `int`.
+
+## Parser Behavior
+
+- If `Content-Type` includes `application/json`, DRF's `JSONParser` is used.
+- If `Content-Type` includes `multipart/form-data`, data is parsed and keys are converted to nested structures.
+- Otherwise (e.g. `application/x-www-form-urlencoded`), `FormParser` is used and the same conversion applies.
+
+## Limitations and Notes
+
+- Keys should start with a string root (e.g. `items[0]` should be used as part of a root like `items[0][name]` or at least `items[0]` alongside a textual root). A valid example: `items[0][name]`.
+- File values in `multipart/form-data` are kept in `files` and are not modified.
+
+## Development
+
+Code layout:
+
+- `parsers.py`: `SmartNestedParser` implementation
+- `utils.py`: `parse_nested_keys` helper
+
+## License
+
+MIT

drf_smart_nested_parser-0.1.0/drf_smart_nested_parser.egg-info/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: drf_smart_nested_parser
+Version: 0.1.0
+Summary: Smart nested parser for DRF (JSON + multipart + files)
+Home-page: https://github.com/AmirHosseinDonyaei/drf_smart_nested_parser
+Author: AmirHosseinDonyaei
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: djangorestframework>=3.14
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# DRF Smart Nested Parser
+
+A simple parser for Django REST Framework that converts `form-data` and `application/x-www-form-urlencoded` inputs into nested structures (dict / list). For JSON, it uses the default DRF JSON parser without additional conversion.
+
+## Installation
+
+If you're using this package locally, ensure it is importable from your project. If published on PyPI, install it by the package name.
+
+## Usage
+
+### Add to DRF settings
+
+```python
+# settings.py
+REST_FRAMEWORK = {
+    "DEFAULT_PARSER_CLASSES": [
+        "drf_smart_nested_parser.SmartNestedParser",
+    ]
+}
+```
+
+### Or only for a single view
+
+```python
+from rest_framework.views import APIView
+from drf_smart_nested_parser import SmartNestedParser
+
+class MyView(APIView):
+    parser_classes = [SmartNestedParser]
+```
+
+## Input and Output
+
+### Example for `multipart/form-data` or `application/x-www-form-urlencoded`
+
+Form keys with bracket notation (`[]`) are converted to nested structures:
+
+```
+user[name] = Amir
+user[age] = 30
+items[0][title] = Book
+items[0][price] = 120
+items[1][title] = Pen
+```
+
+Output:
+
+```json
+{
+  "user": {
+    "name": "Amir",
+    "age": 30
+  },
+  "items": [
+    {"title": "Book", "price": 120},
+    {"title": "Pen"}
+  ]
+}
+```
+
+Note: If a value can be converted to a number, it will be cast to `int`.
+
+## Parser Behavior
+
+- If `Content-Type` includes `application/json`, DRF's `JSONParser` is used.
+- If `Content-Type` includes `multipart/form-data`, data is parsed and keys are converted to nested structures.
+- Otherwise (e.g. `application/x-www-form-urlencoded`), `FormParser` is used and the same conversion applies.
+
+## Limitations and Notes
+
+- Keys should start with a string root (e.g. `items[0]` should be used as part of a root like `items[0][name]` or at least `items[0]` alongside a textual root). A valid example: `items[0][name]`.
+- File values in `multipart/form-data` are kept in `files` and are not modified.
+
+## Development
+
+Code layout:
+
+- `parsers.py`: `SmartNestedParser` implementation
+- `utils.py`: `parse_nested_keys` helper
+
+## License
+
+MIT

drf_smart_nested_parser-0.1.0/drf_smart_nested_parser.egg-info/SOURCES.txt

@@ -0,0 +1,7 @@
+README.md
+setup.py
+drf_smart_nested_parser.egg-info/PKG-INFO
+drf_smart_nested_parser.egg-info/SOURCES.txt
+drf_smart_nested_parser.egg-info/dependency_links.txt
+drf_smart_nested_parser.egg-info/requires.txt
+drf_smart_nested_parser.egg-info/top_level.txt

drf_smart_nested_parser-0.1.0/drf_smart_nested_parser.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

drf_smart_nested_parser-0.1.0/drf_smart_nested_parser.egg-info/requires.txt

@@ -0,0 +1 @@
+djangorestframework>=3.14

drf_smart_nested_parser-0.1.0/drf_smart_nested_parser.egg-info/top_level.txt

@@ -0,0 +1 @@
+

drf_smart_nested_parser-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

drf_smart_nested_parser-0.1.0/setup.py

@@ -0,0 +1,25 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="drf_smart_nested_parser",
+    version="0.1.0",
+    packages=find_packages(),
+    install_requires=[
+        "djangorestframework>=3.14",
+    ],
+    include_package_data=True,
+    description="Smart nested parser for DRF (JSON + multipart + files)",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    url="https://github.com/AmirHosseinDonyaei/drf_smart_nested_parser",
+    author="AmirHosseinDonyaei",
+    license="MIT",
+    classifiers=[
+    "Programming Language :: Python :: 3",
+    "Framework :: Django",       
+    "Framework :: Django :: 4",  
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    ],
+    python_requires='>=3.7',
+)