opd


Nameopd JSON
Version 220 PyPI version JSON
download
home_pageNone
SummaryOriginal Programmer Daemon
upload_time2024-08-14 16:12:47
maintainerNone
docs_urlNone
authorNone
requires_pythonNone
licensePublic Domain
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            NAME

::

    OPD - Original Programmer Daemon


SYNOPSIS

::

    op  <cmd> [key=val] [key==val]
    opc [-i] [-v]
    opd 


DESCRIPTION

::

    OPD has all the python3 code to program a unix cli program, such as
    disk perisistence for configuration files, event handler to
    handle the client/server connection, code to introspect modules
    for commands, deferred exception handling to not crash on an
    error, a parser to parse commandline options and values, etc.

    OPD uses object programming (OP) that allows for easy json save//load
    to/from disk of objects. It provides an "clean namespace" Object class
    that only has dunder methods, so the namespace is not cluttered with
    method names. This makes storing and reading to/from json possible.

    OPD has a demo bot, it can connect to IRC, fetch and display RSS
    feeds, take todo notes, keep a shopping list and log text. You can
    also copy/paste the service file and run it under systemd for 24/7
    presence in a IRC channel.

    OPD is Public Domain.


INSTALL

::

    $ pipx install opd
    $ pipx ensurepath

    <new terminal>

    $ op srv > opd.service
    # mv *.service /etc/systemd/system/
    # systemctl enable opd --now

    joins #op on localhost


USAGE

::

    without any argument the bot does nothing::

    $ op
    $

    see list of commands

    $ op cmd
    cmd,skl,srv


    start a console

    $ opc
    >

    start daemon

    $ opd
    $ 


CONFIGURATION

::

    irc

    $ op cfg server=<server>
    $ op cfg channel=<channel>
    $ op cfg nick=<nick>

    sasl

    $ op pwd <nsvnick> <nspass>
    $ op cfg password=<frompwd>

    rss

    $ op rss <url>
    $ op dpl <url> <item1,item2>
    $ op rem <url>
    $ op nme <url> <name>


COMMANDS

::

    cfg - irc configuration
    cmd - commands
    mre - displays cached output
    pwd - sasl nickserv name/pass


FILES

::

    ~/.op
    ~/.local/bin/op
    ~/.local/bin/opc
    ~/.local/bin/opd
    ~/.local/pipx/venvs/opd/*


AUTHOR

::

    Bart Thate <bthate@dds.nl>


COPYRIGHT

::

    OPD is Public Domain.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "opd",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": null,
    "author": null,
    "author_email": "Bart Thate <bthate@dds.nl>",
    "download_url": "https://files.pythonhosted.org/packages/a0/31/f7b408de4c1f6fc220f96754da7ef82a9eba87eca8d63f3d372af68480d3/opd-220.tar.gz",
    "platform": null,
    "description": "NAME\n\n::\n\n    OPD - Original Programmer Daemon\n\n\nSYNOPSIS\n\n::\n\n    op  <cmd> [key=val] [key==val]\n    opc [-i] [-v]\n    opd \n\n\nDESCRIPTION\n\n::\n\n    OPD has all the python3 code to program a unix cli program, such as\n    disk perisistence for configuration files, event handler to\n    handle the client/server connection, code to introspect modules\n    for commands, deferred exception handling to not crash on an\n    error, a parser to parse commandline options and values, etc.\n\n    OPD uses object programming (OP) that allows for easy json save//load\n    to/from disk of objects. It provides an \"clean namespace\" Object class\n    that only has dunder methods, so the namespace is not cluttered with\n    method names. This makes storing and reading to/from json possible.\n\n    OPD has a demo bot, it can connect to IRC, fetch and display RSS\n    feeds, take todo notes, keep a shopping list and log text. You can\n    also copy/paste the service file and run it under systemd for 24/7\n    presence in a IRC channel.\n\n    OPD is Public Domain.\n\n\nINSTALL\n\n::\n\n    $ pipx install opd\n    $ pipx ensurepath\n\n    <new terminal>\n\n    $ op srv > opd.service\n    # mv *.service /etc/systemd/system/\n    # systemctl enable opd --now\n\n    joins #op on localhost\n\n\nUSAGE\n\n::\n\n    without any argument the bot does nothing::\n\n    $ op\n    $\n\n    see list of commands\n\n    $ op cmd\n    cmd,skl,srv\n\n\n    start a console\n\n    $ opc\n    >\n\n    start daemon\n\n    $ opd\n    $ \n\n\nCONFIGURATION\n\n::\n\n    irc\n\n    $ op cfg server=<server>\n    $ op cfg channel=<channel>\n    $ op cfg nick=<nick>\n\n    sasl\n\n    $ op pwd <nsvnick> <nspass>\n    $ op cfg password=<frompwd>\n\n    rss\n\n    $ op rss <url>\n    $ op dpl <url> <item1,item2>\n    $ op rem <url>\n    $ op nme <url> <name>\n\n\nCOMMANDS\n\n::\n\n    cfg - irc configuration\n    cmd - commands\n    mre - displays cached output\n    pwd - sasl nickserv name/pass\n\n\nFILES\n\n::\n\n    ~/.op\n    ~/.local/bin/op\n    ~/.local/bin/opc\n    ~/.local/bin/opd\n    ~/.local/pipx/venvs/opd/*\n\n\nAUTHOR\n\n::\n\n    Bart Thate <bthate@dds.nl>\n\n\nCOPYRIGHT\n\n::\n\n    OPD is Public Domain.\n",
    "bugtrack_url": null,
    "license": "Public Domain",
    "summary": "Original Programmer Daemon",
    "version": "220",
    "project_urls": {
        "bugs": "https://github.com/bthate/opd/issues",
        "home": "https://pypi.org/project/opd",
        "source": "https://github.com/bthate/opd"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "a031f7b408de4c1f6fc220f96754da7ef82a9eba87eca8d63f3d372af68480d3",
                "md5": "6c2ba266c673ef11b94a79823f6e4ece",
                "sha256": "80b17e0d834524648541acd0e7db1e403f2362c7f34ec8c3e5039e20cb54d1d3"
            },
            "downloads": -1,
            "filename": "opd-220.tar.gz",
            "has_sig": false,
            "md5_digest": "6c2ba266c673ef11b94a79823f6e4ece",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 23623,
            "upload_time": "2024-08-14T16:12:47",
            "upload_time_iso_8601": "2024-08-14T16:12:47.236119Z",
            "url": "https://files.pythonhosted.org/packages/a0/31/f7b408de4c1f6fc220f96754da7ef82a9eba87eca8d63f3d372af68480d3/opd-220.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-08-14 16:12:47",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "bthate",
    "github_project": "opd",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "opd"
}
        
Elapsed time: 0.82375s