## tinyoffice
Make your Office files tiny!
`tinyoffice` attemps to compresses and optionally convert the embedded image files in your Office files.
## Installation
You can install `tinyoffice` from PyPi:
```
% pip install tinyoffice
```
NOTE: `tinyoffice` requires `Pillow` (`PIL` Fork) [Pillow](https://pillow.readthedocs.io/en/stable/), which can have installation conflicts. If you experience any issues while installing `tinyoffice`, please follow the `Pillow` installation steps found here: https://pillow.readthedocs.io/en/stable/installation.html.
## Usage
```
usage: tinyoffice [-h] [-r] [-c] [-v]
[-t .docx .pptx .xlsx [.docx .pptx .xlsx ...]] [--overwrite]
[-o OUTPUT] [-exts EXTENSIONS [EXTENSIONS ...]]
path
Make your Office files tiny!
positional arguments:
path File or directory path.
If a file and recurse (-r/--recurse) is not set, only that file will be compressed.
If a directory and recurse is not set, only the top-level files in the directory will be compressed.
If recurse is set, everything at path and below will be compressed.
options:
-h, --help show this help message and exit
-r, --recurse Flag for if tinyoffice should recursively search for files. Default is False
-c, --convert Flag for if TIFF files should be converted to JPEGs. Default is False
-v, --verbose Flag for verbosity levels. Can be set multiple times, e.g., -vv, for increased verbosity
-t .docx .pptx .xlsx [.docx .pptx .xlsx ...], --types .docx .pptx .xlsx [.docx .pptx .xlsx ...]
Filetype extensions to compress.
Default is .docx, .pptx, .xlsx
--overwrite Flag for if an existing file should be overwritten. Default is False
-o OUTPUT, --output OUTPUT
Path for the output location.
-exts EXTENSIONS [EXTENSIONS ...], --extensions EXTENSIONS [EXTENSIONS ...]
Image extensions to compress. Default will be only the extensions that are supported by Pillow on your system.
Should be ignored.
```
Raw data
{
"_id": null,
"home_page": null,
"name": "tinyoffice",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "office, compress, convert, image, Word, Excel, Powerpoint",
"author": null,
"author_email": "Samuel Woodward <sam@woodward.fyi>",
"download_url": "https://files.pythonhosted.org/packages/6c/00/168699aae7c616d9c93f88377c5bc06185da8e40ebf72b52a19123e91e21/tinyoffice-0.0.5.tar.gz",
"platform": null,
"description": "## tinyoffice\n\nMake your Office files tiny!\n\n`tinyoffice` attemps to compresses and optionally convert the embedded image files in your Office files.\n\n\n## Installation\n\nYou can install `tinyoffice` from PyPi:\n\n```\n% pip install tinyoffice\n```\n\nNOTE: `tinyoffice` requires `Pillow` (`PIL` Fork) [Pillow](https://pillow.readthedocs.io/en/stable/), which can have installation conflicts. If you experience any issues while installing `tinyoffice`, please follow the `Pillow` installation steps found here: https://pillow.readthedocs.io/en/stable/installation.html.\n\n\n## Usage\n\n```\nusage: tinyoffice [-h] [-r] [-c] [-v]\n [-t .docx .pptx .xlsx [.docx .pptx .xlsx ...]] [--overwrite]\n [-o OUTPUT] [-exts EXTENSIONS [EXTENSIONS ...]]\n path\n\nMake your Office files tiny!\n\npositional arguments:\n path File or directory path.\n If a file and recurse (-r/--recurse) is not set, only that file will be compressed.\n If a directory and recurse is not set, only the top-level files in the directory will be compressed.\n If recurse is set, everything at path and below will be compressed.\n\noptions:\n -h, --help show this help message and exit\n -r, --recurse Flag for if tinyoffice should recursively search for files. Default is False\n -c, --convert Flag for if TIFF files should be converted to JPEGs. Default is False\n -v, --verbose Flag for verbosity levels. Can be set multiple times, e.g., -vv, for increased verbosity\n -t .docx .pptx .xlsx [.docx .pptx .xlsx ...], --types .docx .pptx .xlsx [.docx .pptx .xlsx ...]\n Filetype extensions to compress.\n Default is .docx, .pptx, .xlsx\n --overwrite Flag for if an existing file should be overwritten. Default is False\n -o OUTPUT, --output OUTPUT\n Path for the output location.\n -exts EXTENSIONS [EXTENSIONS ...], --extensions EXTENSIONS [EXTENSIONS ...]\n Image extensions to compress. Default will be only the extensions that are supported by Pillow on your system.\n Should be ignored.\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Make your Office files tiny!",
"version": "0.0.5",
"project_urls": {
"Homepage": "https://github.com/PyWoody/tinyoffice"
},
"split_keywords": [
"office",
" compress",
" convert",
" image",
" word",
" excel",
" powerpoint"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2901e9d0b5a96da84bc81f00946e8ba1ea862c43c2d94cbec3187b5c43feb92e",
"md5": "adc98d662ca2b0e18563822ba8e41453",
"sha256": "7a645e997f35497205f3621f7f8dad8204b459d4bf93720742d2877b3e77ebfb"
},
"downloads": -1,
"filename": "tinyoffice-0.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "adc98d662ca2b0e18563822ba8e41453",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 8651,
"upload_time": "2024-08-28T19:23:43",
"upload_time_iso_8601": "2024-08-28T19:23:43.449116Z",
"url": "https://files.pythonhosted.org/packages/29/01/e9d0b5a96da84bc81f00946e8ba1ea862c43c2d94cbec3187b5c43feb92e/tinyoffice-0.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6c00168699aae7c616d9c93f88377c5bc06185da8e40ebf72b52a19123e91e21",
"md5": "46f3ac29ef6bc471fa0529103107daaa",
"sha256": "45c04057fafad5879b6ffe57427b556508047c7617be2fad693ce18b08f1580b"
},
"downloads": -1,
"filename": "tinyoffice-0.0.5.tar.gz",
"has_sig": false,
"md5_digest": "46f3ac29ef6bc471fa0529103107daaa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 9797,
"upload_time": "2024-08-28T19:23:44",
"upload_time_iso_8601": "2024-08-28T19:23:44.786940Z",
"url": "https://files.pythonhosted.org/packages/6c/00/168699aae7c616d9c93f88377c5bc06185da8e40ebf72b52a19123e91e21/tinyoffice-0.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-28 19:23:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "PyWoody",
"github_project": "tinyoffice",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "tinyoffice"
}
JSON
