Metadata-Version: 2.1
Name: xlparser
Version: 0.6.1
Summary: Parse excel(xlsx/xls/csv) to other format(csv, xlsx, json).
License: MIT
Author: ahuigo
Author-email: 1781999+ahuigo@users.noreply.github.com
Requires-Python: >=3.9
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: click (>=8.1.7,<9.0.0)
Requires-Dist: openpyxl (>=3.1.5,<4.0.0)
Requires-Dist: python-dateutil (>=2.8.2)
Requires-Dist: xlrd (>=2.0.1,<3.0.0)
Description-Content-Type: text/markdown

- [xlparser](#xlparser)
  - [Install](#install)
  - [Usage](#usage)
    - [CLI Usage](#cli-usage)
    - [Module Usage](#module-usage)
    - [Parse any type of file](#parse-any-type-of-file)
    - [Save to any type of file](#save-to-any-type-of-file)
    - [Csv operation](#csv-operation)
    - [Zip operation](#zip-operation)
  - [Required](#required)

# xlparser
Parse excel(xlsx/xls/csv) to other format(csv, xlsx, json).


[![](https://img.shields.io/pypi/pyversions/xlparser.svg?longCache=True)](https://pypi.org/pypi/xlparser/)
[![](https://img.shields.io/pypi/v/xlparser.svg?maxAge=36000)](https://pypi.org/pypi/xlparser/)

## Install

    pip install xlparser
    # or
    pip3 install xlparser

If you want to filter fields, it will be convenient with [xcut](https://github.com/ahuigo/xcut).

    pip install xcut 
    # or
    pip3 install xcut 

## Usage

    $ xlparser -h
    xlparser [options] INFILE [OUTFILE]\n
        options:\n
            -h       For help.\n

### CLI Usage
From xlsx to csv.

    $ xlparser source.xlsx new.csv 

From csv to xlsx.

    $ xlparser source.csv new.xlsx 

From csv to json.

    $ xlparser source.csv new.json

From xlsx to csv(stdout).

    $ xlparser source.xlsx | head 

    $ xlparser src.xlsx | tee test.csv
    name, score
    "李雷,韩梅",15
    小花,16

Use xcut to filter fields.

    $ xlparser src.xlsx | xcut --from-csv -f name 
    name
    "李雷,韩梅"
    小花

    $ xlparser src.xlsx | xcut --from-csv -f score,name
    score,name
    15,"李雷,韩梅"
    16,小花

Convert xlsx to csv

    $ xlparser src.xlsx test.csv; 
    $ cat test.csv
    name, age
    李雷,15
    小花,16

Convert csv to json

    $ xlparser test.csv test.json
    [["name", "age"], ["李雷", "15"], ["小花", "16"]]

### Module Usage

#### Parse any type of file
`parse` any type of file to rows:

    >>> from xlparser import parse, saveCsv
    >>> rows = parse('some.xlsx')
    >>> list(rows)
    [['foo', 'bar'], ['看', '我', '变']]

The `parse` function supports the following file formats: .csv, .xls, .xlsx .

#### Save to any type of file
Save rows to csv

    >>> from xlparser import saveCsv
    >>> rows = [['foo', 'bar'], ['看', '我', '变']]
    >>> saveCsv(rows, 'test.csv')

Save rows to xlsx

    >>> saveXlsx(rows, 'test.xlsx')

#### Csv operation

    >>> from xlparser import *

    >>> rows = [('foo','bar'), ('看','我','变')]
    >>> saveCsv(rows, 'test.csv')

    >>> list(parseCsv('test.csv'))
    [['foo', 'bar'], ['看', '我', '变']]

#### Zip operation

    >>> from xlparser import loadZip
    >>> zf = loadZip('test.xlsx')
    >>> print(zf.filelist)
    ......
    >>> zf.extract('xl/media/image1.png', '/tmp')
    >>> os.rename('/tmp/'+'xl/media/image1.png', './image1.png')

## Required
1. python>=3.5
2. xlrd: required by xls
2. openpyxl>=2.5.4: required by xlsx

