Bug 903766 (php-PhpOption)

Summary: Review Request: php-PhpOption - Option type for PHP
Product: [Fedora] Fedora Reporter: Shawn Iwinski <shawn>
Component: Package ReviewAssignee: Remi Collet <fedora>
Status: CLOSED CURRENTRELEASE QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: medium Docs Contact:
Priority: medium    
Version: rawhideCC: fedora, notting, package-review
Target Milestone: ---Flags: fedora: fedora-review+
gwync: fedora-cvs+
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2013-02-05 02:58:22 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 903768, 903785    
Attachments:
Description Flags
phpci.log
none
php-PhpOption-review.txt none

Description Shawn Iwinski 2013-01-24 19:44:27 UTC
Spec URL: http://siwinski.fedorapeople.org/rpmbuild/SPECS/php-PhpOption.spec

SRPM URL: http://siwinski.fedorapeople.org/rpmbuild/SRPMS/php-PhpOption-1.1.0-1.fc18.src.rpm

Description:
This package adds an Option type for PHP.

The Option type is intended for cases where you sometimes might return a value
(typically an object), and sometimes you might return no value (typically null)
depending on arguments, or other runtime factors.

Often times, you forget to handle the case where no value is returned. Not
intentionally of course, but maybe you did not account for all possible states
of the system; or maybe you indeed covered all cases, then time goes on, code
is refactored, some of these your checks might become invalid, or incomplete.
Suddenly, without noticing, the no value case is not handled anymore. As a
result, you might sometimes get fatal PHP errors telling you that you called a
method on a non-object; users might see blank pages, or worse.

On one hand, the Option type forces a developer to consciously think about both
cases (returning a value, or returning no value). That in itself will already
make your code more robust. On the other hand, the Option type also allows the
API developer to provide more concise API methods, and empowers the API user in
how he consumes these methods.


Fedora Account System Username: siwinski

Comment 1 Remi Collet 2013-01-25 14:26:55 UTC
Created attachment 687489 [details]
phpci.log

Comment 2 Remi Collet 2013-01-25 14:27:27 UTC
Created attachment 687490 [details]
php-PhpOption-review.txt

Generated by fedora-review 0.3.1 (b71abc1) last change: 2012-10-16
Buildroot used: fedora-17-x86_64
Command line :/usr/bin/fedora-review -b 903766

Comment 3 Remi Collet 2013-01-25 14:27:54 UTC
All seems correct.

No Blocker

=== APPROVED ===

Comment 4 Shawn Iwinski 2013-01-25 15:09:35 UTC
THANKS for the review!


New Package SCM Request
=======================
Package Name: php-PhpOption
Short Description: Option type for PHP
Owners: siwinski
Branches: f18 el6
InitialCC:

Comment 5 Gwyn Ciesla 2013-01-25 15:27:05 UTC
Git done (by process-git-requests).

Comment 6 Fedora Update System 2013-01-25 17:16:13 UTC
php-PhpOption-1.1.0-1.fc18 has been submitted as an update for Fedora 18.
https://admin.fedoraproject.org/updates/php-PhpOption-1.1.0-1.fc18

Comment 7 Fedora Update System 2013-01-25 17:16:25 UTC
php-PhpOption-1.1.0-1.el6 has been submitted as an update for Fedora EPEL 6.
https://admin.fedoraproject.org/updates/php-PhpOption-1.1.0-1.el6

Comment 8 Fedora Update System 2013-01-26 16:00:34 UTC
php-PhpOption-1.1.0-1.fc18 has been pushed to the Fedora 18 testing repository.

Comment 9 Fedora Update System 2013-02-05 02:58:24 UTC
php-PhpOption-1.1.0-1.fc18 has been pushed to the Fedora 18 stable repository.

Comment 10 Fedora Update System 2013-02-15 18:36:33 UTC
php-PhpOption-1.1.0-1.el6 has been pushed to the Fedora EPEL 6 stable repository.