Metadata-Version: 2.4
Name: dewi
Version: 2.4.0
Summary: DEWI - A toolchain and framework for everyday tasks
Author-email: Laszlo Attila Toth <python-dewi@laszloattilatoth.me>
Maintainer-email: Laszlo Attila Toth <python-dewi@laszloattilatoth.me>
License-Expression: LGPL-3.0-only
Project-URL: Homepage, https://github.com/LA-Toth/dewi
Keywords: tool,framework,development,synchronization
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: System :: Filesystems
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Documentation :: Sphinx
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/x-rst
License-File: COPYING
Requires-Dist: dewi-dataclass<3,>=2.0.0
Requires-Dist: dewi_core<7,>=6.1.1
Requires-Dist: dewi_utils<5,>=4.0.1
Requires-Dist: dewi_module_framework<3,>=2.0.3
Requires-Dist: dewi_logparsers<3,>=2.1.1
Requires-Dist: dewi_realtime_sync<4,>=3.0.0
Requires-Dist: dewi_commands<4,>=3.2.0
Dynamic: license-file

DEWI: A set of commands and a framework
=======================================

Name
----
DEWI: Old Welsh form of David

The name is chosen because of the similarity to DWA, which was the project's
original name, which stands for Developer's Work Area.


Purpose
-------

As the name implies the original purpose was to add tools.

It's not split to many different packages:
  * dewi_dataclass_
  * dewi_core_
  * dewi_utils_
  * dewi_module_framework_
  * dewi_logparsers_
  * dewi_realtime_sync_
  * dewi_commands_  - which is the main package a a command-line tool

.. _dewi_dataclass: https://github.com/LA-Toth/dewi-dataclass
.. _dewi_core: https://github.com/LA-Toth/dewi_core
.. _dewi_utils: https://github.com/LA-Toth/dewi_utils
.. _dewi_module_framework: https://github.com/LA-Toth/dewi_module_framework
.. _dewi_logparsers: https://github.com/LA-Toth/dewi_logparsers
.. _dewi_realtime_sync: https://github.com/LA-Toth/dewi_realtime_sync
.. _dewi_commands: https://github.com/LA-Toth/dewi_commands


Installation
------------

It can be installed from source::

        python3 setup.py

Or from pip::

        pip install dewi


Usage as a command-line tool
----------------------------

Common usage
~~~~~~~~~~~~

To print its help::

        dewi -h

To print dewi_commands.commands with their descriptions::

        dewi
        dewi list

To print dewi_commands.commands with their aliases and descriptions::

        dewi list-all

An example: I want to open ~/.ssh/known_hosts at line 123, and it's
listed on the console as ~/.ssh/known_hosts:123. After copy-paste::

        dewi edit ~/.ssh/known_hosts:123

And it starts `vim` with arguments `~/.ssh/known_hosts +123`
