Elements of Design¶

The main colours of the design are a dark pastel azure (#336790) and a paleorange (#E5B62F), referred in this document simply as “blue” and “yellow”respectively. The text uses theMonoid typeface, an open source webfont thatwas developed by Andreas Larsen and contributors in 2015 and is distributedunder the MIT or SIL licenses (more information athttps://github.com/larsenwork/monoid)

Usage¶

The preferred way of using the setuptools logo is over a white (or light)background. Alternatively, the following options can be considered, dependingon the circumstances:

• “negative” design - for dark backgrounds (e.g. website displayed in “darkmode”): the white colour (#FFFFFF) of the background and the “blue”(#336790) colour of the design can be swapped.

• “monochrome” - when colours are not available (e.g. black and white printedmedia): a completely black or white version of the logo can also be used.

• “banner” mode: the symbol and text can be used alongside depending on theavailable space.

The following image illustrate these alternatives:

Please refer to the SVG files in thesetuptools repository for the specificshapes and proportions between the elements of the design.

Working with the Design¶

Thesetuptools repository contains a series of vector representations of thedesign under thedocs/images directory. These representations can bemanipulated via any graphic editor that support SVG files,however the free and open-source softwareInkscape is recommended for maximumcompatibility.

When selecting the right file to work with, file names includingeditable-inkscape indicate “more editable” elements (e.g. editable text),while the others prioritise SVG paths for maximum reproducibility.

Also notice that you might have toinstall the correct fonts to be able tovisualise or edit some of the designs.

Inspiration¶

This design was inspired by@cajhne’soriginal proposal and theancient symbol of theouroboros.It features a snake moving in a circular trajectory not only as a reference tothe Python programming language but also to thewheel package format as oneof the distribution formats supported by setuptools.The shape of the snake also resembles a cog, which together with the hammer isa nod to the two words that compose the name of the project.

License¶

This logo, design variations or a modified version may be used by anyone torefer to setuptools, but does not indicate endorsement by the project.

Redistribution, usage and derivative works are permitted under the same licenseused by the setuptools software (MIT):

Copyright (c) Anderson BravalheriPermission is hereby granted, free of charge, to any person obtaining a copyof this software and associated documentation files (the "Software"), todeal in the Software without restriction, including without limitation therights to use, copy, modify, merge, publish, distribute, sublicense, and/orsell copies of the Software, and to permit persons to whom the Software isfurnished to do so, subject to the following conditions:The above copyright notice and this permission notice shall be included inall copies or substantial portions of the Software.THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS ORIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THEAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHERLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISINGFROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGSIN THE SOFTWARE.THE USAGE OF THIS LOGO AND ARTWORK DOES NOT INDICATE ENDORSEMENT BY THESETUPTOOLS PROJECT.

Whenever possible, please make the image a link tohttps://github.com/pypa/setuptools orhttps://setuptools.pypa.io.