updated-packages

vendor/gitonomy/gitlib/doc/blob.md

@@ -0,0 +1,44 @@
+Blob
+====
+
+In git, a blob represents a file content. You can't access the file name
+directly from the *Blob* object; the filename information is stored
+within the tree, not in the blob.
+
+It means that for git, two files with different names but same content
+will have the same hash.
+
+To access a repository *Blob*, you need the hash identifier:
+
+```php
+$repository = new Gitonomy\Git\Repository('/path/to/repository');
+$blob = $repository->getBlob('a7c8d2b4');
+```
+
+Get content
+-----------
+
+To get content from a *Blob* object:
+
+```php
+echo $blob->getContent();
+```
+
+File informations
+-----------------
+
+To get mimetype of a *Blob* object using finfo extension:
+
+```php
+echo $blob->getMimetype();
+```
+
+You can also test if *Blob* is a text of a binary file:
+
+```php
+if ($blob->isText()) {
+    echo $blob->getContent(), PHP_EOL;
+} elseif ($blob->isBinary()) {
+    echo 'File is binary', PHP_EOL;
+}
+```