{ "info": { "author": "Antoine Busque", "author_email": "antoinebusque@gmail.com", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6" ], "description": "===\nqng\n===\n\n.. image:: https://img.shields.io/pypi/v/qng.svg\n :target: https://pypi.org/project/qng/\n :alt: PyPI\n\n*Documentation aussi disponible en* `fran\u00e7ais `_\n\n**qng**, the Queb name generator.\n\nRequirements\n------------\n\nTo run **qng**, you will only need Python \u2265 3.4.\n\nFor installing, we recommend using the ``pip`` package manager.\n\nInstalling\n----------\n\nTo install **qng** system-wide, run:\n\n.. code-block:: sh\n\n sudo pip3 install qng\n\nTo install **qng** manually from source, the steps are as follows:\n\n.. code-block:: sh\n\n git clone git@github.com:abusque/qng.git\n cd qng\n sudo ./setup.py install\n\nUsing\n-----\n\nOnce installed, you can use **qng** by running the following command:\n\n.. code-block:: sh\n\n qng\n\nThis will generate a single random Queb name.\n\nYou can also generate names for a specific gender:\n\n.. code-block:: sh\n\n qng --gender male\n\nGenerate only part of a name:\n\n.. code-block:: sh\n\n qng --part first\n\nGenerate names according to their relative popularity:\n\n.. code-block:: sh\n\n qng --weighted\n\nGenerate a name formatted as \"snake_case\" without any diacritics\n(useful for naming your containers):\n\n.. code-block:: sh\n\n qng --snake-case\n\nHere's how you could use this to name a Docker container:\n\n.. code-block:: sh\n\n docker run --name $(qng --snake-case) hello-world\n\nAll the above options may be combined if desired. Refer to the help\nfor more details:\n\n.. code-block:: sh\n\n qng --help\n\nPython API\n^^^^^^^^^^\n\nYou can also use **qng** through its Python API, for integration with\nother applications.\n\nHere is a simple example of programmatic usage:\n\n.. code-block:: python\n\n import qng.generator\n\n generator = qng.generator.QuebNameGenerator()\n name = generator.generate()\n print(name)\n\nThe ``generate()`` function also supports the following options, with\nthe same meaning as the corresponding CLI options:\n\n.. code-block:: python\n\n import qng.generator\n\n generator = qng.generator.QuebNameGenerator()\n name = generator.generate(\n gender='male',\n part='first',\n snake_case=True,\n weighted=True,\n )\n print(name)\n\nRefer to the documentation in the source file for more details.\n\nDevelopment\n-----------\n\nFor local development of **qng**, you may use\n`pipenv `_. Use ``pipenv install --dev`` to\ngenerate a virtual environment into which the dependencies will be\ninstalled. You may then use ``pipenv shell`` to activate that\nenvironment.\n\nFor publishing releases to PyPI, we recommend using\n`Twine `_.\n\nReferences\n----------\n\nThe data for **qng** was sourced from `l'institut de la statistique`_\nfor surnames, and from `Pr\u00e9nomsQu\u00e9bec.ca`_ for first names (who in\nturn get their data from Retraite Qu\u00e9bec's `banque de pr\u00e9noms`_).\n\nScripts used for scraping the data from the web pages can be found\nunder the ``scripts/`` directory.\n\n.. _l'institut de la statistique: http://www.stat.gouv.qc.ca/statistiques/population-demographie/caracteristiques/noms_famille_1000.htm\n.. _Pr\u00e9nomsQu\u00e9bec.ca: https://www.prenomsquebec.ca/\n.. _banque de pr\u00e9noms: https://www.rrq.gouv.qc.ca/fr/enfants/banque_prenoms/Pages/banque_prenoms.aspx\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/abusque/qng", "keywords": "name,generator,quebec", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "qng", "package_url": "https://pypi.org/project/qng/", "platform": "", "project_url": "https://pypi.org/project/qng/", "project_urls": { "Homepage": "https://github.com/abusque/qng" }, "release_url": "https://pypi.org/project/qng/1.0.1/", "requires_dist": null, "requires_python": "", "summary": "The Queb name generator", "version": "1.0.1" }, "last_serial": 3997255, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "0653bf24b3625d53551b27ab313643d6", "sha256": "273f089dc1b824e468c33610c01fee9c9ff82a6d75efcb25f5da02ebdfdcc712" }, "downloads": -1, "filename": "qng-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "0653bf24b3625d53551b27ab313643d6", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 17182, "upload_time": "2018-06-19T05:40:30", "url": "https://files.pythonhosted.org/packages/a7/b7/d36ce53aa9722a803809bce24662a8d77ff233fb9af0940cdf941263f5af/qng-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "815c9ed30c299b88674121c9020b7c80", "sha256": "a19cd2aa5716a43153239d733601b699b261149d2387684a6b6b53549926fed5" }, "downloads": -1, "filename": "qng-0.1.0.tar.gz", "has_sig": false, "md5_digest": "815c9ed30c299b88674121c9020b7c80", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15991, "upload_time": "2018-06-19T05:40:31", "url": "https://files.pythonhosted.org/packages/ed/ad/d5c28e4bc68287b687d1dca99d3a8bae2ad3393988ce4f08296e4bf086f1/qng-0.1.0.tar.gz" } ], "0.1.3": [ { "comment_text": "", "digests": { "md5": "3e6bcc81f03c983956371e0d950b3d61", "sha256": "91367ba5e22f02fb7345fcb9c43eac6e581f97b8ce5b8af71a49fe56efbcac34" }, "downloads": -1, "filename": "qng-0.1.3-py3-none-any.whl", "has_sig": false, "md5_digest": "3e6bcc81f03c983956371e0d950b3d61", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 17229, "upload_time": "2018-06-19T06:13:04", "url": "https://files.pythonhosted.org/packages/92/6f/915c77445fc458658e4a8d5abd95f84a055c7e45b5757f66a180e14d726b/qng-0.1.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "9b6e5e25582889bbff5f83868e31df5b", "sha256": "37f257ea7de4b4d64459acd3b3497810022d4c3f3ebed4ee245d336753345a90" }, "downloads": -1, "filename": "qng-0.1.3.tar.gz", "has_sig": false, "md5_digest": "9b6e5e25582889bbff5f83868e31df5b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15314, "upload_time": "2018-06-19T06:13:05", "url": "https://files.pythonhosted.org/packages/0f/bc/8285854f64645ee38184536c6c062a694ca37e665bce05807d1b2a9289bf/qng-0.1.3.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "62763258ba964d559eda4a9a4c4030f2", "sha256": "bc1e95555e8b3012465a1f8aaccb3a8ff53ecb875699a03eab6a0fc9ae73f566" }, "downloads": -1, "filename": "qng-0.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "62763258ba964d559eda4a9a4c4030f2", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 17465, "upload_time": "2018-06-20T03:12:37", "url": "https://files.pythonhosted.org/packages/59/c3/1b3ba4e67161fc0f1c56d75c764c084cfc6e7f188834a24f5ce1456bb9f1/qng-0.2.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "89f3a335dec48d085a485233bddc17b8", "sha256": "59a1e41b7c008dc28e91e5446e81255233aa42a66de097c09e43c5066a251e07" }, "downloads": -1, "filename": "qng-0.2.0.tar.gz", "has_sig": false, "md5_digest": "89f3a335dec48d085a485233bddc17b8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15596, "upload_time": "2018-06-20T03:12:38", "url": "https://files.pythonhosted.org/packages/96/d3/4a3070b37c87d3ba200c92a4fd2af603916e27301117f77b8ea974ad5448/qng-0.2.0.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "f65d9346b0458cfdd2dda901532c10ed", "sha256": "32e494c139aa8dd3e4da6fe301834e00b5bb0f88d0fb259396cd68e888d4389d" }, "downloads": -1, "filename": "qng-0.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "f65d9346b0458cfdd2dda901532c10ed", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 17520, "upload_time": "2018-06-22T02:45:23", "url": "https://files.pythonhosted.org/packages/62/69/42569e7b6270d158e0882ac90463d9041d385f7747150b7a38e77ec15dc1/qng-0.3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "eb01e3b22b7e1d7f5bb0acdab858b8d8", "sha256": "706525595dd05893f4adb468f66624353d43dd257b38509ad46ba22be7f19ff3" }, "downloads": -1, "filename": "qng-0.3.0.tar.gz", "has_sig": false, "md5_digest": "eb01e3b22b7e1d7f5bb0acdab858b8d8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15668, "upload_time": "2018-06-22T02:45:24", "url": "https://files.pythonhosted.org/packages/b0/e4/dc98c5d350d33cdfd606ab52b0bbbc035f0addab1700ff459bb2084ca660/qng-0.3.0.tar.gz" } ], "0.4.0": [ { "comment_text": "", "digests": { "md5": "9ec7eb82738bff176c5ccae15846d102", "sha256": "3cda9ac9ee8d450e351498504a6c168da05d0a8c770ffa1f8f43848a56ba8cd5" }, "downloads": -1, "filename": "qng-0.4.0-py3-none-any.whl", "has_sig": false, "md5_digest": "9ec7eb82738bff176c5ccae15846d102", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 15896, "upload_time": "2018-06-23T03:39:45", "url": "https://files.pythonhosted.org/packages/e3/e1/e2202ea9985ccc089243d6fcb26064d59a8ad7f5a6d810a750119738f1e6/qng-0.4.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "efa6861328334e3e2b9fe53994035cee", "sha256": "610232788938f81c50fb04b4d32b5f089672101f0e7a75a6bb6752e3b4de999d" }, "downloads": -1, "filename": "qng-0.4.0.tar.gz", "has_sig": false, "md5_digest": "efa6861328334e3e2b9fe53994035cee", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15898, "upload_time": "2018-06-23T03:39:47", "url": "https://files.pythonhosted.org/packages/d4/63/beaa191b93bc76c4a91c6cc4b78d514cf91eba220080886efb95f5012a03/qng-0.4.0.tar.gz" } ], "0.5.0": [ { "comment_text": "", "digests": { "md5": "587b76e56ca93d44a6d4e78a0e5325a5", "sha256": "0cd22fad4688d767c5f5f9c3d5af049e5b8c2137022d2123e8c50aca9d668d49" }, "downloads": -1, "filename": "qng-0.5.0-py3-none-any.whl", "has_sig": false, "md5_digest": "587b76e56ca93d44a6d4e78a0e5325a5", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 17629, "upload_time": "2018-06-23T18:09:53", "url": "https://files.pythonhosted.org/packages/52/a8/179520a4bd88659dc2042d634e9820862fffcec759d35d28de1e0100ef82/qng-0.5.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "337a0cdfe8ee73c02a4ac6feb0dc3bcb", "sha256": "ac577b77b116407b39268dba3e29340da9b789b31cd6fb0a94162879d44f4976" }, "downloads": -1, "filename": "qng-0.5.0.tar.gz", "has_sig": false, "md5_digest": "337a0cdfe8ee73c02a4ac6feb0dc3bcb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17563, "upload_time": "2018-06-23T18:09:54", "url": "https://files.pythonhosted.org/packages/ae/ca/89219c56b52237ebb4c3952554b7aa15f0eaa36dabfc583a461e7ecf582f/qng-0.5.0.tar.gz" } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "34d7f6ad5edba80e7f587dda2a45f2cb", "sha256": "c62c4cafc04e241e1b6c089384ecff818575896bf8811714b31f9f1cb439d8b4" }, "downloads": -1, "filename": "qng-1.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "34d7f6ad5edba80e7f587dda2a45f2cb", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 17744, "upload_time": "2018-06-24T17:03:29", "url": "https://files.pythonhosted.org/packages/c9/c4/b5115440b46044d9730f3d72f2a2417613f632463d47c673fa486c904f96/qng-1.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "38d0e7a278b8317e207385485af3e901", "sha256": "8263861c82e3e9c718bc46e6d385f0ced4ec935f7d4e2486897bbbce5550ea51" }, "downloads": -1, "filename": "qng-1.0.0.tar.gz", "has_sig": false, "md5_digest": "38d0e7a278b8317e207385485af3e901", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17702, "upload_time": "2018-06-24T17:03:30", "url": "https://files.pythonhosted.org/packages/24/fa/ac5044a1dabdcb10a3bdb44a2e4b0502a7799d21bf7a9fe9de5b6c5f8bf7/qng-1.0.0.tar.gz" } ], "1.0.1": [ { "comment_text": "", "digests": { "md5": "8920c68183224cb9939df7dae46af316", "sha256": "b390c419361fd9ecb4c3a0c67ae35a3181fc3fe4057ea676543eb6a2d34806e4" }, "downloads": -1, "filename": "qng-1.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "8920c68183224cb9939df7dae46af316", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 17761, "upload_time": "2018-06-24T17:40:19", "url": "https://files.pythonhosted.org/packages/7b/b1/6466e93741301ebb7c64857a2c30ad1f353b86178f12bb133168e7fc78b7/qng-1.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e343d4994679a82a251487de74f180d0", "sha256": "ab26de79ed29f260e53b795b4e29fdca53d1bfcf7a6464d6396954c751a9e030" }, "downloads": -1, "filename": "qng-1.0.1.tar.gz", "has_sig": false, "md5_digest": "e343d4994679a82a251487de74f180d0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17717, "upload_time": "2018-06-24T17:40:20", "url": "https://files.pythonhosted.org/packages/b7/12/ebc61e5de576c2e227139086d6a49a9a5ba989cbccb27bdc53a3b5735764/qng-1.0.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "8920c68183224cb9939df7dae46af316", "sha256": "b390c419361fd9ecb4c3a0c67ae35a3181fc3fe4057ea676543eb6a2d34806e4" }, "downloads": -1, "filename": "qng-1.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "8920c68183224cb9939df7dae46af316", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 17761, "upload_time": "2018-06-24T17:40:19", "url": "https://files.pythonhosted.org/packages/7b/b1/6466e93741301ebb7c64857a2c30ad1f353b86178f12bb133168e7fc78b7/qng-1.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e343d4994679a82a251487de74f180d0", "sha256": "ab26de79ed29f260e53b795b4e29fdca53d1bfcf7a6464d6396954c751a9e030" }, "downloads": -1, "filename": "qng-1.0.1.tar.gz", "has_sig": false, "md5_digest": "e343d4994679a82a251487de74f180d0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17717, "upload_time": "2018-06-24T17:40:20", "url": "https://files.pythonhosted.org/packages/b7/12/ebc61e5de576c2e227139086d6a49a9a5ba989cbccb27bdc53a3b5735764/qng-1.0.1.tar.gz" } ] }