{ "info": { "author": "Ronaldo Webb", "author_email": "mobil3.g3nius@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: Developers", "Intended Audience :: End Users/Desktop", "Intended Audience :: System Administrators", "Programming Language :: Python", "Topic :: Communications :: Email", "Topic :: Software Development :: Bug Tracking" ], "description": "============\r\nIntroduction\r\n============\r\n\r\nOnce in a lifetime of a computer user is the need to rename multiple folders or files. Normally, the user will try to find all the locations of the folders or files to be renamed one by one starting from a starting folder (i.e. target folder). Some sample use cases that multiple renaming is done by the user are the following:\r\n\r\n* Copied a bunch of template folders and files and then renamed them accordingly.\r\n* Downloaded a bunch of episode of a TV series and the user has his/her own file naming convention.\r\n* A java developer is duplicating a big working package where the source files have embedded acronyms where he needs to rename those with a new the acronym. \r\n\r\nWithout a simple tool, these use cases are very time consuming to accomplish. This is the motivation that made this simple **Name Modifier** project to exist.\r\n\r\n===========\r\nThe Package\r\n===========\r\n\r\nName Modifier has three packages for different OS:\r\n\r\n============================= ===============================================================================================\r\nPackage Description\r\n============================= ===============================================================================================\r\nnamemod-.zip Contains the Python source codes and documents packaged for Windows and Python 3.4 is required.\r\nnamemod-.tar.gz Contains the Python source codes and documents packaged for Linux and Python 3.4 is required.\r\nnamemod-.win-bin.zip Contains binary for Windows which doesn\u2019t need Python to be installed\r\n============================= ===============================================================================================\r\n\r\nThese packages are normally downloadable in addresses below:\r\n\r\n https://pypi.python.org/pypi/namemod\r\n\r\nand\r\n\r\n https://sourceforge.net/projects/namemodifier/files\r\n\r\nIf the user had Python 3.4 installed, he/she doesn\u2019t necessary needs to download this binary. The user can just use the pip module (see \r\nInstalling the module using pip) for installation.\r\n\r\n==================================\r\nInstalling the Package for Windows\r\n==================================\r\n\r\nThe installation is as easy as downloading the namemod-.win-bin.zip package and extracting it to wherever directory the user needs it to be. Moreover, it is recommended to include the installation directory to the users **PATH environment variable**. \r\n\r\n===============================\r\nInstalling the module using pip\r\n===============================\r\n\r\nIf the user had Python 3.4 installed, he/she can just use the pip module by running the command in Command 1.\r\n\r\n**Command 1. Using pip module for installation**\r\n::\r\n\r\n C:\\>python -m pip install namemod\r\n\r\n=========================\r\nUsing the namemod command\r\n=========================\r\n\r\nName Modifier can be used as easy as the other command line (e.g. dir) known to the user. The main command in this package is **namemod**. This command has many arguments that the user can opt to. \r\nIf the user opted to install namemod using pip module (see Installing the module using pip), all the commands in the following sections can be carried out by using python with the following format found in Command 2:\r\n\r\n**Command 2. Using namemod with python**\r\n::\r\n\r\n python -m namemod [optional arguments] \r\n\r\nThe -h or --help argument\r\n-------------------------\r\n\r\nNormally the first thing to do is to know how to use the command. This can be accomplished quickly by the -h or --help argument. For example, execute the command found in Command 3. \r\n\r\n**Command 3. Using -h argument**\r\n::\r\n\r\n python -m namemod \u2013h\r\n\r\nThe output would be the one shown in Listing 1.\r\n\r\n**Listing 1. -h argument output**\r\n::\r\n\r\n usage: namemod [-h] [-f] [-F] [-i] [-I] [-m {text,regex}] [-n] [-R]\r\n [-xr regex] [-xt text] [-Xr regex] [-Xt text] [-v]\r\n folder old_name_segment new_name_segment\r\n\r\n Simplifying multiple files or folders renames.\r\n\r\n positional arguments:\r\n folder Specifies the target folder to process.\r\n old_name_segment Old name segment to be renamed.\r\n new_name_segment New name segment.\r\n\r\n optional arguments:\r\n -h, --help show this help message and exit\r\n -f, --file-only Process only files.\r\n -F, --folder-only Process only folders.\r\n -i, --interactive Ask confirmation before renaming.\r\n -I, --include-target-folder\r\n Include the target folder in renaming.\r\n -m {text,regex}, --mode {text,regex}\r\n Default: text\r\n -n, --noop Inhibit the actual renamig but display the intended\r\n outcome.\r\n -R, --recursive Recursive\r\n -xr regex, --exclude-file-regex regex\r\n Exclude files by regex.\r\n -xt text, --exclude-file-text text\r\n Exclude files by exact text match.\r\n -Xr regex, --exclude-folder-regex regex\r\n Exclude folders by regex.\r\n -Xt text, --exclude-folder-text text\r\n Exclude folders by exact text match.\r\n -v, --version show program's version number and exit\r\n\r\nFor more information about the usage, please download the user guide from https://sourceforge.net/projects/namemodifier/files", "description_content_type": null, "docs_url": null, "download_url": "https://sourceforge.net/projects/namemodifier/files/latest/download", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://sourceforge.net/projects/namemodifier", "keywords": "name rename tool console windows linux utility", "license": "UNKNOWN", "maintainer": "", "maintainer_email": "", "name": "namemod", "package_url": "https://pypi.org/project/namemod/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/namemod/", "project_urls": { "Download": "https://sourceforge.net/projects/namemodifier/files/latest/download", "Homepage": "https://sourceforge.net/projects/namemodifier" }, "release_url": "https://pypi.org/project/namemod/0.1.1/", "requires_dist": null, "requires_python": null, "summary": "A console tool for renaming files or folders.", "version": "0.1.1" }, "last_serial": 1147257, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "b4335e6dc97ae01f657cf607825c7a22", "sha256": "8d3bef28a91a5435548d1c666f02d5889d538432875f44fdc03ebeb3a40ce49c" }, "downloads": -1, "filename": "namemod-0.1.zip", "has_sig": false, "md5_digest": "b4335e6dc97ae01f657cf607825c7a22", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10005, "upload_time": "2014-07-03T14:09:01", "url": "https://files.pythonhosted.org/packages/b9/52/25d6b19cd0c07b3bd6c256222065f309f78ded76aa642d1264e5d085ee90/namemod-0.1.zip" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "79a0d016b4b87ec8f5ed177daa7a3d44", "sha256": "2548910961aa6e27ae2a48194ed3df79f79738028fef8ef2044b7082db3d2696" }, "downloads": -1, "filename": "namemod-0.1.1.tar.gz", "has_sig": false, "md5_digest": "79a0d016b4b87ec8f5ed177daa7a3d44", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 687423, "upload_time": "2014-07-04T10:25:57", "url": "https://files.pythonhosted.org/packages/95/5c/0828f0f3ececbde23b3868c6747463620fdd52cb9f4ee6a1d7503f5927ca/namemod-0.1.1.tar.gz" }, { "comment_text": "", "digests": { "md5": "881acab20106bb51d81dd312482f23bc", "sha256": "ec58389c359f28ccf9036a4fe39f234e6a5784f85b8a30865c911640c139547f" }, "downloads": -1, "filename": "namemod-0.1.1.zip", "has_sig": false, "md5_digest": "881acab20106bb51d81dd312482f23bc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 693379, "upload_time": "2014-07-04T10:26:09", "url": "https://files.pythonhosted.org/packages/d2/f4/931c069e800f472dfbc3f6dc77464de7ea104326a0078a38cf777f348953/namemod-0.1.1.zip" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "79a0d016b4b87ec8f5ed177daa7a3d44", "sha256": "2548910961aa6e27ae2a48194ed3df79f79738028fef8ef2044b7082db3d2696" }, "downloads": -1, "filename": "namemod-0.1.1.tar.gz", "has_sig": false, "md5_digest": "79a0d016b4b87ec8f5ed177daa7a3d44", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 687423, "upload_time": "2014-07-04T10:25:57", "url": "https://files.pythonhosted.org/packages/95/5c/0828f0f3ececbde23b3868c6747463620fdd52cb9f4ee6a1d7503f5927ca/namemod-0.1.1.tar.gz" }, { "comment_text": "", "digests": { "md5": "881acab20106bb51d81dd312482f23bc", "sha256": "ec58389c359f28ccf9036a4fe39f234e6a5784f85b8a30865c911640c139547f" }, "downloads": -1, "filename": "namemod-0.1.1.zip", "has_sig": false, "md5_digest": "881acab20106bb51d81dd312482f23bc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 693379, "upload_time": "2014-07-04T10:26:09", "url": "https://files.pythonhosted.org/packages/d2/f4/931c069e800f472dfbc3f6dc77464de7ea104326a0078a38cf777f348953/namemod-0.1.1.zip" } ] }