{
    "info": {
        "author": "anqxyr",
        "author_email": "anqxyr@gmail.com",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 4 - Beta",
            "Intended Audience :: Developers",
            "Intended Audience :: Other Audience",
            "License :: OSI Approved :: MIT License",
            "Operating System :: POSIX :: Linux",
            "Programming Language :: Python",
            "Programming Language :: Python :: 3.4",
            "Programming Language :: Python :: 3.5",
            "Programming Language :: Python :: 3.6",
            "Topic :: Multimedia",
            "Topic :: Utilities"
        ],
        "description": "racovimge\n=========\n\n**racovimge** is a minimalistic library for generating random\nplaceholder book covers. It allows generating svg or png covers, and can\nbe used as a python library or as a command line utility.\n\nInstallation\n~~~~~~~~~~~~\n\n::\n\n    pip install --user racovimge\n\nBasic Usage\n~~~~~~~~~~~\n\n.. code:: python\n\n    import racovimge\n\n    # generate random svg cover\n    cover = racovimge.random('As I Lay Dying', 'William Faulkner')\n\n    # generate specific cover and write it to a file\n    with open('cover.svg', 'w') as stream:\n        stream.write(racovimge.cover(\n            title='The Ambassadors',\n            # note that author is optional.\n            # Multiple authors can be passed as a non-str iterator as well.\n            author='Henry James',\n            template='Simple Dark',\n            colors=['#d3dcf2', '#829fe4', '#6692c3', '#4878a4', '#00305a'],\n            font='/path/to/otf/or/ttf/file',\n            font_size=120,  # Used for the title of the book.\n            font_size_author=70  # Used for the authors.\n            ))\n\n    # Passing non-str iterable as title allows for explicit line breaks,\n    # which is useful for longer titles\n    cover = racovimge.random(['Strange Case', 'of Dr. Jekyll', 'and Mr. Hyde'], 'Robert Louis Stevenson')\n\n    # generate random png file and write it to file\n    # note that unlike for svg, the file must be opened in binary mode\n    with open('cover.png', 'wb') as stream:\n        # font sizes can be set explicitly even for random covers\n        stream.write(racovimge.png_random('The Odyssey', 'Homer', font_size=200))\n\n\n    # specifying keyword arguments for random generators enables limiting the output results\n    cover = racovimge.random(\n        'The Killer Angels',\n        'Michael Shaara',\n        templates=['Blocks', 'Simple Dark', 'Tiles'],\n        fonts=racovimge.fonts[:4],\n        schemes=racovimge.color_schemes[2:8])\n\nUsing as Command Line Utility\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nTo generate a random cover:\n\n::\n\n    racovimge One Flew Over the Cuckoo's Nest --authors \"Ken Kesey\"\n\nNote that unlike titles author names must be quoted. Multiple\nspace-separated authors can be supplied.\n\nTo generate a png cover:\n\n::\n\n    racovimge --png A Moveable Feast -a \"Ernest Hemingway\"\n\nTo generate multipe covers with a given prefix:\n\n::\n\n    racovimge The War of the Worlds -a \"H. G. Wells\" --output war --count 10 --png\n\nThis will create files war01.png, war02.png, ... war10.png in the\ncurrent directory. You can also specify an absolute path:\n\n::\n\n    racovimge The Chronicles of Narnia -o /home/user/books/narnia/cover -c 5\n\nLimitations\n~~~~~~~~~~~\n\nThe cover templates, color schemes, and fonts, have been carefully\nselected to work in combination with each other. Despite of that, some\ncombinations of various parameters will still produce aesthetically\nunpleasing covers. In particular, some of the fonts combined with longer\nbook titles do not fit completely within some of the cover templates.\nThis can be ammended by decreasing the font size, explicitly specifying\nlinebreak points in the titles, or by just generating a different random\ncover. Thankfully, **racovimge** makes the later process quite easy, and\nit can be repeated multiple times until you get a cover you're a\nsatisfied with.\n\nGenerating png covers requires **rsvg** to be installed on Linux system.\nOn Windows and MacOS, it is untested and unlikely to work.\n\nThe current version of **racovimge** is 0.9, and should be considered a\nbeta. The core functionality is complete, but it still contains a number\nof rough edges. The documentation can be improved, particularly in\nregards to the command line utility. The API for some of the optional\nparameters can be changed to accomodate non-default values better. Minor\nfixes to existing color schemes and cover templates can be made, as well\nas more schemes, templates, and fonts can be added to the library.\nUnfortunately, the author of the library does not have time to do any of\nthese things, and so **racovimge** will remain in its current state for\nan as of yet undetermined amount of time.\n\nAcknowledgements\n~~~~~~~~~~~~~~~~\n\n**racovimge** is inspired by the cover-generator found in the excellent\n`calibre <https://github.com/kovidgoyal/calibre>`__ e-book manager.\n**racovimge** also borrows some color schemes and svg elements from it.\n\nThe following free fonts are bundled with **racovimge**: `Alex\nBrush <https://fontlibrary.org/en/font/alex-brush>`__,\n`Bellota <https://fontlibrary.org/en/font/bellota>`__, `Bradley\nGratis <https://fontlibrary.org/en/font/bradley-gratis>`__,\n`Caladea <https://fontlibrary.org/en/font/caladea>`__,\n`Crimson <https://fontlibrary.org/en/font/crimson>`__,\n`Gidole <https://github.com/larsenwork/Gidole>`__, `Glacial\nIndifference <https://fontlibrary.org/en/font/glacial-indifference>`__,\n`Great Vibes <https://fontlibrary.org/en/font/rebecca>`__,\n`Horta <https://fontlibrary.org/en/font/horta>`__, `Liberation\nSerif <https://fontlibrary.org/en/font/liberation-serif>`__, `Libre\nBaskerville <https://fontlibrary.org/en/font/libre-baskerville>`__,\n`Orkney <https://fontlibrary.org/en/font/orkney>`__, `Petit Formal\nScript <https://fontlibrary.org/en/font/petit-formal-script>`__,\n`Sofia <https://fontlibrary.org/en/font/sofia>`__, and\n`Unique <https://fontlibrary.org/en/font/unique>`__.\n\nThe cover templates used by **racovimge** include svg elements taken\nfrom the following design collections:\n\n-  `Decorative Floral\n   Elements <http://all-free-download.com/free-vector/download/vector-set-of-decorative-floral-elements-for-design_570139.html>`__\n   by `webdesignhot <http://www.webdesignhot.com/>`__\n-  `Vintage Frame Border\n   Elements <http://all-free-download.com/free-vector/download/vintage-design-element-set-frame-border-floral-label_6815728.html>`__\n   by `BSGStudio <http://buysellgraphic.com/>`__\n-  `Border Decoration\n   Elements <http://all-free-download.com/free-vector/download/vector-border-decoration-design-elements_148134.html>`__\n   by `webdesignhot <http://www.webdesignhot.com/>`__\n\n\n\n",
        "description_content_type": null,
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/anqxyr/racovimge/",
        "keywords": "",
        "license": "MIT",
        "maintainer": "",
        "maintainer_email": "",
        "name": "racovimge",
        "package_url": "https://pypi.org/project/racovimge/",
        "platform": "",
        "project_url": "https://pypi.org/project/racovimge/",
        "project_urls": {
            "Homepage": "https://github.com/anqxyr/racovimge/"
        },
        "release_url": "https://pypi.org/project/racovimge/0.9/",
        "requires_dist": [
            "jinja2"
        ],
        "requires_python": "",
        "summary": "Random Cover Image Generator",
        "version": "0.9"
    },
    "last_serial": 2989697,
    "releases": {
        "0.9": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "9055bc461cb30e9030bffdf3e42385a4",
                    "sha256": "b3e22f8368d737210a6f9e6d3067111b87753b4c815c4b8242388b4245a20cc3"
                },
                "downloads": -1,
                "filename": "racovimge-0.9-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "9055bc461cb30e9030bffdf3e42385a4",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 869655,
                "upload_time": "2017-06-30T12:39:49",
                "url": "https://files.pythonhosted.org/packages/90/3c/d80b7766f71f1bb784d6bcc30b7506972df69e12c7be41097d64b2e59c42/racovimge-0.9-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "45dd07761903307b502771a9170da201",
                    "sha256": "c8f0b62788dd70ce049529751f2b7a428f9f19e76abaf00574411230b7b0757d"
                },
                "downloads": -1,
                "filename": "racovimge-0.9.tar.gz",
                "has_sig": false,
                "md5_digest": "45dd07761903307b502771a9170da201",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 842220,
                "upload_time": "2017-06-30T12:39:52",
                "url": "https://files.pythonhosted.org/packages/c8/95/c7ca6afc05780a45604e95740caa4939d1a529f73e560583b28a2973fbea/racovimge-0.9.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "9055bc461cb30e9030bffdf3e42385a4",
                "sha256": "b3e22f8368d737210a6f9e6d3067111b87753b4c815c4b8242388b4245a20cc3"
            },
            "downloads": -1,
            "filename": "racovimge-0.9-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "9055bc461cb30e9030bffdf3e42385a4",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 869655,
            "upload_time": "2017-06-30T12:39:49",
            "url": "https://files.pythonhosted.org/packages/90/3c/d80b7766f71f1bb784d6bcc30b7506972df69e12c7be41097d64b2e59c42/racovimge-0.9-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "45dd07761903307b502771a9170da201",
                "sha256": "c8f0b62788dd70ce049529751f2b7a428f9f19e76abaf00574411230b7b0757d"
            },
            "downloads": -1,
            "filename": "racovimge-0.9.tar.gz",
            "has_sig": false,
            "md5_digest": "45dd07761903307b502771a9170da201",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 842220,
            "upload_time": "2017-06-30T12:39:52",
            "url": "https://files.pythonhosted.org/packages/c8/95/c7ca6afc05780a45604e95740caa4939d1a529f73e560583b28a2973fbea/racovimge-0.9.tar.gz"
        }
    ]
}