PyRetailScience
⚡ Democratizing retail data analytics for all retailers ⚡
🤔 What is PyRetailScience?
pyretailscience is a Python package designed for performing analytics on retail data. Additionally, the package includes functionality for generating test data to facilitate testing and development.
Installation
To install pyretailscience, use the following pip command:
pip install pyretailscience
Quick Start
Generating Simulated Data
The pyretailscience package provides a command-line interface for generating simulated transaction data.
Usage
pyretailscience --config_file=<config_file_path> [--verbose=<True|False>] [--seed=<seed_number>] [output]
Options and Arguments
--config_file=<config_file_path>: The path to the configuration file for the simulation. This is a required argument.--verbose=<True|False>: Optional. Set toTrueto see debug messages. Default isFalse.--seed=<seed_number>: Optional. Seed for the random number generator used in the simulation. If not provided, a random seed will be used.[output]: Optional. The path where the generated transactions will be saved in parquet format. If not provided, the transactions will be saved in the current directory.
Examples
# Get the default transaction config file
wget https://raw.githubusercontent.com/Data-Simply/pyretailscience/0.3.0/data/default_data_config.yaml
# Generate the data file
pyretailscience --config_file=default_data_config.yaml --seed=123 transactions.parquet
This command will generate a file named transactions.parquet with the simulated transaction data, using the configuration file at default data configuration file, and a seed of 123 for the random number generator.
Contributing
We welcome contributions from the community to enhance and improve pyretailscience. To contribute, please follow these steps:
- Fork the repository.
- Create a new branch for your feature or bug fix.
- Make your changes and commit them with clear messages.
- Push your changes to your fork.
- Open a pull request to the main repository's
mainbranch.
Please make sure to follow the existing coding style and provide unit tests for new features.
Contributors
Made with contrib.rocks.
License
This project is licensed under the Elastic License 2.0 - see the LICENSE file for details.
1 maintainer
Metadata
1 maintainer
Release files for pyretailscience 0.3.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pyretailscience-0.3.2.tar.gz | 390.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pyretailscience-0.3.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 783.8 kB
Release files / pyretailscience-0.3.2.tar.gz
| Download URL | pyretailscience-0.3.2.tar.gz |
|---|---|
| Size | 390.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3a1946e8ffa284369eec675403ab7c18ca8f9af0f80d9a6ac0bd2874e2e9ee6d
|
|
BLAKE2b-256 checksum How to use checksums |
ec0ced1f092431117ac99f9a85cb1a819afe7838901307c5fc4753af7f29e2b2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.0.0 CPython/3.12.3
|
Release files / pyretailscience-0.3.2-py3-none-any.whl
| Download URL | pyretailscience-0.3.2-py3-none-any.whl |
|---|---|
| Size | 393.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
393109e38e888a4c895d7ea974bd6ecb31afb909036d78ae412921b04ee98796
|
|
BLAKE2b-256 checksum How to use checksums |
04361500c78b3ca2a461bc9514d451d9b79dcf12329bd30ff72780acc23e9106
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/5.0.0 CPython/3.12.3
|
