1. Línea de comando y entorno 1.1.1. Opciones de interfaz La interfaz del intérprete se asemeja a la del shell UNIX, pero proporciona algunos métodos adicionales de invocación: Cuando se llama con entrada estándar conectada a un dispositivo tty, solicita comandos y los ejecuta hasta que un EOF (un carácter de fin de archivo, Puede producir que con Ctrl-D en UNIX o Ctrl-Z, Enter en Windows) se lee. Cuando se llama con un argumento de nombre de archivo o con un archivo como entrada estándar, lee y ejecuta un script de ese archivo. Cuando se llama con un argumento de nombre de directorio, lee y ejecuta una secuencia de comandos apropiadamente nombrada desde ese directorio. Cuando se llama con el comando - c. Ejecuta la instrucción Python dada como comando. Aquí el comando puede contener varias declaraciones separadas por nuevas líneas. El espacio en blanco principal es significativo en las sentencias de Python Cuando se llama con - m nombre-módulo. El módulo dado se encuentra en la ruta del módulo Python y se ejecuta como un script. En modo no interactivo, toda la entrada se analiza antes de ejecutarse. Una opción de interfaz termina la lista de opciones consumidas por el intérprete, todos los argumentos consecutivos terminarán en sys. argv 8211 note que el primer elemento, subíndice cero (sys. argv0), es una cadena que refleja el origen del programa. Ejecute el comando Python en el comando. Comando puede ser una o más declaraciones separadas por líneas de nuevo, con un espacio en blanco significativo como en el código de módulo normal. Si se da esta opción, el primer elemento de sys. argv será quot-cquot y el directorio actual se añadirá al inicio de sys. path (permitiendo que módulos en ese directorio sean importados como módulos de nivel superior). Buscar sys. path para el módulo nombrado y ejecutar su contenido como el módulo principal. Dado que el argumento es un nombre de módulo, no debe dar una extensión de archivo (.py). El nombre del módulo debe ser un nombre de módulo Python válido, pero la implementación no siempre puede hacer cumplir esto (por ejemplo, puede permitirle usar un nombre que incluya un guión). Los nombres de paquetes también están permitidos. Cuando se proporciona un nombre de paquete en lugar de un módulo normal, el intérprete ejecutará ltpkggt. main como el módulo principal. Este comportamiento es deliberadamente similar al manejo de directorios y zipfiles que se pasan al intérprete como el argumento de secuencia de comandos. Esta opción no se puede utilizar con módulos incorporados y módulos de extensión escritos en C, ya que no tienen archivos de módulo Python. Sin embargo, todavía se puede utilizar para módulos precompilados, incluso si el archivo original de origen no está disponible. Si se da esta opción, el primer elemento de sys. argv será la ruta completa al archivo de módulo (mientras se localiza el archivo de módulo, el primer elemento se establecerá en quot-mquot). Al igual que con la opción - c, el directorio actual se añadirá al inicio de sys. path. Muchos módulos de biblioteca estándar contienen código que se invoca en su ejecución como un script. Un ejemplo es el módulo timeit: runpy. runmodule () Funcionalidad equivalente directamente disponible para el código Python PEP 338 8211 Ejecutar módulos como scripts Cambiado en la versión 3.1: Proporcione el nombre del paquete para ejecutar un submódulo principal. Leer los comandos de la entrada estándar (sys. stdin). Si la entrada estándar es un terminal, - i está implícito. Si se da esta opción, el primer elemento de sys. argv será quot-quot y el directorio actual se agregará al inicio de sys. path. Ejecutar el código Python contenido en la secuencia de comandos. Que debe ser una ruta del sistema de archivos (absoluta o relativa) que se refiere a un archivo Python, un directorio que contiene un archivo main. py o un archivo zip que contiene un archivo main. py. Si se da esta opción, el primer elemento de sys. argv será el nombre del script dado en la línea de comandos. Si el nombre del script se refiere directamente a un archivo Python, el directorio que contiene ese archivo se añade al inicio de sys. path. Y el archivo se ejecuta como el módulo principal. Si el nombre del script se refiere a un directorio o archivo zip, el nombre del script se agrega al inicio de sys. path y el archivo main. py en esa ubicación se ejecuta como el módulo principal. Si no se da ninguna opción de interfaz, - i está implícita, sys. argv0 es una cadena vacía (quotquot) y el directorio actual se añadirá al inicio de sys. path. Invocación del intérprete 1.1.2. Opciones genéricas Imprima una breve descripción de todas las opciones de la línea de comandos. Imprima el número de versión de Python y salga. Ejemplo de salida podría ser: 1.1.3. Otras opciones Emita una advertencia al comparar str y bytes. Emitir un error cuando la opción se da dos veces (-bb). Si se le da, Python won8217t intenta escribir archivos. pyc o. pyo en la importación de los módulos fuente. Véase también PYTHONDONTWRITEBYTECODE. Active la salida de depuración del analizador (solo para asistentes, según las opciones de compilación). Ver también PYTHONDEBUG. Ignorar todas las variables de entorno PYTHON, p. PITONPATO y PITONO. Que se puede establecer. Cuando se pasa un guión como primer argumento o se usa la opción - c, ingrese el modo interactivo después de ejecutar el script o el comando, incluso cuando sys. stdin no parece ser un terminal. El archivo PYTHONSTARTUP no se lee. Esto puede ser útil para inspeccionar variables globales o un seguimiento de pila cuando un script genera una excepción. Véase también PYTHONINSPECT. Active las optimizaciones básicas. Esto cambia la extensión de nombre de archivo para archivos compilados (bytecode) de. pyc a. pyo. Véase también PYTHONOPTIMIZE. Descarte docstrings además de las optimizaciones - O. Don8217t muestra los mensajes de copyright y de versión incluso en modo interactivo. Nuevo en la versión 3.2. Mantenido para la compatibilidad. En Python 3.3 y superior, la asignación aleatoria hash está activada de forma predeterminada. En versiones anteriores de Python, esta opción activa la aleatorización hash, de modo que los valores hash () de str, bytes y datetime son 8220salted8221 con un valor aleatorio impredecible. Aunque permanecen constantes dentro de un proceso Python individual, no son predecibles entre invocaciones repetidas de Python. La aleatorización del hash se piensa para proporcionar la protección contra una negación-de-servicio causada por los inputs cuidadosamente-elegidos que explotan el funcionamiento del peor caso de una construcción del dict, O (n2) complejidad. Vea ocert. org/advisories/ocert-2011-003.html para más detalles. PYTHONHASHSEED le permite establecer un valor fijo para el secreto de la semilla hash. Novedad en la versión 3.2.3. Don8217t agrega el directorio de paquetes de sitios de usuario a sys. path. PEP 370 8211 Desactivar la importación del sitio del módulo y las manipulaciones dependientes del sitio de sys. path que conlleva. También deshabilite estas manipulaciones si el sitio se importa explícitamente más tarde (llame a site. main () si desea que se activen). Forzar la capa binaria de stdout y stderr arroyos (que está disponible como su atributo de búfer) para ser unbuffered. La capa de E / S de texto seguirá estando en búfer de línea si escribe en la consola o se almacenará en búfer de bloque si se redirige a un archivo no interactivo. Ver también PYTHONUNBUFFERED. Imprima un mensaje cada vez que se inicialice un módulo, mostrando el lugar (nombre de archivo o módulo incorporado) desde el que se ha cargado. Cuando se da dos veces (-vv), imprima un mensaje para cada archivo que se comprueba cuando se busca un módulo. También proporciona información sobre la limpieza del módulo en la salida. Véase también PYTHONVERBOSE. Control de advertencia. Maquinaria de advertencia Python8217s por defecto imprime mensajes de advertencia a sys. stderr. Un mensaje de advertencia típico tiene el siguiente formulario: De forma predeterminada, cada advertencia se imprime una vez para cada línea de origen donde se produce. Esta opción controla la frecuencia con la que se imprimen las advertencias. Pueden darse varias opciones - W cuando una advertencia coincide con más de una opción, se realiza la acción para la última opción coincidente. Las opciones - W no válidas se ignoran (aunque se imprime un mensaje de advertencia sobre las opciones no válidas cuando se emite la primera advertencia). Las advertencias también se pueden controlar desde un programa Python utilizando el módulo de advertencias. La forma más simple de argumento es una de las siguientes cadenas de acción (o una abreviatura única): ignore Ignora todas las advertencias. Default Solicitar explícitamente el comportamiento predeterminado (imprimir cada advertencia una vez por línea de origen). All Imprime una advertencia cada vez que se produce (esto puede generar muchos mensajes si se activa una advertencia repetidamente para la misma línea de origen, como dentro de un bucle). Module Imprimir cada advertencia sólo la primera vez que ocurre en cada módulo. Una vez Imprima cada advertencia sólo la primera vez que ocurre en el programa. Error Aumentar una excepción en lugar de imprimir un mensaje de advertencia. La forma completa del argumento es: Aquí, la acción es como se explicó anteriormente, pero sólo se aplica a los mensajes que coinciden con los campos restantes. Los campos vacíos coinciden con todos los valores y los campos vacíos pueden omitirse. El campo de mensaje coincide con el inicio del mensaje de advertencia impreso, este enlace no distingue entre mayúsculas y minúsculas. El campo de categoría coincide con la categoría de advertencia. Éste debe ser un nombre de clase el partido comprueba si la categoría de advertencia real del mensaje es una subclase de la categoría de advertencia especificada. El nombre completo de la clase debe ser dado. El campo del módulo coincide con el nombre del módulo (totalmente cualificado), este cambio es sensible a mayúsculas y minúsculas. El campo de línea coincide con el número de línea, donde cero coincide con todos los números de línea y es, por lo tanto, equivalente a un número de línea omitido. Advertencias 8211 el módulo de advertencias PEP 230 8211 Marco de advertencia Omita la primera línea de la fuente, permitiendo el uso de formas no-Unix de cmd. Esto está pensado para un hack específico de DOS solamente. Los números de línea en los mensajes de error se desactivarán en uno. Reservado para varias opciones específicas de implementación. CPython actualmente define sólo uno, puede utilizar - X faulthandler para habilitar faulthandler. También permite pasar valores arbitrarios y recuperarlos a través del diccionario sys. xoptions. Cambiado en la versión 3.2: Ahora se permite pasar - X con CPython. Nuevo en la versión 3.3: La opción - X faulthandler. 1.1.4. Opciones que no debe utilizarse Reservado para su uso por Jython. 1.2. Variables de entorno Estas variables de entorno influyen en el comportamiento de Python8217s, se procesan antes de los modificadores de la línea de comandos que no sean - E. Es habitual que los modificadores de línea de comandos anulen las variables ambientales donde hay un conflicto. Cambiar la ubicación de las bibliotecas estándar de Python. De forma predeterminada, las bibliotecas se buscan en la versión prefix / lib / python y en la versión execprefix / lib / python. Donde prefix y execprefix son directorios dependientes de la instalación, ambos predeterminados en / usr / local. Cuando PYTHONHOME se establece en un único directorio, su valor reemplaza prefijo y execprefix. Para especificar valores diferentes para estos, configure PYTHONHOME como prefijo. Execprefix. Aumente la ruta de búsqueda predeterminada para los archivos de módulo. El formato es el mismo que el shell8217s PATH. Uno o más nombres de rutas de directorio separados por os. pathsep (por ejemplo, dos puntos en Unix o punto y coma en Windows). Los directorios inexistentes se ignoran en silencio. Además de los directorios normales, las entradas individuales de PYTHONPATH pueden referirse a archivos zip que contienen módulos Python puros (en fuente o en forma compilada). Los módulos de extensión no se pueden importar desde archivos zip. La ruta de búsqueda predeterminada depende de la instalación, pero generalmente comienza con la versión prefix / lib / python (véase PYTHONHOME anterior). Siempre se anexa a PYTHONPATH. Un directorio adicional se insertará en la ruta de búsqueda delante de PYTHONPATH como se describe arriba en Opciones de interfaz. La ruta de búsqueda se puede manipular desde un programa Python como la variable sys. path. Si este es el nombre de un archivo legible, los comandos de Python en ese archivo se ejecutan antes de que se muestre el primer indicador en modo interactivo. El archivo se ejecuta en el mismo espacio de nombres donde se ejecutan comandos interactivos para que los objetos definidos o importados en él puedan utilizarse sin calificación en la sesión interactiva. También puede cambiar las solicitudes sys. ps1 y sys. ps2 en este archivo. Establezca esto en una cadena no vacía para que el módulo de tiempo requiera las fechas especificadas como cadenas para incluir años de 4 dígitos, de lo contrario los años de 2 dígitos se convierten según las reglas descritas en la documentación del módulo de tiempo. Si se establece en una cadena no vacía, es equivalente a especificar la opción - O. Si se establece en un entero, es equivalente a especificar - O varias veces. Si se establece en una cadena no vacía, es equivalente a especificar la opción - d. Si se establece en un entero, es equivalente a especificar - d varias veces. Si se establece en una cadena no vacía, es equivalente a especificar la opción - i. Esta variable también se puede modificar mediante código Python usando os. environ para forzar el modo de inspección en la terminación del programa. Si se establece en una cadena no vacía, es equivalente a especificar la opción - u. Si se establece en una cadena no vacía, es equivalente a especificar la opción - v. Si se establece en un entero, es equivalente a especificar - v varias veces. Si esto se establece, Python ignora el caso en las instrucciones de importación. Esto sólo funciona en Windows y OS X. Si se establece esto, Python won8217t intenta escribir archivos. pyc o. pyo en la importación de módulos fuente. Esto equivale a especificar la opción - B. Si esta variable no está configurada o configurada como aleatoria. Se utiliza un valor aleatorio para sembrar los hashes de str, bytes y objetos de fecha y hora. Si PYTHONHASHSEED se establece en un valor entero, se utiliza como una semilla fija para generar el hash () de los tipos cubiertos por la aleatorización hash. Su propósito es permitir el hashing repetible, tal como para los autotests para el propio intérprete, o permitir que un grupo de procesos de python comparta valores de hash. El número entero debe ser un número decimal en el rango 0,4294967295. Al especificar el valor 0, se inhabilitará la aleatorización de hash. Nuevo en la versión 3.2.3. Si está configurado antes de ejecutar el intérprete, reemplaza la codificación utilizada para stdin / stdout / stderr, en la sintaxis encodingname: errorhandler. La parte: errorhandler es opcional y tiene el mismo significado que en str. encode (). Para stderr, la parte: errorhandler se ignora el manejador siempre será backslashreplace. Si se establece esto, Python won8217t agrega el directorio user-packages a sys. path. PEP 370 8211 Por usuario directorio de paquetes de sitio Define el directorio de base de usuarios. Que se utiliza para calcular la ruta del directorio de paquetes de sitios de usuario y rutas de instalación de Distutils para python setup. py install --user. PEP 370 8211 Por usuario sitio-paquetes directorio Si esta variable de entorno se establece, sys. argv0 se establecerá en su valor en lugar del valor obtenido a través del tiempo de ejecución C. Sólo funciona en Mac OS X. Esto es equivalente a la opción - W. Si se establece en una cadena separada por comas, es equivalente a especificar - W varias veces. Si se establece esta variable de entorno, se llama a faulthandler. enable () en el arranque: instale un manejador para SIGSEGV. SIGFPE. SIGABRT. SIGBUS y señales SIGILL para volcar el traceback de Python. Esto es equivalente a la opción - X faulthandler. Nuevo en la versión 3.3. 1.2.1. Variables de modo de depuración La configuración de estas variables sólo tiene un efecto en una compilación de depuración de Python, es decir, si Python se configuró con la opción de compilación --with-pydebug. Si se establece, Python imprimirá información de depuración de subprocesos. Si se establece, Python descargará objetos y los recuentos de referencia seguirán activos después de cerrar el intérprete. Si se establece, Python imprimirá estadísticas de asignación de memoria cada vez que se cree un nuevo área de objetos, y al apagarse.16.2. Io 8212 Herramientas básicas para trabajar con corrientes 16.2.1. Descripción general El módulo io proporciona las principales instalaciones de Python8217 para tratar con diversos tipos de E / S. Existen tres tipos principales de E / S: E / S de texto. E / S binaria y E / S sin procesar. Estas son categorías genéricas, y se pueden usar varios almacenes de respaldo para cada uno de ellos. Un objeto concreto perteneciente a cualquiera de estas categorías se denomina objeto de archivo. Otros términos comunes son flujo y archivo-como objeto. Independientemente de su categoría, cada objeto de flujo de concreto también tendrá varias capacidades: puede ser de sólo lectura, escribir sólo o leer y escribir. También puede permitir acceso aleatorio arbitrario (buscar hacia delante o hacia atrás en cualquier ubicación), o sólo acceso secuencial (por ejemplo, en el caso de un zócalo o tubería). Todos los arroyos son cuidadosos con el tipo de datos que les das. Por ejemplo, dar un objeto str al método write () de un flujo binario elevará un TypeError. Por lo tanto, dará un objeto bytes al método write () de un flujo de texto. Cambiado en la versión 3.3: Las operaciones que se utilizan para aumentar IOError ahora aumentan OSError. Ya que IOError es ahora un alias de OSError. 16.2.1.1. Text I / O Text I / O espera y produce objetos str. Esto significa que cada vez que el almacén de respaldo se compone de bytes nativos (como en el caso de un archivo), la codificación y decodificación de datos se hace de forma transparente, así como la traducción opcional de caracteres de nueva línea específicos de la plataforma. La forma más fácil de crear un flujo de texto es con open (). Opcionalmente especificando una codificación: Los flujos de texto en memoria también están disponibles como objetos StringIO: El API de flujo de texto se describe en detalle en la documentación de TextIOBase. 16.2.1.2. E / S binaria E / S binaria (también llamada E / S almacenada en buffer) espera bytes-como objetos y produce bytes de objetos. No se realiza ninguna codificación, descodificación o traducción de nueva línea. Esta categoría de flujos puede usarse para todo tipo de datos que no son de texto, y también cuando se desea un control manual sobre el manejo de datos de texto. La forma más sencilla de crear un flujo binario es con open () con b en la cadena de modo: Los flujos binarios en memoria también están disponibles como objetos BytesIO: El API de flujo binario se describe en detalle en los documentos de BufferedIOBase. Otros módulos de biblioteca pueden proporcionar formas adicionales de crear flujos de texto o binarios. Vea socket. socket. makefile () por ejemplo. 16.2.1.3. Raw I / O Raw I / O (también llamada unbuffered I / O) se utiliza generalmente como un bloque de construcción de bajo nivel para los flujos de texto binario y de texto que rara vez es útil para manipular directamente un flujo bruto desde el código de usuario. Sin embargo, puede crear un flujo sin procesar abriendo un archivo en modo binario con deshabilitado el búfer: El API de flujo sin procesar se describe en detalle en los documentos de RawIOBase. 16.2.2. Interfaz de módulo de alto nivel Un int que contiene el tamaño de búfer predeterminado utilizado por las clases de E / S almacenadas en el módulo 8217s. Open () utiliza el fichero 8217s blksize (obtenido por os. stat ()) si es posible. Este es un alias para la función open () incorporada. Excepción io. BlockingIOError Este es un alias de compatibilidad para la excepción BlockingIOError incorporada. Excepción io. UnsupportedOperation Una excepción que hereda OSError y ValueError que se genera cuando se llama a una operación no admitida en una secuencia. 16.2.2.1. Flujos en memoria También es posible utilizar un objeto str o bytes como un archivo para lectura y escritura. Para cadenas StringIO se puede utilizar como un archivo abierto en modo texto. BytesIO se puede utilizar como un archivo abierto en modo binario. Ambos ofrecen capacidades de lectura-escritura completas con acceso aleatorio. 16.2.3. Jerarquía de clases La implementación de los flujos de E / S se organiza como una jerarquía de clases. Primeras clases de base abstracta (ABCs), que se utilizan para especificar las diversas categorías de flujos, a continuación, las clases concretas que proporcionan las implementaciones de flujo estándar. Las clases base abstractas también proporcionan implementaciones por defecto de algunos métodos para ayudar a la implementación de clases de flujo concretas. Por ejemplo, BufferedIOBase proporciona implementaciones sin optimizar de readinto () y readline (). En la parte superior de la jerarquía de E / S está la clase base abstracta IOBase. Define la interfaz básica de un flujo. Tenga en cuenta, sin embargo, que no hay separación entre la lectura y la escritura a los flujos de implementaciones se les permite subir UnsupportedOperation si no admiten una operación determinada. El RawIOBase ABC extiende IOBase. Se ocupa de la lectura y escritura de bytes a una corriente. FileIO subclases RawIOBase para proporcionar una interfaz a los archivos en el sistema de archivos machine8217s. El BufferedIOBase ABC trata de almacenar en búfer en un flujo de bytes sin procesar (RawIOBase). Sus subclases, BufferedWriter. BufferedReader. Y BufferedRWPair que son legibles, escritura, y tanto legible como escribible. BufferedRandom proporciona una interfaz almacenada en búfer a las corrientes de acceso aleatorio. Otra subclase BufferedIOBase, BytesIO. Es un flujo de bytes en memoria. El TextIOBase ABC, otra subclase de IOBase. Trata de los flujos cuyos bytes representan el texto, y maneja la codificación y decodificación hacia y desde las cadenas. TextIOWrapper. Que lo extiende, es una interfaz de texto almacenado en búfer a un flujo bruto almacenado en búfer (BufferedIOBase). Por último, StringIO es un flujo en memoria para texto. Los nombres de argumento no forman parte de la especificación, y sólo los argumentos de open () están destinados a ser utilizados como argumentos de palabras clave. La tabla siguiente resume los ABC proporcionados por el módulo io: 16.2.3.1. Clases base de E / S La clase base abstracta para todas las clases de E / S, que actúan sobre flujos de bytes. No hay constructor público. Esta clase proporciona implementaciones abstractas vacías para muchos métodos que las clases derivadas pueden anular selectivamente las implementaciones predeterminadas representan un archivo que no se puede leer, escribir o buscar. Aunque IOBase no declare read (). Readinto (). O write () porque sus firmas variarán, las implementaciones y los clientes deberían considerar esos métodos como parte de la interfaz. Además, las implementaciones pueden generar un ValueError (o UnsupportedOperation) cuando se llaman operaciones que no soportan. El tipo básico utilizado para los datos binarios leídos o escritos en un archivo es bytes. Otros objetos como bytes se aceptan como argumentos de método también. En algunos casos, como readinto (). Se requiere un objeto escribible tal como bytearray. Las clases de E / S de texto funcionan con datos str. Tenga en cuenta que llamar a cualquier método (incluso consultas) en un flujo cerrado no está definido. Las implementaciones pueden aumentar ValueError en este caso. IOBase (y sus subclases) soporta el protocolo iterador, lo que significa que un objeto IOBase puede iterarse sobre el rendimiento de las líneas en un flujo. Las líneas se definen de forma ligeramente diferente dependiendo de si el flujo es un flujo binario (cediendo bytes) o un flujo de texto (que produce cadenas de caracteres). Ver readline () debajo. IOBase también es un gestor de contexto y, por tanto, soporta la sentencia with. En este ejemplo, el archivo se cierra después de que se complete el conjunto with statement8217s8212, incluso si se produce una excepción: IOBase proporciona estos atributos y métodos de datos: Rinde y cierre este flujo. Este método no tiene ningún efecto si el archivo ya está cerrado. Una vez que el archivo se cierra, cualquier operación en el archivo (por ejemplo, la lectura o la escritura) elevará un ValueError. Como conveniencia, se le permite llamar a este método más de una vez sólo la primera llamada, sin embargo, tendrá un efecto. Verdad si el flujo está cerrado. Devuelve el descriptor de archivo subyacente (un entero) del flujo si existe. Se genera un OSError si el objeto IO no utiliza un descriptor de archivo. Rinde los búferes de escritura del flujo, si corresponde. Esto no hace nada para los flujos de sólo lectura y no bloqueadores. Devuelve True si el flujo es interactivo (es decir, conectado a un terminal / dispositivo tty). Devuelve True si se puede leer el flujo. Si es falso. Read () elevará OSError. Lee y devuelve una línea del flujo. Si se especifica el tamaño, se leerán como máximo los bytes de tamaño. El terminador de línea siempre es bn para archivos binarios para archivos de texto, el argumento newline a open () puede usarse para seleccionar el terminador de línea reconocido. Lee y devuelve una lista de líneas de la secuencia. Se puede especificar una indirecta para controlar el número de líneas leídas: no se leerán más líneas si el tamaño total (en bytes / caracteres) de todas las líneas supera hasta ahora la sugerencia. Tenga en cuenta que it8217s ya es posible iterar en los objetos de archivo utilizando para la línea en el archivo. Sin llamar a file. readlines (). Cambie la posición del flujo al desplazamiento de bytes dado. Offset se interpreta con respecto a la posición indicada por donde. El valor por defecto de whence es SEEKSET. Los valores de donde son: SEEKSET o 0 8211 inicio de la corriente (el valor por defecto) el desplazamiento debe ser cero o positivo SEEKCUR o 1 8211 corriente corriente posición desplazamiento puede ser negativo SEEKEND o 2 8211 final de la secuencia de desplazamiento es generalmente negativo Volver el nuevo absoluto posición. Nuevo en la versión 3.1: Las constantes SEEK. Nuevo en la versión 3.3: Algunos sistemas operativos podrían admitir valores adicionales, como os. SEEKHOLE o os. SEEKDATA. Los valores válidos para un archivo podrían depender de que esté abierto en modo texto o binario. Devuelve True si el flujo es compatible con acceso aleatorio. Si es falso. buscar(). Tell () y truncate () elevará OSError. Devuelve la posición del flujo actual. Cambie el tamaño del flujo al tamaño especificado en bytes (o la posición actual si no se especifica el tamaño). La posición actual del flujo no ha cambiado. Este cambio de tamaño puede ampliar o reducir el tamaño del archivo actual. En caso de extensión, el contenido del nuevo área de archivo depende de la plataforma (en la mayoría de los sistemas, los bytes adicionales están cero). Se devuelve el nuevo tamaño del archivo. Cambiado en la versión 3.5: Windows ahora cero-rellenar archivos al extender. Devuelve True si el flujo es compatible con la escritura. Si es falso. Write () y truncate () elevará OSError. Escribe una lista de líneas en la secuencia. No se agregan separadores de línea, por lo que es habitual que cada línea provista tenga un separador de línea al final. Prepárese para la destrucción de objetos. IOBase proporciona una implementación predeterminada de este método que llama al método close () de instance8217s. Clase base para la E / S binaria sin procesar. Hereda IOBase. No hay constructor público. Normalmente, la E / S binaria brinda acceso de bajo nivel a un dispositivo o API de SO subyacente, y no intenta encapsularlo en primitivas de alto nivel (esto se deja en la E / S de Buffered y en la E / S de texto, descrita más adelante en este página). Además de los atributos y métodos de IOBase. RawIOBase proporciona los siguientes métodos: Leer hasta el tamaño de los bytes del objeto y devolverlos. Como conveniencia, si el tamaño no es especificado o -1, readall () se llama. De lo contrario, sólo se realizará una llamada de sistema. Menos de tamaño bytes se pueden devolver si la llamada al sistema operativo devuelve menos de tamaño bytes. Si se devuelven 0 bytes y el tamaño no es 0, esto indica el final del archivo. Si el objeto está en modo sin bloqueo y no hay bytes disponibles, se devuelve None. Lea y devuelva todos los bytes de la secuencia hasta EOF, utilizando varias llamadas a la secuencia si es necesario. Lectura de bytes en un objeto pre-asignado, con capacidad de escribir bytes b. Y devuelve el número de bytes leídos. Si el objeto está en modo sin bloqueo y no hay bytes disponibles, se devuelve None. Escriba el objeto de tipo bytes dado. B. Al flujo primario subyacente, y devuelve el número de bytes escritos. Esto puede ser menor que la longitud de bytes en bytes, dependiendo de los detalles del flujo subyacente, y especialmente si está en modo no bloqueado. Ninguno se devuelve si el flujo en bruto se establece para no bloquear y no se puede escribir fácilmente en él ningún byte. El llamador puede liberar o mutate b después de que este método devuelve, por lo que la implementación sólo debe tener acceso b durante la llamada al método. Clase io. BufferedIOBase Clase base para flujos binarios que admiten algún tipo de almacenamiento en búfer. Hereda IOBase. No hay constructor público. La principal diferencia con RawIOBase es que los métodos read (). Readinto () y write () intentarán (respectivamente) leer tanto entrada como pidió o consumir toda la salida dada, a expensas de hacer quizás más que una llamada de sistema. Además, estos métodos pueden generar BlockingIOError si el flujo subyacente subyacente está en modo no bloqueador y no puede tomar o dar datos suficientes a diferencia de sus equivalentes RawIOBase, nunca devolverá None. Además, el método read () no tiene una implementación predeterminada que difiere a readinto (). Una implementación típica de BufferedIOBase no debe heredar de una implementación de RawIOBase, pero envolver una, como BufferedWriter y BufferedReader. BufferedIOBase proporciona o reemplaza estos métodos y atributo además de los de IOBase: El flujo subyacente subyacente (una instancia de RawIOBase) que BufferedIOBase trata. Esto no es parte de la API BufferedIOBase y puede no existir en algunas implementaciones. Separar el flujo bruto subyacente del búfer y devolverlo. Después de separar el flujo sin procesar, el buffer está en un estado inutilizable. Algunos búferes, como BytesIO. No tienen el concepto de un solo flujo sin procesar para volver de este método. Suben UnsupportedOperation. Nuevo en la versión 3.1. Lea y regrese hasta tamaño bytes. Si se omite el argumento, Ninguno. O negativa, los datos se leen y se devuelven hasta que se alcanza EOF. Se devuelve un objeto bytes vacío si el flujo ya está en EOF. Si el argumento es positivo y el flujo crudo subyacente no es interactivo, se pueden emitir varias lecturas sin procesar para satisfacer el recuento de bytes (a menos que se alcance primero EOF). Pero para los flujos crudos interactivos, se emitirá como máximo una lectura en bruto y un resultado corto no implica que el EOF sea inminente. Un BlockingIOError se incrementa si el flujo subyacente está en modo no bloqueante y no tiene datos disponibles en este momento. Lee y devuelve hasta el tamaño de bytes, con como máximo una llamada al método raw raw8217s read () (o readinto ()) subyacente. Esto puede ser útil si está implementando su propio búfer en la parte superior de un objeto BufferedIOBase. Lea los bytes en un objeto b de bytes con escritura preasignado y devuelva el número de bytes leídos. Como leer (). Se pueden emitir varias lecturas al flujo primario subyacente, a menos que éste último sea interactivo. Un BlockingIOError se incrementa si el flujo subyacente está en modo no bloqueante y no tiene datos disponibles en este momento. Lectura de bytes en un objeto pre-asignado, con capacidad de escribir bytes b. Utilizando como máximo una llamada al método raw () de rawstream8217s (o readinto ()) subyacente. Devuelve el número de bytes leídos. Un BlockingIOError se incrementa si el flujo subyacente está en modo no bloqueante y no tiene datos disponibles en este momento. Nuevo en la versión 3.5. Escriba el objeto de tipo bytes dado. B. Y devuelve el número de bytes escritos (siempre igual a la longitud de b en bytes, ya que si la escritura falla se generará un OSError). Dependiendo de la implementación real, estos bytes se pueden escribir fácilmente en el flujo subyacente, o mantenerse en un búfer por razones de rendimiento y latencia. Cuando está en modo no bloqueante, se genera un error de bloqueo si los datos necesitan ser escritos en el flujo crudo pero no puede aceptar todos los datos sin bloquearlos. El llamador puede liberar o mutate b después de que este método devuelve, por lo que la implementación sólo debe tener acceso b durante la llamada al método. 16.2.3.2. RAW File I / O FileIO representa un archivo de nivel OS que contiene datos de bytes. Implementa la interfaz RawIOBase (y por lo tanto la interfaz IOBase, también). El nombre puede ser una de dos cosas: una cadena de caracteres o un objeto de bytes que representa la ruta al archivo que se abrirá. En este caso, closefd debe ser True (el valor predeterminado), de lo contrario se generará un error. Un número entero que representa el número de un descriptor de archivo de nivel OS existente al que dará acceso el objeto FileIO resultante. Cuando el objeto FileIO está cerrado, este fd también se cerrará, a menos que closefd esté establecido en False. El modo puede ser r. W X o a para lectura (predeterminado), escritura, creación exclusiva o adición. El archivo se creará si no existe cuando se abre para escribir o agregar, se truncará cuando se abra para escribir. FileExistsError se aumentará si ya existe cuando se abre para crear. Abrir un archivo para crear implica escribir, por lo que este modo se comporta de manera similar a w. Agregue a al modo para permitir la lectura y escritura simultáneas. The read() (when called with a positive argument), readinto() and write() methods on this class will only make one system call. A custom opener can be used by passing a callable as opener . The underlying file descriptor for the file object is then obtained by calling opener with ( name . flags ). opener must return an open file descriptor (passing os. open as opener results in functionality similar to passing None ). See the open() built-in function for examples on using the opener parameter. Changed in version 3.3: The opener parameter was added. The x mode was added. Changed in version 3.4: The file is now non-inheritable. In addition to the attributes and methods from IOBase and RawIOBase. FileIO provides the following data attributes: The mode as given in the constructor. The file name. This is the file descriptor of the file when no name is given in the constructor. 16.2.3.3. Buffered Streams Buffered I/O streams provide a higher-level interface to an I/O device than raw I/O does. A stream implementation using an in-memory bytes buffer. It inherits BufferedIOBase. The buffer is discarded when the close() method is called. The optional argument initialbytes is a bytes-like object that contains initial data. BytesIO provides or overrides these methods in addition to those from BufferedIOBase and IOBase : Return a readable and writable view over the contents of the buffer without copying them. Also, mutating the view will transparently update the contents of the buffer: As long as the view exists, the BytesIO object cannot be resized or closed. New in version 3.2. Return bytes containing the entire contents of the buffer. In BytesIO. this is the same as read() . In BytesIO. this is the same as readinto() . New in version 3.5. class io. BufferedReader ( raw . buffersizeDEFAULTBUFFERSIZE ) A buffer providing higher-level access to a readable, sequential RawIOBase object. It inherits BufferedIOBase. When reading data from this object, a larger amount of data may be requested from the underlying raw stream, and kept in an internal buffer. The buffered data can then be returned directly on subsequent reads. The constructor creates a BufferedReader for the given readable raw stream and buffersize . If buffersize is omitted, DEFAULTBUFFERSIZE is used. BufferedReader provides or overrides these methods in addition to those from BufferedIOBase and IOBase : Return bytes from the stream without advancing the position. At most one single read on the raw stream is done to satisfy the call. The number of bytes returned may be less or more than requested. Read and return size bytes, or if size is not given or negative, until EOF or if the read call would block in non-blocking mode. Read and return up to size bytes with only one call on the raw stream. If at least one byte is buffered, only buffered bytes are returned. Otherwise, one raw stream read call is made. class io. BufferedWriter ( raw . buffersizeDEFAULTBUFFERSIZE ) A buffer providing higher-level access to a writeable, sequential RawIOBase object. It inherits BufferedIOBase. When writing to this object, data is normally placed into an internal buffer. The buffer will be written out to the underlying RawIOBase object under various conditions, including: when the buffer gets too small for all pending data when flush() is called when a seek() is requested (for BufferedRandom objects) when the BufferedWriter object is closed or destroyed. The constructor creates a BufferedWriter for the given writeable raw stream. If the buffersize is not given, it defaults to DEFAULTBUFFERSIZE . BufferedWriter provides or overrides these methods in addition to those from BufferedIOBase and IOBase : Force bytes held in the buffer into the raw stream. A BlockingIOError should be raised if the raw stream blocks. Write the bytes-like object. b . and return the number of bytes written. When in non-blocking mode, a BlockingIOError is raised if the buffer needs to be written out but the raw stream blocks. class io. BufferedRandom ( raw . buffersizeDEFAULTBUFFERSIZE ) A buffered interface to random access streams. It inherits BufferedReader and BufferedWriter. and further supports seek() and tell() functionality. The constructor creates a reader and writer for a seekable raw stream, given in the first argument. If the buffersize is omitted it defaults to DEFAULTBUFFERSIZE . class io. BufferedRWPair ( reader . writer . buffersizeDEFAULTBUFFERSIZE ) A buffered I/O object combining two unidirectional RawIOBase objects 8211 one readable, the other writeable 8211 into a single bidirectional endpoint. It inherits BufferedIOBase . reader and writer are RawIOBase objects that are readable and writeable respectively. If the buffersize is omitted it defaults to DEFAULTBUFFERSIZE . BufferedRWPair does not attempt to synchronize accesses to its underlying raw streams. You should not pass it the same object as reader and writer use BufferedRandom instead. 16.2.3.4. Text I/O Base class for text streams. This class provides a character and line based interface to stream I/O. There is no readinto() method because Python8217s character strings are immutable. It inherits IOBase. There is no public constructor. TextIOBase provides or overrides these data attributes and methods in addition to those from IOBase : The name of the encoding used to decode the stream8217s bytes into strings, and to encode strings into bytes. The error setting of the decoder or encoder. A string, a tuple of strings, or None. indicating the newlines translated so far. Depending on the implementation and the initial constructor flags, this may not be available. The underlying binary buffer (a BufferedIOBase instance) that TextIOBase deals with. This is not part of the TextIOBase API and may not exist in some implementations. Separate the underlying binary buffer from the TextIOBase and return it. After the underlying buffer has been detached, the TextIOBase is in an unusable state. Some TextIOBase implementations, like StringIO. may not have the concept of an underlying buffer and calling this method will raise UnsupportedOperation . New in version 3.1. Read and return at most size characters from the stream as a single str. If size is negative or None. reads until EOF. Read until newline or EOF and return a single str. If the stream is already at EOF, an empty string is returned. If size is specified, at most size characters will be read. Change the stream position to the given offset . Behaviour depends on the whence parameter. The default value for whence is SEEKSET . SEEKSET or 0. seek from the start of the stream (the default) offset must either be a number returned by TextIOBase. tell(). or zero. Any other offset value produces undefined behaviour. SEEKCUR or 1. 8220seek8221 to the current position offset must be zero, which is a no-operation (all other values are unsupported). SEEKEND or 2. seek to the end of the stream offset must be zero (all other values are unsupported). Return the new absolute position as an opaque number. New in version 3.1: The SEEK constants. Return the current stream position as an opaque number. The number does not usually represent a number of bytes in the underlying binary storage. Write the string s to the stream and return the number of characters written. class io. TextIOWrapper ( buffer . encodingNone . errorsNone . newlineNone . linebufferingFalse . writethroughFalse ) A buffered text stream over a BufferedIOBase binary stream. It inherits TextIOBase . encoding gives the name of the encoding that the stream will be decoded or encoded with. It defaults to locale. getpreferredencoding(False) . errors is an optional string that specifies how encoding and decoding errors are to be handled. Pass strict to raise a ValueError exception if there is an encoding error (the default of None has the same effect), or pass ignore to ignore errors. (Note that ignoring encoding errors can lead to data loss.) replace causes a replacement marker (such as ) to be inserted where there is malformed data. backslashreplace causes malformed data to be replaced by a backslashed escape sequence. When writing, xmlcharrefreplace (replace with the appropriate XML character reference) or namereplace (replace with N escape sequences) can be used. Any other error handling name that has been registered with codecs. registererror() is also valid. newline controls how line endings are handled. It can be None. . norte. R and rn. It works as follows: When reading input from the stream, if newline is None. universal newlines mode is enabled. Lines in the input can end in n. R or rn. and these are translated into n before being returned to the caller. If it is . universal newlines mode is enabled, but line endings are returned to the caller untranslated. If it has any of the other legal values, input lines are only terminated by the given string, and the line ending is returned to the caller untranslated. When writing output to the stream, if newline is None. any n characters written are translated to the system default line separator, os. linesep. If newline is or n. no translation takes place. If newline is any of the other legal values, any n characters written are translated to the given string. If linebuffering is True. flush() is implied when a call to write contains a newline character. If writethrough is True. calls to write() are guaranteed not to be buffered: any data written on the TextIOWrapper object is immediately handled to its underlying binary buffer . Changed in version 3.3: The writethrough argument has been added. Changed in version 3.3: The default encoding is now locale. getpreferredencoding(False) instead of locale. getpreferredencoding(). Don8217t change temporary the locale encoding using locale. setlocale(). use the current locale encoding instead of the user preferred encoding. TextIOWrapper provides one attribute in addition to those of TextIOBase and its parents: Whether line buffering is enabled. An in-memory stream for text I/O. The text buffer is discarded when the close() method is called. The initial value of the buffer can be set by providing initialvalue . If newline translation is enabled, newlines will be encoded as if by write(). The stream is positioned at the start of the buffer. The newline argument works like that of TextIOWrapper. The default is to consider only n characters as ends of lines and to do no newline translation. If newline is set to None. newlines are written as n on all platforms, but universal newline decoding is still performed when reading. StringIO provides this method in addition to those from TextIOBase and its parents: Return a str containing the entire contents of the buffer. Newlines are decoded as if by read(). although the stream position is not changed. class io. IncrementalNewlineDecoder 16.2.4. Performance This section discusses the performance of the provided concrete I/O implementations. 16.2.4.1. Binary I/O By reading and writing only large chunks of data even when the user asks for a single byte, buffered I/O hides any inefficiency in calling and executing the operating system8217s unbuffered I/O routines. The gain depends on the OS and the kind of I/O which is performed. For example, on some modern OSes such as Linux, unbuffered disk I/O can be as fast as buffered I/O. The bottom line, however, is that buffered I/O offers predictable performance regardless of the platform and the backing device. Therefore, it is almost always preferable to use buffered I/O rather than unbuffered I/O for binary data. 16.2.4.2. Text I/O Text I/O over a binary storage (such as a file) is significantly slower than binary I/O over the same storage, because it requires conversions between unicode and binary data using a character codec. This can become noticeable handling huge amounts of text data like large log files. Also, TextIOWrapper. tell() and TextIOWrapper. seek() are both quite slow due to the reconstruction algorithm used. StringIO. however, is a native in-memory unicode container and will exhibit similar speed to BytesIO . 16.2.4.3. Multi-threading FileIO objects are thread-safe to the extent that the operating system calls (such as read(2) under Unix) they wrap are thread-safe too. Binary buffered objects (instances of BufferedReader. BufferedWriter. BufferedRandom and BufferedRWPair ) protect their internal structures using a lock it is therefore safe to call them from multiple threads at once. TextIOWrapper objects are not thread-safe. 16.2.4.4. Reentrancy Binary buffered objects (instances of BufferedReader. BufferedWriter. BufferedRandom and BufferedRWPair ) are not reentrant. While reentrant calls will not happen in normal situations, they can arise from doing I/O in a signal handler. If a thread tries to re-enter a buffered object which it is already accessing, a RuntimeError is raised. Note this doesn8217t prohibit a different thread from entering the buffered object. The above implicitly extends to text files, since the open() function will wrap a buffered object inside a TextIOWrapper. This includes standard streams and therefore affects the built-in function print() as well. Thanks for contacting me. Ive added you to GenoMeds contact list, so youll get press releases like the one I sent out March 4, 2010, when I first heard that the SEC had suspended trading in our stock. The SECs position is pretty cut and dried. We havent filed with them since 2005, and their position is that we shouldnt be a public company unless we continue to file with them. Unfortunately, auditors and SEC attorneys, not to mention Sarbannes-Oxley requirements, would cost us an extra 100K or so a year. At this point, we simply cant afford to keep current with our SEC filing requirements. I hope our financial situation changes soon, and we can re-register with the SEC and resume trading on a public exchange. For the moment, we have no alternative but to continue as a non-trading, i. e. private, company until we have sufficient money to re-register with the SEC again and resume trading. I have no idea how long that will be. I keep hoping the world will hear about our ability to prevent 90 of dialysis and well soon have thousands of patients who want us to keep them off dialysis. But that hasnt happened yet. I keep trying to get the word out everyday, as many of you do. In any event, the SEC assures me that the current action will not adversely affect our chances to re-register with them once our finances have improved. I promise to keep you posted as closely, now that were private, as I did when we were public. También prometo tratar a todos mis inversores de manera justa. Ive instruyó al agente de la transferencia de la acción para enviarme una lista de accionistas a partir del 3 de marzo de 2010 de modo que pueda cargar todos sus email en nuestra lista principal. I would appreciate it if you contacted me yourselves, along with the number of shares that you own, so that I can send you company news when I send it to everybody else. PLEASE DO NOT THROW AWAY YOUR GENOMED SHARE CERTIFICATES You will need them to prove your prior investment in the company. They still have value. Even though you cant trade them on a public exchange like the Pink Sheets anymore, its perfectly legal for you to trade them amongst yourselves. Best regards, Dave Moskowitz MD CEO, GenoMed, Inc. 2001-2016 GenoMed. Todos los derechos reservados.
No comments:
Post a Comment