up to 0.6.0

[packages/php-pear-Testing_DocTest.git] / php-pear-Testing_DocTest.spec

%define		status		beta
%define		pearname	Testing_DocTest
%include	/usr/lib/rpm/macros.php
Summary:	%{pearname} - A Unit Test framework for writing tests in your php code docstrings
Summary(pl.UTF-8):	%{pearname} - framework do pisania testów w kodzie php za pomocą docstrings
Name:		php-pear-%{pearname}
Version:	0.6.0
Release:	1
License:	MIT
Group:		Development/Languages/PHP
Source0:	http://pear.php.net/get/%{pearname}-%{version}.tgz
# Source0-md5:	b6143bc74c19f29368f72957db608c42
URL:		http://pear.php.net/package/Testing_DocTest/
BuildRequires:	php-pear-PEAR >= 1:1.4.0
BuildRequires:	rpm-php-pearprov >= 4.4.2-11
BuildRequires:	rpmbuild(macros) >= 1.300
Requires:	php(tokenizer)
Requires:	php-pear
Requires:	php-pear-Console_CommandLine >= 1.0.0-0.RC3
Requires:	php-pear-PEAR-core >= 1:1.4.0
Obsoletes:	php-pear-Testing_DocTest-tests
BuildArch:	noarch
BuildRoot:	%{tmpdir}/%{name}-%{version}-root-%(id -u -n)

%description
Testing_DocTest allows the developer to write unit tests directly in
the <code></code> blocs of your functions, classes and class methods
doc comments.

It comes with a default runner (phpdt) that will parse all your
<code></code> blocs and will run the extracted tests. Running tests is
as simple as:

$ phpdt /path/to/your/code

There are several advantages in using Testing_DocTest:
- it makes unit tests writing funnier, easier and quicker (there's no
  infrastructure to setup, you just install the package, write your code
  examples tests and you're done !);
- it ensures that doc comments are up-to-date by verifying that all
  examples work as documented;
- it enforces writing of tutorial documentation, liberally illustrated
  with input-output examples.

In PEAR status of this package is: %{status}.

%description -l pl.UTF-8
Testing_DocTest pozwala developerowi na pisanie testów bezpośrednio
wewnątrz znaczników <code></code> w komentarzach funkcji, klas i ich
metod.

Dostarczany jest program (phpdt) który przetworzy bloki <code></code>
i wykona pobrane testy. Wywołanie jest proste:

$ phpdt /sciezka/do/kodu

Istnieje sporo korzyści z wykorzystania Testing_DocTest:
- sprawia, że pisanie testów jest prostsze i szybsze (brak
  infrastruktury do konfiguracji, wystarczy zainstalowanie pakietu i
  napisanie testu),
- zapewnia aktualność komentarzy poprzez weryfikację załączonych
  przykładów,
- wymusza pisanie dokumentacji, ilustrując za pomocą przykładów
  wejścia-wyjścia.

Ta klasa ma w PEAR status: %{status}.

%prep
%pear_package_setup

%install
rm -rf $RPM_BUILD_ROOT
install -d $RPM_BUILD_ROOT{%{php_pear_dir},%{_bindir}}
%pear_package_install
install usr/bin/phpdt $RPM_BUILD_ROOT%{_bindir}

%clean
rm -rf $RPM_BUILD_ROOT

%files
%defattr(644,root,root,755)
%doc install.log
%attr(755,root,root) %{_bindir}/phpdt
%{php_pear_dir}/.registry/*.reg
%{php_pear_dir}/Testing/DocTest
%{php_pear_dir}/Testing/DocTest.php