{ "info": { "author": "Randall Degges", "author_email": "rdegges@gmail.com", "bugtrack_url": null, "classifiers": [], "description": "# flask-heroku-cacheify\n\nAutomatic Flask cache configuration on Heroku.\n\n![Thinking Man Sketch](https://raw.github.com/rdegges/flask-heroku-cacheify/master/assets/thinking-man-sketch.jpg)\n\n\n## Purpose\n\nConfiguring your cache on Heroku can be a time sink. There are lots of\ndifferent caching addons available on Heroku (Redis, Memcached, etc.), and among\nthose -- lots of competitors.\n\n`flask-heroku-cacheify` makes your life easy by automatically configuring your\nFlask application to work with whatever caching addons you've got provisioned\non Heroku, allowing you to easily swap out addon providers at will, without any\ntrouble. And, just in case you don't have any suitable Heroku addons available,\n`flask-heroku-cacheify` will default back to using local memory for your cache!\n\nInstead of looking through documentation, testing stuff out, etc.,\n`flask-heroku-cacheify` will just do everything for you :)\n\n\n## Install\n\nTo install `flask-heroku-cacheify`, use [pip](http://pip.readthedocs.org/en/latest/).\n\n```bash\n$ pip install flask-heroku-cacheify\n```\n\n**NOTE**: If you're install `flask-heroku-cacheify` locally, you'll need to\nhave `libmemcached-dev` installed on your OS (with SASL support).\n\nNext, modify your `requirements.txt` file in your home directory, and add the\nfollowing to the bottom of your file:\n\n```bash\nFlask-Heroku-Cacheify>=1.3\npylibmc>=1.2.3\n```\n\nThe above will ensure that Heroku pulls in the required C header files (in case\nyou decide to use memcached). This step is **required**.\n\n\n## Pick an Addon\n\nHeroku has lots of available addons you can use for caching.\n`flask-heroku-cacheify` currently works with them all! That means no matter\nwhich option you choose, your cache will work out of the box, guaranteed!\n\nBelow is a list of the addons you can install to get started, you should have at\nleast one of these activated on your Heroku app -- otherwise, your cache will be\nin 'local memory' only, and won't be very useful.\n\n- [MemCachier](https://addons.heroku.com/memcachier)\n- [RedisGreen](https://addons.heroku.com/redisgreen)\n- [Redis Cloud](https://addons.heroku.com/rediscloud)\n- [Redis To Go](https://addons.heroku.com/redistogo)\n- [openredis](https://addons.heroku.com/openredis)\n\n**NOTE** My favorite providers are MemCachier (for memcache), and openredis for\nredis. Both are equally awesome as cache providers. If you're in need of a\nstable cache provider for large applications, I'd recommend\n[RedisGreen](https://addons.heroku.com/redisgreen) -- they use dedicated EC2\ninstances (which greatly improves your server power) and have an excellent\ninterface.\n\n\n## Usage\n\nUsing `flask-heroku-cacheify` is *super easy*! In your `app.py` (or wherever\nyou define your Flask application), add the following:\n\n```python\nfrom flask_cacheify import init_cacheify\n\napp = Flask(__name__)\ncache = init_cacheify(app)\n```\n\nOnce you've got your `cache` global defined, you can use it anywhere in your\nFlask app:\n\n```python\n>>> from app import cache\n>>> cache.set('hi', 'there', 30)\n>>> cache.get('hi')\n'there'\n```\n\nHow does this work? In the background, `flask-heroku-cacheify` is really just\nautomatically configuring the popular\n[Flask-Cache](http://pythonhosted.org/Flask-Cache/) extension! This means, you\ncan basically skip down to [this\npart](http://pythonhosted.org/Flask-Cache/#caching-view-functions) of their\ndocumentation, and begin using all the methods listed there, without worrying\nabout setting up your caches! Neat, right?\n\nFor more information and examples of how to use your cache, don't forget to read\nthe [Flask-Cache](http://pythonhosted.org/Flask-Cache/) documentation.\n\n\n## Like This?\n\nLike this software? If you really enjoy `flask-heroku-cacheify`, you can show\nyour appreciation by:\n\n- Sending me some bitcoin, my address is: **17BE6Q6fRgxJutnn8NsQgeKnACFjzWLbQT**\n- Tipping me on [gittip](https://www.gittip.com/rdegges/).\n\nEither way, thanks! <3\n\n\n## Changelog\n\n1.6.1: 12-20-2017\n\n - Update docs\n - Updating code to support latest Flask release\n\n1.6.0: 04-22-2017\n\n - Upgrading to work with latest FLask release (thanks @mattstibbs).\n\nv1.5: 06-20-2015\n\n - Removing MyRedis addon support -- the addon has been shut down.\n\nv1.4: 04-04-2015\n\n - Fixing typos in README.\n - Adding Python 3 compatibility.\n\nv1.3: 05-31-2012\n\n - Fixing bug with memcachier support (thanks @eriktaubeneck)!\n\nv1.2: 04-18-2013\n\n - Adding proper documentation.\n\nv1.1: 04-18-2013\n\n - Adding support for MyRedis.\n - Adding support for Redis Cloud.\n - Adding support for Redis To Go.\n - Adding support for openredis.\n\nv1.0: 04-18-2013\n\n - Fixing bug with RedisGreen support.\n\nv0.9: 04-18-2013\n\n - First *real* release! Supports MemCachier and RedisGreen!\n\nv0.8: 04-18-2013\n\n - Pushing eigth release to PyPI (don't use this still!).\n\nv0.7: 04-18-2013\n\n - Pushing seventh release to PyPI (don't use this still!).\n\nv0.6: 04-18-2013\n\n - Pushing sixth release to PyPI (don't use this still!).\n\nv0.5: 04-18-2013\n\n - Pushing fifth release to PyPI (don't use this still!).\n\nv0.4: 04-18-2013\n\n - Pushing fourth release to PyPI (don't use this still!).\n\nv0.3: 04-18-2013\n\n - Pushing third release to PyPI (don't use this still!).\n\nv0.2: 04-18-2013\n\n - Pushing second release to PyPI (don't use this still!).\n\nv0.1: 04-18-2013\n\n - Pushing first release to PyPI (don't use this yet!).\n\nv0.0: 04-14-2013\n\n - Started work >:)", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/rdegges/flask-heroku-cacheify", "keywords": "flask heroku cloud cache memcache memcached redis awesome", "license": "UNLICENSE", "maintainer": "", "maintainer_email": "", "name": "Flask-Heroku-Cacheify", "package_url": "https://pypi.org/project/Flask-Heroku-Cacheify/", "platform": "", "project_url": "https://pypi.org/project/Flask-Heroku-Cacheify/", "project_urls": { "Homepage": "https://github.com/rdegges/flask-heroku-cacheify" }, "release_url": "https://pypi.org/project/Flask-Heroku-Cacheify/1.6.1/", "requires_dist": null, "requires_python": "", "summary": "Automatic Flask cache configuration on Heroku.", "version": "1.6.1" }, "last_serial": 3433419, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "e343160cac5ba3c2c91e57b9807c18d4", "sha256": "2c2732f8cab53f6c8733ed2d0f8086c61c68aecbed7ba74ecd7232224e5e0b37" }, "downloads": -1, "filename": "Flask-Heroku-Cacheify-0.1.tar.gz", "has_sig": false, "md5_digest": "e343160cac5ba3c2c91e57b9807c18d4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 193093, "upload_time": "2013-04-19T06:00:19", "url": "https://files.pythonhosted.org/packages/01/07/1e1df04b884265a235de17cb378dd992e66fb6c40e7e8b176227605f6c81/Flask-Heroku-Cacheify-0.1.tar.gz" } ], "0.2": [ { "comment_text": "", "digests": { "md5": "7e46518a6d24a4e7c3edccec184ea32b", "sha256": "7db72d435923b847afd1024792eff0def3b4e16f05004fb933b87c5eca555a63" }, "downloads": -1, "filename": "Flask-Heroku-Cacheify-0.2.tar.gz", "has_sig": false, "md5_digest": "7e46518a6d24a4e7c3edccec184ea32b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 193176, "upload_time": "2013-04-19T06:19:50", "url": "https://files.pythonhosted.org/packages/ee/cf/dd74f8f3e99daa2edc8c8c41e982e9dcbd001d7bdd3cf4670f1bffa9dc50/Flask-Heroku-Cacheify-0.2.tar.gz" } ], "0.3": [ { "comment_text": "", "digests": { "md5": "4f41636da638d61e2426498ca4983201", "sha256": "4a27fd8a5cbc2cf34195f72f5bf24ec06f4cff426d18cdd9fbd81f1e8578b66d" }, "downloads": -1, "filename": "Flask-Heroku-Cacheify-0.3.tar.gz", "has_sig": false, "md5_digest": "4f41636da638d61e2426498ca4983201", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 193202, "upload_time": "2013-04-19T06:26:06", "url": "https://files.pythonhosted.org/packages/ba/ca/2a72164381e8db6359dc9c752d77738f0e1f8959ef048e3452bbed43d3d6/Flask-Heroku-Cacheify-0.3.tar.gz" } ], "0.4": [ { "comment_text": "", "digests": { "md5": "3e4c925937bd2c30a4c6d1c23b73a5a2", "sha256": "876a600f336a5c773b831d4c2f1fc410047407f4ad973dae5681ff2703ad06e0" }, "downloads": -1, "filename": "Flask-Heroku-Cacheify-0.4.tar.gz", "has_sig": false, "md5_digest": "3e4c925937bd2c30a4c6d1c23b73a5a2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 193214, "upload_time": "2013-04-19T06:31:15", "url": "https://files.pythonhosted.org/packages/18/b2/1bf1117520e88114a225dca346698bec9e95af1d02d5d8f19a4021048b3a/Flask-Heroku-Cacheify-0.4.tar.gz" } ], "0.5": [ { "comment_text": "", "digests": { "md5": "7349b437416f2b352dba278c1965381d", "sha256": "c6cc2728b8c00eabde025c1fef4219368a6719dcbfa9ca443ce23d862dded864" }, "downloads": -1, "filename": "Flask-Heroku-Cacheify-0.5.tar.gz", "has_sig": false, "md5_digest": "7349b437416f2b352dba278c1965381d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 193181, "upload_time": "2013-04-19T06:36:09", "url": "https://files.pythonhosted.org/packages/10/03/b906c2a16ef4cb682cb6e9374e2375b62a68ef71142cf20901e99d41aed0/Flask-Heroku-Cacheify-0.5.tar.gz" } ], "0.6": [ { "comment_text": "", "digests": { "md5": "cd704094c827f6a1cb89d73042a95df9", "sha256": "cceca25e7ad5c515d0c2bc12ba657b9097250bda253211eb34d327068444910b" }, "downloads": -1, "filename": "Flask-Heroku-Cacheify-0.6.tar.gz", "has_sig": false, "md5_digest": "cd704094c827f6a1cb89d73042a95df9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 193203, "upload_time": "2013-04-19T06:40:20", "url": "https://files.pythonhosted.org/packages/de/b6/81c92472c4d38563d6de947ef8e6eac8a8526bc8bbe4448c8c2380f31e88/Flask-Heroku-Cacheify-0.6.tar.gz" } ], "0.7": [ { "comment_text": "", "digests": { "md5": "8eac188380c2d855bbf1e6f42753d77a", "sha256": "78c8350b7478c19b55f8c4bd1c3ab74914ac11da7547f62707842cec1c4b80fe" }, "downloads": -1, "filename": "Flask-Heroku-Cacheify-0.7.tar.gz", "has_sig": false, "md5_digest": "8eac188380c2d855bbf1e6f42753d77a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 192806, "upload_time": "2013-04-19T07:00:42", "url": "https://files.pythonhosted.org/packages/98/af/89deec2c0ed856d818440c95b5ffb74ff5921789d93a73231bc756b48c8d/Flask-Heroku-Cacheify-0.7.tar.gz" } ], "0.8": [ { "comment_text": "", "digests": { "md5": "4bef70cd2bd9261c0be3626383cf01d9", "sha256": "4eac74e1c5e778fe15041b04a367da2ee037d8a51c34330cd2f2c57f2ba9d1dc" }, "downloads": -1, "filename": "Flask-Heroku-Cacheify-0.8.tar.gz", "has_sig": false, "md5_digest": "4bef70cd2bd9261c0be3626383cf01d9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 192832, "upload_time": "2013-04-19T07:05:10", "url": "https://files.pythonhosted.org/packages/d3/60/a2455abbac0f271e84b54aa15ce04870dc4623117423a9e697d3d32c7a6d/Flask-Heroku-Cacheify-0.8.tar.gz" } ], "0.9": [ { "comment_text": "", "digests": { "md5": "20ad1b4f0dc1c5b1a94b54238770eec1", "sha256": "9f9fba28a05d71301ca01a678a2e3d432faa05dca9d0a66a29a19c83fb196214" }, "downloads": -1, "filename": "Flask-Heroku-Cacheify-0.9.tar.gz", "has_sig": false, "md5_digest": "20ad1b4f0dc1c5b1a94b54238770eec1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 192977, "upload_time": "2013-04-19T07:27:38", "url": "https://files.pythonhosted.org/packages/c0/19/3b512d07857789e3bba4635fb0ad3a5f87aec797185db6954607272477c0/Flask-Heroku-Cacheify-0.9.tar.gz" } ], "1.0": [ { "comment_text": "", "digests": { "md5": "c7df24d7f578d5d7a1da90abb9ae2ad9", "sha256": "d7378ea208f96d2b10cd125df825bf605ba63cf13a5bccc81cbc18f344a09af5" }, "downloads": -1, "filename": "Flask-Heroku-Cacheify-1.0.tar.gz", "has_sig": false, "md5_digest": "c7df24d7f578d5d7a1da90abb9ae2ad9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 193022, "upload_time": "2013-04-19T07:35:18", "url": "https://files.pythonhosted.org/packages/b4/07/eb6116b61f8a3265c14f1c6edfebd6e6e86efd48e241d6cbe203333986a4/Flask-Heroku-Cacheify-1.0.tar.gz" } ], "1.1": [ { "comment_text": "", "digests": { "md5": "0fce32f51b704a91581920f2c11d9a45", "sha256": "af6de48a01a3d6ba42c2727a188deb562d07ace656faf515044d7bf9f24ab7e4" }, "downloads": -1, "filename": "Flask-Heroku-Cacheify-1.1.tar.gz", "has_sig": false, "md5_digest": "0fce32f51b704a91581920f2c11d9a45", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 193159, "upload_time": "2013-04-19T07:54:53", "url": "https://files.pythonhosted.org/packages/92/e4/abd1558bef66d763d53faad565b6d9258f0fc3d26ef67f960674cfb412da/Flask-Heroku-Cacheify-1.1.tar.gz" } ], "1.2": [ { "comment_text": "", "digests": { "md5": "7b13cb052691a2e5783473f3a8110442", "sha256": "a31f0a882869ff0326d839119092982e74306c595abb657410356adfc2bfe35d" }, "downloads": -1, "filename": "Flask-Heroku-Cacheify-1.2.tar.gz", "has_sig": false, "md5_digest": "7b13cb052691a2e5783473f3a8110442", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 194787, "upload_time": "2013-04-19T08:40:33", "url": "https://files.pythonhosted.org/packages/9d/fd/7ee48d3c75c1342fe409bf8ffec6e6dee5e8f302de842d81b4f5835898fc/Flask-Heroku-Cacheify-1.2.tar.gz" } ], "1.3": [ { "comment_text": "", "digests": { "md5": "a5e23793e055bc1cd874d0fc2d4ed6ad", "sha256": "681cbe414bd447af115f35ddd04c1a09bed94ff7caca903793223ab48f257be9" }, "downloads": -1, "filename": "Flask-Heroku-Cacheify-1.3.tar.gz", "has_sig": false, "md5_digest": "a5e23793e055bc1cd874d0fc2d4ed6ad", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 194950, "upload_time": "2013-05-31T22:00:33", "url": "https://files.pythonhosted.org/packages/59/4f/ff5e8d2ae2f3dbe553b4acc7fc352140fbbdeb7935e723f3fe5726b40c82/Flask-Heroku-Cacheify-1.3.tar.gz" } ], "1.4": [ { "comment_text": "", "digests": { "md5": "cd6a830adf7f98a280644c1180f97aee", "sha256": "67472568c68098b9543a9f48fb5f019c3c0810cf79af98f05e265c9be918b552" }, "downloads": -1, "filename": "Flask-Heroku-Cacheify-1.4.tar.gz", "has_sig": false, "md5_digest": "cd6a830adf7f98a280644c1180f97aee", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 194902, "upload_time": "2015-04-05T06:32:41", "url": "https://files.pythonhosted.org/packages/d0/ac/f3234cea661d35795f37b2259e7ca65b01f6911cd0b810502038129d3883/Flask-Heroku-Cacheify-1.4.tar.gz" } ], "1.5": [ { "comment_text": "", "digests": { "md5": "5c7032c259cfaedcba92f6ebbda95fc9", "sha256": "5d00e92340d8eea110c31c3e719a304aa7e2086602b14c3ac603582462fa5d05" }, "downloads": -1, "filename": "Flask_Heroku_Cacheify-1.5-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "5c7032c259cfaedcba92f6ebbda95fc9", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 6963, "upload_time": "2015-06-21T06:52:29", "url": "https://files.pythonhosted.org/packages/be/e5/68e17876c7b22126035473789958cc697097a86cae464b348fdc7fa9b45b/Flask_Heroku_Cacheify-1.5-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "61133b7a5384e5f3fe9794d5c5ddaf61", "sha256": "d54750c0021c897bd098a630ef96dc60b5450b179df41cc5039451a926b686cb" }, "downloads": -1, "filename": "Flask-Heroku-Cacheify-1.5.tar.gz", "has_sig": false, "md5_digest": "61133b7a5384e5f3fe9794d5c5ddaf61", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 194928, "upload_time": "2015-06-21T06:52:24", "url": "https://files.pythonhosted.org/packages/bb/5d/ae3bbbc724b1d055ab4ccce39443056ae1dde8a8451f8a8eb86ccac6a516/Flask-Heroku-Cacheify-1.5.tar.gz" } ], "1.6.0": [ { "comment_text": "", "digests": { "md5": "0c8bb0b99fa0f4079dd7eee47cd0ea66", "sha256": "b8a3c346f4e7e98bcfc9b3bfb483903c0696eb68cf6e9667c53807ef8c608eca" }, "downloads": -1, "filename": "Flask_Heroku_Cacheify-1.6.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "0c8bb0b99fa0f4079dd7eee47cd0ea66", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 7064, "upload_time": "2017-04-23T01:33:45", "url": "https://files.pythonhosted.org/packages/43/cf/4ed3f46fe6d4055ceb70ee6faf183c9932d7c0f209248d1f428f7d0c4c44/Flask_Heroku_Cacheify-1.6.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f695882ebbcc9b96c8b9e40d6abb240b", "sha256": "6c1e8f3f612f5dfd8bab910dcd54a8d959e97d4fe6bb59f1b6b984edeaf35076" }, "downloads": -1, "filename": "Flask-Heroku-Cacheify-1.6.0.tar.gz", "has_sig": false, "md5_digest": "f695882ebbcc9b96c8b9e40d6abb240b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 197866, "upload_time": "2017-04-23T01:33:48", "url": "https://files.pythonhosted.org/packages/12/97/b0b27483c68f006759f70d0560f0bffb70f129d5472fc2216226df7e0f5d/Flask-Heroku-Cacheify-1.6.0.tar.gz" } ], "1.6.1": [ { "comment_text": "", "digests": { "md5": "5e23e5f95e8f3ca34915afa1871fae78", "sha256": "f6026f01f6693b16409e4cdf76db024dc64bdcfbbc765e1b472ab02f76ae4c10" }, "downloads": -1, "filename": "Flask-Heroku-Cacheify-1.6.1.tar.gz", "has_sig": false, "md5_digest": "5e23e5f95e8f3ca34915afa1871fae78", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 197316, "upload_time": "2017-12-21T05:33:26", "url": "https://files.pythonhosted.org/packages/6e/70/42445eda0412797f0bf6135f53ad3d03c26a4f50b3dd20a77b226d9f5555/Flask-Heroku-Cacheify-1.6.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "5e23e5f95e8f3ca34915afa1871fae78", "sha256": "f6026f01f6693b16409e4cdf76db024dc64bdcfbbc765e1b472ab02f76ae4c10" }, "downloads": -1, "filename": "Flask-Heroku-Cacheify-1.6.1.tar.gz", "has_sig": false, "md5_digest": "5e23e5f95e8f3ca34915afa1871fae78", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 197316, "upload_time": "2017-12-21T05:33:26", "url": "https://files.pythonhosted.org/packages/6e/70/42445eda0412797f0bf6135f53ad3d03c26a4f50b3dd20a77b226d9f5555/Flask-Heroku-Cacheify-1.6.1.tar.gz" } ] }