https://github.com/kurusugawa-computer/convert-fileformat-with-pandas

Convert file format with pandas
https://github.com/kurusugawa-computer/convert-fileformat-with-pandas

csv pandas xlsx

Last synced: about 2 months ago
JSON representation

Convert file format with pandas

• Host: GitHub
• URL: https://github.com/kurusugawa-computer/convert-fileformat-with-pandas
• Owner: kurusugawa-computer
• License: mit
• Created: 2020-05-19T13:42:04.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2024-03-04T07:30:42.000Z (11 months ago)
• Last Synced: 2024-11-19T12:55:13.964Z (about 2 months ago)
• Topics: csv, pandas, xlsx
• Language: Python
• Homepage:
• Size: 249 KB
• Stars: 1
• Watchers: 5
• Forks: 0
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# convert-fileformat-with-pandas

Convert file format with [pandas](https://pandas.pydata.org/).

[![Build Status](https://app.travis-ci.com/kurusugawa-computer/convert-fileformat-with-pandas.svg?branch=main)](https://app.travis-ci.com/kurusugawa-computer/convert-fileformat-with-pandas)

[![PyPI version](https://badge.fury.io/py/convpandas.svg)](https://badge.fury.io/py/convpandas)

[![Python Versions](https://img.shields.io/pypi/pyversions/convpandas.svg)](https://pypi.org/project/convpandas/)

# Requirements

* Python 3.9+

# Install

```

$ pip install convpandas

```

https://pypi.org/project/convpandas/

# Usage

## csv2xlsx

Convert csv file to xlsx file.

```

$ convpandas csv2xlsx --help

usage: convpandas csv2xlsx [-h] [--sep SEP] [--encoding ENCODING] [--quotechar QUOTECHAR] [--numeric_to_string] [--sheet_name SHEET_NAME [SHEET_NAME ...]]

                           csv_files [csv_files ...] xlsx_file

positional arguments:

  csv_files

  xlsx_file

optional arguments:

  -h, --help            show this help message and exit

  --sep SEP             Delimiter to use when reading csv. (default: ,)

  --encoding ENCODING   Encoding to use when reading csv. List of Python standard encodings.

                        https://docs.python.org/3/library/codecs.html#standard-encodings (default: utf-8)

  --quotechar QUOTECHAR

                        The character used to denote the start and end of a quoted item when reading csv. (default: ")

  --numeric_to_string   If specified, write numeric value as string type. If not specified, write numeric value as numeric type. (default: False)

  --sheet_name SHEET_NAME [SHEET_NAME ...]

```

Convert `in.csv` to `out.xlsx` .

```

$ convpandas csv2xlsx in.csv out.xlsx

```

When `CSV_FILE` is `-` , STDIN is used for input. 

```

$ convpandas csv2xlsx - out.xlsx < in.csv

```

Convert `in1.csv` and `in2.csv` to `out.xlsx` . Sheet name is csv filename without its' suffix.  

```

$ convpandas csv2xlsx in1.csv in2.csv out.xlsx

```

![](docs/img/output_xlsx_file_from_multiple_csv.png)

If `--sheet_name` is specified, sheet name is set.

```

$ convpandas csv2xlsx in1.csv in2.csv out.xlsx --sheet_name foo bar

```

![](docs/img/output_xlsx_file_from_multiple_csv2.png)

## xlsx2csv

Convert xlsx file to csv file.

```

$ convpandas xlsx2csv --help

usage: convpandas xlsx2csv [-h] [--sheet_name SHEET_NAME] [--sep SEP] [--encoding ENCODING] [--quotechar QUOTECHAR] xlsx_file csv_file

positional arguments:

  xlsx_file

  csv_file

optional arguments:

  -h, --help            show this help message and exit

  --sheet_name SHEET_NAME

                        Sheet name when reading xlsx. If not specified, read 1st sheet. (default: None)

  --sep SEP             Field delimiter for the output file. (default: ,)

  --encoding ENCODING   A string representing the encoding to use in the output file. (default: utf-8)

  --quotechar QUOTECHAR

                        Character used to quote fields. (default: ")

```

Convert `in.xlsx` to `out.csv` .

```

$ convpandas csv2xlsx in.xlsx out.csv

```

When `CSV_FILE` is `-` , write to STDOUT. 

```

$ convpandas csv2xlsx in.xlsx -

name,age

Alice,23

```

With specifying `--sheet_name`, you can select sheet name that you want to convert.

```

$ convpandas csv2xlsx in.xlsx out.csv --sheet_name sheet2

```

# Usage for Developer

Refer to https://github.com/kurusugawa-computer/convert-fileformat-with-pandas/blob/main/README_for_developer.md .