Herramientas de desarrollo¶
Los módulos descritos en este capítulo le ayudan a escribir software. Por ejemplo, el módulo pydoc toma un módulo y genera documentación basada en el contenido del módulo. Los módulos doctest y unittest contienen frameworks para escribir pruebas unitarias que ejecutan y validan automáticamente el código, verificando que se produce la salida esperada. 2to3 puede traducir el código fuente de Python 2.x en código válido de Python 3.x.
La lista de módulos descritos en este capítulo es:
typing— Soporte para type hints- Specification for the Python Type System
- Alias de tipo
- NewType
- Annotating callable objects
- Genéricos
- Annotating tuples
- The type of class objects
- Annotating generators and coroutines
- Tipos genéricos definidos por el usuario
- El tipo
Any - Subtipado nominal vs estructural
- Contenido del módulo
- Primitivos especiales de tipado
- Protocolos
- ABCs for working with IO
- Funciones y decoradores
- Ayudas de introspección
- Constantes
- Deprecated aliases
- Línea de tiempo de obsolescencia de características principales
pydoc— Documentation generator and online help system- Modo de desarrollo de Python
doctest— Test interactive Python examples- Uso simple: verificar ejemplos en docstrings
- Uso Simple: Verificar ejemplos en un Archivo de Texto
- Cómo funciona
- API básica
- API de unittest
- API avanzada
- Depuración
- Plataforma improvisada
unittest— Unit testing framework- Ejemplo sencillo
- Interfaz de línea de comandos
- Descubrimiento de pruebas
- Organización del código de pruebas
- Reutilización de código de prueba anterior
- Omitir tests y fallos esperados
- Distinguiendo iteraciones de tests empleando subtests
- Clases y funciones
- Casos de test
TestCasesetUp()tearDown()setUpClass()tearDownClass()run()skipTest()subTest()debug()assertEqual()assertNotEqual()assertTrue()assertFalse()assertIs()assertIsNot()assertIsNone()assertIsNotNone()assertIn()assertNotIn()assertIsInstance()assertNotIsInstance()assertRaises()assertRaisesRegex()assertWarns()assertWarnsRegex()assertLogs()assertNoLogs()assertAlmostEqual()assertNotAlmostEqual()assertGreater()assertGreaterEqual()assertLess()assertLessEqual()assertRegex()assertNotRegex()assertCountEqual()addTypeEqualityFunc()assertMultiLineEqual()assertSequenceEqual()assertListEqual()assertTupleEqual()assertSetEqual()assertDictEqual()fail()failureExceptionlongMessagemaxDiffcountTestCases()defaultTestResult()id()shortDescription()addCleanup()enterContext()doCleanups()addClassCleanup()enterClassContext()doClassCleanups()
IsolatedAsyncioTestCaseFunctionTestCase
- Agrupando tests
- Cargando y ejecutando tests
TestLoaderTestResulterrorsfailuresskippedexpectedFailuresunexpectedSuccessescollectedDurationsshouldStoptestsRunbufferfailfasttb_localswasSuccessful()stop()startTest()stopTest()startTestRun()stopTestRun()addError()addFailure()addSuccess()addSkip()addExpectedFailure()addUnexpectedSuccess()addSubTest()addDuration()
TextTestResultdefaultTestLoaderTextTestRunnermain()- load_tests protocolo
- Casos de test
- Instalaciones para clases y módulos
- Manejo de señales
unittest.mock— mock object library- Guía rápida
- La clase Mock
Mockassert_called()assert_called_once()assert_called_with()assert_called_once_with()assert_any_call()assert_has_calls()assert_not_called()reset_mock()mock_add_spec()attach_mock()configure_mock()__dir__()_get_child_mock()calledcall_countreturn_valueside_effectcall_argscall_args_listmethod_callsmock_calls__class__
NonCallableMockPropertyMockAsyncMock- Llamar a los objetos simulados
- Eliminar atributos
- Los nombres de los objetos simulados y el atributo name
- Adjuntar objetos simulados como atributos
- Parcheadores
- MagicMock y el soporte de métodos mágicos
- Ayudantes
- Order of precedence of
side_effect,return_valueand wraps
unittest.mock— getting started- Usando mock
- Métodos de parcheo mock
- Mock de llamadas a métodos sobre un objeto
- Clases de Mock
- Nombrando tus mocks
- Siguiendo todas las llamadas
- Establecer valores de retorno y atributos
- Generar excepciones con mocks
- Funciones de efectos secundarios e iterables
- Iteradores asincrónicos de Mocking
- El gestor de contexto asincrónico de Mocking
- Creando un mock desde un objeto existente
- Uso de side_effect para devolver el contenido por archivo
- Decoradores de Parches
- Otros ejemplos
- Mocking de llamadas encadenadas
- Mocking parcial
- Mocking de un método generador
- Aplicar el mismo parche a cada método de prueba
- Mocking de métodos sin enlazar
- Comprobación de varias llamadas con mock
- Copiando con argumentos mutables
- Anidando parches
- Mocking a un diccionario usando MagickMock
- Mock de subclases y sus atributos
- Importaciones de Mocking con patch.dict
- Seguimiento del orden de las llamadas y de las aserciones de llamadas menos detalladas
- Coincidencia de argumentos más compleja
- Usando mock
- 2to3 — Traducción automática de código de Python 2 a 3
test— Regression tests package for Pythontest.support— Utilidades para el conjunto de pruebas de PythonTestFailedResourceDeniedverboseis_jythonis_androidunix_shellLOOPBACK_TIMEOUTINTERNET_TIMEOUTSHORT_TIMEOUTLONG_TIMEOUTPGOPIPE_MAX_SIZEPy_DEBUGSOCK_MAX_SIZETEST_SUPPORT_DIRTEST_HOME_DIRTEST_DATA_DIRMAX_Py_ssize_tmax_memusereal_max_memuseMISSING_C_DOCSTRINGSHAVE_DOCSTRINGSTEST_HTTP_URLALWAYS_EQNEVER_EQLARGESTSMALLESTbusy_retry()sleeping_retry()is_resource_enabled()python_is_optimized()with_pymalloc()requires()sortdict()findfile()get_pagesize()setswitchinterval()check_impl_detail()set_memlimit()record_original_stdout()get_original_stdout()args_from_interpreter_flags()optim_args_from_interpreter_flags()captured_stdin()captured_stdout()captured_stderr()disable_faulthandler()gc_collect()disable_gc()swap_attr()swap_item()flush_std_streams()print_warning()wait_process()calcobjsize()calcvobjsize()checksizeof()anticipate_failure()system_must_validate_cert()run_with_locale()run_with_tz()requires_freebsd_version()requires_linux_version()requires_mac_version()requires_IEEE_754()requires_zlib()requires_gzip()requires_bz2()requires_lzma()requires_resource()requires_docstrings()requires_limited_api()cpython_only()impl_detail()no_tracing()refcount_test()bigmemtest()bigaddrspacetest()check_syntax_error()open_urlresource()reap_children()get_attribute()catch_unraisable_exception()load_package_tests()detect_api_mismatch()patch()run_in_subinterp()check_free_after_iterating()missing_compiler_executable()check__all__()skip_if_broken_multiprocessing_synchronize()check_disallow_instantiation()adjust_int_max_str_digits()SuppressCrashReportSaveSignalsMatcher
test.support.socket_helper— Utilidades para pruebas de sockettest.support.script_helper—Utilidades para las pruebas de ejecución de Pythontest.support.bytecode_helper— Herramientas de apoyo para comprobar la correcta generación de bytecodetest.support.threading_helper— Utilidades para pruebas con hilostest.support.os_helper— Utilidades para pruebas de sistemas operativosFS_NONASCIISAVEDCWDTESTFNTESTFN_NONASCIITESTFN_UNENCODABLETESTFN_UNDECODABLETESTFN_UNICODEEnvironmentVarGuardFakePathset()unset()can_symlink()can_xattr()change_cwd()create_empty_file()fd_count()fs_is_case_insensitive()make_bad_fd()rmdir()rmtree()skip_unless_symlink()skip_unless_xattr()temp_cwd()temp_dir()temp_umask()unlink()
test.support.import_helper— Utilidades para pruebas de importacióntest.support.warnings_helper— Utilidades para pruebas de advertencias