o 2.a!@sjddlZddlZddlmZddlmZddlmZddlmZddlmZddl m Z Gdd d Z dS) N)errors) get_meta_dir)METAFILE)get_current_context_name)#write_context_name_to_docker_config)Contextc@szeZdZdZeddZe  dddZeddd Zed d Z ed d Z edddZ eddZ edddZ dS) ContextAPIzfContext API. Contains methods for context management: create, list, remove, get, inspect. defaultswarmNFc Csv|std|dkrtdt|}|rt|d}|r&|dkr&|}t||}|j|||||d||S)aRCreates a new context. Returns: (Context): a Context object. Raises: :py:class:`docker.errors.MissingContextParameter` If a context name is not provided. :py:class:`docker.errors.ContextAlreadyExists` If a context with the name already exists. :py:class:`docker.errors.ContextException` If name is default. Example: >>> from docker.context import ContextAPI >>> ctx = ContextAPI.create_context(name='test') >>> print(ctx.Metadata) { "Name": "test", "Metadata": {}, "Endpoints": { "docker": { "Host": "unix:///var/run/docker.sock", "SkipTLSVerify": false } } } namer z$"default" is a reserved context namedockerr )skip_tls_verifyZ def_namespace)rMissingContextParameterContextExceptionr load_contextZContextAlreadyExistsZ set_endpointZsave) clsr Z orchestratorZhostZtls_cfgZdefault_namespacer ctxZendpointr4/usr/lib/python3/dist-packages/docker/context/api.pycreate_contexts(     zContextAPI.create_contextcCs"|st}|dkr |jSt|S)aRetrieves a context object. Args: name (str): The name of the context Example: >>> from docker.context import ContextAPI >>> ctx = ContextAPI.get_context(name='test') >>> print(ctx.Metadata) { "Name": "test", "Metadata": {}, "Endpoints": { "docker": { "Host": "unix:///var/run/docker.sock", "SkipTLSVerify": false } } } r )rDEFAULT_CONTEXTrr)rr rrr get_contextEs  zContextAPI.get_contextc Csg}ttD];\}}}||D]1}|tkrBztttj||}| |dWqt yA}z t d ||d}~wwqq|jg}|D] } | t| qJ|S)zContext list. Returns: (Context): List of context objects. Raises: :py:class:`docker.errors.APIError` If the server returns an error. NamezFailed to load metafile {}: {}N)oswalkrrjsonloadopenpathjoinappend Exceptionrrformatrrr) rnamesdirnamedirnamesfnamesfilenamedataecontextsr rrrr*as.   zContextAPI.contextscCs|S)z]Get current context. Returns: (Context): current context object. )r)rrrrget_current_context|szContextAPI.get_current_contextcCs8||}|s t|t|}|rtd|dS)NzFailed to set current context: )rrContextNotFoundrr)rr rerrrrrset_current_contexts  zContextAPI.set_current_contextcCsV|std|dkrtdt|}|st||tkr%td|dS)aYRemove a context. Similar to the ``docker context rm`` command. Args: name (str): The name of the context Raises: :py:class:`docker.errors.MissingContextParameter` If a context name is not provided. :py:class:`docker.errors.ContextNotFound` If a context with the name does not exist. :py:class:`docker.errors.ContextException` If name is default. Example: >>> from docker.context import ContextAPI >>> ContextAPI.remove_context(name='test') >>> r r z#context "default" cannot be removedN) rrrrrr,rrremoverr rrrrremove_contexts     zContextAPI.remove_contextcCs<|std|dkr|St|}|st||S)aRemove a context. Similar to the ``docker context inspect`` command. Args: name (str): The name of the context Raises: :py:class:`docker.errors.MissingContextParameter` If a context name is not provided. :py:class:`docker.errors.ContextNotFound` If a context with the name does not exist. Example: >>> from docker.context import ContextAPI >>> ContextAPI.remove_context(name='test') >>> r r )rrrrrr,r0rrrinspect_contexts   zContextAPI.inspect_context)NNNNF)N)r )__name__ __module__ __qualname____doc__rr classmethodrrr*r+r.r1r2rrrrr s&  1      r) rrr rZdocker.context.configrrrrZdocker.contextrrrrrrs