##########
Namespaces
##########

Reference
---------

* v4 API:

  + :class:`gitlab.v4.objects.Namespace`
  + :class:`gitlab.v4.objects.NamespaceManager`
  + :attr:`gitlab.Gitlab.namespaces`

* GitLab API: https://docs.gitlab.com/api/namespaces

Examples
--------

List namespaces::

    namespaces = gl.namespaces.list(get_all=True)

Search namespaces::

    namespaces = gl.namespaces.list(search='foo', get_all=True)

Get a namespace by ID or path::

  namespace = gl.namespaces.get("my-namespace")

Get existence of a namespace by path::

  namespace = gl.namespaces.exists("new-namespace")

  if namespace.exists:
      # get suggestions of namespaces that don't already exist
      print(namespace.suggests)