pyreadstat 1.2.1__tar.gz → 1.2.3__tar.gz

{pyreadstat-1.2.1/pyreadstat.egg-info → pyreadstat-1.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pyreadstat
-Version: 1.2.1
+Version: 1.2.3
 Summary: Reads and Writes SAS, SPSS and Stata files into/from pandas data frames.
 Home-page: https://github.com/Roche/pyreadstat
 Author: Otto Fajardo

{pyreadstat-1.2.1 → pyreadstat-1.2.3}/README.md

@@ -194,9 +194,7 @@ You can also install from the github repo directly (without cloning). Use the fl
 pip install git+https://github.com/Roche/pyreadstat.git
 ```
 
-You need a working C compiler. If working in python 2.7 you will need
-cython version >= 0.28 installed (see later Python 2.7 support). For python 3, cython
-is not necessary if compiling on unix, but if installed it will be used.
+You need a working C compiler and cython >=3.0.0.
 
 ### Compiling on Windows and Mac
 
@@ -330,7 +328,8 @@ df, meta = pyreadstat.read_sas7bdat('/path/to/a/file.sas7bdat', usecols=["variab
 #### Reading files in parallel processes
 
 A challenge when reading large files is the time consumed in the operation. In order to alleviate this
-pyreadstat provides a function "read_file_multiprocessing" to read a file in parallel processes using the python multiprocessing library. As it reads the whole file in one go you need to have enough RAM for the operation. If
+pyreadstat provides a function "read\_file\_multiprocessing" to read a file in parallel processes using
+ the python multiprocessing library. As it reads the whole file in one go you need to have enough RAM for the operation. If
 that is not the case look at Reading rows in chunks (next section)
 
 Speed ups in the process will depend on a number of factors such as number of processes available, RAM, 
@@ -351,6 +350,11 @@ import multiprocessing
 num_processes = multiprocessing.cpu_count()
 ```
 
+**Notes for Xport, Por and some defective SAV files not having the number of rows in the metadata**
+1. In all Xport, Por and some defective SAV files, the number of rows cannot be determined from the metadata. In such cases,
+   you can use the parameter num\_rows to be equal or larger to the number of rows in the dataset. This number can be obtained
+   reading the file without multiprocessing, reading in another application, etc.
+
 **Notes for windows**
 
 1. For this to work you must include a __name__ == "__main__" section in your script. See [this issue](#85)
@@ -410,6 +414,9 @@ for df, meta in reader:
     # do some cool calculations here for the chunk
 ```
 
+**If using multiprocessing, please read the notes in the previous section regarding Xport, Por and some defective SAV files not
+having the number of rows in the metadata**
+ 
 **For Windows, please check the notes on the previous section reading files in parallel processes**
 
 #### Reading value labels
@@ -861,17 +868,9 @@ Converting data types from foreign applications into python some times also brin
 
 ## Python 2.7 support.
 
-Python 2.7 is not actively supported. If it works, we are happy about that. But if it does not, and the
-bug is specific for python 2.7 (cannot be reproduced in python 3), the issue is not going to be solved.
-
-At the moment of writing this document Python 2.7 does not work for windows.
-It does work for Mac and Linux. In Mac and Linux, files cannot be opened
-if the path contains international (non-ascii) characters. As mentioned
-before this bug is not going to be repaired (There is not such issue on
-Python 3). 
-
-Starting on version 1.0.6 wheels are not produced for Python 2.7 anymore,
-but you can still compile on linux and mac. 
+As version 1.2.3 Python 2.7 is not supported. In previous versions it was possible to compile it for 
+mac and linux but not for windows, but no wheels were provided. In linux and mac it will fail if
+ the path file contains non-ascii characters.
 
 ## Change log
 

{pyreadstat-1.2.1 → pyreadstat-1.2.3}/pyreadstat/__init__.py

@@ -20,5 +20,5 @@ from .pyreadstat import set_value_labels, set_catalog_to_sas
 from .pyreadstat import read_file_in_chunks, read_file_multiprocessing
 from ._readstat_parser import ReadstatError, metadata_container
 
-__version__ = "1.2.1"
+__version__ = "1.2.3"