https://github.com/aljaroudi/randos-pip
A Python pip package for generating randomness
https://github.com/aljaroudi/randos-pip
random-generation randomizer
Last synced: about 2 months ago
JSON representation
A Python pip package for generating randomness
- Host: GitHub
- URL: https://github.com/aljaroudi/randos-pip
- Owner: aljaroudi
- License: mit
- Created: 2021-05-16T09:35:12.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2021-06-07T22:52:11.000Z (almost 5 years ago)
- Last Synced: 2025-09-20T11:58:44.807Z (9 months ago)
- Topics: random-generation, randomizer
- Language: Python
- Homepage:
- Size: 143 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
# randos
A Python pip package for generating randomness
[](#)
[](#)
[](#)
[](#)
[](#)
[](#)
[](#)
## Requirements
Python 3.7+
## Installation
```console
pip install randos
```
## Usage
#### 1. Random integers
```python
random_ints(length: int, minimum: int = 0, maximum: int = 100) -> list[int]
```
- ##### example
```python
>>>random_ints(3)
[3,5,7]
```
#### 2. Random line from a file
```python
random_line(file_name: str, separator: str = None, number_of_lines: int = None) -> str | tuple[str,str]
```
#### 3. Random city
```python
random_city(include_country: bool = False) -> str | tuple[str,str]
```
- ##### example
```python
>>>city = random_city()
'San Diego'
>>>city, country = random_city(True)
('San Diego', 'United States')
```
#### 4. Random country
```python
random_country(include_abbr: bool = False) -> str | tuple[str,str]
```
- ##### example
```python
>>>country = random_country()
'United States'
>>>country, abbr = random_country(True)
('United States', 'US')
```
#### 5. Random emoji
```python
random_emoji(include_desc: bool = False) -> str | tuple[str,str]
```
- ##### example
```python
>>>emoji = random_emoji()
'🦝'
>>>emoji, desc = random_emoji(True)
('🦝,', 'Raccoon')
```
#### 6. Random bool
```python
random_bool() -> bool
```
- ##### example
```python
>>>boolean = random_bool()
True
```
#### 7. Random travel city
```python
random_travel_city(include_country: bool = False) -> str | tuple[str,str]
```
- ##### example
```python
>>>city = random_travel_city()
'San Diego'
>>>city, country = random_travel_city(True)
('San Diego', 'United States')
```
#### 7. Random tourist attraction
```python
random_travel_dest() -> str
```
- ##### example
```python
>>>place = random_travel_destination()
'Glacier National Park'
```