{ "info": { "author": "Shantanu Goel", "author_email": "shantanu@shantanugoel.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Operating System :: OS Independent", "Operating System :: POSIX", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Topic :: Internet", "Topic :: Software Development :: Libraries", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: Utilities" ], "description": "# deecubes (Damn Simple Static url Shortener)\n\nThe name comes from the short form DSSS of Damn Simple Static url Shortener (so, a D and a cube of S's. Idiotic, I know :P). This program allows to maintain a website of short urls, akin to bit.ly/tinyurl etc, that can redirect to longer urls so one has to remember/give shorter ones. The main point of this project is to allow this to be done via a static website instead of a database based solution.\n\nThere are several benefits of a static website like they are much cheaper (Free to host on github/gitlab etc), easy to migrate to any host in minutes (if not seconds), etc. On top of this, the project strives to make this process as simple as possible to use.\n\n## Input\n\nLong url that you want to shorten\n\nA mnemonic/shorturl you want to assign to it (Optional. If not given, one is generated automatically)\n\n## Output\n\nStatic website of shorturls redirecting to your long urls\n\nOne can also go to shorturl/preview.html to see the long url it points to without getting redirected.\n\n# Demo Website:\nhttps://shgl.in/ uses this project. Repository for reference: https://shgl.in/deecubesdemo\n\n# Installation\n\nIt's recommended to install deecubes from pypi using pip\n\n```\npip install deecubes\n```\n\n# Deployment methods\n\nYou can use/deploy your own shorturl websites using deecubes in various ways given below and more:\n\n- Host website on github/gitlab etc. Run deecubes cli commands (given in next section) locally to generate shorturls in a git repository. Commit and upload.\n\n- Host website on github/gitlab etc. Create a 'source' branch in the website repository. Add a link to input directory from PC or directly through web interface and use a CI job (like Travis/CircleCI/Pipeline etc) to automatically generate shorturls using \"sync\" commands. https://shgl.in/ uses this method.\n\n- Create your own automation to host the output directory on any host (through APIs or mounted directories etc)\n\n# CLI Usage\n\n```\nusage: deecubes [-h] [-v] [-l LOGLEVEL]\n [-a SHORTURL URL | -g URL | -d SHORTURL | -s] -r RAW_DATA_PATH\n -o OUTPUT_PATH\n\noptional arguments:\n -h, --help show this help message and exit\n -v, --version show program's version number and exit\n -l LOGLEVEL, --log LOGLEVEL\n Set log level. 0=> Warning, 1=>Info, 2=>Debug\n -a SHORTURL URL, --add SHORTURL URL\n Add given shorturl for given url\n -g URL, --generate URL\n Generate shorturl for given url\n -d SHORTURL, --delete SHORTURL\n Delete given shorturl\n -s, --sync Sync raw data storage and html output\n\nrequired arguments:\n -r RAW_DATA_PATH, --raw-data-path RAW_DATA_PATH\n Raw data storage path\n -o OUTPUT_PATH, --output-path OUTPUT_PATH\n HTML output path\n\n```\n\nNotes:\n\n- Raw Path: A directory where deecubes stores raw information about urls. This can be empty directory if you are using add/generate commands for urls. Otherwise, you can add a .txt file here with the content being a long url. Then when, sync command is used, deecubes will add corresponding shorturl html files in output directory using the filename as the shorturl.\n\n- Output Path: Path where the static website is generated. This directory should be used for deployment.\n\n- Raw path and output path are mandatory to specify for all commands\n\n## Examples\n\nAdd a specific shorturl for a long url\n\n```\ndeecubes -r ./raw -o ./public -a github https://github.com/shantanugoel/\n```\n\nAdd a long url and deecubes will generate a shorturl on its own\n\n```\ndeecubes -r ./raw -o ./public -g https://github.com/shantanugoel/\n```\n\nAutomatically generate shorturls in output dir for any .txt files that were manually added to raw directory\n\n```\ndeecubes -r ./raw -o ./public --sync\n```\n\n# TODO\n\n- Add collision handling\n\n- Add google analytics\n\n- Add configurable templates\n\n- Suggestions?\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/shantanugoel/deecubes/", "keywords": "url shorturl url-shortener", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "deecubes", "package_url": "https://pypi.org/project/deecubes/", "platform": "", "project_url": "https://pypi.org/project/deecubes/", "project_urls": { "Homepage": "https://github.com/shantanugoel/deecubes/" }, "release_url": "https://pypi.org/project/deecubes/0.3.1/", "requires_dist": null, "requires_python": ">=3", "summary": "deecubes (DSSS - Damn Simple Static url Shortener)", "version": "0.3.1" }, "last_serial": 3231169, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "590b9da59000e739a5937ebe7dd3fa0d", "sha256": "d6999085ffa258efa6aa92159a8ba81f3fa4edf13c42a7bf4abb55c9640d20dd" }, "downloads": -1, "filename": "deecubes-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "590b9da59000e739a5937ebe7dd3fa0d", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3", "size": 5466, "upload_time": "2017-09-15T20:23:28", "url": "https://files.pythonhosted.org/packages/75/72/8ac50b7fc5517062e66357b1709c686d2d027f9b366555ce19aafd8df43c/deecubes-0.1.0-py3-none-any.whl" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "8b470dacbfdefe40223d81dd40b7c038", "sha256": "d2994722d0d58634bc121eb0951ed822d4e100daf9f922719439b3fdb864cd04" }, "downloads": -1, "filename": "deecubes-0.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "8b470dacbfdefe40223d81dd40b7c038", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3", "size": 5573, "upload_time": "2017-09-16T15:42:46", "url": "https://files.pythonhosted.org/packages/44/bd/6c7f13bcb6bffff75a178eac49f760f8bf5f08992fadda57a3a45dabfbe2/deecubes-0.2.0-py3-none-any.whl" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "e04f06ef2be57e07f854743f3c2f3e54", "sha256": "c430117868a56813115589a70c8c6e13330aba3f56b65576f5f7dab9ffe2877f" }, "downloads": -1, "filename": "deecubes-0.2.1-py3-none-any.whl", "has_sig": false, "md5_digest": "e04f06ef2be57e07f854743f3c2f3e54", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3", "size": 8133, "upload_time": "2017-09-16T19:10:57", "url": "https://files.pythonhosted.org/packages/0f/d6/fa004ed1ab5126d031d0d61f1fb0831b4b4517628c5eb52f2b41d00dfa9a/deecubes-0.2.1-py3-none-any.whl" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "bf20388fbdf8d3661765bd5e49b7b773", "sha256": "89316858228e93125f6798d464c5cff56bfcdfad5ecc49c75871cbeec83319d6" }, "downloads": -1, "filename": "deecubes-0.2.2-py3-none-any.whl", "has_sig": false, "md5_digest": "bf20388fbdf8d3661765bd5e49b7b773", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3", "size": 8814, "upload_time": "2017-09-16T20:04:59", "url": "https://files.pythonhosted.org/packages/04/7d/7eb23a51410bd9ef40b200c5843b0db9bb31c1067b27d44a8fded3a51c45/deecubes-0.2.2-py3-none-any.whl" } ], "0.2.3": [ { "comment_text": "", "digests": { "md5": "9544eee59512b55d0fce701d8d8a44e2", "sha256": "137f8849943fa436579b49b3436bf9deb818d101771b339190fcbfb12ff2150d" }, "downloads": -1, "filename": "deecubes-0.2.3-py3-none-any.whl", "has_sig": false, "md5_digest": "9544eee59512b55d0fce701d8d8a44e2", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3", "size": 8932, "upload_time": "2017-10-05T17:31:58", "url": "https://files.pythonhosted.org/packages/db/16/933b5138fffba2c67edf3b70e0addc0ecbc7a2075399c05c78b03b1fc7eb/deecubes-0.2.3-py3-none-any.whl" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "59dee9c635b5399c28a7fbe96e6aa8e7", "sha256": "7ea43ed4f1a94a20b4f55f861d57cfe9c8c5db161ee872ca45cb70b3d3520813" }, "downloads": -1, "filename": "deecubes-0.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "59dee9c635b5399c28a7fbe96e6aa8e7", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3", "size": 9053, "upload_time": "2017-10-06T18:13:53", "url": "https://files.pythonhosted.org/packages/a5/22/6ed90526c8bd76c819f0c93b3460801d23284ac5d1b3bed0236e82ba7766/deecubes-0.3.0-py3-none-any.whl" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "110a3192255b7bc7f9fb7f1a7160245f", "sha256": "39a51422fc068e580107e851968c5d9b6fc5b93de399d6e1ee95edb04667adae" }, "downloads": -1, "filename": "deecubes-0.3.1-py3-none-any.whl", "has_sig": false, "md5_digest": "110a3192255b7bc7f9fb7f1a7160245f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3", "size": 9121, "upload_time": "2017-10-06T18:28:50", "url": "https://files.pythonhosted.org/packages/be/92/c6531935ba2add8772d3b07aa1225c14f96b8b5b45523b32a5ca06f2a47d/deecubes-0.3.1-py3-none-any.whl" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "110a3192255b7bc7f9fb7f1a7160245f", "sha256": "39a51422fc068e580107e851968c5d9b6fc5b93de399d6e1ee95edb04667adae" }, "downloads": -1, "filename": "deecubes-0.3.1-py3-none-any.whl", "has_sig": false, "md5_digest": "110a3192255b7bc7f9fb7f1a7160245f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3", "size": 9121, "upload_time": "2017-10-06T18:28:50", "url": "https://files.pythonhosted.org/packages/be/92/c6531935ba2add8772d3b07aa1225c14f96b8b5b45523b32a5ca06f2a47d/deecubes-0.3.1-py3-none-any.whl" } ] }