# Mappa CLI
Mappa is a command-line interface tool that allows you to quickly perform operations on CSV and XLSX files, such as renaming header keys, remapping header positions, stripping columns, and converting headers to lowercase.
## Installation
You can install Mappa VIA pip
```bash
pip install mappa-cli
```
## Usage
The tool can be invoked using the mappa command. Below is an example of how to use Mappa, along with the available options.
### Examples
```bash
mappa --filepath [filepath] --output [output path] [options]
```
The input path and output path are optional arguments. If not provided, you will be prompted to enter the file paths during runtime. The default output file will be named filepath.mapped.csv.
You can stack multiple options in one command. However, the options will always be executed in a predefined order, regardless of how you input them. For example:
```bash
mappa --rename --remap --strip
```
## Options
`--rename`: Rename header keys
`--remap`: Remap header position
`--strip`: Strip specified columns from the table
`--lower`: Set all headers to lowercase
`--inplace`: Save changes to the same input file
`--help`: Display help
# License
This package is free to use and open for contributions under the GLWTS License, which prohibits the use of this repo for any AI or non human based training.
Raw data
{
"_id": null,
"home_page": "https://github.com/0x3at/mappa-cli",
"name": "mappa-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "python, csv, remap, remap csv, rename headers, header keys, strip columns, lowercase headers",
"author": "Dunder Dev",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/09/b8/32bdcae99118f3c238d6a1e268f860ab7c7b86f5bed84029b8219a2bc559/mappa_cli-0.0.1.0.tar.gz",
"platform": null,
"description": "# Mappa CLI\r\n\r\nMappa is a command-line interface tool that allows you to quickly perform operations on CSV and XLSX files, such as renaming header keys, remapping header positions, stripping columns, and converting headers to lowercase.\r\n\r\n## Installation\r\nYou can install Mappa VIA pip\r\n```bash\r\npip install mappa-cli\r\n```\r\n\r\n## Usage\r\nThe tool can be invoked using the mappa command. Below is an example of how to use Mappa, along with the available options.\r\n\r\n### Examples\r\n```bash\r\nmappa --filepath [filepath] --output [output path] [options]\r\n```\r\n\r\nThe input path and output path are optional arguments. If not provided, you will be prompted to enter the file paths during runtime. The default output file will be named filepath.mapped.csv.\r\n\r\nYou can stack multiple options in one command. However, the options will always be executed in a predefined order, regardless of how you input them. For example:\r\n\r\n```bash\r\nmappa --rename --remap --strip\r\n```\r\n\r\n## Options\r\n`--rename`: Rename header keys\r\n`--remap`: Remap header position\r\n`--strip`: Strip specified columns from the table\r\n`--lower`: Set all headers to lowercase\r\n`--inplace`: Save changes to the same input file\r\n`--help`: Display help\r\n\r\n# License\r\nThis package is free to use and open for contributions under the GLWTS License, which prohibits the use of this repo for any AI or non human based training.\r\n\r\n\r\n\r\n\r\n\r\n\r\n",
"bugtrack_url": null,
"license": "GLWTS",
"summary": "The simplest way to quickly manipulate CSV and XLSX files via the command line.",
"version": "0.0.1.0",
"project_urls": {
"Homepage": "https://github.com/0x3at/mappa-cli"
},
"split_keywords": [
"python",
" csv",
" remap",
" remap csv",
" rename headers",
" header keys",
" strip columns",
" lowercase headers"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0db384308ad353ea0584d4984e4df6aa9902f0d4b201c00ebe8c5e1defd75da9",
"md5": "a213141695178ac0fd0ecd445dfd60fe",
"sha256": "02843897a8d153443900d2bc1f21315dcd88cb202e5534eb82fb0dbf4781b09a"
},
"downloads": -1,
"filename": "mappa_cli-0.0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a213141695178ac0fd0ecd445dfd60fe",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 5700,
"upload_time": "2024-10-08T07:32:33",
"upload_time_iso_8601": "2024-10-08T07:32:33.774018Z",
"url": "https://files.pythonhosted.org/packages/0d/b3/84308ad353ea0584d4984e4df6aa9902f0d4b201c00ebe8c5e1defd75da9/mappa_cli-0.0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "09b832bdcae99118f3c238d6a1e268f860ab7c7b86f5bed84029b8219a2bc559",
"md5": "139d8095a6562c51247b4f99888b4c5d",
"sha256": "719047d8568e4a4c4f90fef17e10c72fa57f1b4b3f956d93447312fd7f2b88c2"
},
"downloads": -1,
"filename": "mappa_cli-0.0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "139d8095a6562c51247b4f99888b4c5d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 5022,
"upload_time": "2024-10-08T07:32:34",
"upload_time_iso_8601": "2024-10-08T07:32:34.729418Z",
"url": "https://files.pythonhosted.org/packages/09/b8/32bdcae99118f3c238d6a1e268f860ab7c7b86f5bed84029b8219a2bc559/mappa_cli-0.0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-08 07:32:34",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "0x3at",
"github_project": "mappa-cli",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "mappa-cli"
}
JSON
