samples-lib-react
v1.2.6
Published
A library for react development which includes animations like slides , dynamic forms and some validators
Downloads
17
Maintainers
Readme
��#� �r�e�a�c�t�-�l�i�b�r�a�r�y�-�v�a�l�i�d�a�t�o�r�s�-�a�n�d�-�f�o�r�m�s� �
�
� �
�
�
�
�#� �S�a�m�p�l�e�s� �L�i�b� �-� �R�e�a�c�t�
�
�
�
�A� �v�e�r�s�a�t�i�l�e� �R�e�a�c�t� �c�o�m�p�o�n�e�n�t� �l�i�b�r�a�r�y� �f�o�r� �d�y�n�a�m�i�c� �f�o�r�m�s� �a�n�d� �a�n�i�m�a�t�i�o�n�s�.�
�
�
�
�#�#� �F�e�a�t�u�r�e�s�
�
�
�
�-� ���D�y�n�a�m�i�c�F�o�r�m���:� �A� �f�l�e�x�i�b�l�e� �f�o�r�m� �c�o�m�p�o�n�e�n�t� �t�h�a�t� �g�e�n�e�r�a�t�e�s� �f�i�e�l�d�s� �b�a�s�e�d� �o�n� �a� �c�o�n�f�i�g�u�r�a�t�i�o�n� �a�n�d� �h�a�n�d�l�e�s� �v�a�l�i�d�a�t�i�o�n�.�
�
�-� ���F�a�d�e�I�n���:� �A�n� �a�n�i�m�a�t�i�o�n� �c�o�m�p�o�n�e�n�t� �f�o�r� �s�m�o�o�t�h�l�y� �f�a�d�i�n�g� �i�n� �c�o�n�t�e�n�t�.�
�
�-� ���S�l�i�d�e�U�p���:� �A�n� �a�n�i�m�a�t�i�o�n� �c�o�m�p�o�n�e�n�t� �f�o�r� �s�l�i�d�i�n�g� �c�o�n�t�e�n�t� �u�p� �f�r�o�m� �a�n� �i�n�i�t�i�a�l� �o�f�f�s�e�t�.�
�
�
�
�#�#� �I�n�s�t�a�l�l�a�t�i�o�n�
�
�
�
�Y�o�u� �c�a�n� �i�n�s�t�a�l�l� �t�h�e� �l�i�b�r�a�r�y� �v�i�a� �n�p�m�:�
�
�
�
��
��b�a�s�h�
�
�n�p�m� �i�n�s�t�a�l�l� �s�a�m�p�l�e�s�-�l�i�b�-�r�e�a�c�t�
�
�
��
�
�
�
�
�O�r� �u�s�i�n�g� �y�a�r�n�:�
�
�
�
��
��b�a�s�h�
�
�y�a�r�n� �a�d�d� �s�a�m�p�l�e�s�-�l�i�b�-�r�e�a�c�t�
�
�
��
�
�
�
�
�#�#� �U�s�a�g�e�
�
�
�
�#�#�#� �D�y�n�a�m�i�c�F�o�r�m�
�
�
�
�T�h�e� ��D�y�n�a�m�i�c�F�o�r�m�
� �c�o�m�p�o�n�e�n�t� �a�l�l�o�w�s� �y�o�u� �t�o� �c�r�e�a�t�e� �a� �f�o�r�m� �d�y�n�a�m�i�c�a�l�l�y� �b�a�s�e�d� �o�n� �a� �c�o�n�f�i�g�u�r�a�t�i�o�n�.�
�
�
�
���P�r�o�p�s�:���
�
�
�
�-� ��f�i�e�l�d�s�
�:� �A�n� �a�r�r�a�y� �o�f� �f�i�e�l�d� �c�o�n�f�i�g�u�r�a�t�i�o�n�s�.� �E�a�c�h� �f�i�e�l�d� �m�u�s�t� �h�a�v�e� ��n�a�m�e�
�,� ��l�a�b�e�l�
�,� ��t�y�p�e�
�,� �a�n�d� ��v�a�l�i�d�a�t�i�o�n�
� �p�r�o�p�e�r�t�i�e�s�.�
�
�-� ��o�n�S�u�b�m�i�t�
�:� �A� �f�u�n�c�t�i�o�n� �t�h�a�t� �r�e�c�e�i�v�e�s� �t�h�e� �f�o�r�m� �v�a�l�u�e�s� �w�h�e�n� �t�h�e� �f�o�r�m� �i�s� �s�u�b�m�i�t�t�e�d�.�
�
�
�
���E�x�a�m�p�l�e� �U�s�a�g�e�:���
�
�
�
��
��t�y�p�e�s�c�r�i�p�t�
�
�i�m�p�o�r�t� �R�e�a�c�t� �f�r�o�m� �'�r�e�a�c�t�'�;�
�
�i�m�p�o�r�t� �D�y�n�a�m�i�c�F�o�r�m� �f�r�o�m� �'�s�a�m�p�l�e�s�-�l�i�b�-�r�e�a�c�t�'�;�
�
�
�
�c�o�n�s�t� �A�p�p�:� �R�e�a�c�t�.�F�C� �=� �(�)� �=�>� �{�
�
� � �c�o�n�s�t� �h�a�n�d�l�e�S�u�b�m�i�t� �=� �(�v�a�l�u�e�s�:� �{� �[�k�e�y�:� �s�t�r�i�n�g�]�:� �a�n�y� �}�)� �=�>� �{�
�
� � � � �c�o�n�s�o�l�e�.�l�o�g�(�'�F�o�r�m� �v�a�l�u�e�s�:�'�,� �v�a�l�u�e�s�)�;�
�
� � �}�;�
�
�
�
� � �
�
� � �c�o�n�s�t� �f�i�e�l�d�s� �=� �[�
�
� � � � �{�
�
� � � � � � �n�a�m�e�:� �'�e�m�a�i�l�'�,�
�
� � � � � � �l�a�b�e�l�:� �'�E�m�a�i�l�'�,�
�
� � � � � � �t�y�p�e�:� �'�e�m�a�i�l�'�,�
�
� � � � � � �v�a�l�i�d�a�t�i�o�n�:� �(�v�a�l�u�e�:� �s�t�r�i�n�g�)� �=�>� �v�a�l�u�e�.�i�n�c�l�u�d�e�s�(�'�@�'�)� �?� �n�u�l�l� �:� �'�I�n�v�a�l�i�d� �e�m�a�i�l�'�,�
�
� � � � � � �c�l�a�s�s�N�a�m�e�:� �'�i�n�p�u�t�-�e�m�a�i�l�'�,� �/�/� �A�d�i�c�i�o�n�a�n�d�o� �c�l�a�s�s�e� �C�S�S� �p�a�r�a� �e�s�t�i�l�i�z�a�����o�
�
� � � � �}�,�
�
� � � � �{�
�
� � � � � � �n�a�m�e�:� �'�p�a�s�s�w�o�r�d�'�,�
�
� � � � � � �l�a�b�e�l�:� �'�P�a�s�s�w�o�r�d�'�,�
�
� � � � � � �t�y�p�e�:� �'�p�a�s�s�w�o�r�d�'�,�
�
� � � � � � �v�a�l�i�d�a�t�i�o�n�:� �(�v�a�l�u�e�:� �s�t�r�i�n�g�)� �=�>� �v�a�l�u�e�.�l�e�n�g�t�h� �>�=� �6� �?� �n�u�l�l� �:� �'�P�a�s�s�w�o�r�d� �t�o�o� �s�h�o�r�t�'�,�
�
� � � � � � �c�l�a�s�s�N�a�m�e�:� �'�i�n�p�u�t�-�p�a�s�s�w�o�r�d�'�,� �/�/� �A�d�i�c�i�o�n�a�n�d�o� �c�l�a�s�s�e� �C�S�S� �p�a�r�a� �e�s�t�i�l�i�z�a�����o�
�
� � � � �}�,�
�
� � �]�;�
�
�
�
�
�
� � �r�e�t�u�r�n� �<�D�y�n�a�m�i�c�F�o�r�m� �f�i�e�l�d�s�=�{�f�i�e�l�d�s�}� �o�n�S�u�b�m�i�t�=�{�h�a�n�d�l�e�S�u�b�m�i�t�}� �/�>�;�
�
�}�;�
�
�
��
�
�
�
�
�#�#�#� �F�a�d�e�I�n�
�
�
�
�T�h�e� ��F�a�d�e�I�n�
� �c�o�m�p�o�n�e�n�t� �a�n�i�m�a�t�e�s� �i�t�s� �c�h�i�l�d�r�e�n� �b�y� �f�a�d�i�n�g� �t�h�e�m� �i�n�.�
�
�
�
���P�r�o�p�s�:���
�
�
�
�-� ��c�h�i�l�d�r�e�n�
�:� �T�h�e� �c�o�n�t�e�n�t� �t�o� �a�n�i�m�a�t�e�.�
�
�-� ��d�u�r�a�t�i�o�n�
�:� �T�h�e� �d�u�r�a�t�i�o�n� �o�f� �t�h�e� �a�n�i�m�a�t�i�o�n� �i�n� �m�i�l�l�i�s�e�c�o�n�d�s� �(�d�e�f�a�u�l�t�:� �5�0�0�)�.�
�
�-� ��d�e�l�a�y�
�:� �T�h�e� �d�e�l�a�y� �b�e�f�o�r�e� �t�h�e� �a�n�i�m�a�t�i�o�n� �s�t�a�r�t�s� �i�n� �m�i�l�l�i�s�e�c�o�n�d�s� �(�d�e�f�a�u�l�t�:� �0�)�.�
�
�
�
���E�x�a�m�p�l�e� �U�s�a�g�e�:���
�
�
�
��
��t�y�p�e�s�c�r�i�p�t�
�
�i�m�p�o�r�t� �R�e�a�c�t� �f�r�o�m� �'�r�e�a�c�t�'�;�
�
�i�m�p�o�r�t� �F�a�d�e�I�n� �f�r�o�m� �'�s�a�m�p�l�e�s�-�l�i�b�-�r�e�a�c�t�/�c�o�m�p�o�n�e�n�t�s�/�A�n�i�m�a�t�i�o�n�s�/�F�a�d�e�I�n�'�;�
�
�
�
�c�o�n�s�t� �A�p�p�:� �R�e�a�c�t�.�F�C� �=� �(�)� �=�>� �{�
�
� � �r�e�t�u�r�n� �(�
�
� � � � �<�F�a�d�e�I�n� �d�u�r�a�t�i�o�n�=�{�1�0�0�0�}� �d�e�l�a�y�=�{�5�0�0�}�>�
�
� � � � � � �<�h�1�>�H�e�l�l�o�,� �W�o�r�l�d�!�<�/�h�1�>�
�
� � � � �<�/�F�a�d�e�I�n�>�
�
� � �)�;�
�
�}�;�
�
�
��
�
�
�
�
�#�#�#� �S�l�i�d�e�U�p�
�
�
�
�T�h�e� ��S�l�i�d�e�U�p�
� �c�o�m�p�o�n�e�n�t� �a�n�i�m�a�t�e�s� �i�t�s� �c�h�i�l�d�r�e�n� �b�y� �s�l�i�d�i�n�g� �t�h�e�m� �u�p� �f�r�o�m� �a�n� �i�n�i�t�i�a�l� �o�f�f�s�e�t�.�
�
�
�
���P�r�o�p�s�:���
�
�
�
�-� ��c�h�i�l�d�r�e�n�
�:� �T�h�e� �c�o�n�t�e�n�t� �t�o� �a�n�i�m�a�t�e�.�
�
�-� ��d�u�r�a�t�i�o�n�
�:� �T�h�e� �d�u�r�a�t�i�o�n� �o�f� �t�h�e� �a�n�i�m�a�t�i�o�n� �i�n� �m�i�l�l�i�s�e�c�o�n�d�s� �(�d�e�f�a�u�l�t�:� �5�0�0�)�.�
�
�-� ��d�e�l�a�y�
�:� �T�h�e� �d�e�l�a�y� �b�e�f�o�r�e� �t�h�e� �a�n�i�m�a�t�i�o�n� �s�t�a�r�t�s� �i�n� �m�i�l�l�i�s�e�c�o�n�d�s� �(�d�e�f�a�u�l�t�:� �0�)�.�
�
�-� ��i�n�i�t�i�a�l�O�f�f�s�e�t�
�:� �T�h�e� �i�n�i�t�i�a�l� �o�f�f�s�e�t� �f�o�r� �t�h�e� �a�n�i�m�a�t�i�o�n� �(�d�e�f�a�u�l�t�:� �'�1�0�0�%�'�)�.�
�
�
�
���E�x�a�m�p�l�e� �U�s�a�g�e�:���
�
�
�
��
��t�y�p�e�s�c�r�i�p�t�
�
�i�m�p�o�r�t� �R�e�a�c�t� �f�r�o�m� �'�r�e�a�c�t�'�;�
�
�i�m�p�o�r�t� �S�l�i�d�e�U�p� �f�r�o�m� �'�s�a�m�p�l�e�s�-�l�i�b�-�r�e�a�c�t�/�c�o�m�p�o�n�e�n�t�s�/�A�n�i�m�a�t�i�o�n�s�/�S�l�i�d�e�U�p�'�;�
�
�
�
�c�o�n�s�t� �A�p�p�:� �R�e�a�c�t�.�F�C� �=� �(�)� �=�>� �{�
�
� � �r�e�t�u�r�n� �(�
�
� � � � �<�S�l�i�d�e�U�p� �d�u�r�a�t�i�o�n�=�{�1�0�0�0�}� �d�e�l�a�y�=�{�5�0�0�}� �i�n�i�t�i�a�l�O�f�f�s�e�t�=�"�5�0�%�"�>�
�
� � � � � � �<�h�1�>�W�e�l�c�o�m�e� �t�o� �t�h�e� �S�l�i�d�e�U�p� �A�n�i�m�a�t�i�o�n�<�/�h�1�>�
�
� � � � �<�/�S�l�i�d�e�U�p�>�
�
� � �)�;�
�
�}�;�
�
�
��
�
�
�
�
�#�#� �A�P�I�
�
�
�
�#�#�#� �D�y�n�a�m�i�c�F�o�r�m�
�
�
�
����<�D�y�n�a�m�i�c�F�o�r�m� �/�>�
���
�
�
�
�-� ���f�i�e�l�d�s���:� ��{� �n�a�m�e�:� �s�t�r�i�n�g�,� �l�a�b�e�l�:� �s�t�r�i�n�g�,� �t�y�p�e�:� �s�t�r�i�n�g�,� �v�a�l�i�d�a�t�i�o�n�:� �(�v�a�l�u�e�:� �a�n�y�)� �=�>� �s�t�r�i�n�g� �|� �n�u�l�l� �}�[�]�
�
�
�-� ���o�n�S�u�b�m�i�t���:� ��(�v�a�l�u�e�s�:� �{� �[�k�e�y�:� �s�t�r�i�n�g�]�:� �a�n�y� �}�)� �=�>� �v�o�i�d�
�
�
�
�
�#�#�#� �F�a�d�e�I�n�
�
�
�
����<�F�a�d�e�I�n� �/�>�
���
�
�
�
�-� ���c�h�i�l�d�r�e�n���:� ��R�e�a�c�t�.�R�e�a�c�t�N�o�d�e�
�
�
�-� ���d�u�r�a�t�i�o�n���:� ��n�u�m�b�e�r�
� �(�d�e�f�a�u�l�t�:� �5�0�0�)�
�
�-� ���d�e�l�a�y���:� ��n�u�m�b�e�r�
� �(�d�e�f�a�u�l�t�:� �0�)�
�
�
�
�#�#�#� �S�l�i�d�e�U�p�
�
�
�
����<�S�l�i�d�e�U�p� �/�>�
���
�
�
�
�-� ���c�h�i�l�d�r�e�n���:� ��R�e�a�c�t�.�R�e�a�c�t�N�o�d�e�
�
�
�-� ���d�u�r�a�t�i�o�n���:� ��n�u�m�b�e�r�
� �(�d�e�f�a�u�l�t�:� �5�0�0�)�
�
�-� ���d�e�l�a�y���:� ��n�u�m�b�e�r�
� �(�d�e�f�a�u�l�t�:� �0�)�
�
�-� ���i�n�i�t�i�a�l�O�f�f�s�e�t���:� ��s�t�r�i�n�g�
� �(�d�e�f�a�u�l�t�:� �'�1�0�0�%�'�)�
�
�
�
�
�
�
�
�
�
�
�
�
�
�
�
�#�#�#� �V�a�l�i�d�a�t�o�r�s�
�
�
�
���V�a�l�i�d�a�t�i�o�n� �F�u�n�c�t�i�o�n�s���
�
�
�
�T�h�e� �l�i�b�r�a�r�y� �p�r�o�v�i�d�e�s� �s�e�v�e�r�a�l� �u�t�i�l�i�t�y� �f�u�n�c�t�i�o�n�s� �f�o�r� �v�a�l�i�d�a�t�i�o�n� �a�n�d� �f�o�r�m�a�t�t�i�n�g�:�
�
�
�
�-� ��v�a�l�i�d�a�t�e�E�m�a�i�l�(�e�m�a�i�l�:� �s�t�r�i�n�g�)�:� �s�t�r�i�n�g� �|� �n�u�l�l�
�
�
�-� ��v�a�l�i�d�a�t�e�R�e�q�u�i�r�e�d�(�v�a�l�u�e�:� �a�n�y�)�:� �s�t�r�i�n�g� �|� �n�u�l�l�
�
�
�-� ��v�a�l�i�d�a�t�e�P�a�s�s�w�o�r�d�(�p�a�s�s�w�o�r�d�:� �s�t�r�i�n�g�)�:� �s�t�r�i�n�g� �|� �n�u�l�l�
�
�
�-� ��v�a�l�i�d�a�t�e�U�s�e�r�n�a�m�e�(�u�s�e�r�n�a�m�e�:� �s�t�r�i�n�g�)�:� �s�t�r�i�n�g� �|� �n�u�l�l�
�
�
�-� ��v�a�l�i�d�a�t�e�D�a�t�e�(�d�a�t�e�:� �s�t�r�i�n�g�)�:� �s�t�r�i�n�g� �|� �n�u�l�l�
�
�
�-� ��v�a�l�i�d�a�t�e�P�h�o�n�e�N�u�m�b�e�r�(�p�h�o�n�e�N�u�m�b�e�r�:� �s�t�r�i�n�g�)�:� �s�t�r�i�n�g� �|� �n�u�l�l�
�
�
�-� ��v�a�l�i�d�a�t�e�A�n�d�F�o�r�m�a�t�P�h�o�n�e�N�u�m�b�e�r�(�n�u�m�b�e�r�:� �s�t�r�i�n�g�,� �c�o�u�n�t�r�y�C�o�d�e�:� �C�o�u�n�t�r�y�C�o�d�e�)�:� �{� �v�a�l�i�d�:� �b�o�o�l�e�a�n�,� �f�o�r�m�a�t�t�e�d�:� �s�t�r�i�n�g� �|� �n�u�l�l�,� �e�r�r�o�r�:� �s�t�r�i�n�g� �|� �n�u�l�l� �}�
�
�
�-� ��v�a�l�i�d�a�t�e�A�n�g�o�l�a�n�B�I�(�b�i�:� �s�t�r�i�n�g�)�:� �s�t�r�i�n�g� �|� �n�u�l�l�
�
�
�
�
���E�x�a�m�p�l�e� �U�s�a�g�e�:���
�
�
�
��
��t�y�p�e�s�c�r�i�p�t�
�
�i�m�p�o�r�t� �{� �v�a�l�i�d�a�t�e�E�m�a�i�l�,� �v�a�l�i�d�a�t�e�P�a�s�s�w�o�r�d�,� �v�a�l�i�d�a�t�e�A�n�d�F�o�r�m�a�t�P�h�o�n�e�N�u�m�b�e�r�,� �v�a�l�i�d�a�t�e�A�n�g�o�l�a�n�B�I� �}� �f�r�o�m� �'�s�a�m�p�l�e�s�-�l�i�b�-�r�e�a�c�t�/�u�t�i�l�s�/�v�a�l�i�d�a�t�o�r�s�'�;�
�
�
�
�c�o�n�s�t� �e�m�a�i�l�E�r�r�o�r� �=� �v�a�l�i�d�a�t�e�E�m�a�i�l�(�'�t�e�s�t�@�e�x�a�m�p�l�e�.�c�o�m�'�)�;�
�
�c�o�n�s�t� �p�a�s�s�w�o�r�d�E�r�r�o�r� �=� �v�a�l�i�d�a�t�e�P�a�s�s�w�o�r�d�(�'�P�a�s�s�w�0�r�d�!�'�)�;�
�
�c�o�n�s�t� �p�h�o�n�e�V�a�l�i�d�a�t�i�o�n� �=� �v�a�l�i�d�a�t�e�A�n�d�F�o�r�m�a�t�P�h�o�n�e�N�u�m�b�e�r�(�'�+�1�2�3�4�5�6�7�8�9�0�'�,� �'�U�S�'�)�;�
�
�c�o�n�s�t� �b�i�E�r�r�o�r� �=� �v�a�l�i�d�a�t�e�A�n�g�o�l�a�n�B�I�(�'�1�2�3�4�5�6�7�8�9�B�A�0�0�1�'�)�;�
�
�
�
�c�o�n�s�o�l�e�.�l�o�g�(�e�m�a�i�l�E�r�r�o�r�)�;� �/�/� �n�u�l�l� �i�f� �v�a�l�i�d�,� �o�r� �a�n� �e�r�r�o�r� �m�e�s�s�a�g�e�
�
�c�o�n�s�o�l�e�.�l�o�g�(�p�a�s�s�w�o�r�d�E�r�r�o�r�)�;� �/�/� �n�u�l�l� �i�f� �v�a�l�i�d�,� �o�r� �a�n� �e�r�r�o�r� �m�e�s�s�a�g�e�
�
�c�o�n�s�o�l�e�.�l�o�g�(�p�h�o�n�e�V�a�l�i�d�a�t�i�o�n�)�;� �/�/� �{� �v�a�l�i�d�:� �t�r�u�e�,� �f�o�r�m�a�t�t�e�d�:� �'�+�1� �2�3�4� �5�6�7�-�8�9�0�'�,� �e�r�r�o�r�:� �n�u�l�l� �}�
�
�c�o�n�s�o�l�e�.�l�o�g�(�b�i�E�r�r�o�r�)�;� �/�/� �n�u�l�l� �i�f� �v�a�l�i�d�,� �o�r� �a�n� �e�r�r�o�r� �m�e�s�s�a�g�e�
�
�
��
�
�
�
�
�#�#� �A�P�I�
�
�
�
�#�#�#� �D�y�n�a�m�i�c�F�o�r�m�
�
�
�
����<�D�y�n�a�m�i�c�F�o�r�m� �/�>�
���
�
�
�
�-� ���f�i�e�l�d�s���:� ��{� �n�a�m�e�:� �s�t�r�i�n�g�,� �l�a�b�e�l�:� �s�t�r�i�n�g�,� �t�y�p�e�:� �s�t�r�i�n�g�,� �v�a�l�i�d�a�t�i�o�n�:� �(�v�a�l�u�e�:� �a�n�y�)� �=�>� �s�t�r�i�n�g� �|� �n�u�l�l� �}�[�]�
�
�
�-� ���o�n�S�u�b�m�i�t���:� ��(�v�a�l�u�e�s�:� �{� �[�k�e�y�:� �s�t�r�i�n�g�]�:� �a�n�y� �}�)� �=�>� �v�o�i�d�
�
�
�
�
�#�#�#� �A�n�i�m�a�t�i�o�n�s�
�
�
�
����<�F�a�d�e�I�n� �/�>�
���
�
�
�
�-� ���c�h�i�l�d�r�e�n���:� ��R�e�a�c�t�.�R�e�a�c�t�N�o�d�e�
�
�
�-� ���d�u�r�a�t�i�o�n���:� ��n�u�m�b�e�r�
� �(�d�e�f�a�u�l�t�:� �5�0�0�)�
�
�-� ���d�e�l�a�y���:� ��n�u�m�b�e�r�
� �(�d�e�f�a�u�l�t�:� �0�)�
�
�
�
����<�S�l�i�d�e�U�p� �/�>�
���
�
�
�
�-� ���c�h�i�l�d�r�e�n���:� ��R�e�a�c�t�.�R�e�a�c�t�N�o�d�e�
�
�
�-� ���d�u�r�a�t�i�o�n���:� ��n�u�m�b�e�r�
� �(�d�e�f�a�u�l�t�:� �5�0�0�)�
�
�-� ���d�e�l�a�y���:� ��n�u�m�b�e�r�
� �(�d�e�f�a�u�l�t�:� �0�)�
�
�-� ���i�n�i�t�i�a�l�O�f�f�s�e�t���:� ��s�t�r�i�n�g�
� �(�d�e�f�a�u�l�t�:� �'�1�0�0�%�'�)�
�
�
�
�#�#�#� �V�a�l�i�d�a�t�o�r�s�
�
�
�
����v�a�l�i�d�a�t�e�E�m�a�i�l�(�e�m�a�i�l�:� �s�t�r�i�n�g�)�:� �s�t�r�i�n�g� �|� �n�u�l�l�
���
�
�
�
�V�a�l�i�d�a�t�e�s� �a�n� �e�m�a�i�l� �a�d�d�r�e�s�s�.�
�
�
�
����v�a�l�i�d�a�t�e�R�e�q�u�i�r�e�d�(�v�a�l�u�e�:� �a�n�y�)�:� �s�t�r�i�n�g� �|� �n�u�l�l�
���
�
�
�
�C�h�e�c�k�s� �i�f� �a� �f�i�e�l�d� �i�s� �r�e�q�u�i�r�e�d� �a�n�d� �n�o�t� �e�m�p�t�y�.�
�
�
�
����v�a�l�i�d�a�t�e�P�a�s�s�w�o�r�d�(�p�a�s�s�w�o�r�d�:� �s�t�r�i�n�g�)�:� �s�t�r�i�n�g� �|� �n�u�l�l�
���
�
�
�
�V�a�l�i�d�a�t�e�s� �a� �p�a�s�s�w�o�r�d� �b�a�s�e�d� �o�n� �l�e�n�g�t�h�,� �c�h�a�r�a�c�t�e�r� �t�y�p�e�s�,� �a�n�d� �s�p�e�c�i�a�l� �c�h�a�r�a�c�t�e�r�s�.�
�
�
�
����v�a�l�i�d�a�t�e�U�s�e�r�n�a�m�e�(�u�s�e�r�n�a�m�e�:� �s�t�r�i�n�g�)�:� �s�t�r�i�n�g� �|� �n�u�l�l�
���
�
�
�
�V�a�l�i�d�a�t�e�s� �a� �u�s�e�r�n�a�m�e� �b�a�s�e�d� �o�n� �a�l�l�o�w�e�d� �c�h�a�r�a�c�t�e�r�s� �a�n�d� �l�e�n�g�t�h�.�
�
�
�
����v�a�l�i�d�a�t�e�D�a�t�e�(�d�a�t�e�:� �s�t�r�i�n�g�)�:� �s�t�r�i�n�g� �|� �n�u�l�l�
���
�
�
�
�V�a�l�i�d�a�t�e�s� �a� �d�a�t�e� �i�n� �t�h�e� �f�o�r�m�a�t� �Y�Y�Y�Y�-�M�M�-�D�D�.�
�
�
�
����v�a�l�i�d�a�t�e�P�h�o�n�e�N�u�m�b�e�r�(�p�h�o�n�e�N�u�m�b�e�r�:� �s�t�r�i�n�g�)�:� �s�t�r�i�n�g� �|� �n�u�l�l�
���
�
�
�
�V�a�l�i�d�a�t�e�s� �a� �p�h�o�n�e� �n�u�m�b�e�r� �i�n� �E�.�1�6�4� �f�o�r�m�a�t�.�
�
�
�
����v�a�l�i�d�a�t�e�A�n�d�F�o�r�m�a�t�P�h�o�n�e�N�u�m�b�e�r�(�n�u�m�b�e�r�:� �s�t�r�i�n�g�,� �c�o�u�n�t�r�y�C�o�d�e�:� �C�o�u�n�t�r�y�C�o�d�e�)�:� �{� �v�a�l�i�d�:� �b�o�o�l�e�a�n�,� �f�o�r�m�a�t�t�e�d�:� �s�t�r�i�n�g� �|� �n�u�l�l�,� �e�r�r�o�r�:� �s�t�r�i�n�g� �|� �n�u�l�l� �}�
���
�
�
�
�V�a�l�i�d�a�t�e�s� �a�n�d� �f�o�r�m�a�t�s� �p�h�o�n�e� �n�u�m�b�e�r�s� �f�o�r� �s�u�p�p�o�r�t�e�d� �c�o�u�n�t�r�y� �c�o�d�e�s�.�
�
�
�
����v�a�l�i�d�a�t�e�A�n�g�o�l�a�n�B�I�(�b�i�:� �s�t�r�i�n�g�)�:� �s�t�r�i�n�g� �|� �n�u�l�l�
���
�
�
�
�V�a�l�i�d�a�t�e�s� �a�n� �A�n�g�o�l�a�n� �I�D� �c�a�r�d� �n�u�m�b�e�r�.�
�
�
�
�#�#� �C�o�n�t�r�i�b�u�t�i�n�g�
�
�
�
�W�e� �w�e�l�c�o�m�e� �c�o�n�t�r�i�b�u�t�i�o�n�s� �t�o� �i�m�p�r�o�v�e� �t�h�e� �l�i�b�r�a�r�y�.� �T�o� �c�o�n�t�r�i�b�u�t�e�:�
�
�
�
�1�.� �F�o�r�k� �t�h�e� �r�e�p�o�s�i�t�o�r�y�.�
�
�2�.� �C�r�e�a�t�e� �a� �n�e�w� �b�r�a�n�c�h� �f�o�r� �y�o�u�r� �c�h�a�n�g�e�s�.�
�
�3�.� �M�a�k�e� �y�o�u�r� �c�h�a�n�g�e�s� �a�n�d� �t�e�s�t� �t�h�o�r�o�u�g�h�l�y�.�
�
�4�.� �S�u�b�m�i�t� �a� �p�u�l�l� �r�e�q�u�e�s�t� �w�i�t�h� �a� �d�e�t�a�i�l�e�d� �d�e�s�c�r�i�p�t�i�o�n� �o�f� �y�o�u�r� �c�h�a�n�g�e�s�.�
�
�
�
�F�o�r� �m�o�r�e� �d�e�t�a�i�l�e�d� �c�o�n�t�r�i�b�u�t�i�n�g� �g�u�i�d�e�l�i�n�e�s�,� �p�l�e�a�s�e� �r�e�f�e�r� �t�o� �[�C�O�N�T�R�I�B�U�T�I�N�G�.�m�d�]�(�C�O�N�T�R�I�B�U�T�I�N�G�.�m�d�)�.�
�
�
�
�#�#� �T�e�s�t�i�n�g�
�
�
�
�T�o� �r�u�n� �t�e�s�t�s�,� �u�s�e�:�
�
�
�
��
��b�a�s�h�
�
�n�p�m� �t�e�s�t�
�
�
��
�
�
�
�
�O�r�:�
�
�
�
��
��b�a�s�h�
�
�y�a�r�n� �t�e�s�t�
�
�
��
�
�
�
�
�E�n�s�u�r�e� �t�h�a�t� �a�l�l� �t�e�s�t�s� �p�a�s�s� �b�e�f�o�r�e� �s�u�b�m�i�t�t�i�n�g� �c�h�a�n�g�e�s�.�
�
�
�
�#�#� �L�i�c�e�n�s�e�
�
�
�
�T�h�i�s� �l�i�b�r�a�r�y� �i�s� �l�i�c�e�n�s�e�d� �u�n�d�e�r� �t�h�e� �[�M�I�T� �L�i�c�e�n�s�e�]�(�L�I�C�E�N�S�E�)�.�
�
�
�
�#�#� �C�o�n�t�a�c�t�
�
�
�
�F�o�r� �q�u�e�s�t�i�o�n�s� �o�r� �s�u�p�p�o�r�t�,� �p�l�e�a�s�e� �r�e�a�c�h� �o�u�t� �t�o� �[�j�o�a�o�k�a�t�u�m�b�e�l�a�8�2�@�g�m�a�i�l�.�c�o�m�]�(�m�a�i�l�t�o�:�j�o�a�o�k�a�t�u�m�b�e�l�a�8�2�@�g�m�a�i�l�.�c�o�m�)� �o�r� �o�p�e�n� �a�n� �i�s�s�u�e� �o�n� �t�h�e� �[�G�i�t�H�u�b� �r�e�p�o�s�i�t�o�r�y�]�(�h�t�t�p�s�:�/�/�g�i�t�h�u�b�.�c�o�m�/�K�a�t�u�m�b�e�l�a�)�.�
�
�
�
�#�#� �C�h�a�n�g�e�l�o�g�
�
�
�
�S�e�e� �[�C�H�A�N�G�E�L�O�G�.�m�d�]�(�C�H�A�N�G�E�L�O�G�.�m�d�)� �f�o�r� �t�h�e� �l�a�t�e�s�t� �u�p�d�a�t�e�s� �a�n�d� �v�e�r�s�i�o�n� �c�h�a�n�g�e�s�.�
�
�
�
�-�-�-�
�
�
�
�
�
�#�#� �C�o�n�t�r�i�b�u�t�i�n�g�
�
�
�
�W�e� �w�e�l�c�o�m�e� �c�o�n�t�r�i�b�u�t�i�o�n�s� �t�o� �i�m�p�r�o�v�e� �t�h�e� �l�i�b�r�a�r�y�.� �T�o� �c�o�n�t�r�i�b�u�t�e�:�
�
�
�
�1�.� �F�o�r�k� �t�h�e� �r�e�p�o�s�i�t�o�r�y�.�
�
�2�.� �C�r�e�a�t�e� �a� �n�e�w� �b�r�a�n�c�h� �f�o�r� �y�o�u�r� �c�h�a�n�g�e�s�.�
�
�3�.� �M�a�k�e� �y�o�u�r� �c�h�a�n�g�e�s� �a�n�d� �t�e�s�t� �t�h�o�r�o�u�g�h�l�y�.�
�
�4�.� �S�u�b�m�i�t� �a� �p�u�l�l� �r�e�q�u�e�s�t� �w�i�t�h� �a� �d�e�t�a�i�l�e�d� �d�e�s�c�r�i�p�t�i�o�n� �o�f� �y�o�u�r� �c�h�a�n�g�e�s�.�
�
�
�
�F�o�r� �m�o�r�e� �d�e�t�a�i�l�e�d� �c�o�n�t�r�i�b�u�t�i�n�g� �g�u�i�d�e�l�i�n�e�s�,� �p�l�e�a�s�e� �r�e�f�e�r� �t�o� �[�C�O�N�T�R�I�B�U�T�I�N�G�.�m�d�]�(�C�O�N�T�R�I�B�U�T�I�N�G�.�m�d�)�.�
�
�
�
�#�#� �T�e�s�t�i�n�g�
�
�
�
�T�o� �r�u�n� �t�e�s�t�s�,� �u�s�e�:�
�
�
�
��
��b�a�s�h�
�
�n�p�m� �t�e�s�t�
�
�
��
�
�
�
�
�O�r�:�
�
�
�
��
��b�a�s�h�
�
�y�a�r�n� �t�e�s�t�
�
�
��
�
�
�
�
�E�n�s�u�r�e� �t�h�a�t� �a�l�l� �t�e�s�t�s� �p�a�s�s� �b�e�f�o�r�e� �s�u�b�m�i�t�t�i�n�g� �c�h�a�n�g�e�s�.�
�
�
�
�#�#� �L�i�c�e�n�s�e�
�
�
�
�T�h�i�s� �l�i�b�r�a�r�y� �i�s� �l�i�c�e�n�s�e�d� �u�n�d�e�r� �t�h�e� �[�M�I�T� �L�i�c�e�n�s�e�]�(�L�I�C�E�N�S�E�)�.�
�
�
�
�#�#� �C�o�n�t�a�c�t�
�
�
�
�F�o�r� �q�u�e�s�t�i�o�n�s� �o�r� �s�u�p�p�o�r�t�,� �p�l�e�a�s�e� �r�e�a�c�h� �o�u�t� �t�o� �[�j�o�a�o�k�a�t�u�m�b�e�l�a�8�2�@�g�m�a�i�l�.�c�o�m�]�(�m�a�i�l�t�o�:�j�o�a�o�k�a�t�u�m�b�e�l�a�8�2�@�g�m�a�i�l�.�c�o�m�)� �o�r� �o�p�e�n� �a�n� �i�s�s�u�e� �o�n� �t�h�e� �[�G�i�t�H�u�b� �r�e�p�o�s�i�t�o�r�y�]�(�h�t�t�p�s�:�/�/�g�i�t�h�u�b�.�c�o�m�/�K�a�t�u�m�b�e�l�a�)�.�
�
�
�
�#�#� �C�h�a�n�g�e�l�o�g�
�
�
�
�S�e�e� �[�C�H�A�N�G�E�L�O�G�.�m�d�]�(�C�H�A�N�G�E�L�O�G�.�m�d�)� �f�o�r� �t�h�e� �l�a�t�e�s�t� �u�p�d�a�t�e�s� �a�n�d� �v�e�r�s�i�o�n� �c�h�a�n�g�e�s�.�
�
�
�
�-�-�-�
�
�
�
�E�s�s�e� �R�E�A�D�M�E� �f�o�r�n�e�c�e� �u�m�a� �v�i�s���o� �g�e�r�a�l� �c�o�m�p�l�e�t�a� �e� ���t�i�l� �p�a�r�a� �q�u�a�l�q�u�e�r� �u�s�u���r�i�o� �d�e�s�t�a� �b�i�b�l�i�o�t�e�c�a�.� � �
�
�
�
� �