Merge remote-tracking branch 'chobie:php-git2/master' into php-git

i apologize for broken php-git extension. as my implementation was too suck to maintain the codes.
re-writed codes looks not bad than old one.

there are test codes on tests directory and they are very straight forward to use new php-git API.
most features has their test codes.

i'll add docs when i implemented most features.

Author: chobie

.gitignore

@@ -1,36 +1,37 @@
 *.o
 
-# ignore build documents.
-
-docs/_build/*
-docs/_static/*
-docs/_templates/*
-
 # ignore temporary files
 tmp/*
 
-# ignore your phpunit xml file.
-phpunit.xml
+# ignore tests
+tests/*.php
+tests/*.sh
+tests/*.log
+tests/*.diff
+tests/*.exp
+tests/*.out
 
 # ignore phpized files
-src/Makefile.global
-src/acinclude.m4
-src/aclocal.m4
-src/autom4te.cache
-src/build
-src/config.*
-src/configure
-src/configure*
-src/install-sh
-src/iltmain.sh
-src/missing
-src/mkinstalldirs
-src/run-tests.php
-src/*.lo
-src/.deps
-src/.libs
-src/libtool
-src/Makefile*
-src/modules
-src/ltmain.sh
-src/*.la
+Makefile.global
+acinclude.m4
+aclocal.m4
+autom4te.cache
+build
+config.*
+configure
+configure*
+install-sh
+iltmain.sh
+missing
+mkinstalldirs
+run-tests.php
+*.lo
+.deps
+.libs
+libtool
+Makefile*
+modules
+ltmain.sh
+*.la
+tmp-php.ini
+php_test_results*

CREDITS

@@ -1,83 +1,109 @@
-php-git
-=======================================================
-
-php-git is a set of PHP 5.3+ bindings to the libgit2 linkable C Git library.
-
-How Can I Contribute?
-=======================================================
-
-* fork our repository.
-
-<https://github.com/libgit2/php-git>
-
-* create topic branch on your repository (contributors looking issue
-themselves)
-
-e.g. fix-repository-xxxx-bug, fix-barerepository-detection-bug.
-
-  topic branch desirable minimum change.
-
-  or post probrem to Github issues feature.
-  https://github.com/libgit2/php-git/issues
-
-  then i'll fix as possible.
-
-* send a pull request to me. i'll check and response in a few days.
-
-
-Current Development Status
-=======================================================
-
-*first Alpha development*.
-(development started at 2010-12-30)
-
-*notice* do not use this extenstion on any production server. this extension not fully tested.
-
-*1st alpha development release: (2011/1/17)
-just work on php. not fully tested. classes and methods may changed.
-
-*2nd alpha development release: (2011/2)
-added some unit test. libgit2 feature fully support.
-(i'm busy my work, 1 or 2 week delayed)
-
-i'll follow libgit2 changes as possible as :)
-
-DEPENDENCIES
-=======================================================
-
-* libgit2
-* php5
-* pcre
-
-INSTALL
-=======================================================
-
-see php-git Wiki: <https://github.com/chobie/php-git/wiki>
-
-
-Documents
-=======================================================
-
-see php-git Documents: <http://php-git.chobie.co/>
-
-you can build with sphinx.
-
-  cd docs
-  make html
-
-AUTHORS
-=======================================================
-
-* Shuhei Tanuma <chobieee@gmail.com>
-
-LICENSE
-=======================================================
-
-MIT Licence.
-
-
-Links
-=======================================================
-
-* libgit2: <https://github.com/libgit2/libgit2>
-* php-git documents: <http://php-git.chobie.co>
+# PHP-Git2 - libgit2 bindings in PHP
+
+php-git2 is a PHP bindings to the libgit2 linkable C Git library. 
+this extension are re-writing php-git as that code too dirty.
+
+# Installing And Running
+
+````
+git clone https://github.com/chobie/php-git2.git
+cd php-git2
+phpize
+./configure
+make
+sudo make Install
+````
+
+# API
+
+## Repository Access
+
+````php
+$repo = new Git2\Repository($path);
+/*
+  bool = $repo->isExist(string sha1)
+  Git2\Object = $repo->read(string sha1)
+  string sha1 = $repo->hash(string content, long type)
+  string sha1 = $repo->write(string content, long type)
+  bool = $repo->isBare()
+  bool = $repo->isEmpty()
+  bool = $repo->headDetached()
+  bool = $repo->headOrphan()
+  string path = Git2\Repository::discover("/Users/chobie/projects/work/repo/lib/subdir");
+  // => /Users/chobie/projects/work/repo/.git
+
+  Git2\Repository = Git2\Repository::init(string $path, bool isBare)
+*/
+````
+
+## Object Access
+
+## Tree Access
+
+````
+$repo = new Git2\Repository($path);
+$tree = $repo->lookup(tree sha); // specify tree sha
+
+foreach ($tree as $oid => $entry) {
+        var_dump($entry);
+}
+````
+
+## Ref Management
+
+````
+$ref = Git2\Reference::lookup($repo, "refs/heads/master");
+  sha = $ref->getTarget();
+  str = $ref->getName();
+````
+
+````
+foreach (Git2\Reference::each($repo) as $ref) {
+  echo $ref->getName() . PHP_EOL;
+}
+````
+
+
+## Commit
+
+````
+<?php
+date_default_timezone_set('Asia/Tokyo');
+$repo = Git2\Repository::init("/path/to/repo",true);
+
+$author = new Git2\Signature("Shuhei Tanuma","chobieee@gmail.com",new DateTime());
+
+$bld = new Git2\TreeBuilder();
+$bld->insert(new Git2\TreeEntry(array(
+	"name" => "README.txt",
+	"oid" => "63542fbea05732b78711479a31557bd1b0aa2116",
+	"attributes" => octdec('100644'),
+)));
+$tree = $bld->write($repo);
+
+$parent = "";
+$parents = array();
+for ($i = 0; $i< 10;$i++){
+	$parent = Git2\Commit::create($repo, array(
+		"author"    => $author,
+		"committer" => $author,
+		"message"   => "Hello World: {$i}",
+		"tree"      => $tree,
+		"parents"   => $parents,
+	));
+	$parents = array($parent);
+}
+````
+
+## Revision Walking
+
+````
+$repo = new Git2\Repository($path);
+$walker = new Git2\Walker($repo);
+/* specify HEAD oid */
+$walker->push("6e20138dc38f9f626107f1cd3ef0f9838c43defe");
+
+foreach ($walker as $oid => $commit) {
+        printf("oid: %s\n", $oid);
+        printf("message: %s\n", $commit->getMessage());
+}

