====
IMGX
====
.. image:: https://img.shields.io/pypi/v/imgx.svg
:target: https://pypi.python.org/pypi/imgx
.. image:: https://img.shields.io/travis/M-Farag/imgx.svg
:target: https://travis-ci.com/M-Farag/imgx
.. image:: https://readthedocs.org/projects/imgx/badge/?version=latest
:target: https://imgx.readthedocs.io/en/latest/?version=latest
:alt: Documentation Status
IMGX is a powerful, easy-to-use image processing package developed by Synth9, designed to help photographers and organizations efficiently manage and organize large image libraries across various storage devices.
* Free software: MIT license
* Documentation: https://imgx.readthedocs.io.
Features
--------
IMGX currently offers the following functionalities:
- **Directory Flattening**: Simplify your folder structure by flattening one level of subdirectories, moving all image files into the parent directory. This feature helps in consolidating scattered images into one location, making them easier to access and manage.
- **Metadata Extraction and Recording**: Automatically extract metadata from images and write this information into a file. This feature aids in cataloging and maintaining essential details about each image, such as the file size, image name, and path.
How to Use
----------
1. **Installation**:
Install IMGX using pip:
.. code-block:: bash
pip install imgx
2. **Flattening Directories via CLI**:
To flatten directories using the command line, run:
.. code-block:: bash
imgx flat /path/to/your/directory
This command will flatten the directory structure at the specified path, moving all images to the parent directory.
3. **Extracting and Recording Metadata via CLI**:
To extract metadata and write it to a file using the command line, run:
.. code-block:: bash
imgx read /path/to/your/directory
This command will read the metadata from all images in the specified directory and write the information to a file in the same directory.
Credits
-------
This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
=======
History
=======
0.1.0 (2024-04-05)
------------------
* First release on PyPI.
Raw data
{
"_id": null,
"home_page": "https://github.com/M-Farag/imgx",
"name": "imgx",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "imgx",
"author": "Mina Amin",
"author_email": "mina.farag@icloud.com",
"download_url": "https://files.pythonhosted.org/packages/c8/a5/b639a4e1ac6f92e5950c5fb59c9c37538e7e96bea890fdb26b954e72c109/imgx-0.1.3.tar.gz",
"platform": null,
"description": "====\nIMGX\n====\n\n.. image:: https://img.shields.io/pypi/v/imgx.svg\n :target: https://pypi.python.org/pypi/imgx\n\n.. image:: https://img.shields.io/travis/M-Farag/imgx.svg\n :target: https://travis-ci.com/M-Farag/imgx\n\n.. image:: https://readthedocs.org/projects/imgx/badge/?version=latest\n :target: https://imgx.readthedocs.io/en/latest/?version=latest\n :alt: Documentation Status\n\nIMGX is a powerful, easy-to-use image processing package developed by Synth9, designed to help photographers and organizations efficiently manage and organize large image libraries across various storage devices.\n\n* Free software: MIT license\n* Documentation: https://imgx.readthedocs.io.\n\nFeatures\n--------\n\nIMGX currently offers the following functionalities:\n\n- **Directory Flattening**: Simplify your folder structure by flattening one level of subdirectories, moving all image files into the parent directory. This feature helps in consolidating scattered images into one location, making them easier to access and manage.\n\n- **Metadata Extraction and Recording**: Automatically extract metadata from images and write this information into a file. This feature aids in cataloging and maintaining essential details about each image, such as the file size, image name, and path.\n\nHow to Use\n----------\n\n1. **Installation**:\n\n Install IMGX using pip:\n\n .. code-block:: bash\n\n pip install imgx\n\n2. **Flattening Directories via CLI**:\n\n To flatten directories using the command line, run:\n\n .. code-block:: bash\n\n imgx flat /path/to/your/directory\n\n This command will flatten the directory structure at the specified path, moving all images to the parent directory.\n\n3. **Extracting and Recording Metadata via CLI**:\n\n To extract metadata and write it to a file using the command line, run:\n\n .. code-block:: bash\n\n imgx read /path/to/your/directory\n\n This command will read the metadata from all images in the specified directory and write the information to a file in the same directory.\n\nCredits\n-------\n\nThis package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.\n\n.. _Cookiecutter: https://github.com/audreyr/cookiecutter\n.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage\n\n\n=======\nHistory\n=======\n\n0.1.0 (2024-04-05)\n------------------\n\n* First release on PyPI.\n",
"bugtrack_url": null,
"license": "MIT license",
"summary": "Image processing package",
"version": "0.1.3",
"project_urls": {
"Homepage": "https://github.com/M-Farag/imgx"
},
"split_keywords": [
"imgx"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "79faabd98c4231cb4bd1fff764a7bb3dbe57f8e8e8da6ff2e42430c8c9d0eb97",
"md5": "672ff5068a1abba470493d05ceb75395",
"sha256": "c1663a7067317c048765dc7aca13a84974f7f578038f735fa8c6ac845677d1ca"
},
"downloads": -1,
"filename": "imgx-0.1.3-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "672ff5068a1abba470493d05ceb75395",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.6",
"size": 5987,
"upload_time": "2024-04-14T05:56:53",
"upload_time_iso_8601": "2024-04-14T05:56:53.004399Z",
"url": "https://files.pythonhosted.org/packages/79/fa/abd98c4231cb4bd1fff764a7bb3dbe57f8e8e8da6ff2e42430c8c9d0eb97/imgx-0.1.3-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c8a5b639a4e1ac6f92e5950c5fb59c9c37538e7e96bea890fdb26b954e72c109",
"md5": "a34397fe092dd342fa54fb99210b75df",
"sha256": "7231c6bc4c8d09131a4cb75879344bf851c2fcbebb22866c56b4f2b1289b92bc"
},
"downloads": -1,
"filename": "imgx-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "a34397fe092dd342fa54fb99210b75df",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 12126,
"upload_time": "2024-04-14T05:56:54",
"upload_time_iso_8601": "2024-04-14T05:56:54.730149Z",
"url": "https://files.pythonhosted.org/packages/c8/a5/b639a4e1ac6f92e5950c5fb59c9c37538e7e96bea890fdb26b954e72c109/imgx-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-14 05:56:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "M-Farag",
"github_project": "imgx",
"github_not_found": true,
"lcname": "imgx"
}
JSON
