Metadata-Version: 1.1
Name: penny
Version: 0.1.0
Summary: Inspect csv files and lists of data
Home-page: https://github.com/gati/penny
Author: Jonathon Morgan
Author-email: jonathon@goodattheinternet.com
License: MIT
Download-URL: https://github.com/gati/penny/tarball/0.1.0
Description: Penny
        ========
        
        ### Inspect csv files and lists of data to find out the truth!
        
        ![alt tag](http://www.martianwatches.com/wp-content/uploads/2013/10/InspectorGadget.jpg)
        
        Uncle Gadget was great and all, but when it came to real detective work, we all know Penny did the heavy lifting. Hence, Penny, the Python module that inspects stuff. Feed it rows or columns from a dataset, and get information about the column types -- including whether or not a given column represents a category or date. Penny also finds column headers (waaaay more reliably than the `Sniffer` class in to the standard `csv` module).
        
        ### Why?
        
        If you're working with a few datasets, it's easy to figure out which columns are supposed to be dates, integers and even categories just by looking at the raw csv files. But if you need to programmatically deal with lots of datasets, this gets tedious fast. 
        
        ### Setup
        
        Grab the package.
        
        ```
        pip install penny
        ```
        
        Or grab the code from GitHub.
        
        ```
        git clone https://github.com/gati/penny
        cd penny
        pip install -r requirements.txt
        ```
        
        ### Getting Started
        
        Guess the headers of a csv file.
        
        ```python
        from penny.headers import get_headers
        
        with open('your-awesome-file.csv') as csvfile:
            has_header, headers = get_headers(csvfile)
            
            # Prints True/False depending on whether or not headers were found
            print has_header 
        
            # Prints column headers or placeholders if real headers weren't found
            print headers # ['Example Header A', 'Example Header B']
        ```
        
        Guess the data type of a column in your dataset.
        
        ```python    
        from penny.inspectors import column_types_probabilities
        
        fileobj = open('your-awesome-file.csv')
        rows = list(csv.reader(fileobj))
        
        # Get the values from column 0
        column_0 = [x[0] for x in rows]
        probs = column_types_probabilities(column_0)
        
        # Prints something like {'date': 1, 'int': .75, 'category': 0 ...}
        print probs
        ```
        
        Or get type guesses for all the rows in your dataset at once.
        
        ```python    
        from penny.inspectors import rows_types_probabilities
        
        fileobj = open('your-awesome-file.csv')
        rows = list(csv.reader(fileobj))
        probs = rows_types_probabilities(rows)
        ```
        
        Last but not least, you can also inspect a column for a single type.
        
        ```python    
        from penny.list_check import column_probability_for_type
        
        fileobj = open('your-awesome-file.csv')
        rows = list(csv.reader(fileobj))
        
        # Get the values from column 0
        column_0 = [x[0] for x in rows]
        prob = column_probability_for_type(column_0, 'date')
        
        # Prints something like 0.78
        print prob
        ```
        
        ### Contributing & Credits
        
        This is a work in progress, so pull request at will. Some of this work was inspired by [messytables](https://github.com/okfn/messytables), which looks great for xls files but wasn't quite what I needed. Thanks to [Chris Albon](http://twitter.com/chrisalbon) for putting together a [repo of useful test datasets](https://github.com/chrisalbon/Variable-Type-Identification-Test-Datasets). 
        
        Questions, concerns, devoted fan mail to [@jonathonmorgan](http://twitter.com/jonathonmorgan) on Twitter.
        
        
Platform: UNKNOWN
