Coverage for sources/frigid/sequences.py: 100%

1# vim: set filetype=python fileencoding=utf-8: 

2# -*- coding: utf-8 -*- 

3 

4#============================================================================# 

5# # 

6# Licensed under the Apache License, Version 2.0 (the "License"); # 

7# you may not use this file except in compliance with the License. # 

8# You may obtain a copy of the License at # 

9# # 

10# http://www.apache.org/licenses/LICENSE-2.0 # 

11# # 

12# Unless required by applicable law or agreed to in writing, software # 

13# distributed under the License is distributed on an "AS IS" BASIS, # 

14# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # 

15# See the License for the specific language governing permissions and # 

16# limitations under the License. # 

17# # 

18#============================================================================# 

19 

20 

21''' Immutable sequences. ''' 

22 

23 

24from __future__ import annotations 

25 

26from . import __ 

27 

28 

29_V = __.typx.TypeVar( '_V' ) 

30 

31 

32def one( value: _V ) -> tuple[ _V, ... ]: 

33 ''' Produces single-item tuple from value. 

34 

35 Provides a more explicit and readable alternative to the comma-syntax 

36 for creating single-item tuples. While Python allows ``( x, )`` for 

37 creating single-item tuples, using ``one( x )`` can be clearer, 

38 especially in certain contexts: 

39 

40 * List comprehensions and generator expressions 

41 * Situations where formatter behavior with trailing commas is undesired 

42 ''' 

43 return value, # pylint: disable=trailing-comma-tuple