class_docstr: Group resources together.
  
  Namespace is to API what :class:`flask:flask.Blueprint` is for :class:`flask:flask.Flask`.
  
  :param str name: The namespace name
  :param str description: An optional short description
  :param str path: An optional prefix path. If not provided, prefix is ``/+name``
  :param list decorators: A list of decorators to apply to each resources
  :param bool validate: Whether or not to perform validation on this namespace
  :param bool ordered: Whether or not to preserve order on models and marshalling
  :param Api api: an optional API to attache to the namespace
class_docstr_tok: ["Group","resources","together",".","Namespace","is","to","API","what",":","class",":","`","flask",":","flask.Blueprint","`","is","for",":","class",":","`","flask",":","flask.Flask","`",".",":","param","str","name",":","The","namespace","name",":","param","str","description",":","An","optional","short","description",":","param","str","path",":","An","optional","prefix","path",".","If","not","provided",",","prefix","is","``","\/+name","``",":","param","list","decorators",":","A","list","of","decorators","to","apply","to","each","resources",":","param","bool","validate",":","Whether","or","not","to","perform","validation","on","this","namespace",":","param","bool","ordered",":","Whether","or","not","to","preserve","order","on","models","and","marshalling",":","param","Api","api",":","an","optional","API","to","attache","to","the","namespace"]
docstr: Register a Resource for a given API Namespace
  
  :param Resource resource: the resource ro register
  :param str urls: one or more url routes to match for the resource,
                   standard flask routing rules apply.
                   Any url variables will be passed to the resource method as args.
  :param str endpoint: endpoint name (defaults to :meth:`Resource.__name__.lower`
      Can be used to reference this route in :class:`fields.Url` fields
  :param list|tuple resource_class_args: args to be forwarded to the constructor of the resource.
  :param dict resource_class_kwargs: kwargs to be forwarded to the constructor of the resource.
  
  Additional keyword arguments not specified above will be passed as-is
  to :meth:`flask.Flask.add_url_rule`.
  
  Examples::
  
      namespace.add_resource(HelloWorld, '/', '/hello')
      namespace.add_resource(Foo, '/foo', endpoint="foo")
      namespace.add_resource(FooSpecial, '/special/foo', endpoint="foo")
docstr_tok: ["Register","a","Resource","for","a","given","API","Namespace",":","param","Resource","resource",":","the","resource","ro","register",":","param","str","urls",":","one","or","more","url","routes","to","match","for","the","resource",",","standard","flask","routing","rules","apply",".","Any","url","variables","will","be","passed","to","the","resource","method","as","args",".",":","param","str","endpoint",":","endpoint","name","(","defaults","to",":","meth",":","`","Resource.__name__.lower","`","Can","be","used","to","reference","this","route","in",":","class",":","`","fields.Url","`","fields",":","param","list|tuple","resource_class_args",":","args","to","be","forwarded","to","the","constructor","of","the","resource",".",":","param","dict","resource_class_kwargs",":","kwargs","to","be","forwarded","to","the","constructor","of","the","resource",".","Additional","keyword","arguments","not","specified","above","will","be","passed","as-is","to",":","meth",":","`","flask.Flask.add_url_rule","`",".","Examples",":",":","namespace.add_resource","(","HelloWorld",",","'\/","'",",","'\/hello","'",")","namespace.add_resource","(","Foo",",","'\/foo","'",",","endpoint=","''","foo","''",")","namespace.add_resource","(","FooSpecial",",","'\/special\/foo","'",",","endpoint=","''","foo","''",")"]
code: def add_resource(self, resource, *urls, **kwargs):
      """
      Register a Resource for a given API Namespace
  
      :param Resource resource: the resource ro register
      :param str urls: one or more url routes to match for the resource,
                       standard flask routing rules apply.
                       Any url variables will be passed to the resource method as args.
      :param str endpoint: endpoint name (defaults to :meth:`Resource.__name__.lower`
          Can be used to reference this route in :class:`fields.Url` fields
      :param list|tuple resource_class_args: args to be forwarded to the constructor of the resource.
      :param dict resource_class_kwargs: kwargs to be forwarded to the constructor of the resource.
  
      Additional keyword arguments not specified above will be passed as-is
      to :meth:`flask.Flask.add_url_rule`.
  
      Examples::
  
          namespace.add_resource(HelloWorld, '/', '/hello')
          namespace.add_resource(Foo, '/foo', endpoint="foo")
          namespace.add_resource(FooSpecial, '/special/foo', endpoint="foo")
      """
      route_doc = kwargs.pop("route_doc", {})
      self.resources.append(
          ResourceRoute(resource, urls, route_doc, kwargs)
      )
      for api in self.apis:
          ns_urls = api.ns_urls(self, urls)
          api.register_resource(self, resource, *ns_urls, **kwargs)
  
imports: from __future__ import unicode_literals
  import inspect
  import warnings
  import logging
  from collections import namedtuple
  import six
  from flask import request
  from flask.views import http_method_funcs
  from ._http import HTTPStatus
  from .errors import abort
  from .marshalling import marshal, marshal_with
  from .model import Model, OrderedModel, SchemaModel
  from .reqparse import RequestParser
  from .utils import merge
label_desc: Use image node_id 3 for calling the Namespace obj's underlying member method code with example usage: obj.add_resource(resource) without return types