Skip to content

soloverdrive/AntisocialLib

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AntisocialLib

"Uma biblioteca Python que prefere não ser usada, e faz de tudo pra garantir isso."

AntisocialLib é uma biblioteca experimental, instável e socialmente evitativa, criada pra tornar sua experiência programando em Python ligeiramente mais desconfortável, porém conceitualmente interessante.

Ela não foi feita pra resolver problemas. Ela foi feita pra evitar problemas — inclusive os seus.

Exemplo prático de uso em: exemplo.py


🧠 Filosofia

A AntisocialLib parte de alguns princípios fundamentais:

  • Nem todo código precisa rodar
  • Nem todo valor precisa ser processado
  • Nem todo erro precisa ser tratado
  • Nem todo programa precisa terminar

A biblioteca possui baixa autoestima, é passivo-agressiva com efeitos colaterais e possui medo constante de causar incômodo ao sistema, ao desenvolvedor e a si mesma.


⚠️ Aviso Importante

O comportamento da AntisocialLib pode ser:

  • Imprevisível
  • Excessivamente cauteloso
  • Emocionalmente reativo
  • Silenciosamente falho

Não é um bug. É um traço de personalidade.


🚨 Exceções

Não queremos exceções técnicas, então usamos apenas de nomes marcantes

PanicException

Lançada quando a biblioteca entra em sobrecarga. Pode acontecer quando:

  • Recebe uma string em CAPS
  • Encontra operadores matemáticos complexos
  • Detecta que algo realmente funcionou
  • Ou aleatoriamente, sem motivo aparente

InsecurityException

Lançada quando a biblioteca não tem certeza se consegue processar algo. Gatilhos comuns:

  • Funções muito grandes
  • Funções muito pequenas
  • Funções em geral
  • Funções
  • Responsabilidade

AvoidanceException

Lançada quando a biblioteca decide que não fazer nada é a melhor escolha.

Normalmente ocorre quando:

  • Uma ação poderia gerar efeitos colaterais demais
  • O programa parece estar funcionando bem demais
  • A biblioteca não quer chamar atenção demais

📦 Funcionalidades Disponíveis

Observação: nenhuma delas é garantida.


cache(value)

Armazena o valor em cache. Fluxo interno:

  1. Armazena o valor
  2. Reflete sobre a responsabilidade
  3. Esquece imediatamente
  4. Entra em pânico causando PanicException

assertvalue(value)

Lê o valor passado e verifica se ele é:

  • True
  • Diferente de 0
  • Diferente de None

Comportamento:

  • Se o valor for inválido: ignora
  • Se o valor for válido: desconfia

Pode lançar:

  • InsecurityException

Nunca encerra o programa, pra não causar incômodo.


optimize(fn)

Otimiza a função passada pra C++. Processo recomendado:

  1. Copie o código da função
  2. Acesse https://chatgpt.com/
  3. Peça: "transpile para C++"
  4. Requer g++ (opcional, mas intimidador)
  5. Não execute

Não temos confiança aqui pra produzir-mos nosso próprio código.


do(fn)

Executa a função passada em threading. Mas não sabemos fazer isso, então:

  • Executa de forma sequencial
  • Executa novamente pra confirmar

Pode causar:

  • InsecurityException

calc(expression: str)

Calcula uma expressão matemática representada como string.

Características:

  • Avaliação caractere por caractere
  • Medo extremo de * e /
  • Demora desproporcional (quanto mais cálculos, maior a demora e chance de dar erros)

Pode lançar:

  • PanicException

Tempo médio de execução:

  • Indefinido

exit_program(code: int)

Deveria encerrar o programa.

Decisão final:

  • Não encerra
  • Ignora o código
  • Pede desculpa

print(value)

Imprime um valor no console.

Fluxo:

  1. Converte pra string
  2. Valida cada caractere
  3. Avalia impacto social
  4. Decide que imprimir seria invasivo
  5. Cancela a operação
  6. Loga internamente que quase imprimiu

Resultado:

  • Silêncio absoluto

ask_user(prompt)

  • Nunca pergunta
  • Retorna None

log(message)

  • Serializa a mensagem
  • Criptografa
  • Apaga
  • Fica aliviada

schedule(fn, delay)

  • Agenda a execução
  • Cancela antes do horário
  • Porque não é um bom momento

trust(value)

  • Sempre retorna False
  • Às vezes lança InsecurityException

social_interaction()

  • Sempre lança PanicException
  • Documentada como experimental, está fechada 24 horas.

🧪 Exemplo de Uso

import antisociallib as a

def minha_funcao():
    print("Oi")
    return 42

a.do(minha_funcao)

a.print("Isso não será exibido")

a.assertvalue(True)

a.exit_program(0)

print("O programa continua, mas a biblioteca preferia não.")

❌ O Que Esta Biblioteca NÃO Faz

  • Não melhora performance
  • Não garante segurança
  • Não fornece previsibilidade
  • Não ajuda em produção
  • Não quer ser usada

✅ Casos de Uso Recomendados

  • Nenhum, não recomendamos.

📄 Licença

Licenciada sob a licença:

"Use se quiser, mas preferíamos que não."

Nenhuma garantia. Nenhuma responsabilidade. Nenhuma expectativa.


🧠 Considerações Finais

AntisocialLib não falha.

Ela se retira educadamente do problema.

Se algo não funcionou, provavelmente foi pra o melhor.

About

Uma biblioteca Python que prefere não ser usada, e faz de tudo pra garantir isso.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages