{
    "info": {
        "author": "kylekatarnls",
        "author_email": "",
        "bugtrack_url": null,
        "classifiers": [],
        "description": "# [VICOPO](https://vicopo.selfbuild.fr/)\n\n#### API HTTP et Script pour trouver les villes \u00c3\u00a0 partir d'un code postal et code postaux \u00c3\u00a0 partir d'une ville\n\nVicopo est un moyen l\u00c3\u00a9ger et rapide rechercher une ville fran\u00c3\u00a7aise et impl\u00c3\u00a9menter des propositions \u00c3\u00a0 la vol\u00c3\u00a9e, l'autocompl\u00c3\u00a9tion d'un champ de ville ou de code postal et la conversion de l'un vers l'autre.\n\nhttps://vicopo.selfbuild.fr/\n\n## Utilisation\n\n### Afficher les villes possibles dans une liste\n\n```html\n<input id=\"ville\" placeholder=\"Entrez un code postal ou une ville\" autocomplete=\"off\" size=\"50\">\n<ul>\n  <li data-vicopo=\"#ville\">\n    <strong data-vicopo-code-postal></strong>\n    <span data-vicopo-ville></span>\n  </li>\n</ul>\n```\n[Voir la d\u00c3\u00a9monstration](https://jsfiddle.net/KyleKatarn/y27x72ka/6/)\n\nAjoutez l'attribut data-vicopo \u00c3\u00a0 un \u00c3\u00a9l\u00c3\u00a9ment et passez-lui en param\u00c3\u00a8tre un s\u00c3\u00a9lecteur qui pointera vers un champ(`<input>`, `<select>` ou `<textarea>`). Quand la valeur du champs change, l'\u00c3\u00a9l\u00c3\u00a9ment sera duppliqu\u00c3\u00a9 autant de fois qu'il y a de villes commen\u00c3\u00a7ant par la valeur tap\u00c3\u00a9e ou dont le code postal commence par la valeur tap\u00c3\u00a9e (la recherche commence \u00c3\u00a0 partir de 2 caract\u00c3\u00a8res tap\u00c3\u00a9s).\n\n\u00c3\u20ac l'int\u00c3\u00a9rieur de ces \u00c3\u00a9l\u00c3\u00a9ments, les balises portant les attributs `data-vicopo-code-postal`, `data-vicopo-ville` seront respectivement pourvus du code postal et de la ville. Si ces balises sont des champs, utilisez `data-vicopo-val-code-postal` et `data-vicopo-val-ville` pour que les informations soient assign\u00c3\u00a9es en tant que valeur.\n\n## Compl\u00c3\u00a9ter le champ avec le premier nom de ville trouv\u00c3\u00a9\n\n```js\n$('#ville').keyup(function (e) {\n  if(e.keyCode == 13) {\n    var $ville = $(this);\n    $.vicopo($ville.val(), function (input, cities) {\n      if(input == $ville.val() && cities[0]) {\n        $ville.val(cities[0].city).vicopoTargets().vicopoClean();\n      }\n    });\n    e.preventDefault();\n    e.stopPropagation();\n  }\n});\n```\n[Voir la d\u00c3\u00a9monstration](https://jsfiddle.net/KyleKatarn/48uuL3v5/3/)\n\nLors de l'appui sur `Entr\u00c3\u00a9e`, on r\u00c3\u00a9cup\u00c3\u00a8re la premi\u00c3\u00a8re ville et on l'applique comme nouvelle valeur du champ.\n\nL'ajout optionnel de `.vicopoTargets().vicopoClean()` permet d'effacer la liste de suggestions.\n\n## R\u00c3\u00a9cup\u00c3\u00a9rer les villes au fur et \u00c3\u00a0 mesure de la saisie\n\n```js\n$('#recherche').vicopo(function (cities) {\n  if(cities.length) {\n    $('#ville').val(cities[0].city);\n    $('#code').val(cities[0].code);\n  } else {\n    $('#ville').val('');\n    $('#code').val('');\n  }\n  $('#count').val(cities.length + ' villes trouv\u00c3\u00a9es');\n});\n```\nLes m\u00c3\u00a9thodes `.vicopo()`, `.codePostal()` et `.ville()` appliqu\u00c3\u00a9es \u00c3\u00a0 un \u00c3\u00a9l\u00c3\u00a9ment jQuery permettent de r\u00c3\u00a9cup\u00c3\u00a9rer dans une variable le r\u00c3\u00a9sultat de la recherche \u00c3\u00a0 chaque lettre saisie dans le champ.\n\n## Utilisation sans champs de saisie\n\n```js\n$('#cp').click(function () {\n  $.ville('strasbourg', function (input, cities) {\n    $('#cp-result').text(cities[0].code);\n  });\n});\n$('#villes').click(function () {\n  $.ville('des', function (input, cities) {\n    $('#villes-result').text(cities.map(function (entry) {\n      return entry.city;\n    }).join(', '));\n  });\n});\n```\n[Voir la d\u00c3\u00a9monstration](https://jsfiddle.net/KyleKatarn/ny8k9ya6/6/)\n\nLes m\u00c3\u00a9thodes `$.vicopo()`, `$.codePostal()` et `$.ville()` prennent en premier param\u00c3\u00a8tre le code postal ou la ville (partiel ou entier) recherch\u00c3\u00a9 et en second param\u00c3\u00a8tre une fonction de callback appel\u00c3\u00a9e avec le terme recherch\u00c3\u00a9 en premier param\u00c3\u00a8tre, les villes trouv\u00c3\u00a9es en second et en troisi\u00c3\u00a8me 'code' pour une recherche de code postal ou 'city' pour une recherche de ville.\n\n## API HTTP brute au fomart JSON (par d\u00c3\u00a9faut)\n\n| Protocole | URL                                                   |\n|-----------|-------------------------------------------------------|\n| HTTP      | http://vicopo.selfbuild.fr/cherche/680                |\n| HTTPS     | https://vicopo.selfbuild.fr/cherche/680               |\n```json\n{\n\t\"input\": \"680\",\n\t\"cities\": [\n\t\t{\n\t\t\t\"code\": 68040,\n\t\t\t\"city\": \"INGERSHEIM\"\n\t\t},\n\t\t{\n\t\t\t\"code\": 68000,\n\t\t\t\"city\": \"COLMAR\"\n\t\t}\n\t]\n}\n```\n\n## Plugin node.js\n\nVicopo est disponible sous node.js directement via require('vicopo') :\n\n```javascript\nvar ville = 'Lille';\nvar vicopo = require('vicopo')('http');\nvicopo(ville, function (err, cities) {\n    if (err) {\n        throw err;\n    } else {\n        console.log(cities);\n    }\n});\n```\n\nPlus d'options sur https://vicopo.selfbuild.fr/\n\n\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://vicopo.selfbuild.fr",
        "keywords": "",
        "license": "",
        "maintainer": "",
        "maintainer_email": "",
        "name": "Vicopo",
        "package_url": "https://pypi.org/project/Vicopo/",
        "platform": "",
        "project_url": "https://pypi.org/project/Vicopo/",
        "project_urls": {
            "Homepage": "https://vicopo.selfbuild.fr"
        },
        "release_url": "https://pypi.org/project/Vicopo/1.2.1/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "Vicopo est un moyen l\u00e9ger et rapide rechercher une ville fran\u00e7aise et impl\u00e9menter des propositions \u00e0 la vol\u00e9e, l'autocompl\u00e9tion d'un champ de ville ou de code postal et la conversion de l'un vers l'autre.",
        "version": "1.2.1"
    },
    "last_serial": 4702549,
    "releases": {
        "1.1.5": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "ae2650ef81c9fd5d1d68d542aa109956",
                    "sha256": "a2d5a11d07ea8b907cba2ab5b32fa042a114d52d18c9409adac6b9b26cf4199c"
                },
                "downloads": -1,
                "filename": "Vicopo-1.1.5.zip",
                "has_sig": false,
                "md5_digest": "ae2650ef81c9fd5d1d68d542aa109956",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 1816,
                "upload_time": "2016-02-10T14:46:01",
                "url": "https://files.pythonhosted.org/packages/25/18/b2a01723287e07113aa41696aa27c9b599598482c95cb8108796c51c828f/Vicopo-1.1.5.zip"
            }
        ],
        "1.1.6": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "ec19947c9f30830b2c60471e7e7e3304",
                    "sha256": "1682545710bd7dffae512abf4130da3125efb66cbd9497df2d3eefd74bfc9125"
                },
                "downloads": -1,
                "filename": "Vicopo-1.1.6.zip",
                "has_sig": false,
                "md5_digest": "ec19947c9f30830b2c60471e7e7e3304",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 1816,
                "upload_time": "2016-02-10T15:21:03",
                "url": "https://files.pythonhosted.org/packages/a4/a3/b4298e8b48325f735491f1d1821f2b08fff92dfab0ea922d677d282690eb/Vicopo-1.1.6.zip"
            }
        ],
        "1.1.8": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "8618c5cadb6a35013276dae58b851caa",
                    "sha256": "8b861b59d7132879e95010b84b06ab21d790482baef3012d8b9e9a0351f77954"
                },
                "downloads": -1,
                "filename": "Vicopo-1.1.8.zip",
                "has_sig": false,
                "md5_digest": "8618c5cadb6a35013276dae58b851caa",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 1838,
                "upload_time": "2016-08-28T11:22:47",
                "url": "https://files.pythonhosted.org/packages/8c/cb/7b51c46a0ec25b1b5c631ad10a34d91464c1cec861a4ae01ea6d79bf5006/Vicopo-1.1.8.zip"
            }
        ],
        "1.1.9": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "be32999e7154320c96f424f64f7a31a3",
                    "sha256": "0f3663421803ebc83450e5ca4759e0a5df7875c62ff9aacdb0385683953b4f61"
                },
                "downloads": -1,
                "filename": "Vicopo-1.1.9-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "be32999e7154320c96f424f64f7a31a3",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 4063,
                "upload_time": "2019-01-16T09:54:40",
                "url": "https://files.pythonhosted.org/packages/19/7f/590997fb683b99ef515ec3c62dbf143cf181e9cee4997dd075fd3116d2d8/Vicopo-1.1.9-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "ac2b276261bf0cb0e5fef884a76cc679",
                    "sha256": "b1020e75f2fc686ac3c8e8fa9dcd874832f379f61f1cc6eb6d73107997e1c547"
                },
                "downloads": -1,
                "filename": "Vicopo-1.1.9.tar.gz",
                "has_sig": false,
                "md5_digest": "ac2b276261bf0cb0e5fef884a76cc679",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 3411,
                "upload_time": "2019-01-16T09:54:42",
                "url": "https://files.pythonhosted.org/packages/3c/fa/f475e10c0f1cfe5801c31228a3d1530ab122437764f50a3cfe2d53e2f373/Vicopo-1.1.9.tar.gz"
            }
        ],
        "1.2.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "2ea2499300b96b947be161b9b618abfd",
                    "sha256": "37a7821b843a606fc0c410b2aeb5ff5c7b9f8e72dc0014410f14b91e0fc7642d"
                },
                "downloads": -1,
                "filename": "Vicopo-1.2.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "2ea2499300b96b947be161b9b618abfd",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 4048,
                "upload_time": "2019-01-16T10:08:03",
                "url": "https://files.pythonhosted.org/packages/d8/d8/abcf6d5e059718280c67cfa9056f408884172fa505674488bbdf736c4814/Vicopo-1.2.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "18a5b3a9d5c0ad19a6fca6f84e37da85",
                    "sha256": "8396658d3258241d9b36c5a9e272e2397e5dcdb89c114ed55418ebba6a416623"
                },
                "downloads": -1,
                "filename": "Vicopo-1.2.1.tar.gz",
                "has_sig": false,
                "md5_digest": "18a5b3a9d5c0ad19a6fca6f84e37da85",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 3393,
                "upload_time": "2019-01-16T10:08:04",
                "url": "https://files.pythonhosted.org/packages/6b/cf/4e9b678e9b01c8f96c178aff2c4c88d343a0bbc86b768d572e64dde026d3/Vicopo-1.2.1.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "2ea2499300b96b947be161b9b618abfd",
                "sha256": "37a7821b843a606fc0c410b2aeb5ff5c7b9f8e72dc0014410f14b91e0fc7642d"
            },
            "downloads": -1,
            "filename": "Vicopo-1.2.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "2ea2499300b96b947be161b9b618abfd",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 4048,
            "upload_time": "2019-01-16T10:08:03",
            "url": "https://files.pythonhosted.org/packages/d8/d8/abcf6d5e059718280c67cfa9056f408884172fa505674488bbdf736c4814/Vicopo-1.2.1-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "18a5b3a9d5c0ad19a6fca6f84e37da85",
                "sha256": "8396658d3258241d9b36c5a9e272e2397e5dcdb89c114ed55418ebba6a416623"
            },
            "downloads": -1,
            "filename": "Vicopo-1.2.1.tar.gz",
            "has_sig": false,
            "md5_digest": "18a5b3a9d5c0ad19a6fca6f84e37da85",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 3393,
            "upload_time": "2019-01-16T10:08:04",
            "url": "https://files.pythonhosted.org/packages/6b/cf/4e9b678e9b01c8f96c178aff2c4c88d343a0bbc86b768d572e64dde026d3/Vicopo-1.2.1.tar.gz"
        }
    ]
}