|License| |Build Status|
.. _`_introduction`:
Introduction
============
This project provides a Python 2.7/3.x library for common tasks
especially when writing shell-like scripts. Some of the functionality
overlaps with the standard library but the API is slightly modified.
The goal of this project is to leverage the straightforward, clean
syntax of Python while avoiding some of the boilerplate code that might
be necessary when using the standard library. Functions that overlap
with the standard library are designed to do what you would reasonably
expect
(`POLA <https://en.wikipedia.org/wiki/Principle_of_least_astonishment>`__)
and, when necessary, fail **without** throwing exceptions.
Please note when using this library that operations will fail silently.
This is a deliberate design decision. However, there is often a way to
check if an operation has failed and optionally throw and exception if
that is desirable:
.. code:: python
auxly.filesys.copy("foo.txt", "bar") or auxly.throw() # Throws/raises exception on failure.
Auxly provides the following modules:
- `auxly <https://auxly.readthedocs.io/en/latest/#id1>`__
- `auxly.filesys <https://auxly.readthedocs.io/en/latest/#auxly-filesys>`__
- `auxly.shell <https://auxly.readthedocs.io/en/latest/#auxly-shell>`__
- `auxly.stringy <https://auxly.readthedocs.io/en/latest/#auxly-stringy>`__
- `auxly.listy <https://auxly.readthedocs.io/en/latest/#auxly-listy>`__
The following are basic examples of Auxly (all examples can be found
`here <https://github.com/jeffrimko/Auxly/tree/master/examples>`__):
- `examples/delete_pyc.py <https://github.com/jeffrimko/Auxly/blob/master/examples/delete_pyc.py>`__
- Deletes all PYC files in the project.
- `examples/guess_os.py <https://github.com/jeffrimko/Auxly/blob/master/examples/guess_os.py>`__
- Attempts to guess the host OS based on available shell commands.
Refer to the unit tests
`here <https://github.com/jeffrimko/Auxly/tree/master/tests>`__ for
additional examples.
.. _`_status`:
Status
======
Currently, this project is in the **development release** stage. While
this project is suitable for use, please note that there may be
incompatibilities in new releases.
Release notes are maintained in the project
`changelog <https://github.com/jeffrimko/Auxly/blob/master/CHANGELOG.adoc>`__.
.. _`_requirements`:
Requirements
============
Auxly should run on any Python 2.7/3.x interpreter without additional
dependencies.
.. _`_installation`:
Installation
============
Auxly can be installed with pip using the following command:
``pip install auxly``
Additionally, Auxly can be installed from source by running:
``python setup.py install``
.. _`_documentation`:
Documentation
=============
The full documentation for this project can be found `here on Read the
Docs <http://auxly.readthedocs.io>`__.
.. _`_similar`:
Similar
=======
The following projects are similar and may be worth checking out:
- `Reusables <https://github.com/cdgriffith/Reusables>`__
.. |License| image:: http://img.shields.io/:license-mit-blue.svg
.. |Build Status| image:: https://github.com/jeffrimko/Auxly/workflows/tests/badge.svg
Raw data
{
"_id": null,
"home_page": "https://github.com/jeffrimko/Auxly",
"name": "auxly",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "cli script utility library",
"author": "Jeff Rimko",
"author_email": "jeffrimko@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/b9/00/0337bdfc1127c462828229604b47e7d5e4d66b65159aca24d43aa8f39f5e/auxly-0.9.0.tar.gz",
"platform": null,
"description": "|License| |Build Status|\r\n\r\n.. _`_introduction`:\r\n\r\nIntroduction\r\n============\r\n\r\nThis project provides a Python 2.7/3.x library for common tasks\r\nespecially when writing shell-like scripts. Some of the functionality\r\noverlaps with the standard library but the API is slightly modified.\r\n\r\nThe goal of this project is to leverage the straightforward, clean\r\nsyntax of Python while avoiding some of the boilerplate code that might\r\nbe necessary when using the standard library. Functions that overlap\r\nwith the standard library are designed to do what you would reasonably\r\nexpect\r\n(`POLA <https://en.wikipedia.org/wiki/Principle_of_least_astonishment>`__)\r\nand, when necessary, fail **without** throwing exceptions.\r\n\r\nPlease note when using this library that operations will fail silently.\r\nThis is a deliberate design decision. However, there is often a way to\r\ncheck if an operation has failed and optionally throw and exception if\r\nthat is desirable:\r\n\r\n.. code:: python\r\n\r\n auxly.filesys.copy(\"foo.txt\", \"bar\") or auxly.throw() # Throws/raises exception on failure.\r\n\r\nAuxly provides the following modules:\r\n\r\n- `auxly <https://auxly.readthedocs.io/en/latest/#id1>`__\r\n\r\n- `auxly.filesys <https://auxly.readthedocs.io/en/latest/#auxly-filesys>`__\r\n\r\n- `auxly.shell <https://auxly.readthedocs.io/en/latest/#auxly-shell>`__\r\n\r\n- `auxly.stringy <https://auxly.readthedocs.io/en/latest/#auxly-stringy>`__\r\n\r\n- `auxly.listy <https://auxly.readthedocs.io/en/latest/#auxly-listy>`__\r\n\r\nThe following are basic examples of Auxly (all examples can be found\r\n`here <https://github.com/jeffrimko/Auxly/tree/master/examples>`__):\r\n\r\n- `examples/delete_pyc.py <https://github.com/jeffrimko/Auxly/blob/master/examples/delete_pyc.py>`__\r\n - Deletes all PYC files in the project.\r\n\r\n- `examples/guess_os.py <https://github.com/jeffrimko/Auxly/blob/master/examples/guess_os.py>`__\r\n - Attempts to guess the host OS based on available shell commands.\r\n\r\nRefer to the unit tests\r\n`here <https://github.com/jeffrimko/Auxly/tree/master/tests>`__ for\r\nadditional examples.\r\n\r\n.. _`_status`:\r\n\r\nStatus\r\n======\r\n\r\nCurrently, this project is in the **development release** stage. While\r\nthis project is suitable for use, please note that there may be\r\nincompatibilities in new releases.\r\n\r\nRelease notes are maintained in the project\r\n`changelog <https://github.com/jeffrimko/Auxly/blob/master/CHANGELOG.adoc>`__.\r\n\r\n.. _`_requirements`:\r\n\r\nRequirements\r\n============\r\n\r\nAuxly should run on any Python 2.7/3.x interpreter without additional\r\ndependencies.\r\n\r\n.. _`_installation`:\r\n\r\nInstallation\r\n============\r\n\r\nAuxly can be installed with pip using the following command:\r\n``pip install auxly``\r\n\r\nAdditionally, Auxly can be installed from source by running:\r\n``python setup.py install``\r\n\r\n.. _`_documentation`:\r\n\r\nDocumentation\r\n=============\r\n\r\nThe full documentation for this project can be found `here on Read the\r\nDocs <http://auxly.readthedocs.io>`__.\r\n\r\n.. _`_similar`:\r\n\r\nSimilar\r\n=======\r\n\r\nThe following projects are similar and may be worth checking out:\r\n\r\n- `Reusables <https://github.com/cdgriffith/Reusables>`__\r\n\r\n.. |License| image:: http://img.shields.io/:license-mit-blue.svg\r\n.. |Build Status| image:: https://github.com/jeffrimko/Auxly/workflows/tests/badge.svg\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python library for common shell-like script tasks.",
"version": "0.9.0",
"split_keywords": [
"cli",
"script",
"utility",
"library"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b9000337bdfc1127c462828229604b47e7d5e4d66b65159aca24d43aa8f39f5e",
"md5": "e120df7f5143d63c9335c9c5fbe6e4e1",
"sha256": "76dd5a37b75e61eadce6554150a72e2ef44f6183b57ad0b45a3476b11f436d5f"
},
"downloads": -1,
"filename": "auxly-0.9.0.tar.gz",
"has_sig": false,
"md5_digest": "e120df7f5143d63c9335c9c5fbe6e4e1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 13439,
"upload_time": "2023-04-18T02:48:00",
"upload_time_iso_8601": "2023-04-18T02:48:00.153321Z",
"url": "https://files.pythonhosted.org/packages/b9/00/0337bdfc1127c462828229604b47e7d5e4d66b65159aca24d43aa8f39f5e/auxly-0.9.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-18 02:48:00",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "jeffrimko",
"github_project": "Auxly",
"travis_ci": true,
"coveralls": false,
"github_actions": true,
"lcname": "auxly"
}
JSON
