{ "info": { "author": "John A. Barbuto", "author_email": "jbarbuto@egnyte.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: System Administrators", "License :: OSI Approved :: MIT License", "Operating System :: POSIX", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Topic :: Communications :: Chat", "Topic :: System :: Archiving" ], "description": "Introduction\n============\n\nOfArchiver generates HTML archives of chat rooms on an\n`Openfire `_\ninstant messaging server.\n\nExample usage is as follows::\n\n from ofarchiver import OfArchiver\n\n ofa = OfArchiver()\n for room in ofa.get_rooms():\n ofa.gen_archive(room)\n\nA script called *ofarchiver* is also installed, which takes advantage of the\n`multiprocessing `_\nPython module to speed up archive generation on installations with multiple\nchat rooms. It can serve as a cron job to generate archives at a given\ninterval.\n\nRequirements\n============\n\n* An Openfire server with chat rooms (tested with 3.7.0).\n* MySQL as the Openfire database (tested with 5.0).\n* A web server (tested with Apache 2.2 and its\n `mod_autoindex `_\n module).\n* Python 2.6 or higher (available for RHEL/CentOS 5 in\n `EPEL `_ as\n `python26 `_).\n\nInstallation\n============\n\n* With ``pip``::\n\n sudo pip install OfArchiver\n\n* With ``easy_install``::\n\n sudo easy_install OfArchiver\n\n* From source::\n\n git clone http://github.com/egnyte/ofarchiver\n cd ofarchiver\n python setup.py build\n sudo python setup.py install\n\nConfiguration\n=============\n\nOpenfire\n--------\n\nThe `Monitoring Service\n`_\nOpenfire plugin must be installed and configured.\n\n1. Log into the Openfire admin panel and select the *Plugins* tab.\n2. Install the ``Monitoring Service`` plugin.\n3. Select the *Server* tab, then the *Archiving* subtab.\n4. Under *Archiving Settings*, enable **Archive group chats**.\n\nOfArchiver\n----------\n\nAn *ofarchiver.ini* configuration file is included which must be copied to\none of the following locations (listed in the order in which they are checked):\n\n* */usr/local/etc*\n* */etc*\n* The user's home directory (**$HOME**)\n\nIt consists of the following sections (mandatory options have a ******):\n\nmain\n~~~~\n\n basedir **\n The base directory in which to generate the HTML archive.\n\n confserver **\n The name of the Openfire conference server.\n\n db **\n The type of database used by Openfire (only ``mysql`` is currently\n supported).\n\n debug\n Whether to enable debugging statements.\n\n logfile\n A file in which to log informational and/or debugging messages.\n\n org\n The name of the organization running Openfire.\n\n rooms\n A list of rooms for which to generate archives.\n\ndb\n~~\n\n hostname **\n The hostname of the MySQL server.\n\n username **\n A MySQL user, either Openfire's or one created just for OfArchiver\n (only ``SELECT`` privileges on the *ofMessageArchive* table is needed).\n\n password **\n The password for the MySQL user above.\n\n database **\n The MySQL database used by Openfire.\n\ncolors\n~~~~~~\n\n enabled\n Whether to enable colors to more easily differentiate chat room members.\n\n names\n A list of colors to choose from.\n\nWeb Server\n----------\n\nA web server with automatic directory index generation is required to view\nthe HTML archive. Here is a sample configuration for Apache, with\n*/var/www/html/ofarchive* as the archive base directory::\n\n \n Options +Indexes\n IndexOptions FancyIndexing\n IndexOrderDefault Descending Date\n \n\nAdding authentication and encryption is highly recommended.\n\nThanks\n======\n\n* `Egnyte `_ for allowing and encouraging me to\n release this software.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/egnyte/ofarchiver", "keywords": "archiving,chat,html,openfire", "license": "MIT", "maintainer": null, "maintainer_email": null, "name": "ofarchiver", "package_url": "https://pypi.org/project/ofarchiver/", "platform": "POSIX", "project_url": "https://pypi.org/project/ofarchiver/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://github.com/egnyte/ofarchiver" }, "release_url": "https://pypi.org/project/ofarchiver/0.43/", "requires_dist": null, "requires_python": null, "summary": "An HTML archive generator for chat rooms on an Openfire instant messaging server.", "version": "0.43" }, "last_serial": 795679, "releases": { "0.42": [ { "comment_text": "", "digests": { "md5": "5e934f9f76ecd9c41e53cae7d010a8ec", "sha256": "09aff0bf074cb4ffd225567aa01c13e2019696c0f18106a97355ac0151f5c19e" }, "downloads": -1, "filename": "ofarchiver-0.42-py2.6.egg", "has_sig": false, "md5_digest": "5e934f9f76ecd9c41e53cae7d010a8ec", "packagetype": "bdist_egg", "python_version": "2.6", "requires_python": null, "size": 12825, "upload_time": "2011-10-10T05:45:46", "url": "https://files.pythonhosted.org/packages/be/33/a41952a9d8ff408dcbfe533fa67dc8024a6e7a2f1c6bef2150a9e10885a1/ofarchiver-0.42-py2.6.egg" }, { "comment_text": "", "digests": { "md5": "d5888e8c99796f8f6081daef54e88038", "sha256": "eb2fa20d604a95902501b94eed0bcda7131e5f9566df1259bfa7567cf6d06217" }, "downloads": -1, "filename": "ofarchiver-0.42-py2.7.egg", "has_sig": false, "md5_digest": "d5888e8c99796f8f6081daef54e88038", "packagetype": "bdist_egg", "python_version": "2.7", "requires_python": null, "size": 12762, "upload_time": "2011-10-10T07:29:05", "url": "https://files.pythonhosted.org/packages/c1/6c/55f83a6b533e263aba011594237ad18a22eeac0f856bc716249079be362a/ofarchiver-0.42-py2.7.egg" }, { "comment_text": "", "digests": { "md5": "60fc4f1bbb18b0e9d0ead0570094e4cc", "sha256": "ab5da68318a8f561d8a3f782e5127415eb30be1cbbf7f970a959040de2eb72a3" }, "downloads": -1, "filename": "ofarchiver-0.42.tar.gz", "has_sig": false, "md5_digest": "60fc4f1bbb18b0e9d0ead0570094e4cc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12358, "upload_time": "2011-10-10T05:45:45", "url": "https://files.pythonhosted.org/packages/bc/a8/1933aad6d801c859f0afabc9c2d3fe31b0076f993eaaf8728afd62783c1c/ofarchiver-0.42.tar.gz" } ], "0.43": [ { "comment_text": "", "digests": { "md5": "9868939a6085774845fa8279bde591e7", "sha256": "abf738da31ae0dfc5761ab4813af561ee4657a2df65b72f627f881ef36ec38db" }, "downloads": -1, "filename": "ofarchiver-0.43-py2.6.egg", "has_sig": false, "md5_digest": "9868939a6085774845fa8279bde591e7", "packagetype": "bdist_egg", "python_version": "2.6", "requires_python": null, "size": 12748, "upload_time": "2011-11-14T18:56:08", "url": "https://files.pythonhosted.org/packages/52/46/17662883a214370553a7051bbf67dd4a8de5feef82533d20a8230111cb1e/ofarchiver-0.43-py2.6.egg" }, { "comment_text": "", "digests": { "md5": "9ec36aecebe39d31933860cc6cbff78c", "sha256": "43e700a0083fd60732c89f4398491724d66320b915dfa53d24ac7b7fbb04a84b" }, "downloads": -1, "filename": "ofarchiver-0.43-py2.7.egg", "has_sig": false, "md5_digest": "9ec36aecebe39d31933860cc6cbff78c", "packagetype": "bdist_egg", "python_version": "2.7", "requires_python": null, "size": 12674, "upload_time": "2011-11-14T18:57:22", "url": "https://files.pythonhosted.org/packages/b1/76/2640c91ffc8766a5913eb7375d76b204646877dad4097d6478ea7cddf41c/ofarchiver-0.43-py2.7.egg" }, { "comment_text": "", "digests": { "md5": "df8fe0fa62a87e628b3f20d1b44a968f", "sha256": "ced7141f47b9f180dc82c34d7aa13747dbe4558c141f06565e2bf5698fa5d3d7" }, "downloads": -1, "filename": "ofarchiver-0.43.tar.gz", "has_sig": false, "md5_digest": "df8fe0fa62a87e628b3f20d1b44a968f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12580, "upload_time": "2011-11-14T18:55:38", "url": "https://files.pythonhosted.org/packages/38/df/4e88f8f49300c190e35f44b128e1c58edd11c9eb6131f825793b1ee6a7bf/ofarchiver-0.43.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "9868939a6085774845fa8279bde591e7", "sha256": "abf738da31ae0dfc5761ab4813af561ee4657a2df65b72f627f881ef36ec38db" }, "downloads": -1, "filename": "ofarchiver-0.43-py2.6.egg", "has_sig": false, "md5_digest": "9868939a6085774845fa8279bde591e7", "packagetype": "bdist_egg", "python_version": "2.6", "requires_python": null, "size": 12748, "upload_time": "2011-11-14T18:56:08", "url": "https://files.pythonhosted.org/packages/52/46/17662883a214370553a7051bbf67dd4a8de5feef82533d20a8230111cb1e/ofarchiver-0.43-py2.6.egg" }, { "comment_text": "", "digests": { "md5": "9ec36aecebe39d31933860cc6cbff78c", "sha256": "43e700a0083fd60732c89f4398491724d66320b915dfa53d24ac7b7fbb04a84b" }, "downloads": -1, "filename": "ofarchiver-0.43-py2.7.egg", "has_sig": false, "md5_digest": "9ec36aecebe39d31933860cc6cbff78c", "packagetype": "bdist_egg", "python_version": "2.7", "requires_python": null, "size": 12674, "upload_time": "2011-11-14T18:57:22", "url": "https://files.pythonhosted.org/packages/b1/76/2640c91ffc8766a5913eb7375d76b204646877dad4097d6478ea7cddf41c/ofarchiver-0.43-py2.7.egg" }, { "comment_text": "", "digests": { "md5": "df8fe0fa62a87e628b3f20d1b44a968f", "sha256": "ced7141f47b9f180dc82c34d7aa13747dbe4558c141f06565e2bf5698fa5d3d7" }, "downloads": -1, "filename": "ofarchiver-0.43.tar.gz", "has_sig": false, "md5_digest": "df8fe0fa62a87e628b3f20d1b44a968f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12580, "upload_time": "2011-11-14T18:55:38", "url": "https://files.pythonhosted.org/packages/38/df/4e88f8f49300c190e35f44b128e1c58edd11c9eb6131f825793b1ee6a7bf/ofarchiver-0.43.tar.gz" } ] }