Version 2.14.0

- Add save and load pose functions

DOCS.md

@@ -213,34 +213,37 @@ studiolibrary.main(name=name, path=path, superusers=superusers, unlockFolder="Us
 
 #### Download
 
-1 . Download and unzip the studiolibrary.zip file from the following link.
+Download and unzip the studiolibrary.zip file from the following link.
 
 www.studiolibrary.com
 
 #### Installation
 
-2 . Move the unzipped studiolibrary folder to the following path depending on your OS.
+1. Unzip the downloaded studiolibrary.zip file.
 
+2. Copy the `Python code` below to the Maya Python script editor. Make sure the tab is Python and not MEL.
 
-##### Linux
+3. Change the path variable in the Python code to the studiolibrary folder.
 
-```~/maya/scripts```
+4. Press `Ctrl + Enter` to run.
 
-##### Windows
+5. Drag the Python code to the shelf.
 
-```C:/Users/USERNAME/Documents/maya/scripts```
+``` python
+# Python code
 
-##### OSX
-
-Use ⌘+Shift+G in the finder and copy the studiolibrary folder to
-
-```~/Library/Preferences/Autodesk/maya/scripts```
-
-#### Run
-
-3 . Start Maya and run the following code in the Python script editor.
-
-```
+import os
+import sys
+
+# 3. REPLACE this path with the location to the unzipped `src` location. 
+path = r"C:\Users\USER\Downloads\studiolibrary\src"
+
+if not os.path.exists(path):
+    raise IOError(r'The source path does not exist!')
+
+if path not in sys.path:
+    sys.path.insert(0, path)
+
 import studiolibrary
 studiolibrary.main()
 ```

README.md

@@ -41,11 +41,6 @@ place the unzipped "studiolibrary" folder on a network drive.
 Find the latest documentation [here](DOCS.md).
 
 
-## Merge Requests
-
-The next major release is in active development. In order to ensure smooth progress, we kindly request that merge requests primarily focus on fixes or small changes. Thank you. 
-
-
 ## Contributing
 
 Contributions to Studio Library are always welcome! Whether it's reporting bugs, feature requests, discussing ideas or committing code.

src/studiolibrary/__init__.py

@@ -10,8 +10,8 @@
 # You should have received a copy of the GNU Lesser General Public
 # License along with this library. If not, see <http://www.gnu.org/licenses/>.
 
-__version__ = "2.13.2"
-__build_date__ = "September 17, 2023"
+__version__ = "2.14.0"
+__build_date__ = "November 12, 2023"
 
 
 def version():

src/studiolibrarymaya/poseitem.py

@@ -32,6 +32,16 @@
 logger = logging.getLogger(__name__)
 
 
+def save(path, *args, **kwargs):
+    """Convenience function for saving a PoseItem."""
+    PoseItem(path).safeSave(*args, **kwargs)
+
+
+def load(path, *args, **kwargs):
+    """Convenience function for loading a PoseItem."""
+    PoseItem(path).load(*args, **kwargs)
+
+
 class PoseLoadWidget(baseloadwidget.BaseLoadWidget):
 
     @classmethod