Scopes are used to grant an application different levels of access to data on behalf of the end user. Each API may declare one or more scopes.',
30 | 'Learn how to use',
31 | '
',
32 | '
' + appName + ' API requires the following scopes. Select which ones you want to grant to Swagger UI.
',
33 | '
',
34 | '
',
35 | '',
36 | '',
37 | '
',
38 | '
'].join(''));
39 | $(document.body).append(popupDialog);
40 |
41 | popup = popupDialog.find('ul.api-popup-scopes').empty();
42 | for (i = 0; i < scopes.length; i ++) {
43 | scope = scopes[i];
44 | str = '
' + '
';
49 | popup.append(str);
50 | }
51 | }
52 |
53 | var $win = $(window),
54 | dw = $win.width(),
55 | dh = $win.height(),
56 | st = $win.scrollTop(),
57 | dlgWd = popupDialog.outerWidth(),
58 | dlgHt = popupDialog.outerHeight(),
59 | top = (dh -dlgHt)/2 + st,
60 | left = (dw - dlgWd)/2;
61 |
62 | popupDialog.css({
63 | top: (top < 0? 0 : top) + 'px',
64 | left: (left < 0? 0 : left) + 'px'
65 | });
66 |
67 | popupDialog.find('button.api-popup-cancel').click(function() {
68 | popupMask.hide();
69 | popupDialog.hide();
70 | });
71 | popupDialog.find('button.api-popup-authbtn').click(function() {
72 | popupMask.hide();
73 | popupDialog.hide();
74 |
75 | var authSchemes = window.swaggerUi.api.authSchemes;
76 | var host = window.location;
77 | var redirectUrl = "{{full_base_url}}o2c.html";
78 | var url = null;
79 |
80 | var p = window.swaggerUi.api.authSchemes;
81 | for (var key in p) {
82 | if (p.hasOwnProperty(key)) {
83 | var o = p[key].grantTypes;
84 | for(var t in o) {
85 | if(o.hasOwnProperty(t) && t === 'implicit') {
86 | var dets = o[t];
87 | url = dets.loginEndpoint.url + "?response_type=token";
88 | window.swaggerUi.tokenName = dets.tokenName;
89 | }
90 | }
91 | }
92 | }
93 | var scopes = []
94 | var o = $('.api-popup-scopes').find('input:checked');
95 |
96 | for(k =0; k < o.length; k++) {
97 | scopes.push($(o[k]).attr("scope"));
98 | }
99 |
100 | window.enabledScopes=scopes;
101 |
102 | url += '&redirect_uri=' + encodeURIComponent(redirectUrl);
103 | url += '&realm=' + encodeURIComponent(realm);
104 | url += '&client_id=' + encodeURIComponent(clientId);
105 | url += '&scope=' + encodeURIComponent(scopes);
106 |
107 | window.open(url);
108 | });
109 |
110 | popupMask.show();
111 | popupDialog.show();
112 | return;
113 | }
114 |
115 |
116 | function handleLogout() {
117 | for(key in window.authorizations.authz){
118 | window.authorizations.remove(key)
119 | }
120 | window.enabledScopes = null;
121 | $('.api-ic.ic-on').addClass('ic-off');
122 | $('.api-ic.ic-on').removeClass('ic-on');
123 |
124 | // set the info box
125 | $('.api-ic.ic-warning').addClass('ic-error');
126 | $('.api-ic.ic-warning').removeClass('ic-warning');
127 | }
128 |
129 | function initOAuth(opts) {
130 | var o = (opts||{});
131 | var errors = [];
132 |
133 | appName = (o.appName||errors.push("missing appName"));
134 | popupMask = (o.popupMask||$('#api-common-mask'));
135 | popupDialog = (o.popupDialog||$('.api-popup-dialog'));
136 | clientId = (o.clientId||errors.push("missing client id"));
137 | realm = (o.realm||errors.push("missing realm"));
138 |
139 | if(errors.length > 0){
140 | log("auth unable initialize oauth: " + errors);
141 | return;
142 | }
143 |
144 | $('pre code').each(function(i, e) {hljs.highlightBlock(e)});
145 | $('.api-ic').click(function(s) {
146 | if($(s.target).hasClass('ic-off'))
147 | handleLogin();
148 | else {
149 | handleLogout();
150 | }
151 | false;
152 | });
153 | }
154 |
155 | function onOAuthComplete(token) {
156 | if(token) {
157 | if(token.error) {
158 | var checkbox = $('input[type=checkbox],.secured')
159 | checkbox.each(function(pos){
160 | checkbox[pos].checked = false;
161 | });
162 | alert(token.error);
163 | }
164 | else {
165 | var b = token[window.swaggerUi.tokenName];
166 | if(b){
167 | // if all roles are satisfied
168 | var o = null;
169 | $.each($('.auth #api_information_panel'), function(k, v) {
170 | var children = v;
171 | if(children && children.childNodes) {
172 | var requiredScopes = [];
173 | $.each((children.childNodes), function (k1, v1){
174 | var inner = v1.innerHTML;
175 | if(inner)
176 | requiredScopes.push(inner);
177 | });
178 | var diff = [];
179 | for(var i=0; i < requiredScopes.length; i++) {
180 | var s = requiredScopes[i];
181 | if(window.enabledScopes && window.enabledScopes.indexOf(s) == -1) {
182 | diff.push(s);
183 | }
184 | }
185 | if(diff.length > 0){
186 | o = v.parentNode;
187 | $(o.parentNode).find('.api-ic.ic-on').addClass('ic-off');
188 | $(o.parentNode).find('.api-ic.ic-on').removeClass('ic-on');
189 |
190 | // sorry, not all scopes are satisfied
191 | $(o).find('.api-ic').addClass('ic-warning');
192 | $(o).find('.api-ic').removeClass('ic-error');
193 | }
194 | else {
195 | o = v.parentNode;
196 | $(o.parentNode).find('.api-ic.ic-off').addClass('ic-on');
197 | $(o.parentNode).find('.api-ic.ic-off').removeClass('ic-off');
198 |
199 | // all scopes are satisfied
200 | $(o).find('.api-ic').addClass('ic-info');
201 | $(o).find('.api-ic').removeClass('ic-warning');
202 | $(o).find('.api-ic').removeClass('ic-error');
203 | }
204 | }
205 | });
206 |
207 | window.authorizations.add("key", new ApiKeyAuthorization("Authorization", "Bearer " + b, "header"));
208 | }
209 | }
210 | }
211 | }
--------------------------------------------------------------------------------
/static/js/shred/content.js:
--------------------------------------------------------------------------------
1 |
2 | // The purpose of the `Content` object is to abstract away the data conversions
3 | // to and from raw content entities as strings. For example, you want to be able
4 | // to pass in a Javascript object and have it be automatically converted into a
5 | // JSON string if the `content-type` is set to a JSON-based media type.
6 | // Conversely, you want to be able to transparently get back a Javascript object
7 | // in the response if the `content-type` is a JSON-based media-type.
8 |
9 | // One limitation of the current implementation is that it [assumes the `charset` is UTF-8](https://github.com/spire-io/shred/issues/5).
10 |
11 | // The `Content` constructor takes an options object, which *must* have either a
12 | // `body` or `data` property and *may* have a `type` property indicating the
13 | // media type. If there is no `type` attribute, a default will be inferred.
14 | var Content = function(options) {
15 | this.body = options.body;
16 | this.data = options.data;
17 | this.type = options.type;
18 | };
19 |
20 | Content.prototype = {
21 | // Treat `toString()` as asking for the `content.body`. That is, the raw content entity.
22 | //
23 | // toString: function() { return this.body; }
24 | //
25 | // Commented out, but I've forgotten why. :/
26 | };
27 |
28 |
29 | // `Content` objects have the following attributes:
30 | Object.defineProperties(Content.prototype,{
31 |
32 | // - **type**. Typically accessed as `content.type`, reflects the `content-type`
33 | // header associated with the request or response. If not passed as an options
34 | // to the constructor or set explicitly, it will infer the type the `data`
35 | // attribute, if possible, and, failing that, will default to `text/plain`.
36 | type: {
37 | get: function() {
38 | if (this._type) {
39 | return this._type;
40 | } else {
41 | if (this._data) {
42 | switch(typeof this._data) {
43 | case "string": return "text/plain";
44 | case "object": return "application/json";
45 | }
46 | }
47 | }
48 | return "text/plain";
49 | },
50 | set: function(value) {
51 | this._type = value;
52 | return this;
53 | },
54 | enumerable: true
55 | },
56 |
57 | // - **data**. Typically accessed as `content.data`, reflects the content entity
58 | // converted into Javascript data. This can be a string, if the `type` is, say,
59 | // `text/plain`, but can also be a Javascript object. The conversion applied is
60 | // based on the `processor` attribute. The `data` attribute can also be set
61 | // directly, in which case the conversion will be done the other way, to infer
62 | // the `body` attribute.
63 | data: {
64 | get: function() {
65 | if (this._body) {
66 | return this.processor.parser(this._body);
67 | } else {
68 | return this._data;
69 | }
70 | },
71 | set: function(data) {
72 | if (this._body&&data) Errors.setDataWithBody(this);
73 | this._data = data;
74 | return this;
75 | },
76 | enumerable: true
77 | },
78 |
79 | // - **body**. Typically accessed as `content.body`, reflects the content entity
80 | // as a UTF-8 string. It is the mirror of the `data` attribute. If you set the
81 | // `data` attribute, the `body` attribute will be inferred and vice-versa. If
82 | // you attempt to set both, an exception is raised.
83 | body: {
84 | get: function() {
85 | if (this._data) {
86 | return this.processor.stringify(this._data);
87 | } else {
88 | return this._body.toString();
89 | }
90 | },
91 | set: function(body) {
92 | if (this._data&&body) Errors.setBodyWithData(this);
93 | this._body = body;
94 | return this;
95 | },
96 | enumerable: true
97 | },
98 |
99 | // - **processor**. The functions that will be used to convert to/from `data` and
100 | // `body` attributes. You can add processors. The two that are built-in are for
101 | // `text/plain`, which is basically an identity transformation and
102 | // `application/json` and other JSON-based media types (including custom media
103 | // types with `+json`). You can add your own processors. See below.
104 | processor: {
105 | get: function() {
106 | var processor = Content.processors[this.type];
107 | if (processor) {
108 | return processor;
109 | } else {
110 | // Return the first processor that matches any part of the
111 | // content type. ex: application/vnd.foobar.baz+json will match json.
112 | var main = this.type.split(";")[0];
113 | var parts = main.split(/\+|\//);
114 | for (var i=0, l=parts.length; i < l; i++) {
115 | processor = Content.processors[parts[i]]
116 | }
117 | return processor || {parser:identity,stringify:toString};
118 | }
119 | },
120 | enumerable: true
121 | },
122 |
123 | // - **length**. Typically accessed as `content.length`, returns the length in
124 | // bytes of the raw content entity.
125 | length: {
126 | get: function() {
127 | if (typeof Buffer !== 'undefined') {
128 | return Buffer.byteLength(this.body);
129 | }
130 | return this.body.length;
131 | }
132 | }
133 | });
134 |
135 | Content.processors = {};
136 |
137 | // The `registerProcessor` function allows you to add your own processors to
138 | // convert content entities. Each processor consists of a Javascript object with
139 | // two properties:
140 | // - **parser**. The function used to parse a raw content entity and convert it
141 | // into a Javascript data type.
142 | // - **stringify**. The function used to convert a Javascript data type into a
143 | // raw content entity.
144 | Content.registerProcessor = function(types,processor) {
145 |
146 | // You can pass an array of types that will trigger this processor, or just one.
147 | // We determine the array via duck-typing here.
148 | if (types.forEach) {
149 | types.forEach(function(type) {
150 | Content.processors[type] = processor;
151 | });
152 | } else {
153 | // If you didn't pass an array, we just use what you pass in.
154 | Content.processors[types] = processor;
155 | }
156 | };
157 |
158 | // Register the identity processor, which is used for text-based media types.
159 | var identity = function(x) { return x; }
160 | , toString = function(x) { return x.toString(); }
161 | Content.registerProcessor(
162 | ["text/html","text/plain","text"],
163 | { parser: identity, stringify: toString });
164 |
165 | // Register the JSON processor, which is used for JSON-based media types.
166 | Content.registerProcessor(
167 | ["application/json; charset=utf-8","application/json","json"],
168 | {
169 | parser: function(string) {
170 | return JSON.parse(string);
171 | },
172 | stringify: function(data) {
173 | return JSON.stringify(data); }});
174 |
175 | var qs = require('querystring');
176 | // Register the post processor, which is used for JSON-based media types.
177 | Content.registerProcessor(
178 | ["application/x-www-form-urlencoded"],
179 | { parser : qs.parse, stringify : qs.stringify });
180 |
181 | // Error functions are defined separately here in an attempt to make the code
182 | // easier to read.
183 | var Errors = {
184 | setDataWithBody: function(object) {
185 | throw new Error("Attempt to set data attribute of a content object " +
186 | "when the body attributes was already set.");
187 | },
188 | setBodyWithData: function(object) {
189 | throw new Error("Attempt to set body attribute of a content object " +
190 | "when the data attributes was already set.");
191 | }
192 | }
193 | module.exports = Content;
--------------------------------------------------------------------------------
/flask_restful_swagger/static/lib/shred/content.js:
--------------------------------------------------------------------------------
1 |
2 | // The purpose of the `Content` object is to abstract away the data conversions
3 | // to and from raw content entities as strings. For example, you want to be able
4 | // to pass in a Javascript object and have it be automatically converted into a
5 | // JSON string if the `content-type` is set to a JSON-based media type.
6 | // Conversely, you want to be able to transparently get back a Javascript object
7 | // in the response if the `content-type` is a JSON-based media-type.
8 |
9 | // One limitation of the current implementation is that it [assumes the `charset` is UTF-8](https://github.com/spire-io/shred/issues/5).
10 |
11 | // The `Content` constructor takes an options object, which *must* have either a
12 | // `body` or `data` property and *may* have a `type` property indicating the
13 | // media type. If there is no `type` attribute, a default will be inferred.
14 | var Content = function(options) {
15 | this.body = options.body;
16 | this.data = options.data;
17 | this.type = options.type;
18 | };
19 |
20 | Content.prototype = {
21 | // Treat `toString()` as asking for the `content.body`. That is, the raw content entity.
22 | //
23 | // toString: function() { return this.body; }
24 | //
25 | // Commented out, but I've forgotten why. :/
26 | };
27 |
28 |
29 | // `Content` objects have the following attributes:
30 | Object.defineProperties(Content.prototype,{
31 |
32 | // - **type**. Typically accessed as `content.type`, reflects the `content-type`
33 | // header associated with the request or response. If not passed as an options
34 | // to the constructor or set explicitly, it will infer the type the `data`
35 | // attribute, if possible, and, failing that, will default to `text/plain`.
36 | type: {
37 | get: function() {
38 | if (this._type) {
39 | return this._type;
40 | } else {
41 | if (this._data) {
42 | switch(typeof this._data) {
43 | case "string": return "text/plain";
44 | case "object": return "application/json";
45 | }
46 | }
47 | }
48 | return "text/plain";
49 | },
50 | set: function(value) {
51 | this._type = value;
52 | return this;
53 | },
54 | enumerable: true
55 | },
56 |
57 | // - **data**. Typically accessed as `content.data`, reflects the content entity
58 | // converted into Javascript data. This can be a string, if the `type` is, say,
59 | // `text/plain`, but can also be a Javascript object. The conversion applied is
60 | // based on the `processor` attribute. The `data` attribute can also be set
61 | // directly, in which case the conversion will be done the other way, to infer
62 | // the `body` attribute.
63 | data: {
64 | get: function() {
65 | if (this._body) {
66 | return this.processor.parser(this._body);
67 | } else {
68 | return this._data;
69 | }
70 | },
71 | set: function(data) {
72 | if (this._body&&data) Errors.setDataWithBody(this);
73 | this._data = data;
74 | return this;
75 | },
76 | enumerable: true
77 | },
78 |
79 | // - **body**. Typically accessed as `content.body`, reflects the content entity
80 | // as a UTF-8 string. It is the mirror of the `data` attribute. If you set the
81 | // `data` attribute, the `body` attribute will be inferred and vice-versa. If
82 | // you attempt to set both, an exception is raised.
83 | body: {
84 | get: function() {
85 | if (this._data) {
86 | return this.processor.stringify(this._data);
87 | } else {
88 | return this._body.toString();
89 | }
90 | },
91 | set: function(body) {
92 | if (this._data&&body) Errors.setBodyWithData(this);
93 | this._body = body;
94 | return this;
95 | },
96 | enumerable: true
97 | },
98 |
99 | // - **processor**. The functions that will be used to convert to/from `data` and
100 | // `body` attributes. You can add processors. The two that are built-in are for
101 | // `text/plain`, which is basically an identity transformation and
102 | // `application/json` and other JSON-based media types (including custom media
103 | // types with `+json`). You can add your own processors. See below.
104 | processor: {
105 | get: function() {
106 | var processor = Content.processors[this.type];
107 | if (processor) {
108 | return processor;
109 | } else {
110 | // Return the first processor that matches any part of the
111 | // content type. ex: application/vnd.foobar.baz+json will match json.
112 | var main = this.type.split(";")[0];
113 | var parts = main.split(/\+|\//);
114 | for (var i=0, l=parts.length; i < l; i++) {
115 | processor = Content.processors[parts[i]]
116 | }
117 | return processor || {parser:identity,stringify:toString};
118 | }
119 | },
120 | enumerable: true
121 | },
122 |
123 | // - **length**. Typically accessed as `content.length`, returns the length in
124 | // bytes of the raw content entity.
125 | length: {
126 | get: function() {
127 | if (typeof Buffer !== 'undefined') {
128 | return Buffer.byteLength(this.body);
129 | }
130 | return this.body.length;
131 | }
132 | }
133 | });
134 |
135 | Content.processors = {};
136 |
137 | // The `registerProcessor` function allows you to add your own processors to
138 | // convert content entities. Each processor consists of a Javascript object with
139 | // two properties:
140 | // - **parser**. The function used to parse a raw content entity and convert it
141 | // into a Javascript data type.
142 | // - **stringify**. The function used to convert a Javascript data type into a
143 | // raw content entity.
144 | Content.registerProcessor = function(types,processor) {
145 |
146 | // You can pass an array of types that will trigger this processor, or just one.
147 | // We determine the array via duck-typing here.
148 | if (types.forEach) {
149 | types.forEach(function(type) {
150 | Content.processors[type] = processor;
151 | });
152 | } else {
153 | // If you didn't pass an array, we just use what you pass in.
154 | Content.processors[types] = processor;
155 | }
156 | };
157 |
158 | // Register the identity processor, which is used for text-based media types.
159 | var identity = function(x) { return x; }
160 | , toString = function(x) { return x.toString(); }
161 | Content.registerProcessor(
162 | ["text/html","text/plain","text"],
163 | { parser: identity, stringify: toString });
164 |
165 | // Register the JSON processor, which is used for JSON-based media types.
166 | Content.registerProcessor(
167 | ["application/json; charset=utf-8","application/json","json"],
168 | {
169 | parser: function(string) {
170 | return JSON.parse(string);
171 | },
172 | stringify: function(data) {
173 | return JSON.stringify(data); }});
174 |
175 | var qs = require('querystring');
176 | // Register the post processor, which is used for JSON-based media types.
177 | Content.registerProcessor(
178 | ["application/x-www-form-urlencoded"],
179 | { parser : qs.parse, stringify : qs.stringify });
180 |
181 | // Error functions are defined separately here in an attempt to make the code
182 | // easier to read.
183 | var Errors = {
184 | setDataWithBody: function(object) {
185 | throw new Error("Attempt to set data attribute of a content object " +
186 | "when the body attributes was already set.");
187 | },
188 | setBodyWithData: function(object) {
189 | throw new Error("Attempt to set body attribute of a content object " +
190 | "when the data attributes was already set.");
191 | }
192 | }
193 | module.exports = Content;
--------------------------------------------------------------------------------
/tests/fixtures_add_model.py:
--------------------------------------------------------------------------------
1 | try:
2 | from unittest.mock import patch
3 | from unittest.mock import Mock
4 | except ImportError:
5 | from mock import patch
6 | from mock import Mock
7 | from contextlib import contextmanager
8 |
9 | from flask_restful import fields
10 |
11 | from flask_restful_swagger import swagger
12 |
13 |
14 | @contextmanager
15 | def patch_registry():
16 | with patch("flask_restful_swagger.swagger.registry") as mock_registry:
17 | _temp_dict = {"models": {}}
18 | mock_registry.__getitem__.side_effect = _temp_dict.__getitem__
19 | mock_registry.__setitem__.side_effect = _temp_dict.__setitem__
20 | yield _temp_dict
21 |
22 |
23 | @contextmanager
24 | def patch_parse_doc():
25 | with patch("flask_restful_swagger.swagger._parse_doc") as mock_parse_doc:
26 | mock_parse_doc.return_value = (None, None)
27 | yield mock_parse_doc
28 |
29 |
30 | @contextmanager
31 | def patch_deduce_swagger_type():
32 | with patch(
33 | "flask_restful_swagger.swagger.deduce_swagger_type"
34 | ) as mock_deduce_swagger_type:
35 | mock_deduce_swagger_type.return_value = "dummy_swagger_type"
36 | yield mock_deduce_swagger_type
37 |
38 |
39 | @contextmanager
40 | def patch_isinstance(patchbool):
41 | with patch("flask_restful_swagger.swagger.isinstance") as mock_isinstance:
42 | mock_isinstance.return_value = patchbool
43 | yield mock_isinstance
44 |
45 |
46 | @contextmanager
47 | def patch_hasattr():
48 | with patch("flask_restful_swagger.swagger.hasattr") as mock_hasattr:
49 | mock_hasattr.return_value = True
50 | yield mock_hasattr
51 |
52 |
53 | @contextmanager
54 | def patch_dir(patchreturn):
55 | with patch("flask_restful_swagger.swagger.dir") as mock_dir:
56 | mock_dir.return_value = patchreturn
57 | yield mock_dir
58 |
59 |
60 | @contextmanager
61 | def patch_getargspec():
62 | with patch(
63 | "flask_restful_swagger.swagger.inspect.getargspec"
64 | ) as mock_getargspec:
65 | mock_argspec = Mock()
66 | mock_argspec.args = ["self", "arg1", "arg2", "arg3"]
67 | mock_argspec.defaults = ("123",)
68 | mock_getargspec.return_value = mock_argspec
69 | yield mock_getargspec
70 |
71 |
72 | ###############################################################################
73 | # Copy setup objects from examples/basic.py
74 | ###############################################################################
75 |
76 | MockBasicObjectNoInit = Mock()
77 | MockBasicObjectNoInit.__name__ = MockBasicObjectNoInit
78 |
79 |
80 | class MockBasicObject:
81 | def __init__(self, arg1):
82 | pass
83 |
84 |
85 | class MockBasicWithSwaggerMetadata1:
86 | def __init__(self, arg1):
87 | pass
88 |
89 | swagger_metadata = {"an_enum": {"enum": ["one", "two", "three"]}}
90 |
91 |
92 | class MockBasicWithSwaggerMetadata2:
93 | def __init__(self, arg1, an_enum):
94 | pass
95 |
96 | swagger_metadata = {"an_enum": {"enum": ["one", "two", "three"]}}
97 |
98 |
99 | class MockTodoItem:
100 | """This is an example of a model class that has parameters in its constructor
101 | and the fields in the swagger spec are derived from the parameters
102 | to __init__.
103 | In this case we would have args, arg2 as required parameters and arg3 as
104 | optional parameter.
105 | """
106 |
107 | def __init__(self, arg1, arg2, arg3="123"):
108 | pass
109 |
110 |
111 | class MockModelWithResourceFieldsNoRequired:
112 | resource_fields = {"a_string": fields.String()}
113 |
114 |
115 | class MockModelWithResourceFieldsWithRequired:
116 | resource_fields = {"a_string": fields.String()}
117 |
118 | required = ["a_string"]
119 |
120 |
121 | @swagger.nested(
122 | a_nested_attribute=MockModelWithResourceFieldsNoRequired.__name__,
123 | a_list_of_nested_types=MockModelWithResourceFieldsNoRequired.__name__,
124 | )
125 | class MockModelWithResourceFieldsWithRequiredWithSwaggerMetadata:
126 | resource_fields = {
127 | "a_string": fields.String(),
128 | "an_enum": fields.String,
129 | }
130 | required = ["a_string"]
131 | swagger_metadata = {"an_enum": {"enum": ["one", "two", "three"]}}
132 |
133 |
134 | @swagger.nested(
135 | a_nested_attribute=MockModelWithResourceFieldsNoRequired.__name__,
136 | a_list_of_nested_types=MockModelWithResourceFieldsNoRequired.__name__,
137 | )
138 | class MockTodoItemWithResourceFields:
139 | """This is an example of how Output Fields work
140 | (http://flask-restful.readthedocs.org/en/latest/fields.html).
141 | Output Fields lets you add resource_fields to your model in which you
142 | specify the output of the model when it gets sent as an HTTP response.
143 | flask-restful-swagger takes advantage of this to specify the fields in
144 | the model
145 | """
146 |
147 | resource_fields = {
148 | "a_string": fields.String(attribute="a_string_field_name"),
149 | "a_formatted_string": fields.FormattedString,
150 | "an_enum": fields.String,
151 | "an_int": fields.Integer,
152 | "a_bool": fields.Boolean,
153 | "a_url": fields.Url,
154 | "a_float": fields.Float,
155 | "an_float_with_arbitrary_precision": fields.Arbitrary,
156 | "a_fixed_point_decimal": fields.Fixed,
157 | "a_datetime": fields.DateTime,
158 | "a_list_of_strings": fields.List(fields.String),
159 | "a_nested_attribute": fields.Nested(
160 | MockModelWithResourceFieldsNoRequired.resource_fields
161 | ),
162 | "a_list_of_nested_types": fields.List(
163 | fields.Nested(
164 | MockModelWithResourceFieldsNoRequired.resource_fields
165 | )
166 | ),
167 | }
168 |
169 | # Specify which of the resource fields are required
170 | required = ["a_string"]
171 |
172 |
173 | ###############################################################################
174 | # Tests Fixtures
175 | ###############################################################################
176 |
177 | fixtures_integration_test_add_model = [
178 | (MockBasicObject, [], [], []),
179 | (MockTodoItem, ["arg1", "arg2", "arg3"], ["arg1", "arg2"], ["arg3"]),
180 | (MockModelWithResourceFieldsNoRequired, ["a_string"], [], []),
181 | (
182 | MockTodoItemWithResourceFields,
183 | [
184 | "a_string",
185 | "a_formatted_string",
186 | "an_enum",
187 | "an_int",
188 | "a_bool",
189 | "a_url",
190 | "a_float",
191 | "an_float_with_arbitrary_precision",
192 | "a_fixed_point_decimal",
193 | "a_datetime",
194 | "a_list_of_strings",
195 | "a_nested_attribute",
196 | "a_list_of_nested_types",
197 | ],
198 | ["a_string"],
199 | [],
200 | ),
201 | (MockBasicWithSwaggerMetadata1, [], [], []),
202 | (MockBasicWithSwaggerMetadata2, [], [], []),
203 | ]
204 |
205 | fixtures_add_model_get_docs = [
206 | MockBasicObject,
207 | MockTodoItem,
208 | MockModelWithResourceFieldsNoRequired,
209 | MockTodoItemWithResourceFields,
210 | ]
211 |
212 | fixtures_add_model_with_resource_fields_without_swagger_metadata = [
213 | MockModelWithResourceFieldsWithRequired,
214 | ]
215 |
216 | fixtures_add_model_with_resource_fields_with_nested = [
217 | MockTodoItemWithResourceFields,
218 | ]
219 |
220 | fixtures_add_model_with_resource_fields_nested_swagger_metadata = [
221 | MockModelWithResourceFieldsWithRequiredWithSwaggerMetadata,
222 | ]
223 |
224 |
225 | fixtures_add_model_no_properties = [
226 | MockBasicObjectNoInit,
227 | ]
228 |
229 | fixtures_add_model_init = [
230 | MockBasicObject,
231 | MockTodoItem,
232 | ]
233 |
234 | fixtures_add_model_init_parsing_args = [
235 | [MockTodoItem, ["arg1", "arg2"], [("arg3", "123")]]
236 | ]
237 |
--------------------------------------------------------------------------------
/examples/basic.py:
--------------------------------------------------------------------------------
1 | """
2 | Running:
3 |
4 | PYTHONPATH=. python examples/basic.py
5 |
6 | """
7 |
8 |
9 | from flask import Flask, redirect
10 | from flask_restful import Api, Resource, abort, fields, marshal_with, reqparse
11 |
12 | from flask_restful_swagger import swagger
13 |
14 | app = Flask(__name__, static_folder="../static")
15 |
16 | ###################################
17 | # This is important:
18 | api = swagger.docs(
19 | Api(app),
20 | apiVersion="0.1",
21 | basePath="http://localhost:5000",
22 | resourcePath="/",
23 | produces=["application/json", "text/html"],
24 | api_spec_url="/api/spec",
25 | description="A Basic API",
26 | )
27 | ###################################
28 |
29 | TODOS = {
30 | "todo1": {"task": "build an API"},
31 | "todo2": {"task": "?????"},
32 | "todo3": {"task": "profit!"},
33 | }
34 |
35 |
36 | def abort_if_todo_doesnt_exist(todo_id):
37 | if todo_id not in TODOS:
38 | abort(404, message="Todo {} doesn't exist".format(todo_id))
39 |
40 |
41 | parser = reqparse.RequestParser()
42 | parser.add_argument("task", type=str)
43 |
44 |
45 | @swagger.model
46 | class TodoItem:
47 | """This is an example of a model class that has parameters in its constructor
48 | and the fields in the swagger spec are derived from the parameters
49 | to __init__.
50 | In this case we would have args, arg2 as required parameters and arg3 as
51 | optional parameter."""
52 |
53 | def __init__(self, arg1, arg2, arg3="123"):
54 | pass
55 |
56 |
57 | class Todo(Resource):
58 | "My TODO API"
59 |
60 | @swagger.operation(
61 | notes="get a todo item by ID",
62 | nickname="get",
63 | # Parameters can be automatically extracted from URLs.
64 | # For Example:
65 | # but you could also override them here, or add other parameters.
66 | parameters=[
67 | {
68 | "name": "todo_id_x",
69 | "description": "The ID of the TODO item",
70 | "required": True,
71 | "allowMultiple": False,
72 | "dataType": "string",
73 | "paramType": "path",
74 | },
75 | {
76 | "name": "a_bool",
77 | "description": "The ID of the TODO item",
78 | "required": True,
79 | "allowMultiple": False,
80 | "dataType": "boolean",
81 | "paramType": "path",
82 | },
83 | ],
84 | )
85 | def get(self, todo_id):
86 | # This goes into the summary
87 | """Get a todo task
88 |
89 | This will be added to the Implementation Notes.
90 | It lets you put very long text in your api.
91 |
92 | Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod
93 | tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim
94 | veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea
95 | commodo consequat. Duis aute irure dolor in reprehenderit in voluptate
96 | velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat
97 | cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id
98 | est laborum.
99 | """
100 | abort_if_todo_doesnt_exist(todo_id)
101 | return TODOS[todo_id], 200, {"Access-Control-Allow-Origin": "*"}
102 |
103 | @swagger.operation(notes="delete a todo item by ID",)
104 | def delete(self, todo_id):
105 | abort_if_todo_doesnt_exist(todo_id)
106 | del TODOS[todo_id]
107 | return "", 204, {"Access-Control-Allow-Origin": "*"}
108 |
109 | @swagger.operation(notes="edit a todo item by ID",)
110 | def put(self, todo_id):
111 | args = parser.parse_args()
112 | task = {"task": args["task"]}
113 | TODOS[todo_id] = task
114 | return task, 201, {"Access-Control-Allow-Origin": "*"}
115 |
116 | def options(self, **args):
117 | # since this method is not decorated with @swagger.operation it does
118 | # not get added to the swagger docs
119 | return (
120 | {"Allow": "GET,PUT,POST,DELETE"},
121 | 200,
122 | {
123 | "Access-Control-Allow-Origin": "*",
124 | "Access-Control-Allow-Methods": "GET,PUT,POST,DELETE",
125 | "Access-Control-Allow-Headers": "Content-Type",
126 | },
127 | )
128 |
129 |
130 | # TodoList
131 | # shows a list of all todos, and lets you POST to add new tasks
132 | class TodoList(Resource):
133 | def get(self):
134 | return TODOS, 200, {"Access-Control-Allow-Origin": "*"}
135 |
136 | @swagger.operation(
137 | notes="Creates a new TODO item",
138 | responseClass=TodoItem.__name__,
139 | nickname="create",
140 | parameters=[
141 | {
142 | "name": "body",
143 | "description": "A TODO item",
144 | "required": True,
145 | "allowMultiple": False,
146 | "dataType": TodoItem.__name__,
147 | "paramType": "body",
148 | }
149 | ],
150 | responseMessages=[
151 | {
152 | "code": 201,
153 | "message": "Created. The URL of the created blueprint should "
154 | + "be in the Location header",
155 | },
156 | {"code": 405, "message": "Invalid input"},
157 | ],
158 | )
159 | def post(self):
160 | args = parser.parse_args()
161 | todo_id = "todo%d" % (len(TODOS) + 1)
162 | TODOS[todo_id] = {"task": args["task"]}
163 | return TODOS[todo_id], 201, {"Access-Control-Allow-Origin": "*"}
164 |
165 |
166 | @swagger.model
167 | class ModelWithResourceFields:
168 | resource_fields = {"a_string": fields.String()}
169 |
170 |
171 | @swagger.model
172 | @swagger.nested(
173 | a_nested_attribute=ModelWithResourceFields.__name__,
174 | a_list_of_nested_types=ModelWithResourceFields.__name__,
175 | )
176 | class TodoItemWithResourceFields:
177 | """This is an example of how Output Fields work
178 | (http://flask-restful.readthedocs.org/en/latest/fields.html).
179 | Output Fields lets you add resource_fields to your model in which you specify
180 | the output of the model when it gets sent as an HTTP response.
181 | flask-restful-swagger takes advantage of this to specify the fields in
182 | the model"""
183 |
184 | resource_fields = {
185 | "a_string": fields.String(attribute="a_string_field_name"),
186 | "a_formatted_string": fields.FormattedString,
187 | "an_enum": fields.String,
188 | "an_int": fields.Integer,
189 | "a_bool": fields.Boolean,
190 | "a_url": fields.Url,
191 | "a_float": fields.Float,
192 | "an_float_with_arbitrary_precision": fields.Arbitrary,
193 | "a_fixed_point_decimal": fields.Fixed,
194 | "a_datetime": fields.DateTime,
195 | "a_list_of_strings": fields.List(fields.String),
196 | "a_nested_attribute": fields.Nested(
197 | ModelWithResourceFields.resource_fields
198 | ),
199 | "a_list_of_nested_types": fields.List(
200 | fields.Nested(ModelWithResourceFields.resource_fields)
201 | ),
202 | }
203 |
204 | # Specify which of the resource fields are required
205 | required = ["a_string"]
206 |
207 | swagger_metadata = {"an_enum": {"enum": ["one", "two", "three"]}}
208 |
209 |
210 | class MarshalWithExample(Resource):
211 | @swagger.operation(
212 | notes="get something",
213 | responseClass=TodoItemWithResourceFields,
214 | nickname="get",
215 | )
216 | @marshal_with(TodoItemWithResourceFields.resource_fields)
217 | def get(self, **kwargs):
218 | return {}, 200, {"Access-Control-Allow-Origin": "*"}
219 |
220 |
221 | #
222 | # Actually setup the Api resource routing here
223 | #
224 | api.add_resource(TodoList, "/todos")
225 | api.add_resource(Todo, "/todos/")
226 | api.add_resource(MarshalWithExample, "/marshal_with")
227 |
228 |
229 | @app.route("/docs")
230 | def docs():
231 | return redirect("/static/docs.html")
232 |
233 |
234 | if __name__ == "__main__":
235 | TodoItemWithResourceFields()
236 | TodoItem(1, 2, "3")
237 | app.run(host='0.0.0.0', debug=True)
238 |
--------------------------------------------------------------------------------
/examples/blueprints.py:
--------------------------------------------------------------------------------
1 | """
2 | Running:
3 |
4 | PYTHONPATH=. python examples/basic.py
5 |
6 | Goto: http://127.0.0.1:5000/api2/api/spec.html
7 |
8 | """
9 |
10 |
11 | from flask import Blueprint, Flask, redirect
12 | from flask_restful import Api, Resource, abort, fields, marshal_with, reqparse
13 |
14 | from flask_restful_swagger import swagger
15 |
16 | app = Flask(__name__, static_folder="../static")
17 | my_blueprint1 = Blueprint("my_blueprint1", __name__)
18 | my_blueprint2 = Blueprint("my_blueprint2", __name__)
19 |
20 | ###################################
21 | # This is important:
22 | api1 = swagger.docs(
23 | Api(my_blueprint1),
24 | apiVersion="0.1",
25 | basePath="http://localhost:5000",
26 | resourcePath="/",
27 | produces=["application/json", "text/html"],
28 | api_spec_url="/api/spec",
29 | description="Blueprint1 Description",
30 | )
31 | api2 = swagger.docs(
32 | Api(my_blueprint2),
33 | apiVersion="0.1",
34 | basePath="http://localhost:5000",
35 | resourcePath="/",
36 | produces=["application/json", "text/html"],
37 | api_spec_url="/api/spec",
38 | description="Blueprint2 Description",
39 | )
40 | ###################################
41 |
42 | TODOS = {
43 | "todo1": {"task": "build an API"},
44 | "todo2": {"task": "?????"},
45 | "todo3": {"task": "profit!"},
46 | }
47 |
48 |
49 | def abort_if_todo_doesnt_exist(todo_id):
50 | if todo_id not in TODOS:
51 | abort(404, message="Todo {} doesn't exist".format(todo_id))
52 |
53 |
54 | parser = reqparse.RequestParser()
55 | parser.add_argument("task", type=str)
56 |
57 |
58 | @swagger.model
59 | class TodoItem:
60 | """This is an example of a model class that has parameters in its constructor
61 | and the fields in the swagger spec are derived from the parameters
62 | to __init__.
63 | In this case we would have args, arg2 as required parameters and arg3 as
64 | optional parameter."""
65 |
66 | def __init__(self, arg1, arg2, arg3="123"):
67 | pass
68 |
69 |
70 | class Todo(Resource):
71 | "My TODO API"
72 |
73 | @swagger.operation(
74 | notes="get a todo item by ID",
75 | nickname="get",
76 | # Parameters can be automatically extracted from URLs.
77 | # For Example:
78 | # but you could also override them here, or add other parameters.
79 | parameters=[
80 | {
81 | "name": "todo_id_x",
82 | "description": "The ID of the TODO item",
83 | "required": True,
84 | "allowMultiple": False,
85 | "dataType": "string",
86 | "paramType": "path",
87 | },
88 | {
89 | "name": "a_bool",
90 | "description": "The ID of the TODO item",
91 | "required": True,
92 | "allowMultiple": False,
93 | "dataType": "boolean",
94 | "paramType": "path",
95 | },
96 | ],
97 | )
98 | def get(self, todo_id):
99 | # This goes into the summary
100 | """Get a todo task
101 |
102 | This will be added to the Implementation Notes.
103 | It let's you put very long text in your api.
104 |
105 | Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod
106 | tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim
107 | veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea
108 | commodo consequat. Duis aute irure dolor in reprehenderit in voluptate
109 | velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat
110 | cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id
111 | est laborum.
112 | """
113 | abort_if_todo_doesnt_exist(todo_id)
114 | return TODOS[todo_id], 200, {"Access-Control-Allow-Origin": "*"}
115 |
116 | @swagger.operation(notes="delete a todo item by ID",)
117 | def delete(self, todo_id):
118 | abort_if_todo_doesnt_exist(todo_id)
119 | del TODOS[todo_id]
120 | return "", 204, {"Access-Control-Allow-Origin": "*"}
121 |
122 | @swagger.operation(notes="edit a todo item by ID",)
123 | def put(self, todo_id):
124 | args = parser.parse_args()
125 | task = {"task": args["task"]}
126 | TODOS[todo_id] = task
127 | return task, 201, {"Access-Control-Allow-Origin": "*"}
128 |
129 | def options(self, **args):
130 | # since this method is not decorated with @swagger.operation it does
131 | # not get added to the swagger docs
132 | return (
133 | {"Allow": "GET,PUT,POST,DELETE"},
134 | 200,
135 | {
136 | "Access-Control-Allow-Origin": "*",
137 | "Access-Control-Allow-Methods": "GET,PUT,POST,DELETE",
138 | "Access-Control-Allow-Headers": "Content-Type",
139 | },
140 | )
141 |
142 |
143 | # TodoList
144 | # shows a list of all todos, and lets you POST to add new tasks
145 | class TodoList(Resource):
146 | def get(self):
147 | return TODOS, 200, {"Access-Control-Allow-Origin": "*"}
148 |
149 | @swagger.operation(
150 | notes="Creates a new TODO item",
151 | responseClass=TodoItem.__name__,
152 | nickname="create",
153 | parameters=[
154 | {
155 | "name": "body",
156 | "description": "A TODO item",
157 | "required": True,
158 | "allowMultiple": False,
159 | "dataType": TodoItem.__name__,
160 | "paramType": "body",
161 | }
162 | ],
163 | responseMessages=[
164 | {
165 | "code": 201,
166 | "message": "Created. The URL of the created blueprint should "
167 | + "be in the Location header",
168 | },
169 | {"code": 405, "message": "Invalid input"},
170 | ],
171 | )
172 | def post(self):
173 | args = parser.parse_args()
174 | todo_id = "todo%d" % (len(TODOS) + 1)
175 | TODOS[todo_id] = {"task": args["task"]}
176 | return TODOS[todo_id], 201, {"Access-Control-Allow-Origin": "*"}
177 |
178 |
179 | @swagger.model
180 | class ModelWithResourceFields:
181 | resource_fields = {"a_string": fields.String()}
182 |
183 |
184 | @swagger.model
185 | @swagger.nested(
186 | a_nested_attribute=ModelWithResourceFields.__name__,
187 | a_list_of_nested_types=ModelWithResourceFields.__name__,
188 | )
189 | class TodoItemWithResourceFields:
190 | """This is an example of how Output Fields work
191 | (http://flask-restful.readthedocs.org/en/latest/fields.html).
192 | Output Fields lets you add resource_fields to your model in which you specify
193 | the output of the model when it gets sent as an HTTP response.
194 | flask-restful-swagger takes advantage of this to specify the fields in
195 | the model"""
196 |
197 | resource_fields = {
198 | "a_string": fields.String(attribute="a_string_field_name"),
199 | "a_formatted_string": fields.FormattedString,
200 | "an_int": fields.Integer,
201 | "a_bool": fields.Boolean,
202 | "a_url": fields.Url,
203 | "a_float": fields.Float,
204 | "an_float_with_arbitrary_precision": fields.Arbitrary,
205 | "a_fixed_point_decimal": fields.Fixed,
206 | "a_datetime": fields.DateTime,
207 | "a_list_of_strings": fields.List(fields.String),
208 | "a_nested_attribute": fields.Nested(
209 | ModelWithResourceFields.resource_fields
210 | ),
211 | "a_list_of_nested_types": fields.List(
212 | fields.Nested(ModelWithResourceFields.resource_fields)
213 | ),
214 | }
215 |
216 | # Specify which of the resource fields are required
217 | required = ["a_string"]
218 |
219 |
220 | class MarshalWithExample(Resource):
221 | @swagger.operation(
222 | notes="get something",
223 | responseClass=TodoItemWithResourceFields,
224 | nickname="get",
225 | )
226 | @marshal_with(TodoItemWithResourceFields.resource_fields)
227 | def get(self, **kwargs):
228 | return {}, 200, {"Access-Control-Allow-Origin": "*"}
229 |
230 |
231 | #
232 | # Actually setup the Api resource routing here
233 | #
234 | api1.add_resource(TodoList, "/todos1")
235 | api1.add_resource(Todo, "/todos1/")
236 | api1.add_resource(MarshalWithExample, "/marshal_with1")
237 | api2.add_resource(TodoList, "/todos2")
238 | api2.add_resource(Todo, "/todos2/")
239 | api2.add_resource(MarshalWithExample, "/marshal_with2")
240 |
241 |
242 | @app.route("/docs")
243 | def docs():
244 | return redirect("/static/docs.html")
245 |
246 |
247 | if __name__ == "__main__":
248 | TodoItemWithResourceFields()
249 | TodoItem(1, 2, "3")
250 | app.register_blueprint(my_blueprint1, url_prefix="/api1")
251 | app.register_blueprint(my_blueprint2, url_prefix="/api2")
252 | app.run(host='0.0.0.0', debug=True)
253 |
--------------------------------------------------------------------------------
/tests/test_add_model.py:
--------------------------------------------------------------------------------
1 | import pytest
2 |
3 | from flask_restful_swagger import swagger
4 | from tests.fixtures_add_model import (
5 | fixtures_add_model_get_docs,
6 | fixtures_add_model_init,
7 | fixtures_add_model_init_parsing_args,
8 | fixtures_add_model_no_properties,
9 | fixtures_add_model_with_resource_fields_nested_swagger_metadata,
10 | fixtures_add_model_with_resource_fields_with_nested,
11 | fixtures_add_model_with_resource_fields_without_swagger_metadata,
12 | fixtures_integration_test_add_model,
13 | patch_deduce_swagger_type,
14 | patch_dir,
15 | patch_getargspec,
16 | patch_hasattr,
17 | patch_isinstance,
18 | patch_parse_doc,
19 | patch_registry,
20 | )
21 |
22 | try:
23 | from unittest.mock import patch
24 | except ImportError:
25 | from mock import patch
26 |
27 |
28 | @pytest.mark.parametrize(
29 | "test_input,properties,required,defaults",
30 | fixtures_integration_test_add_model,
31 | )
32 | def test_integration_test_add_model(
33 | test_input, properties, required, defaults
34 | ):
35 | """Integration test for `add_model(...)` method.
36 |
37 | Ensures models are added to `registry["models"]` with expected structure.
38 | Example each model should have 'description', 'id','notes', 'properties',
39 | etc.
40 | Example `registry["models"]`:
41 | # print(registry["models"])
42 | { 'models': { .....
43 | 'MockTodoItem': { 'description': 'This is an example of a '
44 | 'model class that has '
45 | 'parameters in its '
46 | 'constructor',
47 | 'id': 'MockTodoItem',
48 | 'notes': 'and the fields in the swagger spec '
49 | 'are derived from the '
50 | 'parameters to __init__. In '
51 | 'this case we would have args, arg2 '
52 | 'as required parameters and arg3 '
53 | 'as optional parameter.',
54 | 'properties': { 'arg1': {'type': 'string'},
55 | 'arg2': {'type': 'string'},
56 | 'arg3': { 'default': '123',
57 | 'type': 'string'}},
58 | 'required': ['arg1', 'arg2']},
59 | ..........
60 | """
61 | with patch_registry() as registry:
62 | swagger.add_model(test_input)
63 |
64 | assert test_input.__name__ in registry["models"]
65 | assert "description" in registry["models"][test_input.__name__]
66 | assert "notes" in registry["models"][test_input.__name__]
67 |
68 | if "resource_fields" not in dir(test_input) and "__init__" not in dir(
69 | test_input
70 | ):
71 | # in py2, classes without __init__ or resource_fields defined
72 | # will cause issues.
73 | # note, no issue in PY3.
74 | pytest.fail(
75 | "do not call without resource_fields or __init__ defined."
76 | )
77 |
78 | if "resource_fields" in dir(test_input):
79 | if hasattr(test_input, "required"):
80 | assert "required" in registry["models"][test_input.__name__]
81 | elif "__init__" in dir(test_input):
82 | assert "required" in registry["models"][test_input.__name__]
83 |
84 | assert "properties" in registry["models"][test_input.__name__]
85 |
86 |
87 | @pytest.mark.parametrize("input_model", fixtures_add_model_get_docs)
88 | def test_add_model_get_docs(input_model):
89 | """Ensure `_parse_doc(...)` is called without issues"""
90 | with patch_registry(), patch_parse_doc() as mock_parse_doc:
91 | swagger.add_model(input_model)
92 | mock_parse_doc.assert_called_once_with(input_model)
93 |
94 |
95 | @patch("flask_restful_swagger.swagger._Nested", spec=swagger._Nested)
96 | @pytest.mark.parametrize(
97 | "mock_model_class",
98 | fixtures_add_model_with_resource_fields_without_swagger_metadata,
99 | )
100 | def test_add_model_with_resource_fields_without_swagger_metadata(
101 | mock_nested, mock_model_class,
102 | ):
103 | """Test adding model with resource fields, no init, without swagger metadata.
104 | """
105 | pdst = patch_deduce_swagger_type
106 | pr = patch_registry
107 | ppd = patch_parse_doc
108 | pha = patch_hasattr
109 |
110 | with pr(), ppd(), patch_isinstance(False) as mock_isinstance:
111 | with pha() as mock_hasattr, patch_dir(["resource_fields"]) as mock_dir:
112 | with pdst() as mock_deduce_swagger_type:
113 |
114 | swagger.add_model(mock_model_class)
115 | mock_dir.assert_called_with(mock_model_class)
116 | assert mock_dir.call_count == 2
117 | mock_hasattr.assert_called_once_with(
118 | mock_model_class, "required")
119 | mock_isinstance.assert_called_with(
120 | mock_model_class, mock_nested)
121 | assert mock_deduce_swagger_type.call_count == len(
122 | mock_model_class.resource_fields.items()
123 | )
124 |
125 |
126 | @pytest.mark.parametrize(
127 | "model_class", fixtures_add_model_with_resource_fields_with_nested
128 | )
129 | def test_add_model_with_resource_fields_with_nested(model_class,):
130 | """Test for model with resource fields, nested subclass
131 |
132 | * resource_fields: YES
133 | * nested subclass: YES
134 | * __init__: NO
135 | * swagger_metadata:NO
136 |
137 | """
138 | pdst = patch_deduce_swagger_type
139 | pr = patch_registry
140 | ppd = patch_parse_doc
141 | pha = patch_hasattr
142 |
143 | with pr(), ppd(), patch_isinstance(True) as mock_isinstance:
144 | with pha() as mock_hasattr, patch_dir(["resource_fields"]) as mock_dir:
145 | with pdst() as mock_deduce_swagger_type:
146 |
147 | swagger.add_model(model_class)
148 | mock_dir.assert_called_with(model_class)
149 | assert mock_dir.call_count == 2
150 | mock_hasattr.assert_called_once_with(model_class, "required")
151 | mock_isinstance.assert_called_with(
152 | model_class, swagger._Nested)
153 | assert mock_deduce_swagger_type.call_count == len(
154 | model_class.resource_fields.items()
155 | )
156 |
157 |
158 | @pytest.mark.parametrize(
159 | "model_class",
160 | fixtures_add_model_with_resource_fields_nested_swagger_metadata,
161 | )
162 | def test_add_model_with_resource_fields_nested_swagger_metadata(model_class,):
163 | """Test for model with resource fields, nested subclass, swagger metadata
164 |
165 | * resource_fields: YES
166 | * nested subclass: YES
167 | * __init__: NO
168 | * swagger_metadata:YES
169 | """
170 | pdst = patch_deduce_swagger_type
171 | pr = patch_registry
172 | ppd = patch_parse_doc
173 | pha = patch_hasattr
174 |
175 | with pr(), ppd(), patch_isinstance(True) as mock_isinstance:
176 | with pha() as mock_hasattr:
177 | with patch_dir(["resource_fields"]) as mock_dir:
178 | with pdst() as mock_deduce_swagger_type:
179 | swagger.add_model(model_class)
180 |
181 | mock_dir.assert_called_with(model_class)
182 | assert mock_dir.call_count == 2
183 | mock_hasattr.assert_called_once_with(
184 | model_class, "required")
185 | mock_isinstance.assert_called_with(
186 | model_class, swagger._Nested)
187 | assert mock_deduce_swagger_type.call_count == len(
188 | model_class.resource_fields.items()
189 | )
190 |
191 |
192 | @pytest.mark.parametrize("model_class", fixtures_add_model_init)
193 | def test_add_model_init(model_class):
194 | """Test for model with only init
195 |
196 | * resource_fields: NO
197 | * nested subclass: NO
198 | * __init__: YES
199 | * swagger_metadata: NO
200 | """
201 | pdst = patch_deduce_swagger_type
202 | pr = patch_registry
203 | ppd = patch_parse_doc
204 | pgas = patch_getargspec
205 | pha = patch_hasattr
206 |
207 | with pdst() as mock_deduce_swagger_type:
208 | with patch_dir(["__init__"]), pr(), ppd(), pgas() as mock_getargspec:
209 | with pha() as mock_hasattr:
210 | swagger.add_model(model_class)
211 | mock_getargspec.assert_called_once_with(model_class.__init__)
212 | mock_hasattr.assert_not_called()
213 | mock_deduce_swagger_type.assert_not_called()
214 |
215 |
216 | @pytest.mark.parametrize("model_class", fixtures_add_model_no_properties)
217 | def test_add_model_no_init(model_class):
218 | """Test for model with only init
219 |
220 | * resource_fields: NO
221 | * nested subclass: NO
222 | * __init__: NO
223 | * swagger_metadata: NO
224 | """
225 | pdst = patch_deduce_swagger_type
226 | pr = patch_registry
227 | ppd = patch_parse_doc
228 | pgas = patch_getargspec
229 | pha = patch_hasattr
230 |
231 | with pdst() as mock_deduce_swagger_type:
232 | with pr(), ppd(), pgas() as mock_getargspec:
233 | with pha() as mock_hasattr:
234 | swagger.add_model(model_class)
235 | mock_getargspec.assert_not_called()
236 | mock_hasattr.assert_not_called()
237 | mock_deduce_swagger_type.assert_not_called()
238 |
239 |
240 | @pytest.mark.parametrize(
241 | "model_class,required,defaults", fixtures_add_model_init_parsing_args
242 | )
243 | def test_add_model_init_parsing_args(model_class, required, defaults):
244 | """Test to verify args parsed correctly
245 | """
246 | with patch_registry() as registry, patch_parse_doc(), patch_dir(
247 | ["__init__"]
248 | ):
249 | swagger.add_model(model_class)
250 |
251 | assert model_class.__name__ in registry["models"]
252 | assert registry["models"][model_class.__name__]["required"] == required
253 | for key, default_value in defaults:
254 | _name = model_class.__name__
255 | assert key in registry["models"][_name]["properties"]
256 | assert (
257 | default_value
258 | == registry["models"][_name]["properties"][key]["default"]
259 | )
260 |
--------------------------------------------------------------------------------
/static/js/underscore-min.js:
--------------------------------------------------------------------------------
1 | // Underscore.js 1.3.3
2 | // (c) 2009-2012 Jeremy Ashkenas, DocumentCloud Inc.
3 | // Underscore is freely distributable under the MIT license.
4 | // Portions of Underscore are inspired or borrowed from Prototype,
5 | // Oliver Steele's Functional, and John Resig's Micro-Templating.
6 | // For all details and documentation:
7 | // http://documentcloud.github.com/underscore
8 | (function(){function r(a,c,d){if(a===c)return 0!==a||1/a==1/c;if(null==a||null==c)return a===c;a._chain&&(a=a._wrapped);c._chain&&(c=c._wrapped);if(a.isEqual&&b.isFunction(a.isEqual))return a.isEqual(c);if(c.isEqual&&b.isFunction(c.isEqual))return c.isEqual(a);var e=l.call(a);if(e!=l.call(c))return!1;switch(e){case "[object String]":return a==""+c;case "[object Number]":return a!=+a?c!=+c:0==a?1/a==1/c:a==+c;case "[object Date]":case "[object Boolean]":return+a==+c;case "[object RegExp]":return a.source==
9 | c.source&&a.global==c.global&&a.multiline==c.multiline&&a.ignoreCase==c.ignoreCase}if("object"!=typeof a||"object"!=typeof c)return!1;for(var f=d.length;f--;)if(d[f]==a)return!0;d.push(a);var f=0,g=!0;if("[object Array]"==e){if(f=a.length,g=f==c.length)for(;f--&&(g=f in a==f in c&&r(a[f],c[f],d)););}else{if("constructor"in a!="constructor"in c||a.constructor!=c.constructor)return!1;for(var h in a)if(b.has(a,h)&&(f++,!(g=b.has(c,h)&&r(a[h],c[h],d))))break;if(g){for(h in c)if(b.has(c,h)&&!f--)break;
10 | g=!f}}d.pop();return g}var s=this,I=s._,o={},k=Array.prototype,p=Object.prototype,i=k.slice,J=k.unshift,l=p.toString,K=p.hasOwnProperty,y=k.forEach,z=k.map,A=k.reduce,B=k.reduceRight,C=k.filter,D=k.every,E=k.some,q=k.indexOf,F=k.lastIndexOf,p=Array.isArray,L=Object.keys,t=Function.prototype.bind,b=function(a){return new m(a)};"undefined"!==typeof exports?("undefined"!==typeof module&&module.exports&&(exports=module.exports=b),exports._=b):s._=b;b.VERSION="1.3.3";var j=b.each=b.forEach=function(a,
11 | c,d){if(a!=null)if(y&&a.forEach===y)a.forEach(c,d);else if(a.length===+a.length)for(var e=0,f=a.length;e2;a==null&&(a=[]);if(A&&
12 | a.reduce===A){e&&(c=b.bind(c,e));return f?a.reduce(c,d):a.reduce(c)}j(a,function(a,b,i){if(f)d=c.call(e,d,a,b,i);else{d=a;f=true}});if(!f)throw new TypeError("Reduce of empty array with no initial value");return d};b.reduceRight=b.foldr=function(a,c,d,e){var f=arguments.length>2;a==null&&(a=[]);if(B&&a.reduceRight===B){e&&(c=b.bind(c,e));return f?a.reduceRight(c,d):a.reduceRight(c)}var g=b.toArray(a).reverse();e&&!f&&(c=b.bind(c,e));return f?b.reduce(g,c,d,e):b.reduce(g,c)};b.find=b.detect=function(a,
13 | c,b){var e;G(a,function(a,g,h){if(c.call(b,a,g,h)){e=a;return true}});return e};b.filter=b.select=function(a,c,b){var e=[];if(a==null)return e;if(C&&a.filter===C)return a.filter(c,b);j(a,function(a,g,h){c.call(b,a,g,h)&&(e[e.length]=a)});return e};b.reject=function(a,c,b){var e=[];if(a==null)return e;j(a,function(a,g,h){c.call(b,a,g,h)||(e[e.length]=a)});return e};b.every=b.all=function(a,c,b){var e=true;if(a==null)return e;if(D&&a.every===D)return a.every(c,b);j(a,function(a,g,h){if(!(e=e&&c.call(b,
14 | a,g,h)))return o});return!!e};var G=b.some=b.any=function(a,c,d){c||(c=b.identity);var e=false;if(a==null)return e;if(E&&a.some===E)return a.some(c,d);j(a,function(a,b,h){if(e||(e=c.call(d,a,b,h)))return o});return!!e};b.include=b.contains=function(a,c){var b=false;if(a==null)return b;if(q&&a.indexOf===q)return a.indexOf(c)!=-1;return b=G(a,function(a){return a===c})};b.invoke=function(a,c){var d=i.call(arguments,2);return b.map(a,function(a){return(b.isFunction(c)?c||a:a[c]).apply(a,d)})};b.pluck=
15 | function(a,c){return b.map(a,function(a){return a[c]})};b.max=function(a,c,d){if(!c&&b.isArray(a)&&a[0]===+a[0])return Math.max.apply(Math,a);if(!c&&b.isEmpty(a))return-Infinity;var e={computed:-Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;b>=e.computed&&(e={value:a,computed:b})});return e.value};b.min=function(a,c,d){if(!c&&b.isArray(a)&&a[0]===+a[0])return Math.min.apply(Math,a);if(!c&&b.isEmpty(a))return Infinity;var e={computed:Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;bd?1:0}),"value")};b.groupBy=function(a,c){var d={},e=b.isFunction(c)?c:function(a){return a[c]};
17 | j(a,function(a,b){var c=e(a,b);(d[c]||(d[c]=[])).push(a)});return d};b.sortedIndex=function(a,c,d){d||(d=b.identity);for(var e=0,f=a.length;e>1;d(a[g])=0})})};b.difference=function(a){var c=b.flatten(i.call(arguments,1),true);return b.filter(a,function(a){return!b.include(c,a)})};b.zip=function(){for(var a=
20 | i.call(arguments),c=b.max(b.pluck(a,"length")),d=Array(c),e=0;e=0;d--)b=[a[d].apply(this,b)];return b[0]}};b.after=function(a,b){return a<=0?b():function(){if(--a<1)return b.apply(this,arguments)}};b.keys=L||function(a){if(a!==Object(a))throw new TypeError("Invalid object");var c=[],d;for(d in a)b.has(a,d)&&(c[c.length]=d);return c};b.values=function(a){return b.map(a,b.identity)};b.functions=b.methods=function(a){var c=[],d;for(d in a)b.isFunction(a[d])&&
25 | c.push(d);return c.sort()};b.extend=function(a){j(i.call(arguments,1),function(b){for(var d in b)a[d]=b[d]});return a};b.pick=function(a){var c={};j(b.flatten(i.call(arguments,1)),function(b){b in a&&(c[b]=a[b])});return c};b.defaults=function(a){j(i.call(arguments,1),function(b){for(var d in b)a[d]==null&&(a[d]=b[d])});return a};b.clone=function(a){return!b.isObject(a)?a:b.isArray(a)?a.slice():b.extend({},a)};b.tap=function(a,b){b(a);return a};b.isEqual=function(a,b){return r(a,b,[])};b.isEmpty=
26 | function(a){if(a==null)return true;if(b.isArray(a)||b.isString(a))return a.length===0;for(var c in a)if(b.has(a,c))return false;return true};b.isElement=function(a){return!!(a&&a.nodeType==1)};b.isArray=p||function(a){return l.call(a)=="[object Array]"};b.isObject=function(a){return a===Object(a)};b.isArguments=function(a){return l.call(a)=="[object Arguments]"};b.isArguments(arguments)||(b.isArguments=function(a){return!(!a||!b.has(a,"callee"))});b.isFunction=function(a){return l.call(a)=="[object Function]"};
27 | b.isString=function(a){return l.call(a)=="[object String]"};b.isNumber=function(a){return l.call(a)=="[object Number]"};b.isFinite=function(a){return b.isNumber(a)&&isFinite(a)};b.isNaN=function(a){return a!==a};b.isBoolean=function(a){return a===true||a===false||l.call(a)=="[object Boolean]"};b.isDate=function(a){return l.call(a)=="[object Date]"};b.isRegExp=function(a){return l.call(a)=="[object RegExp]"};b.isNull=function(a){return a===null};b.isUndefined=function(a){return a===void 0};b.has=function(a,
28 | b){return K.call(a,b)};b.noConflict=function(){s._=I;return this};b.identity=function(a){return a};b.times=function(a,b,d){for(var e=0;e/g,">").replace(/"/g,""").replace(/'/g,"'").replace(/\//g,"/")};b.result=function(a,c){if(a==null)return null;var d=a[c];return b.isFunction(d)?d.call(a):d};b.mixin=function(a){j(b.functions(a),function(c){M(c,b[c]=a[c])})};var N=0;b.uniqueId=
29 | function(a){var b=N++;return a?a+b:b};b.templateSettings={evaluate:/<%([\s\S]+?)%>/g,interpolate:/<%=([\s\S]+?)%>/g,escape:/<%-([\s\S]+?)%>/g};var u=/.^/,n={"\\":"\\","'":"'",r:"\r",n:"\n",t:"\t",u2028:"\u2028",u2029:"\u2029"},v;for(v in n)n[n[v]]=v;var O=/\\|'|\r|\n|\t|\u2028|\u2029/g,P=/\\(\\|'|r|n|t|u2028|u2029)/g,w=function(a){return a.replace(P,function(a,b){return n[b]})};b.template=function(a,c,d){d=b.defaults(d||{},b.templateSettings);a="__p+='"+a.replace(O,function(a){return"\\"+n[a]}).replace(d.escape||
30 | u,function(a,b){return"'+\n_.escape("+w(b)+")+\n'"}).replace(d.interpolate||u,function(a,b){return"'+\n("+w(b)+")+\n'"}).replace(d.evaluate||u,function(a,b){return"';\n"+w(b)+"\n;__p+='"})+"';\n";d.variable||(a="with(obj||{}){\n"+a+"}\n");var a="var __p='';var print=function(){__p+=Array.prototype.join.call(arguments, '')};\n"+a+"return __p;\n",e=new Function(d.variable||"obj","_",a);if(c)return e(c,b);c=function(a){return e.call(this,a,b)};c.source="function("+(d.variable||"obj")+"){\n"+a+"}";return c};
31 | b.chain=function(a){return b(a).chain()};var m=function(a){this._wrapped=a};b.prototype=m.prototype;var x=function(a,c){return c?b(a).chain():a},M=function(a,c){m.prototype[a]=function(){var a=i.call(arguments);J.call(a,this._wrapped);return x(c.apply(b,a),this._chain)}};b.mixin(b);j("pop,push,reverse,shift,sort,splice,unshift".split(","),function(a){var b=k[a];m.prototype[a]=function(){var d=this._wrapped;b.apply(d,arguments);var e=d.length;(a=="shift"||a=="splice")&&e===0&&delete d[0];return x(d,
32 | this._chain)}});j(["concat","join","slice"],function(a){var b=k[a];m.prototype[a]=function(){return x(b.apply(this._wrapped,arguments),this._chain)}});m.prototype.chain=function(){this._chain=true;return this};m.prototype.value=function(){return this._wrapped}}).call(this);
33 |
--------------------------------------------------------------------------------
/flask_restful_swagger/static/lib/underscore-min.js:
--------------------------------------------------------------------------------
1 | // Underscore.js 1.3.3
2 | // (c) 2009-2012 Jeremy Ashkenas, DocumentCloud Inc.
3 | // Underscore is freely distributable under the MIT license.
4 | // Portions of Underscore are inspired or borrowed from Prototype,
5 | // Oliver Steele's Functional, and John Resig's Micro-Templating.
6 | // For all details and documentation:
7 | // http://documentcloud.github.com/underscore
8 | (function(){function r(a,c,d){if(a===c)return 0!==a||1/a==1/c;if(null==a||null==c)return a===c;a._chain&&(a=a._wrapped);c._chain&&(c=c._wrapped);if(a.isEqual&&b.isFunction(a.isEqual))return a.isEqual(c);if(c.isEqual&&b.isFunction(c.isEqual))return c.isEqual(a);var e=l.call(a);if(e!=l.call(c))return!1;switch(e){case "[object String]":return a==""+c;case "[object Number]":return a!=+a?c!=+c:0==a?1/a==1/c:a==+c;case "[object Date]":case "[object Boolean]":return+a==+c;case "[object RegExp]":return a.source==
9 | c.source&&a.global==c.global&&a.multiline==c.multiline&&a.ignoreCase==c.ignoreCase}if("object"!=typeof a||"object"!=typeof c)return!1;for(var f=d.length;f--;)if(d[f]==a)return!0;d.push(a);var f=0,g=!0;if("[object Array]"==e){if(f=a.length,g=f==c.length)for(;f--&&(g=f in a==f in c&&r(a[f],c[f],d)););}else{if("constructor"in a!="constructor"in c||a.constructor!=c.constructor)return!1;for(var h in a)if(b.has(a,h)&&(f++,!(g=b.has(c,h)&&r(a[h],c[h],d))))break;if(g){for(h in c)if(b.has(c,h)&&!f--)break;
10 | g=!f}}d.pop();return g}var s=this,I=s._,o={},k=Array.prototype,p=Object.prototype,i=k.slice,J=k.unshift,l=p.toString,K=p.hasOwnProperty,y=k.forEach,z=k.map,A=k.reduce,B=k.reduceRight,C=k.filter,D=k.every,E=k.some,q=k.indexOf,F=k.lastIndexOf,p=Array.isArray,L=Object.keys,t=Function.prototype.bind,b=function(a){return new m(a)};"undefined"!==typeof exports?("undefined"!==typeof module&&module.exports&&(exports=module.exports=b),exports._=b):s._=b;b.VERSION="1.3.3";var j=b.each=b.forEach=function(a,
11 | c,d){if(a!=null)if(y&&a.forEach===y)a.forEach(c,d);else if(a.length===+a.length)for(var e=0,f=a.length;e2;a==null&&(a=[]);if(A&&
12 | a.reduce===A){e&&(c=b.bind(c,e));return f?a.reduce(c,d):a.reduce(c)}j(a,function(a,b,i){if(f)d=c.call(e,d,a,b,i);else{d=a;f=true}});if(!f)throw new TypeError("Reduce of empty array with no initial value");return d};b.reduceRight=b.foldr=function(a,c,d,e){var f=arguments.length>2;a==null&&(a=[]);if(B&&a.reduceRight===B){e&&(c=b.bind(c,e));return f?a.reduceRight(c,d):a.reduceRight(c)}var g=b.toArray(a).reverse();e&&!f&&(c=b.bind(c,e));return f?b.reduce(g,c,d,e):b.reduce(g,c)};b.find=b.detect=function(a,
13 | c,b){var e;G(a,function(a,g,h){if(c.call(b,a,g,h)){e=a;return true}});return e};b.filter=b.select=function(a,c,b){var e=[];if(a==null)return e;if(C&&a.filter===C)return a.filter(c,b);j(a,function(a,g,h){c.call(b,a,g,h)&&(e[e.length]=a)});return e};b.reject=function(a,c,b){var e=[];if(a==null)return e;j(a,function(a,g,h){c.call(b,a,g,h)||(e[e.length]=a)});return e};b.every=b.all=function(a,c,b){var e=true;if(a==null)return e;if(D&&a.every===D)return a.every(c,b);j(a,function(a,g,h){if(!(e=e&&c.call(b,
14 | a,g,h)))return o});return!!e};var G=b.some=b.any=function(a,c,d){c||(c=b.identity);var e=false;if(a==null)return e;if(E&&a.some===E)return a.some(c,d);j(a,function(a,b,h){if(e||(e=c.call(d,a,b,h)))return o});return!!e};b.include=b.contains=function(a,c){var b=false;if(a==null)return b;if(q&&a.indexOf===q)return a.indexOf(c)!=-1;return b=G(a,function(a){return a===c})};b.invoke=function(a,c){var d=i.call(arguments,2);return b.map(a,function(a){return(b.isFunction(c)?c||a:a[c]).apply(a,d)})};b.pluck=
15 | function(a,c){return b.map(a,function(a){return a[c]})};b.max=function(a,c,d){if(!c&&b.isArray(a)&&a[0]===+a[0])return Math.max.apply(Math,a);if(!c&&b.isEmpty(a))return-Infinity;var e={computed:-Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;b>=e.computed&&(e={value:a,computed:b})});return e.value};b.min=function(a,c,d){if(!c&&b.isArray(a)&&a[0]===+a[0])return Math.min.apply(Math,a);if(!c&&b.isEmpty(a))return Infinity;var e={computed:Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;bd?1:0}),"value")};b.groupBy=function(a,c){var d={},e=b.isFunction(c)?c:function(a){return a[c]};
17 | j(a,function(a,b){var c=e(a,b);(d[c]||(d[c]=[])).push(a)});return d};b.sortedIndex=function(a,c,d){d||(d=b.identity);for(var e=0,f=a.length;e>1;d(a[g])=0})})};b.difference=function(a){var c=b.flatten(i.call(arguments,1),true);return b.filter(a,function(a){return!b.include(c,a)})};b.zip=function(){for(var a=
20 | i.call(arguments),c=b.max(b.pluck(a,"length")),d=Array(c),e=0;e=0;d--)b=[a[d].apply(this,b)];return b[0]}};b.after=function(a,b){return a<=0?b():function(){if(--a<1)return b.apply(this,arguments)}};b.keys=L||function(a){if(a!==Object(a))throw new TypeError("Invalid object");var c=[],d;for(d in a)b.has(a,d)&&(c[c.length]=d);return c};b.values=function(a){return b.map(a,b.identity)};b.functions=b.methods=function(a){var c=[],d;for(d in a)b.isFunction(a[d])&&
25 | c.push(d);return c.sort()};b.extend=function(a){j(i.call(arguments,1),function(b){for(var d in b)a[d]=b[d]});return a};b.pick=function(a){var c={};j(b.flatten(i.call(arguments,1)),function(b){b in a&&(c[b]=a[b])});return c};b.defaults=function(a){j(i.call(arguments,1),function(b){for(var d in b)a[d]==null&&(a[d]=b[d])});return a};b.clone=function(a){return!b.isObject(a)?a:b.isArray(a)?a.slice():b.extend({},a)};b.tap=function(a,b){b(a);return a};b.isEqual=function(a,b){return r(a,b,[])};b.isEmpty=
26 | function(a){if(a==null)return true;if(b.isArray(a)||b.isString(a))return a.length===0;for(var c in a)if(b.has(a,c))return false;return true};b.isElement=function(a){return!!(a&&a.nodeType==1)};b.isArray=p||function(a){return l.call(a)=="[object Array]"};b.isObject=function(a){return a===Object(a)};b.isArguments=function(a){return l.call(a)=="[object Arguments]"};b.isArguments(arguments)||(b.isArguments=function(a){return!(!a||!b.has(a,"callee"))});b.isFunction=function(a){return l.call(a)=="[object Function]"};
27 | b.isString=function(a){return l.call(a)=="[object String]"};b.isNumber=function(a){return l.call(a)=="[object Number]"};b.isFinite=function(a){return b.isNumber(a)&&isFinite(a)};b.isNaN=function(a){return a!==a};b.isBoolean=function(a){return a===true||a===false||l.call(a)=="[object Boolean]"};b.isDate=function(a){return l.call(a)=="[object Date]"};b.isRegExp=function(a){return l.call(a)=="[object RegExp]"};b.isNull=function(a){return a===null};b.isUndefined=function(a){return a===void 0};b.has=function(a,
28 | b){return K.call(a,b)};b.noConflict=function(){s._=I;return this};b.identity=function(a){return a};b.times=function(a,b,d){for(var e=0;e/g,">").replace(/"/g,""").replace(/'/g,"'").replace(/\//g,"/")};b.result=function(a,c){if(a==null)return null;var d=a[c];return b.isFunction(d)?d.call(a):d};b.mixin=function(a){j(b.functions(a),function(c){M(c,b[c]=a[c])})};var N=0;b.uniqueId=
29 | function(a){var b=N++;return a?a+b:b};b.templateSettings={evaluate:/<%([\s\S]+?)%>/g,interpolate:/<%=([\s\S]+?)%>/g,escape:/<%-([\s\S]+?)%>/g};var u=/.^/,n={"\\":"\\","'":"'",r:"\r",n:"\n",t:"\t",u2028:"\u2028",u2029:"\u2029"},v;for(v in n)n[n[v]]=v;var O=/\\|'|\r|\n|\t|\u2028|\u2029/g,P=/\\(\\|'|r|n|t|u2028|u2029)/g,w=function(a){return a.replace(P,function(a,b){return n[b]})};b.template=function(a,c,d){d=b.defaults(d||{},b.templateSettings);a="__p+='"+a.replace(O,function(a){return"\\"+n[a]}).replace(d.escape||
30 | u,function(a,b){return"'+\n_.escape("+w(b)+")+\n'"}).replace(d.interpolate||u,function(a,b){return"'+\n("+w(b)+")+\n'"}).replace(d.evaluate||u,function(a,b){return"';\n"+w(b)+"\n;__p+='"})+"';\n";d.variable||(a="with(obj||{}){\n"+a+"}\n");var a="var __p='';var print=function(){__p+=Array.prototype.join.call(arguments, '')};\n"+a+"return __p;\n",e=new Function(d.variable||"obj","_",a);if(c)return e(c,b);c=function(a){return e.call(this,a,b)};c.source="function("+(d.variable||"obj")+"){\n"+a+"}";return c};
31 | b.chain=function(a){return b(a).chain()};var m=function(a){this._wrapped=a};b.prototype=m.prototype;var x=function(a,c){return c?b(a).chain():a},M=function(a,c){m.prototype[a]=function(){var a=i.call(arguments);J.call(a,this._wrapped);return x(c.apply(b,a),this._chain)}};b.mixin(b);j("pop,push,reverse,shift,sort,splice,unshift".split(","),function(a){var b=k[a];m.prototype[a]=function(){var d=this._wrapped;b.apply(d,arguments);var e=d.length;(a=="shift"||a=="splice")&&e===0&&delete d[0];return x(d,
32 | this._chain)}});j(["concat","join","slice"],function(a){var b=k[a];m.prototype[a]=function(){return x(b.apply(this._wrapped,arguments),this._chain)}});m.prototype.chain=function(){this._chain=true;return this};m.prototype.value=function(){return this._wrapped}}).call(this);
33 |
--------------------------------------------------------------------------------