package

A package to package your package
Download

package Ranking & Summary

Advertisement

  • Rating:
  • License:
  • BSD License
  • Price:
  • FREE
  • Publisher Name:
  • Ingy d%uFFFDt Net
  • Publisher web site:
  • http://search.cpan.org/~ingy/

package Tags


package Description

A package to package your package package is the Python library, a toolset to help Python package people package their packages. If you do not personally package Python packages your can ignore this package package.Installation:package isn't meant to be installed like normal Python packages. It is meant to be copied and distributed as a part of other Python packages.The best thing to do is to to git clone it from GitHub, and put it beside the other packages that you package for Python:git clone git://github.com/ingydotnet/package-py.gitConfused? So was I...I like to write a lot of modules and distribute them as packages, but when I started doing this in Python, I ran into a wall of setup/installer bugs, bad workarounds and community infighting about what the best way to go was. I decided to fix this in a way that makes all installers be able to install my Python packages (and their prerequisite packages), regardless of their current Python knowledge or working environment.The solution is simple. Just add helper tools in a subdirectory that gets included in every Python package you release.It's a simple trade of a little extra storage space for functionality, package-author- sanity and world peace.Design GoalsThese are some of the things I was concerned with when I started this project: * Make my Python packages installable by anyone. * Allow my Python packages to depend on other packages. * Put as little extra burden on users as possible. * Never leave the user uninformed and screaming. * Make setup.py files be autogenerated from simple yaml files. * Don't let this project paint its users into yet another dependency corner. * Provide a simple Makefile for automating related tasks. * Provide support for running unittests with make test. * Keep the bloat of using package to a minimum.Usage:To use this Python package packaging technique, follow these simple steps: 1. > cd path/to/your/personal/python/package/called/foo/.. In other words, just go to the directory where you want to put this package package's repository. Putting it next to your other Python package source code repositories is what I am suggesting here... 2. git clone git://github.com/ingydotnet/package-py.git Unless, of course, you already have package-py. 3. > cd foo 4. > make -f ../package-py/Makefile setup This will install a Makefile, a new setup.py file, and create the package/ subdirectory in your project directory. 5. Edit package/info.yaml (for information specific to your project) and ~/.package-py/config.yaml (for information applicable to all your Python projects) with all the information about your package.6. make help At this point everything should be set up for you to use just like any other setup.py. From here on out, you are encouraged (but not required) to use the Makefile. Run make help to see all the options available to you. Requirements: · Python


package Related Software