{"id":13395429,"url":"https://github.com/jorgebastida/glue","last_synced_at":"2025-03-13T20:32:12.216Z","repository":{"id":2139517,"uuid":"3083478","full_name":"jorgebastida/glue","owner":"jorgebastida","description":"Glue is a simple command line tool to generate CSS sprites","archived":false,"fork":false,"pushed_at":"2022-11-29T18:01:31.000Z","size":1993,"stargazers_count":2544,"open_issues_count":69,"forks_count":168,"subscribers_count":59,"default_branch":"master","last_synced_at":"2025-03-11T12:12:05.945Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://glue.readthedocs.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jorgebastida.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-01-01T18:22:31.000Z","updated_at":"2025-02-14T15:50:08.000Z","dependencies_parsed_at":"2023-01-13T11:39:30.128Z","dependency_job_id":null,"html_url":"https://github.com/jorgebastida/glue","commit_stats":null,"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jorgebastida%2Fglue","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jorgebastida%2Fglue/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jorgebastida%2Fglue/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jorgebastida%2Fglue/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jorgebastida","download_url":"https://codeload.github.com/jorgebastida/glue/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243478448,"owners_count":20297259,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-30T17:01:58.235Z","updated_at":"2025-03-13T20:32:11.894Z","avatar_url":"https://github.com/jorgebastida.png","language":"Python","funding_links":[],"categories":["Python","Generators","Sprite Generators"],"sub_categories":["Meetups"],"readme":"Glue\n====\n\n.. image:: https://badge.fury.io/py/glue.png\n    :target: http://badge.fury.io/py/glue\n\n.. image:: https://travis-ci.org/jorgebastida/glue.png?branch=master\n    :target: https://travis-ci.org/jorgebastida/glue\n\n.. image:: https://coveralls.io/repos/jorgebastida/glue/badge.png?branch=master\n    :target: https://coveralls.io/r/jorgebastida/glue?branch=master\n\n.. image:: https://pypip.in/d/glue/badge.png\n    :target: https://crate.io/packages/glue/\n\n\nGlue is a simple command line tool to generate sprites::\n\n    $ glue source output\n\n* The latest documentation is available at: http://glue.readthedocs.org\n* Installation instructions: http://glue.readthedocs.org/en/latest/installation.html\n* Glue-users mailing list: https://groups.google.com/forum/#!forum/glue-users\n\nFeatures\n--------\n* Automatic Sprite (Image + Metadata) creation including:\n\n  - css (less, scss)\n  - cocos2d\n  - json (array, hash)\n  - CAAT\n\n* Automatic multi-dpi `retina \u003chttp://glue.readthedocs.org/en/latest/ratios.html\u003e`_ sprite creation.\n* Support for multi-sprite projects.\n* Create sprites from multiple folders (recursively).\n* Multiple `algorithms \u003chttp://glue.readthedocs.org/en/latest/options.html#a-algorithm\u003e`_ available.\n* Automatic `crop of unnecessary transparent borders \u003chttp://glue.readthedocs.org/en/latest/quickstart.html#crop-unnecessary-transparent-spaces\u003e`_ around source images.\n* Configurable `paddings and margin per image, sprite or project \u003chttp://glue.readthedocs.org/en/latest/paddings.html\u003e`_.\n* Watch option to keep glue running watching for file changes.\n* Project-, Sprite- and Image-level configuration via static config files.\n* Customizable `output \u003chttp://glue.readthedocs.org/en/latest/options.html#global-template\u003e`_ using jinja templates.\n* CSS: Optional .less/.scss output format.\n* CSS: Configurable `cache busting for sprite images \u003chttp://glue.readthedocs.org/en/latest/options.html#cachebuster\u003e`_.\n* CSS: Customizable `class names \u003chttp://glue.readthedocs.org/en/latest/options.html#separator\u003e`_.\n* Python ``2.6``, ``2.7`` and ``3.3+`` supported.\n* Really `well tested \u003chttps://coveralls.io/r/jorgebastida/glue?branch=master\u003e`_.\n\nExample\n-------\nUsing the gorgeous `famfamfam icons \u003chttp://www.famfamfam.com/lab/icons/silk/\u003e`_ (4.2Mb) you will get\nthe following ``icons.png`` (401Kb).\n\n.. image:: https://github.com/jorgebastida/glue/raw/master/docs/img/famfamfam1.png\n\n\nAnd also an ``icons.css`` with all the necessary CSS classes for this sprite::\n\n    .sprite-icons-zoom_out{ background:url('icons.png'); top:0; left:0; no-repeat;}\n    .sprite-icons-zoom_in{ background:url('icons.png'); top:0; left:-16; no-repeat;}\n    .sprite-icons-zoom{ background:url('icons.png'); top:-16; left:0; no-repeat;}\n    .sprite-icons-xhtml_valid{ background:url('icons.png'); top:-16; left:-16; no-repeat;}\n    ...\n\n\nDo you want to know more? Visit the quickstart guide: http://glue.readthedocs.org/en/latest/quickstart.html\n\nContribute\n-----------\n\n* Fork the repository on GitHub to start making your changes to the master branch (or branch off of it).\n* Write a test which shows that the bug was fixed or that the feature works as expected.\n\n  - Use ``python setup.py test``\n\n* Send a pull request and bug the maintainer until it gets merged and published. :) Make sure to add yourself to AUTHORS.\n\n\nIs your company using glue?\n---------------------------\nWe are creating a list of companies using glue in production. If your company use ``glue``, please send `me \u003cmailto:me@jorgebastida.com\u003e`_ an email or send me a message to `@jorgebastida \u003chttps://twitter.com/jorgebastida\u003e`_ . I would really appreciate it.\n\n\nWe need your help\n------------------\n\nThere are several features that ``glue`` users would love to have... but they require a substancial amount of work and dedication, so we are looking for feature-sponsors! If you want to lead the development/testing of any of the following features, please contact `Jorge Bastida \u003cmailto:me@jorgebastida.com\u003e`_.\n\nHere you have some examples:\n\n* Windows support (I'm not a Windows user, ``glue`` needs somebody who care about how ``glue`` works on Windows and write down some installation instructions).\n* Cocos2d Format (Already exists, but we need somebody to give it some love).\n* New Formats (After 0.9, ``glue`` is ready to accept new output formats - If you want to create a new format, contact me).\n* Binary packaging for OSX and Windows (For some users it would be really cool if they were able to download an already packaged binary version).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjorgebastida%2Fglue","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjorgebastida%2Fglue","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjorgebastida%2Fglue/lists"}