automatic import of python-marshmallow-toplevel

3 files changed, 453 insertions, 0 deletions

diff --git a/.gitignore b/.gitignore
index e69de29..693b5b6 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
+/marshmallow-toplevel-0.1.3.tar.gz
diff --git a/python-marshmallow-toplevel.spec b/python-marshmallow-toplevel.spec
new file mode 100644
index 0000000..f2bfafa
--- /dev/null
+++ b/python-marshmallow-toplevel.spec
@@ -0,0 +1,451 @@
+%global _empty_manifest_terminate_build 0
+Name:		python-marshmallow-toplevel
+Version:	0.1.3
+Release:	1
+Summary:	Validate top-level lists with all the power of marshmallow
+License:	MIT
+URL:		https://github.com/and-semakin/marshmallow-toplevel
+Source0:	https://mirrors.nju.edu.cn/pypi/web/packages/cf/6a/34ec3695b91a32cc06721500b86d467e89a4537df3247dfcf58b45af7a4d/marshmallow-toplevel-0.1.3.tar.gz
+BuildArch:	noarch
+
+Requires:	python3-marshmallow
+
+%description
+# marshmallow-toplevel
+Load and validate top-level lists with all the power of
+[marshmallow](https://github.com/marshmallow-code/marshmallow).
+
+## Installation
+
+```sh
+pip install marshmallow-toplevel
+```
+
+## Usage
+
+```python
+from marshmallow import fields
+from marshmallow_toplevel import TopLevelSchema
+
+
+class BatchOfSomething(TopLevelSchema):
+    _toplevel = fields.Nested(
+        SomethingSchema,
+        required=True,
+        many=True,
+        validate=any_validation_logic_applied_to_list
+    )
+```
+
+## Rationale
+
+Imagine that you have an API endpoint (or any other program that
+accepts user input), which is intended to accept multiple blog articles
+and save them to a database. Semantically, your data is a list of dictionaries:
+
+```python
+[
+    {"id": 1, "title": "Hello World!"},
+    {"id": 2, "title": "Yet another awesome article."},
+    ...
+]
+```
+
+You describe article object schema and put constraints on your data:
+
+```python
+from marshmallow import Schema, fields, validate
+
+
+class ArticleSchema(Schema):
+    id = fields.Int(required=True)
+    title = fields.Str(required=True, validate=validate.Length(min=2, max=256))
+```
+
+But you also want to put some constraints onto outer list itself, for example,
+you want it to have length between 1 and 10. How do you describe it in
+terms of `marshmallow`?
+
+### Obvious solution: nest your data
+
+```python
+class BatchOfArticles(Schema):
+    articles = fields.Nested(
+        ArticleSchema,
+        required=True,
+        many=True,
+        validate=validate.Length(1, 10)
+    )
+```
+
+But now a client have to send data this way, with this extra dictionary around:
+
+```python
+{
+    "articles": [
+        {"id": 1, "title": "Hello World!"},
+        {"id": 2, "title": "Yet another awesome article."},
+        ...
+    ]
+}
+```
+
+It makes your API not so beautiful and user-friendly.
+
+### Good solution: use marshmallow-toplevel
+
+With `marshmallow-toplevel` you can describe you data this way:
+
+```python
+from marshmallow_toplevel import TopLevelSchema
+
+
+class BatchOfArticles(TopLevelSchema):
+    _toplevel = fields.Nested(
+        ArticleSchema,
+        required=True,
+        many=True,
+        validate=validate.Length(1, 10)
+    )
+```
+
+Notice that schema inherits from `TopLevelSchema` and uses this
+special `_toplevel` key. It means that the field under this key
+describes top level object. You can define any constrains that
+you can define in `marshmallow` and it will just work:
+
+```python
+schema = BatchOfArticles()
+
+# validation should fail
+errors = schema.validate([])
+assert errors  # length < 1
+errors = schema.validate([{"id": i, "title": "title"} for i in range(100)])
+assert errors  # length > 10
+
+# validation should succeed
+errors = schema.validate([{"id": i, "title": "title"} for i in range(5)])
+assert not errors
+```
+
+You can also use `load` for this schema as usual:
+
+```python
+data = schema.load([{"id": "10", "title": "wow!"}])
+print(data)
+# [{"id": 10, "title": "wow!"}]
+```
+
+Now a client can send data as a list without redundancy.
+
+
+%package -n python3-marshmallow-toplevel
+Summary:	Validate top-level lists with all the power of marshmallow
+Provides:	python-marshmallow-toplevel
+BuildRequires:	python3-devel
+BuildRequires:	python3-setuptools
+BuildRequires:	python3-pip
+%description -n python3-marshmallow-toplevel
+# marshmallow-toplevel
+Load and validate top-level lists with all the power of
+[marshmallow](https://github.com/marshmallow-code/marshmallow).
+
+## Installation
+
+```sh
+pip install marshmallow-toplevel
+```
+
+## Usage
+
+```python
+from marshmallow import fields
+from marshmallow_toplevel import TopLevelSchema
+
+
+class BatchOfSomething(TopLevelSchema):
+    _toplevel = fields.Nested(
+        SomethingSchema,
+        required=True,
+        many=True,
+        validate=any_validation_logic_applied_to_list
+    )
+```
+
+## Rationale
+
+Imagine that you have an API endpoint (or any other program that
+accepts user input), which is intended to accept multiple blog articles
+and save them to a database. Semantically, your data is a list of dictionaries:
+
+```python
+[
+    {"id": 1, "title": "Hello World!"},
+    {"id": 2, "title": "Yet another awesome article."},
+    ...
+]
+```
+
+You describe article object schema and put constraints on your data:
+
+```python
+from marshmallow import Schema, fields, validate
+
+
+class ArticleSchema(Schema):
+    id = fields.Int(required=True)
+    title = fields.Str(required=True, validate=validate.Length(min=2, max=256))
+```
+
+But you also want to put some constraints onto outer list itself, for example,
+you want it to have length between 1 and 10. How do you describe it in
+terms of `marshmallow`?
+
+### Obvious solution: nest your data
+
+```python
+class BatchOfArticles(Schema):
+    articles = fields.Nested(
+        ArticleSchema,
+        required=True,
+        many=True,
+        validate=validate.Length(1, 10)
+    )
+```
+
+But now a client have to send data this way, with this extra dictionary around:
+
+```python
+{
+    "articles": [
+        {"id": 1, "title": "Hello World!"},
+        {"id": 2, "title": "Yet another awesome article."},
+        ...
+    ]
+}
+```
+
+It makes your API not so beautiful and user-friendly.
+
+### Good solution: use marshmallow-toplevel
+
+With `marshmallow-toplevel` you can describe you data this way:
+
+```python
+from marshmallow_toplevel import TopLevelSchema
+
+
+class BatchOfArticles(TopLevelSchema):
+    _toplevel = fields.Nested(
+        ArticleSchema,
+        required=True,
+        many=True,
+        validate=validate.Length(1, 10)
+    )
+```
+
+Notice that schema inherits from `TopLevelSchema` and uses this
+special `_toplevel` key. It means that the field under this key
+describes top level object. You can define any constrains that
+you can define in `marshmallow` and it will just work:
+
+```python
+schema = BatchOfArticles()
+
+# validation should fail
+errors = schema.validate([])
+assert errors  # length < 1
+errors = schema.validate([{"id": i, "title": "title"} for i in range(100)])
+assert errors  # length > 10
+
+# validation should succeed
+errors = schema.validate([{"id": i, "title": "title"} for i in range(5)])
+assert not errors
+```
+
+You can also use `load` for this schema as usual:
+
+```python
+data = schema.load([{"id": "10", "title": "wow!"}])
+print(data)
+# [{"id": 10, "title": "wow!"}]
+```
+
+Now a client can send data as a list without redundancy.
+
+
+%package help
+Summary:	Development documents and examples for marshmallow-toplevel
+Provides:	python3-marshmallow-toplevel-doc
+%description help
+# marshmallow-toplevel
+Load and validate top-level lists with all the power of
+[marshmallow](https://github.com/marshmallow-code/marshmallow).
+
+## Installation
+
+```sh
+pip install marshmallow-toplevel
+```
+
+## Usage
+
+```python
+from marshmallow import fields
+from marshmallow_toplevel import TopLevelSchema
+
+
+class BatchOfSomething(TopLevelSchema):
+    _toplevel = fields.Nested(
+        SomethingSchema,
+        required=True,
+        many=True,
+        validate=any_validation_logic_applied_to_list
+    )
+```
+
+## Rationale
+
+Imagine that you have an API endpoint (or any other program that
+accepts user input), which is intended to accept multiple blog articles
+and save them to a database. Semantically, your data is a list of dictionaries:
+
+```python
+[
+    {"id": 1, "title": "Hello World!"},
+    {"id": 2, "title": "Yet another awesome article."},
+    ...
+]
+```
+
+You describe article object schema and put constraints on your data:
+
+```python
+from marshmallow import Schema, fields, validate
+
+
+class ArticleSchema(Schema):
+    id = fields.Int(required=True)
+    title = fields.Str(required=True, validate=validate.Length(min=2, max=256))
+```
+
+But you also want to put some constraints onto outer list itself, for example,
+you want it to have length between 1 and 10. How do you describe it in
+terms of `marshmallow`?
+
+### Obvious solution: nest your data
+
+```python
+class BatchOfArticles(Schema):
+    articles = fields.Nested(
+        ArticleSchema,
+        required=True,
+        many=True,
+        validate=validate.Length(1, 10)
+    )
+```
+
+But now a client have to send data this way, with this extra dictionary around:
+
+```python
+{
+    "articles": [
+        {"id": 1, "title": "Hello World!"},
+        {"id": 2, "title": "Yet another awesome article."},
+        ...
+    ]
+}
+```
+
+It makes your API not so beautiful and user-friendly.
+
+### Good solution: use marshmallow-toplevel
+
+With `marshmallow-toplevel` you can describe you data this way:
+
+```python
+from marshmallow_toplevel import TopLevelSchema
+
+
+class BatchOfArticles(TopLevelSchema):
+    _toplevel = fields.Nested(
+        ArticleSchema,
+        required=True,
+        many=True,
+        validate=validate.Length(1, 10)
+    )
+```
+
+Notice that schema inherits from `TopLevelSchema` and uses this
+special `_toplevel` key. It means that the field under this key
+describes top level object. You can define any constrains that
+you can define in `marshmallow` and it will just work:
+
+```python
+schema = BatchOfArticles()
+
+# validation should fail
+errors = schema.validate([])
+assert errors  # length < 1
+errors = schema.validate([{"id": i, "title": "title"} for i in range(100)])
+assert errors  # length > 10
+
+# validation should succeed
+errors = schema.validate([{"id": i, "title": "title"} for i in range(5)])
+assert not errors
+```
+
+You can also use `load` for this schema as usual:
+
+```python
+data = schema.load([{"id": "10", "title": "wow!"}])
+print(data)
+# [{"id": 10, "title": "wow!"}]
+```
+
+Now a client can send data as a list without redundancy.
+
+
+%prep
+%autosetup -n marshmallow-toplevel-0.1.3
+
+%build
+%py3_build
+
+%install
+%py3_install
+install -d -m755 %{buildroot}/%{_pkgdocdir}
+if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
+if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
+if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
+if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
+pushd %{buildroot}
+if [ -d usr/lib ]; then
+	find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/lib64 ]; then
+	find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/bin ]; then
+	find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/sbin ]; then
+	find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+touch doclist.lst
+if [ -d usr/share/man ]; then
+	find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
+fi
+popd
+mv %{buildroot}/filelist.lst .
+mv %{buildroot}/doclist.lst .
+
+%files -n python3-marshmallow-toplevel -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Mon May 15 2023 Python_Bot <Python_Bot@openeuler.org> - 0.1.3-1
+- Package Spec generated
diff --git a/sources b/sources
new file mode 100644
index 0000000..20edb3a
--- /dev/null
+++ b/sources
@@ -0,0 +1 @@
+f400bec1a0f37ffd5501175e0c564c4d  marshmallow-toplevel-0.1.3.tar.gz