File manager - Edit - /home/newsbmcs.com/public_html/static/img/logo/is_attached.tar
Back
v1.py 0000644 00000011474 15030037224 0005447 0 ustar 00 import enum from typing import Optional, Tuple from uaclient.api.api import APIEndpoint from uaclient.api.data_types import AdditionalInfo from uaclient.config import UAConfig from uaclient.data_types import ( BoolDataValue, DataObject, Field, IntDataValue, StringDataValue, ) from uaclient.defaults import ( CONTRACT_EXPIRY_GRACE_PERIOD_DAYS, CONTRACT_EXPIRY_PENDING_DAYS, ) from uaclient.files import machine_token class IsAttachedResult(DataObject, AdditionalInfo): fields = [ Field( "is_attached", BoolDataValue, doc=( "True if the machine is attached to an Ubuntu Pro subscription" ), ), Field( "contract_status", StringDataValue, False, doc="Status of the Ubuntu Pro subscription", ), Field( "contract_remaining_days", IntDataValue, doc="Number of days left in the Ubuntu Pro subscription", ), Field( "is_attached_and_contract_valid", BoolDataValue, doc=( "True if the machine is attached to an Ubuntu Pro subscription" " and that subscription is not expired" ), ), ] def __init__( self, *, is_attached: bool, contract_status: Optional[str], contract_remaining_days: int, is_attached_and_contract_valid: bool ): self.is_attached = is_attached self.contract_status = contract_status self.contract_remaining_days = contract_remaining_days self.is_attached_and_contract_valid = is_attached_and_contract_valid @enum.unique class ContractExpiryStatus(enum.Enum): NONE = None ACTIVE = "active" ACTIVE_EXPIRED_SOON = "active-soon-to-expire" EXPIRED_GRACE_PERIOD = "grace-period" EXPIRED = "expired" def _get_contract_expiry_status( cfg: UAConfig, is_machine_attached: bool, remaining_days: Optional[int], ) -> Tuple[ContractExpiryStatus, int]: """Return a tuple [ContractExpiryStatus, num_days]""" if not is_machine_attached: return ContractExpiryStatus.NONE, 0 grace_period = CONTRACT_EXPIRY_GRACE_PERIOD_DAYS pending_expiry = CONTRACT_EXPIRY_PENDING_DAYS # if unknown assume the worst if remaining_days is None: return ContractExpiryStatus.EXPIRED, -grace_period if 0 <= remaining_days <= pending_expiry: return ContractExpiryStatus.ACTIVE_EXPIRED_SOON, remaining_days elif -grace_period <= remaining_days < 0: return ContractExpiryStatus.EXPIRED_GRACE_PERIOD, remaining_days elif remaining_days < -grace_period: return ContractExpiryStatus.EXPIRED, remaining_days return ContractExpiryStatus.ACTIVE, remaining_days def is_attached() -> IsAttachedResult: return _is_attached(UAConfig()) def _is_attached(cfg: UAConfig) -> IsAttachedResult: """ This endpoint shows if the machine is attached to a Pro subscription. """ machine_token_file = machine_token.get_machine_token_file(cfg) is_machine_attached = bool(machine_token_file.machine_token) contract_status, remaining_days = _get_contract_expiry_status( cfg, is_machine_attached, machine_token_file.contract_remaining_days ) is_attached_and_contract_valid = True if ( not is_machine_attached or contract_status == ContractExpiryStatus.EXPIRED ): is_attached_and_contract_valid = False return IsAttachedResult( is_attached=is_machine_attached, contract_status=contract_status.value, contract_remaining_days=remaining_days, is_attached_and_contract_valid=is_attached_and_contract_valid, ) endpoint = APIEndpoint( version="v1", name="IsAttached", fn=_is_attached, options_cls=None, ) _doc = { "introduced_in": "28", "requires_network": False, "example_python": """ from uaclient.api.u.pro.status.is_attached.v1 import is_attached result = is_attached() """, # noqa: E501 "result_class": IsAttachedResult, "exceptions": [], "example_cli": "pro api u.pro.status.is_attached.v1", "example_json": """ { "contract_remaining_days": 360, "contract_status": "active", "is_attached": true, "is_attached_and_contract_valid": true } """, "extra": """ .. tab-item:: Explanation :sync: explanation The ``contract_status`` field can return 4 different states, they are: * **active**: The contract is currently valid. * **grace-period**: The contract is in the grace period. This means that it is expired, but there are still some days where the contract will be valid. * **active-soon-to-expire**: The contract is almost expired, but still valid. * **expired**: The contract is expired and no longer valid. """, } __pycache__/__init__.cpython-310.pyc 0000644 00000000255 15030037224 0013212 0 ustar 00 o �ϴf � @ s d S )N� r r r �P/usr/lib/python3/dist-packages/uaclient/api/u/pro/status/is_attached/__init__.py�<module> s __pycache__/v1.cpython-310.pyc 0000644 00000007650 15030037224 0012007 0 ustar 00 o �(�f< � @ s d dl Z d dlmZmZ d dlmZ d dlmZ d dlm Z d dl m Z m Z m Z mZmZ d dlmZmZ d dlmZ G d d � d e e�Ze jG d d � d e j��Zd e dedee deeef fdd�Zdefdd�Z d e defdd�Z edde dd�Z ddd eg d d d d �Z dS )!� N)�Optional�Tuple)� APIEndpoint)�AdditionalInfo)�UAConfig)� BoolDataValue� DataObject�Field� IntDataValue�StringDataValue)�!CONTRACT_EXPIRY_GRACE_PERIOD_DAYS� CONTRACT_EXPIRY_PENDING_DAYS)� machine_tokenc @ s` e Zd Zededd�ededdd�ededd�ed ed d�gZdede e de d efd d �Z d S )�IsAttachedResult� is_attachedz=True if the machine is attached to an Ubuntu Pro subscription)�doc�contract_statusFz%Status of the Ubuntu Pro subscription�contract_remaining_daysz2Number of days left in the Ubuntu Pro subscription� is_attached_and_contract_validzbTrue if the machine is attached to an Ubuntu Pro subscription and that subscription is not expiredc C s || _ || _|| _|| _d S �N�r r r r )�selfr r r r � r �J/usr/lib/python3/dist-packages/uaclient/api/u/pro/status/is_attached/v1.py�__init__3 s zIsAttachedResult.__init__N) �__name__� __module__� __qualname__r r r r �fields�boolr �str�intr r r r r r s@ ����� ����r c @ s e Zd ZdZdZdZdZdZdS )�ContractExpiryStatusN�activezactive-soon-to-expirez grace-period�expired)r r r �NONE�ACTIVE�ACTIVE_EXPIRED_SOON�EXPIRED_GRACE_PERIOD�EXPIREDr r r r r" A s r" �cfg�is_machine_attached�remaining_days�returnc C s� |st jdfS t}t}|du rt j| fS d| kr |kr&n nt j|fS | | kr1dk r8n nt j|fS || k rBt j|fS t j|fS )z/Return a tuple [ContractExpiryStatus, num_days]r N)r" r% r r r) r' r( r& )r* r+ r, � grace_period�pending_expiryr r r �_get_contract_expiry_statusJ s r0 c C s t t� �S r )� _is_attachedr r r r r r c s r c C sN t �| �}t|j �}t| ||j�\}}d}|r |tjkr d}t||j||d�S )zO This endpoint shows if the machine is attached to a Pro subscription. TFr ) r �get_machine_token_filer r0 r r" r) r �value)r* �machine_token_filer+ r r, r r r r r1 g s �� �r1 �v1� IsAttached)�version�name�fn� options_cls�28FzZ from uaclient.api.u.pro.status.is_attached.v1 import is_attached result = is_attached() z#pro api u.pro.status.is_attached.v1z� { "contract_remaining_days": 360, "contract_status": "active", "is_attached": true, "is_attached_and_contract_valid": true } a� .. tab-item:: Explanation :sync: explanation The ``contract_status`` field can return 4 different states, they are: * **active**: The contract is currently valid. * **grace-period**: The contract is in the grace period. This means that it is expired, but there are still some days where the contract will be valid. * **active-soon-to-expire**: The contract is almost expired, but still valid. * **expired**: The contract is expired and no longer valid. )� introduced_in�requires_network�example_python� result_class� exceptions� example_cli� example_json�extra) �enum�typingr r �uaclient.api.apir �uaclient.api.data_typesr �uaclient.configr �uaclient.data_typesr r r r r �uaclient.defaultsr r �uaclient.filesr r �unique�Enumr" r r! r0 r r1 �endpoint�_docr r r r �<module> sJ ,��� �� � __init__.py 0000644 00000000000 15030037224 0006637 0 ustar 00
| ver. 1.4 |
Github
|
.
| PHP 8.2.28 | Generation time: 0.02 |
proxy
|
phpinfo
|
Settings