Metadata-Version: 2.1
Name: parquet-tools
Version: 0.1.1
Summary: 
    Parquet tools for CLI users.
    
Home-page: https://github.com/ktrueda/parquet-tools
Author: Kentaro Ueda
Author-email: kentaro.ueda.kentaro@gmail.com
License: MIT
Description: # parquet-tools for pip
        
        
        ![Run Unittest](https://github.com/ktrueda/parquet-tools/workflows/Run%20Unittest/badge.svg)
        ![Run CLI test](https://github.com/ktrueda/parquet-tools/workflows/Run%20CLI%20test/badge.svg)
        
        This is a pip version of [parquet-tools](https://github.com/apache/parquet-mr). In other words, this is a CLI tools of [Apache Arrow](https://github.com/apache/arrow).
        You can show parquet file content/shema on local disk or on AWS S3.
        
        ## Features
        
        - Read Parquet data (local file or file on S3)
        - Read Parquet metadata/schema (local file or file on S3)
        
        ## Installation
        
        
        ```bash
        $ pip install parquet-tools
        ```
        
        ## Usage
        
        ```bash
        $ parquet-tools --help
        usage: parquet-tools [-h] {show,csv,inspect} ...
        
        parquet CLI tools
        
        positional arguments:
          {show,csv,inspect}
            show              Show human readble format. see `show -h`
            csv               Cat csv style. see `csv -h`
            inspect           Inspect parquet file. see `inspect -h`
        
        optional arguments:
          -h, --help          show this help message and exit
        ```
        
        
        ## Usage Examples
        
        #### Show local parquet file
        
        ```bash
        $ parquet-tools show test.parquet
        +-------+-------+---------+
        |   one | two   | three   |
        |-------+-------+---------|
        |  -1   | foo   | True    |
        | nan   | bar   | False   |
        |   2.5 | baz   | True    |
        +-------+-------+---------+
        ```
        
        #### Show parquet file on S3
        
        ```bash
        $ parquet-tools show s3://bucket-name/prefix/*
        +-------+-------+---------+
        |   one | two   | three   |
        |-------+-------+---------|
        |  -1   | foo   | True    |
        | nan   | bar   | False   |
        |   2.5 | baz   | True    |
        +-------+-------+---------+
        ```
        
        #### Cat CSV parquet and [csvq](https://github.com/mithrandie/csvq)
        
        ```bash
        $ parquet-tools csv s3://bucket-name/test.parquet |csvq "select one, three where three"
        +-------+-------+
        |  one  | three |
        +-------+-------+
        | -1.0  | True  |
        | 2.5   | True  |
        +-------+-------+
        ```
        
Keywords: parquet parquet-tools
Platform: UNKNOWN
Description-Content-Type: text/markdown
