Fix documentation generation

docs/conf.py

@@ -62,7 +62,7 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = 'en'
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.

setup.cfg

@@ -2,4 +2,4 @@
 universal = 1
 
 [metadata]
-license_file = LICENSE.rst
+license_files = LICENSE.rst

src/drf_yasg/openapi.py

@@ -236,7 +236,7 @@ def __init__(self, info=None, _url=None, _prefix=None, _version=None, consumes=N
  security_definitions=None, security=None, paths=None, definitions=None, **extra):
  """Root Swagger object.
 
- :param .Info info: info object
+ :param Info info: info object
  :param str _url: URL used for setting the API host and scheme
  :param str _prefix: api path prefix to use in setting basePath; this will be appended to the wsgi
  SCRIPT_NAME prefix or Django's FORCE_SCRIPT_NAME if applicable
@@ -391,7 +391,7 @@ def __init__(self, type=None, format=None, enum=None, pattern=None, items=None,
  :param str format: value format, see OpenAPI spec
  :param list enum: restrict possible values
  :param str pattern: pattern if type is ``string``
- :param .Items items: only valid if `type` is ``array``
+ :param Items items: only valid if `type` is ``array``
  """
  super(Items, self).__init__(**extra)
  assert type is not None, "type is required!"
@@ -420,7 +420,7 @@ def __init__(self, name, in_, description=None, required=None, schema=None,
  :param str format: value format, see OpenAPI spec
  :param list enum: restrict possible values
  :param str pattern: pattern if type is ``string``
- :param .Items items: only valid if `type` is ``array``
+ :param Items items: only valid if `type` is ``array``
  :param default: default value if the parameter is not provided; must conform to parameter type
  """
  super(Parameter, self).__init__(**extra)
@@ -512,10 +512,10 @@ def __init__(self, resolver, name, scope, expected_type, ignore_unresolved=False
  """Base class for all reference types. A reference object has only one property, ``$ref``, which must be a JSON
  reference to a valid object in the specification, e.g. ``#/definitions/Article`` to refer to an article model.
 
- :param .ReferenceResolver resolver: component resolver which must contain the referneced object
+ :param ReferenceResolver resolver: component resolver which must contain the referneced object
  :param str name: referenced object name, e.g. "Article"
  :param str scope: reference scope, e.g. "definitions"
- :param type[.SwaggerDict] expected_type: the expected type that will be asserted on the object found in resolver
+ :param type[SwaggerDict] expected_type: the expected type that will be asserted on the object found in resolver
  :param bool ignore_unresolved: do not throw if the referenced object does not exist
  """
  super(_Ref, self).__init__()
@@ -530,7 +530,7 @@ def __init__(self, resolver, name, scope, expected_type, ignore_unresolved=False
  def resolve(self, resolver):
  """Get the object targeted by this reference from the given component resolver.
 
- :param .ReferenceResolver resolver: component resolver which must contain the referneced object
+ :param ReferenceResolver resolver: component resolver which must contain the referneced object
  :returns: the target object
  """
  ref_match = self.ref_name_re.match(self.ref)
@@ -549,7 +549,7 @@ class SchemaRef(_Ref):
  def __init__(self, resolver, schema_name, ignore_unresolved=False):
  """Adds a reference to a named Schema defined in the ``#/definitions/`` object.
 
- :param .ReferenceResolver resolver: component resolver which must contain the definition
+ :param ReferenceResolver resolver: component resolver which must contain the definition
  :param str schema_name: schema name
  :param bool ignore_unresolved: do not throw if the referenced object does not exist
  """
@@ -647,7 +647,7 @@ def with_scope(self, scope):
 
  :param str scope: target scope, must be in this resolver's `scopes`
  :return: the bound resolver
- :rtype: .ReferenceResolver
+ :rtype: ReferenceResolver
  """
  assert scope in self.scopes, "unknown scope %s" % scope
  ret = ReferenceResolver(force_init=True)

src/drf_yasg/views.py

@@ -51,7 +51,8 @@ def get_schema_view(info=None, url=None, patterns=None, urlconf=None, public=Fal
  generator_class=None, authentication_classes=None, permission_classes=None):
  """Create a SchemaView class with default renderers and generators.
 
- :param .Info info: information about the API; if omitted, defaults to :ref:`DEFAULT_INFO <default-swagger-settings>`
+ :param drf_yasg.openapi.Info info: information about the API; if omitted,
+ defaults to :ref:`DEFAULT_INFO <default-swagger-settings>`
  :param str url: same as :class:`.OpenAPISchemaGenerator`
  :param patterns: same as :class:`.OpenAPISchemaGenerator`
  :param urlconf: same as :class:`.OpenAPISchemaGenerator`

tox.ini

@@ -7,7 +7,8 @@ isolated_build_env = .package
 envlist =
  py{36,37,38,39}-django{22,30}-drf{310,311,312},
  py{36,37,38,39}-django{31,32}-drf{311,312},
- py38-{lint, docs},
+ lint,
+ docs,
  py39-djmaster
 
 skip_missing_interpreters = true