This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!
Project Description

Overview

Banner ad development is, at its core, a very repetitive task. You constantly do the same thing over and over. This toolkit aims to ease a bit of that repetitive work and while the tasks it does are relatively small, the speed and ease at which you can do them ends up saving you precious time.

Ask yourself these questions:

  1. Need a quick way to create all the PSDs you’ll need? No problem! One simple command will generate all the PSDs you need at the proper dimensions with the proper file names.
  2. Made sweeping changes to your campaign PSDs? No problem! One simple command will export all your static files while ensuring they are no larger than a specified size. No more manually running Save for Web on each of them.
  3. Need a simple way for your client to review your ads? No problem! One simple command will upload them all to your server and provide you the links to copy and paste into an email.
  4. Not a command line geek? No problem! Create a simple config file and don’t ever add a parameter to any of the available commands. I got you covered.

The workflow described below is one developed over many years of doing banner ad design and devleopment. While it may seem additional work at first, I promise you will find that doing each and every campaign in this way will greatly speed up your workflow. Now on to the good stuff…

Requirements

  • Python 2.7.x

  • ImageMagick

  • pngquant

  • ImageAlpha

  • ImageOptim

  • nasm - download latest tar.gz source code

  • mozjpeg - download latest tar.gz source code

    ./cjpeg -quality 60 -quant-table 2 -sample 1x1 -outfile ../crushed.jpg ../backup.jpg
    

NOTE: Image Optimization only works on a Mac at this time.

Install nasm and mozjpeg from source (optional)

  1. Run ./configure && make in the unzipped source directory
  2. Hope you don’t get a million compilation errors.
  3. If it succeeds, you’ll be able to run ./cjpeg in this directory
  4. You can run sudo make install if you want cjpeg installed system-wide.

Installation

You can install directly via pip:

pip install Banner-Ad-Toolkit

Or from the BitBucket repository (master branch by default):

git clone https://bitbucket.org/tsantor/banner-ad-toolkit
cd banner-ad-toolkit
sudo python setup.py install

Usage

File Structure (Optional)

While not required, using the following project structure is recommended as the command line defaults follow this convention which ends up making the commands require less input from the user.

PROJECT
├── HTML5
│   ├── Prefix_160x600_Suffix
│   ├── Prefix_300x250_Suffix
│   ├── Prefix_300x600_Suffix
│   └── Prefix_728x90_Suffix
├── PSD
└── adkit.ini

NOTE: When running any adkit command, ensure you run it from the root of your project folder where the adkit.ini resides (see recommended File Structure above)

Quickstart

To quickly get up and running by generating a adkit.ini which allows us to configure how adkit runs.

adkit-quickstart

NOTE: You will still need to edit the generated file, this just
helps save some typing.

Generate CSS

Once you save out all your image assets for your HTML5 ads, get a jump start on CSS creation. Simply run the following command:

adkit-css

NOTE: For all available commands, run adkit-css -h.

Optimize Images

If you want to optimize all images used in your ads, simply run the following command:

adkit-optimize

NOTE: For all available commands, run adkit-optimize -h

Upload HTML5 Ads

If you want to upload all HTML5 ads to your server for client preview, simply run the following command:

adkit-upload

NOTE: For all available commands, run adkit-upload -h

Package Ad Zips

If you want to package each HTML5 ad as a zip, simply run the following command:

adkit-zip

NOTE: For all available commands, run adkit-zip -h

Ad Validation

You can check your ads for errors against popular target campaign managers here:

Issues

If you experience any issues, please create an issue on Bitbucket.

Release History

Release History

0.3.0

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.2.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.6

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.5

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.4

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
Banner_Ad_Toolkit-0.3.0-py2.7.egg (25.4 kB) Copy SHA256 Checksum SHA256 2.7 Egg Apr 20, 2017
Banner_Ad_Toolkit-0.3.0-py2.py3-none-any.whl (29.5 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Apr 20, 2017
Banner-Ad-Toolkit-0.3.0.tar.gz (21.1 kB) Copy SHA256 Checksum SHA256 Source Apr 20, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting