{ "info": { "author": "Micha\u0142 M. Wi\u0119c\u0142aw", "author_email": "mwieclaw@icho.edu.pl", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Science/Research", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Topic :: Scientific/Engineering" ], "description": "# zeetoo\n\nA collection of various Python scripts created as a help in everyday work in Team II IChO PAS.\n\n- [Geting Started](#getting-started)\n- [Running Scripts](#running-scripts)\n - [Command Line Interface](#command-line-interface)\n - [Python API](#python-api)\n - [Graphical User Interface](#graphical-user-interface)\n- [Description of modules](#description-of-modules)\n - [backuper](#backuper) - simple automated backup tool for Windows\n - [confsearch](#confsearch) - find conformers of given molecule using RDKit\n - [fixgvmol](#fixgvmol) - correct .mol files created with GaussView software\n - [getcdx](#getcdx) - extract all ChemDraw files embedded in .docx file\n - [gofproc](#gofproc) - simple script for processing Gaussian output files\n - [sdf_to_gjf](#sdf_to_gjf) - save molecules from .sdf file as separate .gjf files\n- [Requirements](#requirements)\n- [License & Disclaimer](#license--disclaimer)\n- [Changelog](#changelog)\n\n## Getting Started\n\nTo use this collection of scripts you will need a Python 3 interpreter.\nYou can download an installer of latest version from [python.org](https://www.python.org)\n(a shortcut to direct download for Windows:\n[Python 3.7.4 Windows x86 executable installer](https://www.python.org/ftp/python/3.7.4/python-3.7.4.exe)).\n\nThe easiest way to get **zeetoo** up and running is to run `pip install zeetoo` in the command line*.\nAlternatively, you can download this package as zip file using 'Clone or download' button on this site.\nUnzip the package and from the resulting directory run `python setup.py install`\nin the command line*.\n\nAnd that's it, you're ready to go!\n\n* On windows you can reach command line by right-clicking inside the directory\nwhile holding Shift and then choosing \"Open PowerShell window here\" or \"Open command window here\".\n\n## Running Scripts\n\n### Command Line Interface\n\nAll zeetoo functionality is available from command line.\nAfter installation of the package each module can be accessed with use of\n`zeetoo [module_name] [parameters]`.\nFor more information run `zeetoo --help` to see available modules or\n`zeetoo [module_name] --help` to see the help page for specific module.\n\n### Python API\n\nModules contained in **zeetoo** may also be used directly from python.\nThis section will be supplemented with details on this topic soon.\n\n### Graphical User Interface\n\nA simple graphical user interface (GUI) is available for backuper script.\nPlease refer to the [backuper section](#backuper) for details.\nGUIs for other modules will probably be available in near future.\n\n## Description of Modules\n\n## backuper\n\nA simple Python script for scheduling and running automated backup.\nEssentially, it copies specified files and directories to specified location\nwith regard to date of last modification of both, source file and existing copy:\n- if source file is newer than backup version, the second will be overridden;\n- if both files have the same last modification time, file will not be copied;\n- if backup version is newer, it will be renamed to \"oldname_last-modification-time\"\n and source file will be copied, preserving both versions.\n\nAfter creating a specification for backup job (that is, specifying backup destination\nand files that should be copied; these information are stored in .ini file),\nit may be run manually or scheduled.\nScheduling is currently available only on Windows, as it uses build-in Windows task scheduler.\nIt is important to remember, that this is not a version control software.\nOnly lastly copied version is stored. \nA minimal graphical user interface for this script is available (see below).\n\n### graphical user interface for backuper module\n\nTo start up the graphical user interface (GUI) run `zeetoo backuper_gui` in the command line.\nIf you've downloaded the whole package manually, you may also double-click on start_gui.bat file.\nA window similar to the one below should appear.\nFurther you'll find description of each element of this window.\n\n![screenshot](https://raw.githubusercontent.com/Mishioo/zeetoo/assets/screenshot.png)\n\n1. This field shows path to backup's main directory. Files will be copied there. You can change this field directly or by clicking 2.\n2. Choose backup destination directory using graphical interface.\n3. All files and directories that are meant to be backuped are listed here. It will be called 'source' from now on. For more details read 4-7.\n4. Add file or files to source. Files will be shown in 3 as line without slash character at the end. Each file will be copied to the directory of the same name as directory it is located in; in example shown above it would be 'x:\\path_to\\backup\\destination\\some_important\\text_file.text'.\n5. Add a directory to source. Directories will be shown in 3 as line with slash character at the end. All files (but not subdirectories!) present in this directory will be copied to directory with same name.\n6. Add a directory tree to source. Trees will be shown in 3 as line with slash and star characters at the end. The whole content of chosen directory will be copied, including all files and subdirectories.\n7. Remove selected path from source.\n8. All files and directories marked as ignored will be shown here. Ignored files and directories won't be copied during backup, even if they are inside source directory or tree, or listed as source.\n9. Add file or files to ignored.\n10. Add directory to ignored.\n11. Remove selected item from list of ignored files and directories.\n12. Set how often backup should be run (once a day, once a week or once a month) and at what time.\n13. Schedule backup task according to specified guidelines. WARNING: this will also automatically save configuration file.\n14. Remove backup task scheduled earlier.\n15. Run backup task now, according to specified guidelines. Saving configuration to file not needed.\n16. Load configuration from specified file.\n17. Save configuration.\n\nConfiguration is stored in `[User]/AppData/Local/zeetoo/backuper/config.ini` file.\nAfter scheduling backup task this file should not be moved.\nIt can be modified though, backup task will be done with this modified guidelines from now on.\nScheduling new backup task, even using different configuration file, will override previous task,\nunless task_name in this file is specifically changed.\n\n## confsearch\n\nPerforms a conformational search on set of given molecules. Takes a .mol file (or number of them)\nas an input and saves a list of generated conformers to specified .sdf file.\nSome restriction on this process may be given: a number of conformers to generate,\na minimum RMSD value, a maximum energy difference, a maximum number of optimization cycles,\nand a set of constraints for force field optimization.\n\n## fixgvmol\n\n.mol files created with GaussView (GV5 at least) lack some information, namely a mol version and END line.\nWithout it some programs might not be able to read such files.\nThis script adds these pieces of information to .mol files missing them.\n\n## getcdx\n\nExtracts all embedded ChemDraw files from a .docx document and saves it in a separate directory\n(which might be specified by user), using in-text description of schemes/drawings as file names.\nIt may be specified if description of the scheme/drawing is located above or underneath it\n(the former is default). Finally, It may be specified how long filename should be.\n\n## gofproc\n\nExtracts information about molecule energy and imaginary frequencies from given set of Gaussian\noutput files with *freq* job performed. Extracted data might be written to terminal (stdout)\nor to specified .xlsx file (must not be opened in other programs) at the end of the file or\nappended to a row, based on name of the file parsed.\nCalculations, that did not converged are reported separately.\n\n## sdf_to_gjf\n\nWrites molecules contained in an .sdf file to a set of .gjf files in accordance with the guidelines\ngiven by user.\n\n# Requirements\n\n- getcdx module requires olefile package\n- gofproc module requires openpyxl package\n- confsearch module requires RDKit software\n\nPlease note, that the RDKit **will not** be installed automatically with this package.\nThe recommended way to get RDKit software is through use of Anaconda Python distribution.\nPlease refer to RDKit documentation for more information.\n\n# License & Disclaimer\n\nSee the LICENSE.txt file for license rights and limitations (MIT).\n\n# Changelog\n\n## v.0.1.2\n\n- getcdx now changes characters forbidden in file names to \"-\" instead of raising an exception\n- start_gui.bat should now work regardless its location\n\n## v.0.1.1\n\n- fixed import errors when run as module\n\n## v.0.1.0\n\n- initial release\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/mishioo/zeetoo", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "zeetoo", "package_url": "https://pypi.org/project/zeetoo/", "platform": "", "project_url": "https://pypi.org/project/zeetoo/", "project_urls": { "Homepage": "https://github.com/mishioo/zeetoo" }, "release_url": "https://pypi.org/project/zeetoo/0.1.2/", "requires_dist": [ "openpyxl", "olefile" ], "requires_python": "", "summary": "A humble collection of various everyday utility scripts from Team II IChO PAS.", "version": "0.1.2" }, "last_serial": 5577295, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "e3834e4685adc1e826b2aed367d66340", "sha256": "8f7d89b783b99c87c9fa4de41e8dd1ad8119b4935538fe29d58649d26edc1217" }, "downloads": -1, "filename": "zeetoo-0.1.0-py3.7.egg", "has_sig": false, "md5_digest": "e3834e4685adc1e826b2aed367d66340", "packagetype": "bdist_egg", "python_version": "3.7", "requires_python": null, "size": 48498, "upload_time": "2019-07-23T14:14:47", "url": "https://files.pythonhosted.org/packages/d7/21/9920a65493fc4c3d3737d6b66ff06dfd97922d00fb19df2b88aba434133d/zeetoo-0.1.0-py3.7.egg" }, { "comment_text": "", "digests": { "md5": "ca1a1d6b4ebbce61551165cd18756ad6", "sha256": "6fb27bae4ff87f532148a741731832ee9c6eae1cec9cb8d7b42bb6fcefab4933" }, "downloads": -1, "filename": "zeetoo-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "ca1a1d6b4ebbce61551165cd18756ad6", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 22956, "upload_time": "2019-07-23T14:14:44", "url": "https://files.pythonhosted.org/packages/4e/88/1671cfdb9b410bd987e7ef2214a92fffa191f3929dc0cac51c8cc44a7298/zeetoo-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "4804e92ef355ea91c0b0d5a0138a1a9c", "sha256": "4aba90060bc14ffed41dfcf3b094352d9dcfecd5c8bf4cd4798266fc794b8fa2" }, "downloads": -1, "filename": "zeetoo-0.1.0.tar.gz", "has_sig": false, "md5_digest": "4804e92ef355ea91c0b0d5a0138a1a9c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22622, "upload_time": "2019-07-23T14:14:48", "url": "https://files.pythonhosted.org/packages/4e/a0/744c8878df1c452e98729d7cb7fbfeaf99869d91e1e70d11b9ebaceb89eb/zeetoo-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "8f3408232c6c505293fc5c11f916ca83", "sha256": "77c7e402900017787b2f06c122e11b6e08f497ecfeb1c1c5bfcf72b589b6dbbc" }, "downloads": -1, "filename": "zeetoo-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "8f3408232c6c505293fc5c11f916ca83", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 22998, "upload_time": "2019-07-23T14:46:19", "url": "https://files.pythonhosted.org/packages/c4/27/05a1ec7df54d85e7d4835764b25f4ddf140a3fcbba634af8f0d54e7eed91/zeetoo-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "c6cca10d759fc12a264620a5b7497611", "sha256": "55a57ffa620a99765f0d309bfa7f0568185d01ebf4a20b91f134c6fc35b3b8b1" }, "downloads": -1, "filename": "zeetoo-0.1.1.tar.gz", "has_sig": false, "md5_digest": "c6cca10d759fc12a264620a5b7497611", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22638, "upload_time": "2019-07-23T14:46:20", "url": "https://files.pythonhosted.org/packages/e3/be/51c331c1c3d3fc2360fbc45271e68a7f5130420f573804a9906202905bac/zeetoo-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "5148e9dd074fe7b66b02754d489bec4d", "sha256": "19d2d8107a3031380b693fdf449a9fec1a1e1efb4f7217ac0e029b1a30674993" }, "downloads": -1, "filename": "zeetoo-0.1.2-py3-none-any.whl", "has_sig": false, "md5_digest": "5148e9dd074fe7b66b02754d489bec4d", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 23212, "upload_time": "2019-07-24T12:07:16", "url": "https://files.pythonhosted.org/packages/27/d8/c1063b90655798d51c9fe215f4e338f8dbc2ab8163383d738c816a2eedca/zeetoo-0.1.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "4ee6ba3a4393bfa262882392d41af491", "sha256": "b3b3e3bf871952e4d04613557e268b9e5be6b7d730fa6904b52512fd0db51f6d" }, "downloads": -1, "filename": "zeetoo-0.1.2.tar.gz", "has_sig": false, "md5_digest": "4ee6ba3a4393bfa262882392d41af491", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23009, "upload_time": "2019-07-24T12:07:17", "url": "https://files.pythonhosted.org/packages/6f/44/ebb5da041197b743585cd8f374aaacc0504f70cf04dd99631c0b381b76c3/zeetoo-0.1.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "5148e9dd074fe7b66b02754d489bec4d", "sha256": "19d2d8107a3031380b693fdf449a9fec1a1e1efb4f7217ac0e029b1a30674993" }, "downloads": -1, "filename": "zeetoo-0.1.2-py3-none-any.whl", "has_sig": false, "md5_digest": "5148e9dd074fe7b66b02754d489bec4d", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 23212, "upload_time": "2019-07-24T12:07:16", "url": "https://files.pythonhosted.org/packages/27/d8/c1063b90655798d51c9fe215f4e338f8dbc2ab8163383d738c816a2eedca/zeetoo-0.1.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "4ee6ba3a4393bfa262882392d41af491", "sha256": "b3b3e3bf871952e4d04613557e268b9e5be6b7d730fa6904b52512fd0db51f6d" }, "downloads": -1, "filename": "zeetoo-0.1.2.tar.gz", "has_sig": false, "md5_digest": "4ee6ba3a4393bfa262882392d41af491", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23009, "upload_time": "2019-07-24T12:07:17", "url": "https://files.pythonhosted.org/packages/6f/44/ebb5da041197b743585cd8f374aaacc0504f70cf04dd99631c0b381b76c3/zeetoo-0.1.2.tar.gz" } ] }