Download the PHP package ananiaslitz/item-balancer without Composer
On this page you can find all versions of the php package ananiaslitz/item-balancer. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ananiaslitz/item-balancer
More information about ananiaslitz/item-balancer
Files in ananiaslitz/item-balancer
Package item-balancer
Short Description ItemBalancer is a flexible library for distributing items across predefined categories based on specified proportions. Using a cache-backed mechanism, it ensures efficient real-time calculations for balanced item assignments.
License
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package item-balancer
ItemBalancer
ItemBalancer é uma biblioteca flexível que permite distribuir itens entre categorias pré-definidas com base em proporções especificadas. Com um mecanismo respaldado por cache, ele garante cálculos em tempo real eficientes para atribuições equilibradas de itens.
Justificativa: Movido por uma explicação inicial de um amigo de trabalho sobre distribuição probabilística, resolvi criar esta implementação simplista. Ela tem como objetivo resolver o desafio de distribuir itens em categorias com diferentes probabilidades, garantindo uma distribuição justa e proporcional.
Instalação
Use o gerenciador de pacotes Composer para instalar a ItemBalancer.
Uso
Neste exemplo, estamos distribuindo o ItemX entre as categorias A e B com uma proporção de 70% para A e 30% para B. O resultado mostrará a categoria para a qual ItemX foi distribuído.
Configuração usando Docker
Para facilitar o desenvolvimento e os testes, fornecemos um arquivo docker-compose.yaml que permite que você rode uma instância do Redis em um container Docker.
Pré-requisitos
Variáveis de ambiente
Instruções
- Clone o repositório.
- No diretório raiz do projeto, execute:
docker-compose up -d - O serviço Redis estará rodando na porta 6379.
Quando estiver usando a biblioteca em seu projeto, lembre-se de configurar o host do Redis para redis se estiver usando Docker.
Contribution
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. We greatly appreciate any contributions you make. Thank you for being a part of our community! 🥰
Aviso sobre Precisão
Quando se utiliza quantidades menores para a distribuição, a precisão dos resultados pode ser influenciada por fatores estocásticos e pela própria natureza do algoritmo probabilístico. Portanto, é importante ter em mente que, com baixas quantidades, pode não ser possível garantir uma distribuição que reflita exatamente as porcentagens estabelecidas.
No entanto, à medida que a quantidade de itens aumenta, a precisão da distribuição tende a se aproximar das porcentagens especificadas. Recomenda-se realizar testes com volumes significativos de dados para obter uma representação mais precisa das categorias de distribuição.
