class_docstr: A class for running communication with Neptune.
  
  In order to query Neptune experiments you need to instantiate this object first.
  
  Args:
      backend (:class:`~neptune.backend.ApiClient`, optional, default is ``None``):
          By default, Neptune client library sends logs, metrics, images, etc to Neptune servers:
          either publicly available SaaS, or an on-premises installation.
  
          You can pass the default backend instance explicitly to specify its parameters:
  
          .. code :: python3
  
              from neptune.legacy import Session, HostedNeptuneBackendApiClient
              session = Session(backend=HostedNeptuneBackendApiClient(...))
  
          Passing an instance of :class:`~neptune.OfflineApiClient` makes your code run without communicating
          with Neptune servers.
  
          .. code :: python3
  
              from neptune.legacy import Session, OfflineApiClient
              session = Session(backend=OfflineApiClient())
  
      api_token (:obj:`str`, optional, default is ``None``):
          User's API token. If ``None``, the value of ``NEPTUNE_API_TOKEN`` environment variable will be taken.
          Parameter is ignored if ``backend`` is passed.
  
          .. deprecated :: 0.4.4
  
          Instead, use:
  
          .. code :: python3
  
              from neptune.legacy import Session
              session = Session.with_default_backend(api_token='...')
  
      proxies (:obj:`str`, optional, default is ``None``):
          Argument passed to HTTP calls made via the `Requests <https://2.python-requests.org/en/master/>`_ library.
          For more information see their proxies
          `section <https://2.python-requests.org/en/master/user/advanced/#proxies>`_.
          Parameter is ignored if ``backend`` is passed.
  
          .. deprecated :: 0.4.4
  
          Instead, use:
  
          .. code :: python3
  
              from neptune.legacy import Session, HostedNeptuneBackendApiClient
              session = Session(backend=HostedNeptuneBackendApiClient(proxies=...))
  
  Examples:
  
      Create session, assuming you have created an environment variable ``NEPTUNE_API_TOKEN``
  
      .. code:: python3
  
          from neptune.legacy import Session
          session = Session.with_default_backend()
  
      Create session and pass ``api_token``
  
      .. code:: python3
  
          from neptune.legacy import Session
          session = Session.with_default_backend(api_token='...')
  
      Create an offline session
  
      .. code:: python3
  
          from neptune.legacy import Session, OfflineApiClient
          session = Session(backend=OfflineApiClient())
docstr: The simplest way to instantiate a ``Session``.
  
  Args:
      api_token (:obj:`str`):
          User's API token.
          If ``None``, the value of ``NEPTUNE_API_TOKEN`` environment variable will be taken.
  
      proxies (:obj:`str`, optional, default is ``None``):
          Argument passed to HTTP calls made via the `Requests <https://2.python-requests.org/en/master/>`_
          library.
          For more information see their proxies
          `section <https://2.python-requests.org/en/master/user/advanced/#proxies>`_.
  
  Examples:
  
      .. code :: python3
  
          from neptune.legacy import Session
          session = Session.with_default_backend()
code: def with_default_backend(cls, api_token=None, proxies=None):
      """The simplest way to instantiate a ``Session``.
  
      Args:
          api_token (:obj:`str`):
              User's API token.
              If ``None``, the value of ``NEPTUNE_API_TOKEN`` environment variable will be taken.
  
          proxies (:obj:`str`, optional, default is ``None``):
              Argument passed to HTTP calls made via the `Requests <https://2.python-requests.org/en/master/>`_
              library.
              For more information see their proxies
              `section <https://2.python-requests.org/en/master/user/advanced/#proxies>`_.
  
      Examples:
  
          .. code :: python3
  
              from neptune.legacy import Session
              session = Session.with_default_backend()
  
      """
      return cls(
          backend=HostedNeptuneBackendApiClient(
              api_token=api_token, proxies=proxies
          )
      )
  
file_path: neptune-client/src/neptune/legacy/sessions.py
imports: import logging
  from collections import OrderedDict
  from neptune.common.utils import assure_project_qualified_name
  from neptune.legacy.internal.api_clients import HostedNeptuneBackendApiClient
  from neptune.legacy.internal.utils.deprecation import legacy_client_deprecation
  from neptune.legacy.projects import Project
label_desc: Use image node_id 2 for calling the Session obj's underlying member method code with example usage: obj.with_default_backend(cls, api_token, proxies) and returns: cls