Metadata-Version: 2.1
Name: simu
Version: 0.0.1
Summary: a simulation data generator
Home-page: https://github.com/uncle-lv/simu
Author: uncle-lv
Author-email: uncle.lv@outlook.com
License: UNKNOWN
Project-URL: Bug Reports, https://github.com/uncle-lv/simu/issues
Project-URL: Source, https://github.com/uncle-lv/simu
Keywords: mock,test,random
Platform: UNKNOWN
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE

# simu

![license](https://img.shields.io/github/license/uncle-lv/simu) ![stars](https://img.shields.io/github/stars/uncle-lv/simu) ![issues](https://img.shields.io/github/issues/uncle-lv/simu) ![forks](https://img.shields.io/github/forks/uncle-lv/simu) ![python version](https://img.shields.io/badge/python-3.7.0-blue)

A simulation data generator



### Usage

### Random

#### Constants

```python
DEFAULT_MAX = 1 << 12       # the default maximum
DEFAULT_MIN = -DEFAULT_MAX  # the default minimum
DEFAULT_SIZE = 10           # the default length of list
```



#### Boolean

##### simu.random.*boolean()*

return a random boolean value



##### simu.random.*booleans(size: int = DEFAULT_SIZE)*

return a list of random boolean values



parameter list:

| parameter |    description     | default |      optional      |
| :-------: | :----------------: | :-----: | :----------------: |
|   size    | the length of list |   10    | :heavy_check_mark: |



#### Natural number

##### simu.random.*natural(min: int = 0, max: int = DEFAULT_MAX)*

return a random natural number



parameter list:

| parameter | description | default |      optional      |
| :-------: | :---------: | :-----: | :----------------: |
|    min    | lower limit |    0    | :heavy_check_mark: |
|    max    | upper limit |  4096   | :heavy_check_mark: |



##### simu.random.*naturals(min: int = 0, max: int = DEFAULT_MAX, size: int = DEFAULT_SIZE)*

return a list of natural numbers



parameter list:

| parameter |    description     | default |      optional      |
| :-------: | :----------------: | :-----: | :----------------: |
|    min    |    lower limit     |    0    | :heavy_check_mark: |
|    max    |    upper limit     |  4096   | :heavy_check_mark: |
|   size    | the length of list |   10    | :heavy_check_mark: |



#### Integer

##### simu.random.*integer(min: int = DEFAULT_MIN, max: int = DEFAULT_MAX)*

return a random integer



parameter list:

| parameter | description | default |      optional      |
| :-------: | :---------: | :-----: | :----------------: |
|    min    | lower limit |  -4096  | :heavy_check_mark: |
|    max    | upper limit |  4096   | :heavy_check_mark: |



##### simu.random.*integers(min: int = DEFAULT_MIN, max: int = DEFAULT_MAX, size: int = DEFAULT_SIZE)*

return a list of random integers



parameter list:

| parameter |    description     | default |      optional      |
| :-------: | :----------------: | :-----: | :----------------: |
|    min    |    lower limit     |  -4096  | :heavy_check_mark: |
|    max    |    upper limit     |  4096   | :heavy_check_mark: |
|   size    | the length of list |   10    | :heavy_check_mark: |



#### Floating number

##### simu.random.*floating(min: float = DEFAULT_MIN, max: float = DEFAULT_MAX, ndigits: int = 2)*

return a random floating number



parameter list:

| parameter |                      description                       | default |      optional      |
| :-------: | :----------------------------------------------------: | :-----: | :----------------: |
|    min    |                      lower limit                       |  -4096  | :heavy_check_mark: |
|    max    |                      upper limit                       |  4096   | :heavy_check_mark: |
|  ndigits  | rounded to *ndigits* precision after the decimal point |    2    | :heavy_check_mark: |



##### simu.random.*floatings(min: float = DEFAULT_MIN, max: float = DEFAULT_MAX, ndigits: int = 2, size: int = DEFAULT_SIZE)*

return a list of random floating numbers



parameter list:

| parameter |                      description                       | default |      optional      |
| :-------: | :----------------------------------------------------: | :-----: | :----------------: |
|    min    |                      lower limit                       |  -4096  | :heavy_check_mark: |
|    max    |                      upper limit                       |  4096   | :heavy_check_mark: |
|  ndigits  | rounded to *ndigits* precision after the decimal point |    2    | :heavy_check_mark: |
|   size    |                   the length of list                   |   10    | :heavy_check_mark: |



#### Character

##### simu.random.*string(pool: str = string.ascii_letters, min: int = 3, max: int = 10)*

return a random character from the character pool



parameter list:

| parameter |  description   |                           default                            |      optional      |
| :-------: | :------------: | :----------------------------------------------------------: | :----------------: |
|   pool    | character pool | *[string.ascii_letters](https://docs.python.org/3/library/string.html?highlight=ascii_letter#string.ascii_letters)* | :heavy_check_mark: |



#### String

##### simu.random.*string(pool: str = string.ascii_letters, min: int = 3, max: int = 10)*

return a string which consists of the characters from the character pool



parameter list:

| parameter |         description          |                           default                            |      optional      |
| :-------: | :--------------------------: | :----------------------------------------------------------: | :----------------: |
|   pool    |        character pool        | *[string.ascii_letters](https://docs.python.org/3/library/string.html?highlight=ascii_letter#string.ascii_letters)* | :heavy_check_mark: |
|    min    | the minimum length of string |                              3                               | :heavy_check_mark: |
|    max    | the maximum length of string |                              10                              | :heavy_check_mark: |



