Metadata-Version: 2.1
Name: charq
Version: 0.0.1
Summary: A simple package that provides methods to get characters, numbers, random words and etc.
Home-page: https://github.com/joaoroberto50/CharQ
Author: João Roberto
Author-email: joaorobert0@protonmail.com
License: UNKNOWN
Project-URL: Bug Tracker, https://github.com/joaoroberto50/CharQ/issues
Description: # Welcome to CharQ!
        ### v.0.0.1 mar 2021
        
        CharQ is a simple python module that provides some character blocks, random words, number and pass.
        
        In this moment existe two class, CharAscii and WordGenerate.
        
        The class CharAscii have the folow methods:
        - ``ascii()``: return a table with all printable ascii characters;
        - ``num()``: return a table with all numbers in str format;
        - ``lower()``: return a table with a-z characters, all lowers;
        - ``up()``: return a table with A-Z characters, all uppers;
        - ``lower_up()``: return a table with a-z and A-Z characters, all lowers and uppers;
        - ``lower_up_num()``: return a table with a-z, A-Z and 0-9 characters, all lowers, uppers and numbers;
        - ``symbols()``: return a table ascii symbols printables;
        - ``as_str()``: Convert class atribute val to str.
        
        The class WordGenerate have the folow methods:
        - ``word()``: return a random word, you optionally can pass the arguments tam to chose how many charcters you want in your random word, and case tochose btwen 'lower', 'up' or 'camel', default ``tam=10, case='lower'``;
        - ``num()``: return a random number, you also can optionally pass the arguments tam to chose how many numbers, and typen to chose btwen formats 'str' or 'int', default ``tam=2, typen='int'``;
        - ``passw()``: return a random password, use the argument tam to chose how many characters you want in you pass, default ``tam=8``;
        - ``as_list()``: Convert class atribute val to table
        
        Both classes have an attribute "val" and this attribute has the same value returned by the last method invoked by the instantiated class.
        
        ## How to Install
        Just use: 
        > pip install charq
        
        ## How to use
        Class CharAscii.
        ``` 
        from charq.charq import CharAscii
        
        a = CharAscii()
        a.ascii()
        >>> [' ', '!', '"', '#', '$', '%', '&', "'", '(', ')', '*', '+', ',', '-', '.', '/', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', ':', ';', '<', '=', '>', '?', '@', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', '[', '\\', ']', '^', '_', '`', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', '{', '|', '}', '~', '\x7f', '\n'] 
        # a.val has the same value
        a.num()
        >>> ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9']
        a.lower()
        >>> ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z'] 
        a.up()
        >>> ['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z'] 
        a.lower_up()
        >>> ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z'] 
        a.lower_up_num()
        >>> ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9'] 
        a.as_str()
        >>> 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789' 
        
        ```
        Class WordGenerate.
        ```
        from charq.charq import CharAscii
        
        a = WordGenerate()
        a.word()
        >>> 'ktopzxhnyn'
        # a.val has the same value
        a.word(tam=12, case='camel')
        >>> 'Detisgihjuhx' 
        a.num()
        >>> 67
        a.num(tam=5, typen='str')
        >>> '86514'
        a.passw()
        >>> '{Ivb>}-"' 
        a.passw(tam=20)
        >>> "p(/ozfDZd3&psT]'5/0K" 
        a.as_list()
        >>> ['p', '(', '/', 'o', 'z', 'f', 'D', 'Z', 'd', '3', '&', 'p', 's', 'T', ']', "'", '5', '/', '0', 'K']
        ``
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
