{
    "info": {
        "author": "Philipp von Weitershausen",
        "author_email": "philipp@weitershausen.de",
        "bugtrack_url": null,
        "classifiers": [
            "Intended Audience :: Developers",
            "License :: OSI Approved :: Zope Public License",
            "Programming Language :: Python"
        ],
        "description": "Documentation\n=============\n\nIntroduction\n------------\n\nThis package allows you to disable specific bits of ZCML configuration\nthat may occur in other packages.  For instance, let's consider a\nsimple ZCML directive that prints strings and a silly one that prints\nlolcat messages:\n\n  >>> zcml(\"\"\"\n  ... <print msg=\"Hello World!\" />\n  ... <lolcat who=\"I\" canhas=\"cheezburger\" />\n  ... \"\"\")\n  Hello World!\n  I can has cheezburger?\n\nNow let's say this directive were used a bunch of times, but we wanted\nto prevent one or two of its occurrences.  To do that we simply repeat\nthe directive inside the ``unconfigure`` grouping directive.  This\ngrouping directive will look at all the previous directives and filter\nout the ones we want to exclude:\n\n  >>> zcml(\"\"\"\n  ... <configure>\n  ...   <print msg=\"Hello World!\" />\n  ...   <lolcat who=\"I\" canhas=\"cheezburger\" />\n  ...   <print msg=\"Goodbye World!\" />\n  ...   <print msg=\"LOL!\" />\n  ...\n  ...   <include package=\"z3c.unconfigure\" file=\"meta.zcml\" />\n  ...   <unconfigure>\n  ...     <lolcat who=\"I\" canhas=\"cheezburger\" />\n  ...     <print msg=\"LOL!\" />\n  ...   </unconfigure>\n  ... </configure>\n  ... \"\"\")\n  Hello World!\n  Goodbye World!\n\nIf you're trying to unconfigure something that hasn't been configured\nin the first place, nothing will happen:\n\n  >>> zcml(\"\"\"\n  ... <configure>\n  ...   <include package=\"z3c.unconfigure\" file=\"meta.zcml\" />\n  ...   <unconfigure>\n  ...     <lolcat who=\"I\" canhas=\"cheezburger\" />\n  ...   </unconfigure>\n  ... </configure>\n  ... \"\"\")\n\nWhere to place \"unconfiguration\"\n--------------------------------\n\nWhat's a good place to add the ``unconfigure`` directives, you may\nask.  Certainly, the example from above is not very realistic because\nboth the original directives and the filters are in one file.  What\ntypically happens is that you have some third party package that has\nmuch configuration of which you'd like to disable just one or two\ndirectives.  Like this file, for instance:\n\n  >>> cat('lolcat.zcml')\n  <configure>\n    <print msg=\"Hello World!\" />\n    <print msg=\"Important configuration here.\" />\n    <lolcat who=\"I\" canhas=\"cheezburger\" />\n    <print msg=\"Goodbye World!\" />\n    <print msg=\"LOL!\" />\n    <print msg=\"This is the last directive\" />\n  </configure>\n\nWhat you can do now is write a separate ZCML file in *your* package.\nA good name for it would be ``overrides.zcml`` (which is the naming\nconvention for ZCML files containing overriding directives, a\ntechnique not unlike to what ``unconfigure`` does).  For example,\nlet's say we wanted to undo some silly configuration in the above\nthird party file:\n\n  >>> cat('overrides.zcml')\n  <configure>\n    <include package=\"z3c.unconfigure\" file=\"meta.zcml\" />\n    <unconfigure>\n      <lolcat who=\"I\" canhas=\"cheezburger\" />\n      <print msg=\"LOL!\" />\n    </unconfigure>\n  </configure>\n\nWhat you would do now is include first that third party package's\nconfiguration and then load your overrides (which is typically done\nusing ``includeOverrides``, either explicitly by you or for you by\n``site.zcml``):\n\n  >>> zcml(\"\"\"\n  ... <configure>\n  ...   <include file=\"lolcat.zcml\" />\n  ...   <includeOverrides file=\"overrides.zcml\" />\n  ... </configure>\n  ... \"\"\")\n  Hello World!\n  Important configuration here.\n  Goodbye World!\n  This is the last directive\n\nIn this case, simply including the file with the ``<include />``\ndirective would've sufficed as well.  What matters is that the\n\"unconfiguration\" happens *after* the original configuration, and\noverride files are a good place to ensure this.\n\nIt can also be conveniend to unconfigure an entire zcml file. This can\nbe done without using z3c.unconfigure, if you use the ``<exclude />``\ndirective before you include that file:\n\n  >>> zcml(\"\"\"\n  ... <configure>\n  ...   <exclude file=\"lolcat.zcml\" />\n  ...   <print msg=\"The new hello\" />\n  ...   <include file=\"lolcat.zcml\" />\n  ...   <include package=\"z3c.unconfigure\" file=\"meta.zcml\" />\n  ...   <print msg=\"The final goodbye\" />\n  ... </configure>\n  ... \"\"\")\n  The new hello\n  The final goodbye\n\nOr you can try to use an include statement inside an unconfigure block:\n\n  >>> zcml(\"\"\"\n  ... <configure>\n  ...   <print msg=\"The new hello\" />\n  ...   <include file=\"lolcat.zcml\" />\n  ...   <include package=\"z3c.unconfigure\" file=\"meta.zcml\" />\n  ...   <unconfigure>\n  ...     <include file=\"lolcat.zcml\" />\n  ...   </unconfigure>\n  ...   <print msg=\"The final goodbye\" />\n  ... </configure>\n  ... \"\"\")\n  The new hello\n  The final goodbye\n\n\n\nChanges\n=======\n\n1.1 (2012-10-26)\n----------------\n\n* Added support for zope.configuration 3.8.0, which changed the internal\n  data structures from tuples to dicts.\n\n* Dropped support for zope.configuration 3.7.x and older.\n\n* Unconfiguring an entire zcml file (include statement inside an unconfigure\n  block) now works.\n\n1.0.1 (2008-08-07)\n------------------\n\n* Added a ``meta.zcml`` file so that the ``<unconfigure>`` directive\n  can actually be registered from ZCML.\n\n1.0 (2008-08-07)\n----------------\n\nFirst public release.",
        "description_content_type": null,
        "docs_url": null,
        "download_url": "UNKNOWN",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "http://pypi.python.org/pypi/z3c.unconfigure",
        "keywords": null,
        "license": "ZPL",
        "maintainer": null,
        "maintainer_email": null,
        "name": "z3c.unconfigure",
        "package_url": "https://pypi.org/project/z3c.unconfigure/",
        "platform": "UNKNOWN",
        "project_url": "https://pypi.org/project/z3c.unconfigure/",
        "project_urls": {
            "Download": "UNKNOWN",
            "Homepage": "http://pypi.python.org/pypi/z3c.unconfigure"
        },
        "release_url": "https://pypi.org/project/z3c.unconfigure/1.1/",
        "requires_dist": null,
        "requires_python": null,
        "summary": "Disable specific ZCML directives in other package's configuration",
        "version": "1.1"
    },
    "last_serial": 802121,
    "releases": {
        "1.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "a13aeab75cd47627d7fdf39ed89eafdb",
                    "sha256": "ceb26e386e3b1d2df9b4aff9e1b6a987e6b5774ec9aec1e486c291aa21f2d237"
                },
                "downloads": -1,
                "filename": "z3c.unconfigure-1.0.tar.gz",
                "has_sig": false,
                "md5_digest": "a13aeab75cd47627d7fdf39ed89eafdb",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 7442,
                "upload_time": "2008-08-07T09:21:33",
                "url": "https://files.pythonhosted.org/packages/9f/16/f2e1149a0ae8a70c86ac7b10a77cf3f5f06a05e8662bfb1c85b34cc92d5d/z3c.unconfigure-1.0.tar.gz"
            }
        ],
        "1.0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "e07d46fa0226734f6ba8531d9633151e",
                    "sha256": "3c2420932c2a0b1bfbac8382a5bdf6db8f1b5ca1064697a4668877465628f338"
                },
                "downloads": -1,
                "filename": "z3c.unconfigure-1.0.1.tar.gz",
                "has_sig": false,
                "md5_digest": "e07d46fa0226734f6ba8531d9633151e",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 7856,
                "upload_time": "2008-08-07T10:15:59",
                "url": "https://files.pythonhosted.org/packages/f4/29/e1437a3e3ccfbb720b2394e55b623487d626e384fc46cbe23db5d4b29236/z3c.unconfigure-1.0.1.tar.gz"
            }
        ],
        "1.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "17e19d5f36b99223daf310bbba0500e4",
                    "sha256": "287fa26e837dff154e58348cebea875f95e9cafce665b3ada1ead328f6bb4316"
                },
                "downloads": -1,
                "filename": "z3c.unconfigure-1.1.zip",
                "has_sig": false,
                "md5_digest": "17e19d5f36b99223daf310bbba0500e4",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 20141,
                "upload_time": "2012-10-26T11:22:59",
                "url": "https://files.pythonhosted.org/packages/52/ea/5b1724c9b609b28cbfb2cfcd81347441af72c5a558039c42da9cc4236d52/z3c.unconfigure-1.1.zip"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "17e19d5f36b99223daf310bbba0500e4",
                "sha256": "287fa26e837dff154e58348cebea875f95e9cafce665b3ada1ead328f6bb4316"
            },
            "downloads": -1,
            "filename": "z3c.unconfigure-1.1.zip",
            "has_sig": false,
            "md5_digest": "17e19d5f36b99223daf310bbba0500e4",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 20141,
            "upload_time": "2012-10-26T11:22:59",
            "url": "https://files.pythonhosted.org/packages/52/ea/5b1724c9b609b28cbfb2cfcd81347441af72c5a558039c42da9cc4236d52/z3c.unconfigure-1.1.zip"
        }
    ]
}