معرفی شرکت ها
disthelper-0.9.2
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
helps you manage a Python distribution
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | disthelper-0.9.2 |
| نام | disthelper |
| نسخه کتابخانه | 0.9.2 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Kumar McMillan |
| ایمیل نویسنده | kumar.mcmillan@gmail.com |
| آدرس صفحه اصلی | http://code.google.com/p/disthelper/ |
| آدرس اینترنتی | https://pypi.org/project/disthelper/ |
| مجوز | New BSD License |
===========
disthelper
===========
.. contents:: :local:
Introduction
============
disthelper is a command line tool that helps you manage a Python distribution. You may want to create Python scripts to automate common maintenance tasks for your project. But where do you put them? How about the standard `setup.py framework`_? You can think of setup.py as a "make" tool for Python, although it's more like how `Ian Bicking describes it`_ and less like an `actual make tool`_ with targets and dependencies. For example, if you wrote a script to build your project docs and another to upload them, you could run these commands from your setup.py file::
python setup.py build_docs upload_docs
What it does
============
disthelper just automates the use of distutils_ so you don't have to think about how to `create a custom setup.py command`_. It sets up the module / submodule structure, edits your setup.cfg, and adds new command modules as you request them. disthelper doesn't do anything you couldn't do by hand.
.. _create a custom setup.py command: http://docs.python.org/dist/node32.html
.. _actual make tool: http://www.gnu.org/software/make/manual/make.html#Overview
.. _Ian Bicking describes it: http://blog.ianbicking.org/pythons-makefile.html
.. _setup.py framework: http://docs.python.org/dist/setup-script.html
.. _creating custom distutils commands: http://peak.telecommunity.com/DevCenter/setuptools#adding-commands
.. _distutils: http://docs.python.org/dist/dist.html
.. _setuptools: http://pypi.python.org/pypi/setuptools
Install
=======
You can easy_install_ it::
easy_install disthelper
Or grab the source_
.. _source: http://disthelper.googlecode.com/svn/trunk/#egg=disthelper-dev
.. _easy_install: http://peak.telecommunity.com/DevCenter/EasyInstall
Create a command
================
disthelper is implemented as a `Paste`_ extension. Let's say you want to create this ``build_docs`` command I mentioned. cd into your project directory and type::
$ paster distcmd build_docs
| Selected and implied templates:
| disthelper#distcmd A disthelper-based package for setup.py commands
|
| ** creating ./setup.py (you'll probably need to edit this)
| Variables:
| command: build_docs
| distcmds_mod: distcmds
| package: foo
| Creating template distcmd
| Recursing into +package+
| Creating ./foo/
| Recursing into +distcmds_mod+
| Creating ./foo/distcmds/
| Copying +command+.py_tmpl to ./foo/distcmds/build_docs.py
| Copying __init__.py to ./foo/distcmds/__init__.py
| Copying __init__.py to ./foo/__init__.py
| patching ./setup.cfg ...
|
| ./foo/distcmds/build_docs.py
| ...is ready to edit
| run as:
| python setup.py build_docs
|
If you don't already have a Python package it will prompt you for its name. Assuming you named your package ``foo``, you should see the following layout::
$ tree
| .
| |-- foo
| | |-- __init__.py
| | `-- distcmds
| | |-- __init__.py
| | `-- build_docs.py
| |-- setup.cfg
| `-- setup.py
|
| 2 directories, 5 files
Your command is ready to run::
$ python setup.py build_docs --help
| Global options:
| --verbose (-v) run verbosely (default)
| --quiet (-q) run quietly (turns verbosity off)
| --dry-run (-n) don't actually do anything
| --help (-h) show detailed help message
|
| Options for 'build_docs' command:
| --long-option (-l) <help>
| --other-long-option (-o) <help>
|
| usage: setup.py [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...]
| or: setup.py --help [cmd1 cmd2 ...]
| or: setup.py --help-commands
| or: setup.py cmd --help
|
However, it doesn't do anything useful yet so get to it!
.. _Paste: http://pythonpaste.org/
My command disappeared, what do I do?
=====================================
Unfortunately, distutils will completely ignore any ImportError in your command so one day your command might simply disappear. To check that your command is set up correctly, run::
$ paster distcmd build_docs --check
| Selected and implied templates:
| disthelper#distcmd A disthelper-based package for setup.py commands
|
| Variables:
| command: build_docs
| distcmds_mod: distcmds
| package: foo
| attempting to import foo.distcmds.build_docs
| OK
| checking vars in ./setup.cfg
|
| build_docs OK
.. The distutils Command class
===========================
Other make like tools
=====================
disthelper isn't designed for complex builds, dependency management, etc, it just helps you create maintenance scripts. You may want to check out...
- Vellum_
- Vellum is a simple build tool like make but written in Python using a simple yet flexible YAML based format.
- SCONS_
- A software construction tool
- `zc.buildout`_
- System for managing development buildouts
.. _Vellum: http://www.zedshaw.com/projects/vellum/index.html
.. _SCONS: http://www.scons.org/
.. _zc.buildout: http://pypi.python.org/pypi/zc.buildout/
Changelog
=========
- 0.9.2
- fixed another bug in generating setup.py files
- added shelldoc support for functional tests (README examples)
- 0.9.1
- fixed handling of setup.py file when one doesn't already exist
- 0.9
- first release, basic paster command working
نحوه نصب
نصب پکیج whl disthelper-0.9.2:
pip install disthelper-0.9.2.whl
نصب پکیج tar.gz disthelper-0.9.2:
pip install disthelper-0.9.2.tar.gz