{ "info": { "author": "Michael Meffie", "author_email": "mmeffie@sinenomine.net", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Operating System :: POSIX", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Topic :: Software Development" ], "description": "avdb - AFS version tracking database\n====================================\n\n``avdb`` runs the OpenAFS ``rxdebug`` command in batches to find versions of\nAFS servers running in the wild. The data is stored in a small database.\nSqlite and mysql databases are currently supported.\n\nInstallation\n============\n\nInstall the OpenAFS ``rxdebug`` command before installing ``avdb``. The\n``rxdebug`` command may be installed from packages or from building the OpenAFS\nuser-space packages from source. ``rxdebug`` is the only OpenAFS program used\nby avdb at this time. A cache manager (OpenAFS client) is not required.\n\nA makefile is provided with ``avdb`` to facilate development and installation\nfrom a git checkout. The avdb package can be installed directly from a git\ncheckout with the ``install-user`` target::\n\n $ make install-user\n\nor for site-wide installation::\n\n $ sudo make install\n\nNext, run the ``avdb init`` subcommand to create the database and tables.\nProvide a connection url on the command line to specify the database type and\nthe connection credentials. The connection url will be saved in the avdb\nconfig file ``~/.avdb.ini`` for subsequent invocations of ``avdb``.\n\nTo create an sqlite database::\n\n $ avdb init --url sqlite://////avdb.db\n\nTo create a mysql database::\n\n $ avdb init --url mysql://:@/avdb \\\n --admin \\\n --password \n\nExample usage\n=============\n\nImport the list of cells to be scanned with the 'import' subcommand.::\n\n $ avdb import --csdb https://grand.central.org/dl/cellservdb/CellServDB \\\n --name sinenomine.net\n\n $ avdb list\n\nPeriodically scan the hosts to find versions with the 'scan' subcommand.::\n\n $ avdb scan --nprocs 100 --verbose\n\nOutput the versions discovered the 'report' subcommand.::\n\n $ avdb report --output /tmp/results --format html\n\nConfiguration\n=============\n\navdb command line option defaults may be set by an ini style configuration\nfile. The site-wide configuation file is ``/etc/avdb.ini``, and the per-user\nconfiguration file is located at ``$HOME/.avdb.ini``. The per-user\nconfiguration file will override options present in the site-wide file, and\ncommand-line arguments will override the values in the configuration files.\n\nThe configuration file contains a global section for common options, which\nincludes the sql url to specify the database connection and common logging\noptions. There is are separate sections for each avdb subsections to specify\ndefault values for each subcommand. See the command line help for option names.\n\nExample configuration file::\n\n $ cat ~/.avdb.ini\n [global]\n url = sqlite:////var/lib/avdb/example.db\n log = /tmp/avdb.log\n\n [scan]\n nprocs = 10\n\n [report]\n format = html\n output = /var/www/html/avdb.html\n\nUsing avdb in Python\n====================\n\nIn addition to the command line interface, the avdb module may be imported into\nPython programs. This allows the avdb subcommands to be invoked directly as\nregular Python functions. All of the subcommand functions have a single\ntrailing underscore to avoid naming conflicts with standard python names. For\nexample, function for the import subcommand is called ``import_``.\n\nThe database connection url must be set once before calling avdb subcommand\nfunctions. Use the ``avdb.model.init_db()`` function to set the connection url.\n\nThe avdb config parser object, if needed, is available as\n``avdb.subcmd.config``.\n\nExample::\n\n import avdb\n url = avdb.subcmd.config.get('global', 'url')\n avdb.model.init_db(url)\n avdb.import_(name='sinenomine.net')\n avdb.scan_(nprocs=20)\n avdb.report_(format='html', output='myfile.html')\n\n\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/meffie/avdb", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "avdb", "package_url": "https://pypi.org/project/avdb/", "platform": "", "project_url": "https://pypi.org/project/avdb/", "project_urls": { "Homepage": "https://github.com/meffie/avdb" }, "release_url": "https://pypi.org/project/avdb/1.2.0/", "requires_dist": [ "SQLAlchemy", "dnspython", "mpipe", "pystache", "sh" ], "requires_python": "", "summary": "AFS version tracking database", "version": "1.2.0" }, "last_serial": 4097301, "releases": { "1.2.0": [ { "comment_text": "", "digests": { "md5": "26986b0ded34b817e30e0f6d1a384d1a", "sha256": "f455bbb7ebc00e8b8fc86975414b764eef783f5f3cdfcf5360a43c2716f30fee" }, "downloads": -1, "filename": "avdb-1.2.0-py2-none-any.whl", "has_sig": false, "md5_digest": "26986b0ded34b817e30e0f6d1a384d1a", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 15957, "upload_time": "2018-07-24T14:55:57", "url": "https://files.pythonhosted.org/packages/1f/cb/a762bcac723d5af634b55cecb67aade63293f746efbbc36b3c8415ddf99a/avdb-1.2.0-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ba495fa6b47fa12224548091ff55f433", "sha256": "b570de0fe7e673ed07359bc9f5e680c337eb71b978db5a4174e4f303d6004195" }, "downloads": -1, "filename": "avdb-1.2.0.tar.gz", "has_sig": false, "md5_digest": "ba495fa6b47fa12224548091ff55f433", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10198, "upload_time": "2018-07-24T14:55:58", "url": "https://files.pythonhosted.org/packages/00/65/15321c03cb3a7f62e8ff14ea8f67fb2e878ed4a50069987225570a3ada4f/avdb-1.2.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "26986b0ded34b817e30e0f6d1a384d1a", "sha256": "f455bbb7ebc00e8b8fc86975414b764eef783f5f3cdfcf5360a43c2716f30fee" }, "downloads": -1, "filename": "avdb-1.2.0-py2-none-any.whl", "has_sig": false, "md5_digest": "26986b0ded34b817e30e0f6d1a384d1a", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 15957, "upload_time": "2018-07-24T14:55:57", "url": "https://files.pythonhosted.org/packages/1f/cb/a762bcac723d5af634b55cecb67aade63293f746efbbc36b3c8415ddf99a/avdb-1.2.0-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ba495fa6b47fa12224548091ff55f433", "sha256": "b570de0fe7e673ed07359bc9f5e680c337eb71b978db5a4174e4f303d6004195" }, "downloads": -1, "filename": "avdb-1.2.0.tar.gz", "has_sig": false, "md5_digest": "ba495fa6b47fa12224548091ff55f433", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10198, "upload_time": "2018-07-24T14:55:58", "url": "https://files.pythonhosted.org/packages/00/65/15321c03cb3a7f62e8ff14ea8f67fb2e878ed4a50069987225570a3ada4f/avdb-1.2.0.tar.gz" } ] }