[{"_1":2,"_155":-5,"_156":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_134":135},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_125":-5,"_126":11,"_127":17,"_128":11,"_129":-5,"_130":11,"_131":-5,"_132":133},"canonicalUrl","https://hub.docker.com/r/itamarhaber/zpop/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","itamarhaber","reponame","zpop","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":58,"_60":61,"_62":-5,"_63":64,"_65":66,"_67":11,"_68":29,"_69":70,"_75":17,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2018-05-02T15:15:52.585142Z","description","Automated docker hub build for the Redis Ze POP module","is_private","last_updated","2018-05-17T12:36:31.34571Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",1978,"repository_type","star_count",1,"status","status_description","active","source","collaborator_count",0,"full_description","# Ze POP Redis Module\n\nAn educational [Redis](https://redis.io) module that implements ze [top requested](https://github.com/antirez/redis/issues/1861) Redis feature by users.\n\nHas hopes (or the vanity) of becoming a part of ze core one day - see pull request [_\"#4879 Implements [B]Z[REV]POP and the respective unit tests\"_](https://github.com/antirez/redis/pull/4879) /cc @antirez ;)\n\nDeveloped w/ <3 for RedisConf 18 and ze Redis community.\n\n## Current status\n\nFresh out of development, and needs tests -> proof of concept.\n\n**WARNING**: TOTALLY UNSAFE FOR USE WITH ANY SYSTEM THAT USES `MULTI/EXEC` AND/OR LUA SCRIPTS\n\n## Quickstart (or Ze Demo)\n\n### Terminal window #1\n\nFollow the instructions below on how to [build and run Ze POP](#Building and running the module), or just use docker ;)\n\n```text\n$ docker run -it -p 6379:6379 --name ZePOP itamarhaber/zpop\n1:C 02 May 14:36:18.660 # oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo\n...\n1:M 02 May 14:36:18.661 * Module 'ZePOP' loaded from /usr/lib/redis/modules/zpop.so\n1:M 02 May 14:36:18.661 * Ready to accept connections\n```\n\n### Terminal window #2\n\n```text\n$ redis-cli\n127.0.0.1:6379> ZADD z 0 a 1 b\n(integer) 2\n127.0.0.1:6379> Z.POP z\n1) \"0.000000\"\n2) \"a\"\n127.0.0.1:6379> Z.POP z\n1) \"1.000000\"\n2) \"b\"\n127.0.0.1:6379> Z.POP z\n(nil)\n127.0.0.1:6379> ZADD z 0 a 1 b\n(integer) 2\n127.0.0.1:6379> 3 Z.REVPOP z\n1) \"1.000000\"\n2) \"b\"\n1) \"0.000000\"\n2) \"a\"\n(nil)\n127.0.0.1:6379> Z.BPOP z1 z2 z3 0\n| <- imagine zat zis iz an indefinitely blinking cursor\n```\n\n### Terminal window #3\n```text\n$ redis-cli\n127.0.0.1:6379> ZADD z2 6379 foobar\n(integer) 1\n```\n\n### And back to terminal window #2\n\n```text\n1) \"z2\"\n2) \"6379.000000\"\n3) \"foobar\"\n127.0.0.1:6379> |\n```\n\n## Educational?!? Use your imagination...\n\nYeah. It is originally intended as teaching/guiding aid for the newly-initiated Redis Module developer as part of the day 0 training at RedisConf 18. I felt I had to refresh upon the stale-ish 2yo HGETSET example, so that's basically ZPOP using the High Level Redis Module API.\n\nBut you don't use the HL API unless you know better, and I guess I know a little better, so there's the (better!) LL implementation that's actually being used by the module more \"advanced\" stuff.\n\nOh, it also shows how to inspect the command's name in order to implement both ZPOP and ZREVPOP efficiently.\n\nThen, because blocking operations are so cool (and you can't do that in Lua), it uses the LL blocking API for implementing the Blocking ZPOP! This kind of a thing only became possible recently (i.e. w/o serious hacking) via Experimental LL Key Space Notifications API BTW FYI.\n\nLastly, for keeping track over the interconnectedness of all things, the it uses [Rax](https://github.com/antirez/rax) (but still implements its own minimal linked list) :)\n\nP.S. no fruits were harmed during the creation of this module.\nP.S.S. honorable mention to the deprecated: https://github.com/RedisLabsModules/redex#zpop-key-withscore\n\n## Commands\n\n### `Z.POP `\n> Time complexity: O(log(N)) with N being the number of elements in the sorted set\n\nPops (remove and return) the lowest-ranking element from a sorted set.\n\n**Return value:** Array, specifically the popped element's score and the popped element itself, or nil if key doesn't exist.\n\n### `Z.REVPOP `\n> Time complexity: O(log(N)) with N being the number of elements in the sorted set\n\nPops (remove and return) the highest-ranking element from a sorted set.\n\n**Return value:** Array, specifically the popped element's score and the popped element itself, or nil if key doesn't exist.\n\n### `Z.BPOP [ ...] `\n> Time complexity: O(log(N)) with N being the number of elements in the sorted set\n\nPops (remove and return) the lowest-ranking element from a sorted set. If the key doesn't exist, it blocks until `` (given in milliseconds) is met. A value of 0 for the `` means block indefinitely.\n\n**Return value:** Array, specifically the popped key, the popped element's score and the popped element itself, or nil if the timeout is met.\n\n### `Z.REVBPOP [ ...] `\n> Time complexity: O(log(N)) with N being the number of elements in the sorted set\n\nPops (remove and return) the highest-ranking element from a sorted set. If the key doesn't exist, it blocks until `` (given in milliseconds) is met. A value of 0 for the `` means block indefinitely.\n\n**Return value:** Array, specifically the popped key, the popped element's score and the popped element itself, or nil if the timeout is met.\n\n# Building and running the module\n\n## Build it\n\n### Prerequirements\n\n* Linux: `build-essential`\n* MacOS: XCode, brew, ...\n\n### Build steps\n\n1. `git clone git@github.com:itamarhaber/zpop.git`\n2. `cd zpop`\n3. `make all -j 4`\n\n## Test it\n\nPrerequirements: Python, Python's setup tools and pip\n\n1. `make test`\n\n## Run it\n\nAdd the following line to your Redis conf file:\n\n```\nloadmodule /path/to/zpop/src/zpop.so\n```\n\nOr load the module from command line:\n\n```\n$ redis-server --loadmodule /path/to/zpop/src/zpop.so\n```\n\nOr load it with the `MODULE LOAD` command:\n\n```text\n127.0.0.1:6379> MODULE LOAD /path/to/zpop/src/zpop.so\nOK\n```\n\n## License\nBSD-3-Clause\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",79044221,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":61,"_124":17},"content_type","creator",1997496,"full_size",39482262,"id",26664925,"images",[97],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":61,"_113":-5},"architecture","amd64","digest","sha256:8b12842588c501e967ae3feefcbdfba6dedfc167b3b4221fc96b507db2a67abf","features","","last_pulled","2026-09-24T01:47:46.511990692Z","last_pushed","2018-05-17T12:36:32Z","os","linux","os_features","os_version","size","variant","2018-05-17T12:36:31.013658Z","last_updater","last_updater_username","media_type","latest","repository",5454749,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":136,"_143":144,"_132":153,"_154":11},{"_36":137,"_38":138,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":139,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":58,"_60":61,"_62":-5,"_63":64,"_65":66,"_67":11,"_68":29,"_69":140,"_75":17,"_76":142,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":141},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_145":58,"_146":-5,"_147":-5,"_148":149},"count","next","previous","results",[150],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":151,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":61,"_124":17},[152],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":61,"_113":-5},[],"canDeleteTags","actionData","errors"]

itamarhaber/zpop

Tags for itamarhaber/zpop