{ "info": { "author": "Piccolo Lab", "author_email": "stephen_piccolo@byu.edu", "bugtrack_url": null, "classifiers": [], "description": "# shapeshifter-cli\nThe official command-line interface for the [shapeshifter](https://github.com/srp33/ShapeShifter) Python module.\nFrom the command-line you can easily take advantage of ShapeShifter's features, such as:\n* Transformation of tabular data sets from one format to another.\n* Querying large data sets to filter out useful data.\n* Selection of additional columns/features to include in the resulting data set.\n* Option to gzip resulting data sets, as well as the ability to read gzipped files.\n\nAnd coming soon:\n* Merging multiple data files of various types into a single file. Type `shapeshiftmerge --help` or `ssm --help` to help test it out!\n\n## Install\n\n```bash\npip3 install shapeshifter-cli\n```\n\n## Basic Use\nTo view instructions for use at any time, simply type the command `shapeshift --help` or `ss --help` into the terminal at any time.\nDoing so will bring up the following:\n```bash\n$ shapeshift --help\nusage: shapeshift [-h] [-i File_Type] [-o File_Type] [-t] [-f \"FILTER\"]\n [-c COLUMNS] [-a] [-g] [-s SET_INDEX]\n input_file output_file\n\nImport, filter, and transform data into a format of your choice!\n\npositional arguments:\n input_file Data file to be imported, filtered, and/or transformed\n output_file File path to which results are exported\n\noptional arguments:\n -h, --help show this help message and exit\n -i File_Type, --input_file_type File_Type\n Type of file to be imported. If not specified, file\n type will be determined by the file extension given.\n Available choices are: CSV, TSV, JSON, Excel, HDF5,\n Parquet, MsgPack, Stata, Pickle, SQLite, ARFF, GCT,\n Kallisto, GEO, Salmon\n -o File_Type, --output_file_type File_Type\n Type of file to which results are exported. If not\n specified, file type will be determined by the file\n extension given. Available choices are: CSV, TSV,\n JSON, Excel, HDF5, Parquet, MsgPack, Stata, Pickle,\n SQLite, ARFF, GCT, RMarkdown, JupyterNotebook\n -t, --transpose Transpose index and columns in the output file\n -f \"FILTER\", --filter \"FILTER\"\n Filter data using python logical syntax. Your filter\n must be surrounded by quotes. For example: -f\n \"ColumnName1 > 12.5 and (ColumnName2 == 'x' or\n ColumnName2 =='y')\"\n -c COLUMNS, --columns COLUMNS\n List of additional column names to include in the\n output file. Column names must be seperated by commas\n and without spaces. For example: -c\n ColumnName1,ColumnName2,ColumnName3\n -a, --all_columns Includes all columns in the output file. Overrides the\n \"--columns\" flag\n -g, --gzip Gzips the output file\n -s SET_INDEX, --set_index SET_INDEX\n Sets the given column to become the index column,\n where appropriate. If not set, the default index will\n be 'Sample'\n\n```\nThere are only two required arguments when using the `shapeshift` command: the path to the file you wish to read,\nand the path to a file you wish to produce. For example, if you had an Excel file called \"input_file.xlsx\" and you \nsimply wanted to convert it to a TSV file called \"output_file.tsv\", you would enter \n`shapeshift input_file.xlsx output_file.tsv` into the terminal to execute the conversion.\n\nShapeShifter automatically infers both the format of the input file and the format of the file you wish to create, based\non the extension on the file path. If for some reason the extensions are irregular or missing, you can specify the \nformat of the input file using the `--input_file_type` flag, followed by the name of the file type,\nand specify the format of the output file using the `--output_file_type` flag, followed by the name of the file type.\n\nApplying filters during the transformation uses the `--filter` flag, followed by a string query in double quotations.\nSyntax for such a query uses basic Python logical syntax, as shown by the following example:\n`--filter \"ColumnName1 > 12.5 and (ColumnName2 == 'x' or ColumnName2 =='y')\"` \n\nApplying filters means that only those columns that are filtered on (in the above example, ColumnName1 and ColumnName2)\nwill appear in the output file. If you wish to include additional columns, you can do so with the `--columns` flag \nfollowed by a list of comma-separated column names. If you wish to include all columns in the output, you can simply\nuse the `--all_columns` flag.\n\n## Currently Supported Formats\n#### Input Formats:\n* CSV\n* TSV\n* JSON\n* Excel\n* HDF5\n* Parquet\n* MsgPack\n* Stata\n* Pickle\n* SQLite\n* ARFF\n* GCT\n* Kallisto\n* GEO\n\n#### Output Formats:\n* CSV \n* TSV\n* JSON\n* Excel\n* HDF5\n* Parquet\n* MsgPack\n* Stata \n* Pickle\n* SQLite \n* ARFF \n* GCT \n* RMarkdown \n* JupyterNotebook\n\n## Future Formats to Support\nWe are working hard to expand ShapeShifter to work with even more file formats! Expect the following formats to be \nincluded in future releases:\n* Fixed-width files (fwf)\n* Genomic Data Commons clinical XML\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/srp33/ShapeShifter-CLI", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "shapeshifter-cli", "package_url": "https://pypi.org/project/shapeshifter-cli/", "platform": "", "project_url": "https://pypi.org/project/shapeshifter-cli/", "project_urls": { "Homepage": "https://github.com/srp33/ShapeShifter-CLI" }, "release_url": "https://pypi.org/project/shapeshifter-cli/1.0.0/", "requires_dist": [ "shapeshifter", "pandas" ], "requires_python": "", "summary": "A command-line tool for transforming large data sets", "version": "1.0.0" }, "last_serial": 4900335, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "647654debbff3c824bc50787f3fc94ff", "sha256": "6d5c7ebbf4de2ca13ab195c09101b75b7a8e0c3ea61545c44dd2daeb13aac834" }, "downloads": -1, "filename": "shapeshifter_cli-0.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "647654debbff3c824bc50787f3fc94ff", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 5101, "upload_time": "2019-01-15T23:14:14", "url": "https://files.pythonhosted.org/packages/df/72/a829f59e3c2fa04ce2e5f97aea92d6fa9e5397196a118c6f172549ca98e3/shapeshifter_cli-0.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1fad7b3cfa8f0495266e4f5bd7aafc42", "sha256": "04d24bde6d36153b9dd78289c2ea547a63ae2d76be62156906c8b415ea2f3c7e" }, "downloads": -1, "filename": "shapeshifter-cli-0.0.1.tar.gz", "has_sig": false, "md5_digest": "1fad7b3cfa8f0495266e4f5bd7aafc42", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3281, "upload_time": "2019-01-15T23:14:16", "url": "https://files.pythonhosted.org/packages/d8/e5/c6819f27e2f4434488eb193c99126beca7e16bb46d6d58f1bcf03384bbd1/shapeshifter-cli-0.0.1.tar.gz" } ], "0.0.2": [ { "comment_text": "", "digests": { "md5": "2080147a46450b09b61c6d3c5a6800e4", "sha256": "95f4f88d96970080b5ab9bb3019cd405dbdb91a35b78187b6cbc467d1ad1c3eb" }, "downloads": -1, "filename": "shapeshifter_cli-0.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "2080147a46450b09b61c6d3c5a6800e4", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 8675, "upload_time": "2019-01-23T18:01:02", "url": "https://files.pythonhosted.org/packages/0e/98/7e835f90ef5662413bbb3cfd11eac76567068d115768044767020ac0669f/shapeshifter_cli-0.0.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "96157cd099228a1976e23c040b181226", "sha256": "e5f28fbbe4a3b53cead6dec94749baaf51c10d426b4ef9acdc652499aee1a4ec" }, "downloads": -1, "filename": "shapeshifter-cli-0.0.2.tar.gz", "has_sig": false, "md5_digest": "96157cd099228a1976e23c040b181226", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6577, "upload_time": "2019-01-23T18:01:04", "url": "https://files.pythonhosted.org/packages/cd/cd/0c7e12ba082ba109f26f3523d775ff37244ee4331701f4a1e83526980d1b/shapeshifter-cli-0.0.2.tar.gz" } ], "0.0.3": [ { "comment_text": "", "digests": { "md5": "26bb545c2ecc9ef5c1412ba4ab87de84", "sha256": "9a0401b95f68221911333b271fa682797622fa15d75e461a6185d52e29420b71" }, "downloads": -1, "filename": "shapeshifter_cli-0.0.3-py3-none-any.whl", "has_sig": false, "md5_digest": "26bb545c2ecc9ef5c1412ba4ab87de84", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 8754, "upload_time": "2019-01-24T19:08:25", "url": "https://files.pythonhosted.org/packages/c3/90/985e558a06245acdc6c14edfb3a7aa09d089a4f4d9dd013980155ad7faa8/shapeshifter_cli-0.0.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1bee88182b13a99729ff4e8553f7e829", "sha256": "5b5dc618cd7ff656efb343f1865174f5efcac6922cb292ac1eb32bfe2d74007e" }, "downloads": -1, "filename": "shapeshifter-cli-0.0.3.tar.gz", "has_sig": false, "md5_digest": "1bee88182b13a99729ff4e8553f7e829", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6672, "upload_time": "2019-01-24T19:08:27", "url": "https://files.pythonhosted.org/packages/88/3f/c8771cb6e46fc70303114c0396bb78bbb0bdf87a19b2f239c55c97fec8cd/shapeshifter-cli-0.0.3.tar.gz" } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "bf9b422a408154e7f1b14aad9030e93c", "sha256": "8b77946d762ac3cae781fee2c37183018392f60e0b9433025570d90b42f3ab18" }, "downloads": -1, "filename": "shapeshifter_cli-1.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "bf9b422a408154e7f1b14aad9030e93c", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 8730, "upload_time": "2019-03-05T15:32:12", "url": "https://files.pythonhosted.org/packages/e8/bb/75e5d19904f15029506e0c5d2e9e3139230ea06b78d781c2a2673b303c51/shapeshifter_cli-1.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b8f4f8b1c92f4cb5f9d070ba4e70cd36", "sha256": "47bbeec1bb98e99bd638f1041df4afff8644eacb81a9025a094c1681e963836d" }, "downloads": -1, "filename": "shapeshifter-cli-1.0.0.tar.gz", "has_sig": false, "md5_digest": "b8f4f8b1c92f4cb5f9d070ba4e70cd36", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6710, "upload_time": "2019-03-05T15:32:14", "url": "https://files.pythonhosted.org/packages/45/83/c02c02552d9b087381666f1bf48f54e4c442d2680a05f6d26ae98a45e73a/shapeshifter-cli-1.0.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "bf9b422a408154e7f1b14aad9030e93c", "sha256": "8b77946d762ac3cae781fee2c37183018392f60e0b9433025570d90b42f3ab18" }, "downloads": -1, "filename": "shapeshifter_cli-1.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "bf9b422a408154e7f1b14aad9030e93c", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 8730, "upload_time": "2019-03-05T15:32:12", "url": "https://files.pythonhosted.org/packages/e8/bb/75e5d19904f15029506e0c5d2e9e3139230ea06b78d781c2a2673b303c51/shapeshifter_cli-1.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b8f4f8b1c92f4cb5f9d070ba4e70cd36", "sha256": "47bbeec1bb98e99bd638f1041df4afff8644eacb81a9025a094c1681e963836d" }, "downloads": -1, "filename": "shapeshifter-cli-1.0.0.tar.gz", "has_sig": false, "md5_digest": "b8f4f8b1c92f4cb5f9d070ba4e70cd36", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6710, "upload_time": "2019-03-05T15:32:14", "url": "https://files.pythonhosted.org/packages/45/83/c02c02552d9b087381666f1bf48f54e4c442d2680a05f6d26ae98a45e73a/shapeshifter-cli-1.0.0.tar.gz" } ] }