{ "info": { "author": "Matt GdV", "author_email": "matthewgdv@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "Programming Language :: Python :: 3.7" ], "description": "Overview\n====================\n\nProvides several utilities for handling I/O:\n\nThe `IOHandler` class\n--------------------\n* Api similar to `argparse.ArgumentParser()`, with `IOHandler.add_arg()` (equivalent to `ArgumentParser.add_argument()`) and `IOHandler.collect_input()`\n (equivalent to `ArgumentParser.parse_args()`, also returning a namespace with the arugment values)\n* Uses argparse under-the-hood when processing commandline arguments, but with a custom-built help interface that is more readable (and way prettier!)\n* When no commandline arguments are provided, it will programatically build a GUI to collect user input, with widgets picked base on the 'argtype' argument of `IOHandler.add_arg()`\n* Can also be run programatically by providing the argument values directly to `IOHandler.collect_input()` as a `dict` of argument name-value pairs\n* The `ArgumentParser.add_argument()` function takes arguments telling the IOHandler how to handle nullability, default values, implicit coercion to the right type, whether the\n argument is optional, and commandline aliases\n\nThe `Validate` class\n--------------------\n* An accessor class granting access to several Validator classes through attribute access\n* Currently supports type checking and implicit coercion of the input value to the following supported types (`int`, `float`, `bool`, `str`, `list`, `dict`, `subtypes.DateTime`,\n `pathlib.Path`, `pathmagic.File`, `pathmagic.Dir`)\n* Its attributes are: `Validate.Int`, `Validate.Float`, `Validate.Bool`, `Validate.Str`, `Validate.List`, `Validate.Dict`, `Validate.DateTime`, `Validate.Path`,\n `Validate.File`, `Validate.Dir`\n\nThe `Validator` classes\n--------------------\n* Currently there are `IntegerValidator`, `FloatValidator`, `BoolValidator`, `StringValidator`, `ListValidator`, `DictionaryValidator`, `DateTimeValidator`, `PathValidator`,\n `FileValidator`, `DirValidator`\n* Some of these validators are implemented as a wrapper over typepy, but the api is different\n* Validators can handle nullability as desired, and, where there is an equivalent typepy checker, have strictness levels that can be set.\n* Some validators have additional validation methods to check for values in valid ranges. For example: `Validate.Int().max_value(7).is_valid(9)` would return False.\n* Additional conditions can be added to a validator by passing callbacks that return boolean values to `Validator.add_condition()`\n* The validator can be reused for any number of values once initially set up.\n* `ListValidator` and `DictionaryValidator` will coerce strings by using eval (safely), rather than coercing a string to a list by calling `list()` on it\n\nThe `Gui` class and its various template subclasses\n--------------------\n* Gui class and several template subclasses that can be used alongside the various `WidgetManager` objects to easily set up a GUI, with the exact internals of the\n underlying QT classes abstracted away behind a consistent API. Makes it very quick and easy to set up a simple GUI. Is a thin wrapper around PyQT5.\n* `FormGui` class for quickly setting up forms\n* `HTMLGui` class for Rendering HTML in a separate window\n* `ProgressBarGui` class for wrapping iterables, which will display a progress bar in a separate window as the iterable is consumed\n\nThe `WidgetManager` class and its various widget subclasses\n--------------------\n* Currently supports the following widgets: Label, Button, Checkbox, CheckBar, DropDown, Entry, Text, FileSelect, DirSelect, Calendar, DateTimeEdit, HtmlDisplay, ProgressBar,\n Table, ListTable, DictTable\n* Have a consistent API primarily using the properties `WidgetManager.active`, `WidgetManager.state`, `WidgetManager.text`, and `WidgetManager.parent`.\n\nInstallation\n====================\n\nTo install use pip:\n\n $ pip install pyiotools\n\n\nOr clone the repo:\n\n $ git clone https://github.com/matthewgdv/iotools.git\n $ python setup.py install\n\n\nUsage\n====================\n\nUsage examples coming soon.\n\nContributing\n====================\n\nContributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.\n\nYou can contribute in many ways:\n\nReport Bugs\n--------------------\n\nReport bugs at https://github.com/matthewgdv/iotools/issues\n\nIf you are reporting a bug, please include:\n\n* Your operating system name and version.\n* Any details about your local setup that might be helpful in troubleshooting.\n* Detailed steps to reproduce the bug.\n\nFix Bugs\n--------------------\n\nLook through the GitHub issues for bugs. Anything tagged with \"bug\" and \"help wanted\" is open to whoever wants to implement a fix for it.\n\nImplement Features\n--------------------\n\nLook through the GitHub issues for features. Anything tagged with \"enhancement\" and \"help wanted\" is open to whoever wants to implement it.\n\nWrite Documentation\n--------------------\n\nThe repository could always use more documentation, whether as part of the official docs, in docstrings, or even on the web in blog posts, articles, and such.\n\nSubmit Feedback\n--------------------\n\nThe best way to send feedback is to file an issue at https://github.com/matthewgdv/iotools/issues.\n\nIf you are proposing a new feature:\n\n* Explain in detail how it would work.\n* Keep the scope as narrow as possible, to make it easier to implement.\n* Remember that this is a volunteer-driven project, and that contributions are welcome :)\n\nGet Started!\n--------------------\n\nBefore you submit a pull request, check that it meets these guidelines:\n\n1. If the pull request adds functionality, it should include tests and the docs should be updated. Write docstrings for any functions that are part of the external API, and add\n the feature to the README.md.\n\n2. If the pull request fixes a bug, tests should be added proving that the bug has been fixed. However, no update to the docs is necessary for bugfixes.\n\n3. The pull request should work for the newest version of Python (currently 3.7). Older versions may incidentally work, but are not officially supported.\n\n4. Inline type hints should be used, with an emphasis on ensuring that introspection and autocompletion tools such as Jedi are able to understand the code wherever possible.\n\n5. PEP8 guidelines should be followed where possible, but deviations from it where it makes sense and improves legibility are encouraged. The following PEP8 error codes can be\n safely ignored: E121, E123, E126, E226, E24, E704, W503\n\n6. This repository intentionally disallows the PEP8 79-character limit. Therefore, any contributions adhering to this convention will be rejected. As a rule of thumb you should\n endeavor to stay under 200 characters except where going over preserves alignment, or where the line is mostly non-algorythmic code, such as extremely long strings or function\n calls.\n\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/matthewgdv/iotools", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "pyiotools", "package_url": "https://pypi.org/project/pyiotools/", "platform": "", "project_url": "https://pypi.org/project/pyiotools/", "project_urls": { "Homepage": "https://github.com/matthewgdv/iotools" }, "release_url": "https://pypi.org/project/pyiotools/0.0.2/", "requires_dist": [ "PyQt5", "maybe-else", "pandas", "pathmagic", "pymiscutils", "pysubtypes", "typepy" ], "requires_python": "", "summary": "Provides several utilities for handling I/O", "version": "0.0.2" }, "last_serial": 5959776, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "12ea05186c81423367c53513b3a191ec", "sha256": "c3997fd02d5316d2b97c93d37a56561c81df8dad0b6f097ebce2aac9eac70eed" }, "downloads": -1, "filename": "pyiotools-0.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "12ea05186c81423367c53513b3a191ec", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 19725, "upload_time": "2019-07-29T15:58:11", "url": "https://files.pythonhosted.org/packages/e3/73/050363fecc1e52fc79330e0b57b684d2b964f9c2526179b77c387fd373fb/pyiotools-0.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1a4b7eaa49ad071d0c6cbda12d5839cf", "sha256": "a5d4382abf9148dfdb551a7a5100a4b19fff653afb0d1855e28b818cc189f7d3" }, "downloads": -1, "filename": "pyiotools-0.0.1.tar.gz", "has_sig": false, "md5_digest": "1a4b7eaa49ad071d0c6cbda12d5839cf", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18661, "upload_time": "2019-07-29T15:58:13", "url": "https://files.pythonhosted.org/packages/ae/6a/55611558ff451e0904ed74d7785d358b1a64b3798003183d72895baa59c7/pyiotools-0.0.1.tar.gz" } ], "0.0.2": [ { "comment_text": "", "digests": { "md5": "a1de775ffa91f748a8d2337f44a37c7f", "sha256": "985068a30d95d4012fef04638d17aabdbff622b0c1bc02a9f1c57019f04a8d33" }, "downloads": -1, "filename": "pyiotools-0.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "a1de775ffa91f748a8d2337f44a37c7f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 18303, "upload_time": "2019-10-11T11:00:28", "url": "https://files.pythonhosted.org/packages/1c/3b/0ff5d9955e67fb46fc4ed98c676559938e778dad6ca50b557d439c974e2c/pyiotools-0.0.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "925525185b5b22f1bc711baec5a96166", "sha256": "ecf967f05042563109c81b669a753471cc18b0e5a6b8259043cd2444ef388221" }, "downloads": -1, "filename": "pyiotools-0.0.2.tar.gz", "has_sig": false, "md5_digest": "925525185b5b22f1bc711baec5a96166", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18307, "upload_time": "2019-10-11T11:00:30", "url": "https://files.pythonhosted.org/packages/8a/f9/cb0457f214a0f936da8357d52156ccc950d975674003ab2ef10000987ec1/pyiotools-0.0.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "a1de775ffa91f748a8d2337f44a37c7f", "sha256": "985068a30d95d4012fef04638d17aabdbff622b0c1bc02a9f1c57019f04a8d33" }, "downloads": -1, "filename": "pyiotools-0.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "a1de775ffa91f748a8d2337f44a37c7f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 18303, "upload_time": "2019-10-11T11:00:28", "url": "https://files.pythonhosted.org/packages/1c/3b/0ff5d9955e67fb46fc4ed98c676559938e778dad6ca50b557d439c974e2c/pyiotools-0.0.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "925525185b5b22f1bc711baec5a96166", "sha256": "ecf967f05042563109c81b669a753471cc18b0e5a6b8259043cd2444ef388221" }, "downloads": -1, "filename": "pyiotools-0.0.2.tar.gz", "has_sig": false, "md5_digest": "925525185b5b22f1bc711baec5a96166", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18307, "upload_time": "2019-10-11T11:00:30", "url": "https://files.pythonhosted.org/packages/8a/f9/cb0457f214a0f936da8357d52156ccc950d975674003ab2ef10000987ec1/pyiotools-0.0.2.tar.gz" } ] }