{ "info": { "author": "James Rutherford", "author_email": "jim@jimr.org", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "License :: OSI Approved :: MIT License", "Operating System :: POSIX :: Linux", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: Implementation :: PyPy", "Topic :: Multimedia :: Graphics :: Graphics Conversion" ], "description": "==========\nDeba b\u014dch\u014d\n==========\n\nSlice up PDFs like a pro::\n\n % bocho my-fancy-file.pdf --pages 1 3 5 6 10 --angle 30 --zoom 1.6\n my-fancy-file-bocho-630x290.png\n\nTakes a PDF file and creates a \"stacked page\" preview from a selection of pages.\n\nIt accepts a bunch of options for customising the output (pass the ``-h`` flag for details).\n\nInstallation\n============\n\nRequires ImageMagick so you might need to, e.g::\n\n % sudo apt-get install imagemagick\n\nIf you want to use ``Wand`` instead of calling ``convert`` directly, you'll also need to perform some some additional steps, e.g::\n\n % sudo apt-get install libmagickwand-dev\n % pip install wand\n\nSee their installation instructions for more details.\n\nOn OS X, you'll want to use Homebrew to get the low-level dependencies in place::\n\n % brew install ghostscript imagemagick\n\nOnce all that's sorted, you just need to ``pip install deba-bocho``.\n\nPyPy: Oh My!\n============\n\nFor simple operations, there's not much difference in performance between CPython and PyPy.\nIf you want to use the ``shadow`` effect, it's a different matter.\nCue unscientific benchmarking run on my laptop...\n\nPython 2.7::\n\n % time bocho /tmp/report.pdf --preset example --shadow\n ...\n bocho /tmp/report.pdf --preset example --shadow 35.89s user 0.15s system 99% cpu 36.132 total\n\nPyPy::\n\n % time bocho /tmp/report.pdf --preset example --shadow\n ...\n bocho /tmp/report.pdf --preset example --shadow 4.10s user 0.18s system 99% cpu 4.297 total\n\nMaking PyPy about 10x as fast as Python 2.7.\nThe same process without ``--shadow`` takes around 2.5 seconds with both implementations.\n\nUsage\n=====\n\nFor information on usage, run ``bocho --help``. If you want to use it as a module::\n\n >>> import bocho\n >>> help(bocho.assemble)\n\nConfiguration\n=============\n\nIf you will be using the same options many times, it's probably worth creating a preset in a ``config.ini`` file (see config.example.ini_ or the example below to get started).\n\n.. _config.example.ini: https://github.com/jimr/deba-bocho/blob/master/config.example.ini\n\nBy default, ``bocho`` will check for ``$HOME/.config/bocho/config.ini``, so it's probably best to keep your config there, but you can pass the ``--config`` option with the path to an alternative location.\n\n.. code-block:: ini\n\n [example]\n pages = 1,3,5,7,9\n width = 630\n height = 290\n border = 4\n reuse = true\n delete = true\n verbose = true\n use_convert = true\n parallel = 5\n\nYou can tell ``bocho`` to use this preset by calling::\n\n bocho /path/to/file.pdf --preset example [--config /path/to/config.ini]\n\nTODO\n====\n\n- implement rotation properly \u2713\n- allow a \"zoom\" option \u2713\n- optional drop-shadows \u2713\n- make shadows smarter in their orientation (they're currently uniform, not respecting the angle / transformations)\n- make the basic edge separators optional \u2713\n- automatic spacing as an option as well as fixed pixel spacing\n- horizontal and vertical spacing \u2713\n- horizontal and vertical offsets \u2713\n- optional right-to-left stacking \u2713\n- handle non-A4 aspect ratio input documents \u2713\n- optionally apply transforms:\n\n - affine \u2717 (abandoned in favour of vertical / horizontal shear effects)\n - shear \u2713 (applied by creating simplified affine transforms)\n - stretch (can be achieved in a similar fashion to shear)\n - perspective\n\n- ensure sliced PNGs are large enough when custom width / height are specified\n- fix x and y spacing calculation to account for any applied rotation & transformation\n- allow transforms to be configurable (probably with presets defined in an ``.ini`` file)\n- drop the PyPDF dependency \u2713\n- use an ImageMagick binding rather than using ``subprocess`` to call ``convert`` \u2713 (Wand)\n- optionally re-use pages between runs \u2713\n- allow user-specified resolution for the PDF to PNG conversion \u2713\n- docs \u2713\n- pretty pictures illustrating the effect of the various options\n- use proper logging\n\nLicense\n=======\n\nSee ``LICENSE.txt``.\nTest images are from the USC-SIPI Image Database (http://sipi.usc.edu/database/).\nThe test PDF is \"Distributed Space-Time Interference Alignment\" (`arXiv:1405.0032 `_).", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/jimr/deba-bocho", "keywords": null, "license": "MIT", "maintainer": null, "maintainer_email": null, "name": "deba-bocho", "package_url": "https://pypi.org/project/deba-bocho/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/deba-bocho/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/jimr/deba-bocho" }, "release_url": "https://pypi.org/project/deba-bocho/0.5.3/", "requires_dist": null, "requires_python": null, "summary": "Slice up PDFs like a pro.", "version": "0.5.3" }, "last_serial": 1271182, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "53c6eec2fe1ca083d9cf78212e77f6bf", "sha256": "7db8c6c4de0acd8b50f9db7e80820d69e5fad5e9ca997636438d7cacd771959b" }, "downloads": -1, "filename": "deba-bocho-0.1.tar.gz", "has_sig": false, "md5_digest": "53c6eec2fe1ca083d9cf78212e77f6bf", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4918, "upload_time": "2014-05-09T13:39:56", "url": "https://files.pythonhosted.org/packages/a6/46/dcfdf7157915e3e4e88a70b4d5f8e8688811459f4838b3fd408c50222ccb/deba-bocho-0.1.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "3af6a4b476406d3eadfab9c60d88cfb6", "sha256": "fa41def09ca1b375671e7da5af9c12b0f46c1a3b72b8fe9c304ef06ae7bf08be" }, "downloads": -1, "filename": "deba-bocho-0.1.1.tar.gz", "has_sig": false, "md5_digest": "3af6a4b476406d3eadfab9c60d88cfb6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5823, "upload_time": "2014-05-09T13:42:02", "url": "https://files.pythonhosted.org/packages/e7/d2/9b6bff92cf9de66de83ce82b77358f99a6c4d69e1a161ce620d9efac3d4c/deba-bocho-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "accfb6923e1173217ae126bba4619b01", "sha256": "7bd578926877d9aece7f61121d6ccefe8d6c3624b5cc6a7e583b884fd0ce29e7" }, "downloads": -1, "filename": "deba-bocho-0.1.2.tar.gz", "has_sig": false, "md5_digest": "accfb6923e1173217ae126bba4619b01", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5973, "upload_time": "2014-05-09T14:14:32", "url": "https://files.pythonhosted.org/packages/eb/57/5b2450d8237d6e47dc3215ca492c4706aab0f1f7571ca9856310e1881a58/deba-bocho-0.1.2.tar.gz" } ], "0.1.3": [ { "comment_text": "", "digests": { "md5": "ffb4035f7e33849d24dd462ea712c43b", "sha256": "7293235dd039360d060864ed58e89d1cde97e8f15f0a89f20b5295fbbdae744d" }, "downloads": -1, "filename": "deba-bocho-0.1.3.tar.gz", "has_sig": false, "md5_digest": "ffb4035f7e33849d24dd462ea712c43b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5960, "upload_time": "2014-05-09T14:22:36", "url": "https://files.pythonhosted.org/packages/4e/ca/8614d1cc651fe6cc9690295ee3aeb7374bbb28de6aa13e9c23f0899f1a96/deba-bocho-0.1.3.tar.gz" } ], "0.1.4": [ { "comment_text": "", "digests": { "md5": "c38edbd4bfc6ae2682eec1fef5718a41", "sha256": "65b4f99ee3449daebaed205faa63aadaf894f7cf13c5a9e064e7a8dadc9ae81b" }, "downloads": -1, "filename": "deba-bocho-0.1.4.tar.gz", "has_sig": false, "md5_digest": "c38edbd4bfc6ae2682eec1fef5718a41", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5950, "upload_time": "2014-05-09T15:55:12", "url": "https://files.pythonhosted.org/packages/e4/c6/c5a22013ce7e5d7fa4858b01117d6134c7a72f54d6f5fb2f17c0d74f2bce/deba-bocho-0.1.4.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "58ab4187b53b7c9ea3adf59ebd0a0f8e", "sha256": "79d56844385bb6a56951be766430103565299b0cee446db56324e020d3b74d71" }, "downloads": -1, "filename": "deba-bocho-0.2.0.tar.gz", "has_sig": false, "md5_digest": "58ab4187b53b7c9ea3adf59ebd0a0f8e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7071, "upload_time": "2014-05-14T16:19:47", "url": "https://files.pythonhosted.org/packages/68/28/c6ae9ff4034ff47b7831c2ccd60391e2ec05e3ba8631c4fbd8b04748d711/deba-bocho-0.2.0.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "6416598f619c1d381ee96e7f546da0e9", "sha256": "b3240da5e90556e40f521aa5642dda0bbfb704efabf3fe519e89b9fbf40cff5d" }, "downloads": -1, "filename": "deba-bocho-0.2.1.tar.gz", "has_sig": false, "md5_digest": "6416598f619c1d381ee96e7f546da0e9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7257, "upload_time": "2014-05-14T16:44:29", "url": "https://files.pythonhosted.org/packages/7a/f6/71236c291e4292e651b3f1659ddbdb2d90359371a66bd8731859c42c8355/deba-bocho-0.2.1.tar.gz" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "71c2128201f747dd72058ed0876c76c0", "sha256": "c7946f9e2bc24314c5174e6e7b4a7a34a39e7f24eddfdfb46e198bd184879cd4" }, "downloads": -1, "filename": "deba-bocho-0.2.2.tar.gz", "has_sig": false, "md5_digest": "71c2128201f747dd72058ed0876c76c0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7258, "upload_time": "2014-05-14T17:04:31", "url": "https://files.pythonhosted.org/packages/56/3a/f54ae8d5f2b83c9d9e2b427bd9bb0ecc64a93326116f46d21de3416438c4/deba-bocho-0.2.2.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "ac547f71c684368a1387480de48b7ab5", "sha256": "2731d9fd264d29d1436b223472a5f56f2398df0b88ab0dccd9c8bfbc4174144a" }, "downloads": -1, "filename": "deba-bocho-0.3.0.tar.gz", "has_sig": false, "md5_digest": "ac547f71c684368a1387480de48b7ab5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7668, "upload_time": "2014-05-14T23:08:40", "url": "https://files.pythonhosted.org/packages/b2/99/b6c02c791d69c436da38c43cfdfc0accbcb54a18e7a7f259b6e317bb2d9f/deba-bocho-0.3.0.tar.gz" } ], "0.4.0": [ { "comment_text": "", "digests": { "md5": "3385830cc097ce43ee10543df6726a01", "sha256": "8f4a2b1297a568799580538a81858aad6f3188e59ba63b7c073eee9d9ad67b44" }, "downloads": -1, "filename": "deba-bocho-0.4.0.tar.gz", "has_sig": false, "md5_digest": "3385830cc097ce43ee10543df6726a01", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9259, "upload_time": "2014-05-15T13:26:24", "url": "https://files.pythonhosted.org/packages/19/cc/c1e0100c04a7aa10e7faa0266387e3c5da39a3f47698543522f94e8ee74e/deba-bocho-0.4.0.tar.gz" } ], "0.4.1": [ { "comment_text": "", "digests": { "md5": "95220841ff6fd5235545933dd9ca17ec", "sha256": "16c478c6727da8162d5b0d36afa87c879ee351b19f51e08008b43075a6bb40ea" }, "downloads": -1, "filename": "deba-bocho-0.4.1.tar.gz", "has_sig": false, "md5_digest": "95220841ff6fd5235545933dd9ca17ec", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9265, "upload_time": "2014-05-15T13:34:54", "url": "https://files.pythonhosted.org/packages/10/23/846a115d5f4ec3fa86a5fbed915ec5e87e1c5ca45676e21ed2e0036e9a0d/deba-bocho-0.4.1.tar.gz" } ], "0.5.0": [ { "comment_text": "", "digests": { "md5": "3c7e817e58958a8c366b13dc2aad6f2a", "sha256": "b3bc6ca0cf8c587dd1faeda7a1f4d73545408b09b10a3581b19374dfedf81354" }, "downloads": -1, "filename": "deba-bocho-0.5.0.tar.gz", "has_sig": false, "md5_digest": "3c7e817e58958a8c366b13dc2aad6f2a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9317, "upload_time": "2014-05-15T17:21:10", "url": "https://files.pythonhosted.org/packages/6d/28/02d04d6322d5ff90be5edd56556133ea4c70b18c25e9713ed5d5ba95a89e/deba-bocho-0.5.0.tar.gz" } ], "0.5.1": [ { "comment_text": "", "digests": { "md5": "6939ae1e294ab25d71bb8f34f92af373", "sha256": "73dc27c5a4b53fc5985ead0b17823c7d0e5889f46508b1f365707bbb83a49380" }, "downloads": -1, "filename": "deba-bocho-0.5.1.tar.gz", "has_sig": false, "md5_digest": "6939ae1e294ab25d71bb8f34f92af373", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9670, "upload_time": "2014-05-16T15:02:11", "url": "https://files.pythonhosted.org/packages/da/f2/bf9f3b093560fb5bdbb987be82bf162da22b1367d514cf35f436e03b2a71/deba-bocho-0.5.1.tar.gz" } ], "0.5.2": [ { "comment_text": "", "digests": { "md5": "ef9100dc385ddfe6f54805b65c24cdba", "sha256": "f030121b98bf149125427ef94b51783bbf60c5091bce5b2be2d2abdfbc173194" }, "downloads": -1, "filename": "deba-bocho-0.5.2.tar.gz", "has_sig": false, "md5_digest": "ef9100dc385ddfe6f54805b65c24cdba", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10741, "upload_time": "2014-10-15T11:29:28", "url": "https://files.pythonhosted.org/packages/54/38/49c50a2d59a4158029dd545b050f47de35ff37fd86069ede2d7fc96b4a45/deba-bocho-0.5.2.tar.gz" } ], "0.5.3": [ { "comment_text": "", "digests": { "md5": "47df6bdc778554ee3290b4d36334d8db", "sha256": "2e1cc4b68a8c572632528a171f43b88115d90f2211de45d4e0eef38ddc7ec039" }, "downloads": -1, "filename": "deba-bocho-0.5.3.tar.gz", "has_sig": false, "md5_digest": "47df6bdc778554ee3290b4d36334d8db", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10714, "upload_time": "2014-10-15T12:40:22", "url": "https://files.pythonhosted.org/packages/19/f4/d2b18d2d1e175a547de783d1baf03bb8226d25cdff2720a56151183f70d8/deba-bocho-0.5.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "47df6bdc778554ee3290b4d36334d8db", "sha256": "2e1cc4b68a8c572632528a171f43b88115d90f2211de45d4e0eef38ddc7ec039" }, "downloads": -1, "filename": "deba-bocho-0.5.3.tar.gz", "has_sig": false, "md5_digest": "47df6bdc778554ee3290b4d36334d8db", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10714, "upload_time": "2014-10-15T12:40:22", "url": "https://files.pythonhosted.org/packages/19/f4/d2b18d2d1e175a547de783d1baf03bb8226d25cdff2720a56151183f70d8/deba-bocho-0.5.3.tar.gz" } ] }