Adds Client::getFolderByPath() (#12)

* Adds Client::getFolderByPath()
* Adds Client::getFolderByName() to prevent ambiguity

src/Client.php

@@ -366,9 +366,33 @@ public function disconnect() {
  * @throws FolderFetchingException
  */
  public function getFolder($folder_name) {
+ return $this->getFolderByName($folder_name);
+ }
+
+ /**
+ * Get a folder instance by a folder name
+ * @param $folder_name
+ *
+ * @return mixed
+ * @throws ConnectionFailedException
+ * @throws FolderFetchingException
+ */
+ public function getFolderByName($folder_name) {
  return $this->getFolders(false)->where("name", $folder_name)->first();
  }
 
+ /**
+ * Get a folder instance by a folder path
+ * @param $folder_path
+ *
+ * @return mixed
+ * @throws ConnectionFailedException
+ * @throws FolderFetchingException
+ */
+ public function getFolderByPath($folder_path) {
+ return $this->getFolders(false)->where("path", $folder_path)->first();
+ }
+
  /**
  * Get folders list.
  * If hierarchical order is set to true, it will make a tree of folders, otherwise it will return flat array.