EXPERIMENTAL

@@ -0,0 +1,83 @@
+/*
+ * The MIT License
+ *
+ * Copyright (c) 2010 - 2012 Shuhei Tanuma
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+#include "php_git2.h"
+
+PHPAPI zend_class_entry *git2_blob_class_entry;
+
+static void php_git2_blob_free_storage(php_git2_blob *object TSRMLS_DC)
+{
+	if (object->blob != NULL) {
+		git_blob_free(object->blob);
+		object->blob = NULL;
+	}
+	zend_object_std_dtor(&object->zo TSRMLS_CC);
+	efree(object);
+}
+
+zend_object_value php_git2_blob_new(zend_class_entry *ce TSRMLS_DC)
+{
+	zend_object_value retval;
+
+	PHP_GIT2_STD_CREATE_OBJECT(php_git2_blob);
+	return retval;
+}
+
+
+/*
+{{{ proto: Git2\Blob::__toString()
+*/
+PHP_METHOD(git2_blob, __toString)
+{
+	char *data;
+	php_git2_blob *m_blob;
+	
+	m_blob = PHP_GIT2_GET_OBJECT(php_git2_blob, getThis());
+
+	if (m_blob != NULL) {
+		if (m_blob->blob == NULL) {
+			RETURN_FALSE;
+		}
+		
+		RETURN_STRINGL(git_blob_rawcontent(m_blob->blob), git_blob_rawsize(m_blob->blob),1);
+	} else {
+		RETURN_FALSE;
+	}
+}
+/* }}} */
+
+
+static zend_function_entry php_git2_blob_methods[] = {
+	PHP_ME(git2_blob, __toString, NULL, ZEND_ACC_PUBLIC)
+	{NULL,NULL,NULL}
+};
+
+void php_git2_blob_init(TSRMLS_D)
+{
+	zend_class_entry ce;
+	
+	INIT_NS_CLASS_ENTRY(ce, PHP_GIT2_NS, "Blob", php_git2_blob_methods);
+	git2_blob_class_entry = zend_register_internal_class(&ce TSRMLS_CC);
+	git2_blob_class_entry->create_object = php_git2_blob_new;
+}