CLInote 0.1.0__py3-none-any.whl

clinote-0.1.0.dist-info/METADATA

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: CLInote
+Version: 0.1.0
+Summary: Gerenciador de notas minimalista para terminal
+Author-email: Geovani Rodrigues <geovanirodr.dev@gmail.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+<h1 align="center">🗒️ CLInote</h1>
+
+📋 **Sobre**
+
+O **CLInote** é um gerenciador de notas minimalista, focado em alta produtividade para quem vive no terminal. Desenvolvido para ser rápido, portátil e sem distrações, permitindo que você crie, liste e edite suas notas diretamente pelo seu editor favorito.
+
+🚀 **Funcionalidades**
+
+* **Terminal-First:** Otimizado para um fluxo de trabalho CLI ágil.
+* **Inteligente:** Detecção automática do melhor editor disponível (Vim > Nano > Notepad).
+* **Portátil:** Funciona nativamente em Windows, Linux e macOS.
+* **Leve:** Sem dependências desnecessárias.
+
+📦 **Instalação**
+
+```bash
+pip install CLInote
+```
+
+🛠️ **Como usar**
+
+Após a instalação, o comando `nc` estará disponível globalmente:
+
+| Ação | Comando | Descrição |
+| :--- | :--- | :--- |
+| **Criar nota** | `nc add <nome>` | Cria uma nova nota e abre o editor. |
+| **Listar tudo** | `nc list` | Exibe todas as suas notas salvas. |
+| **Abrir nota** | `nc <nome>` | Abre uma nota existente para edição. |
+| **Deletar nota** | `nc delete <id>` | Remove uma nota permanentemente. |
+
+💻 **Configurando editores CLI (Recomendado)**
+
+Para a experiência completa no terminal, instale o Vim ou Nano:
+
+* **Linux:**
+    * Ubuntu/Debian: `sudo apt update && sudo apt install vim nano`
+    * Fedora: `sudo dnf install vim nano`
+* **macOS:** `brew install vim nano`
+* **Windows:** `winget install vim.vim nano.nano`
+
+💡 **Filosofia do Projeto**
+
+O **CLInote** acredita que a produtividade vem da simplicidade. O sistema buscará automaticamente o editor mais eficiente no seu ambiente. Caso nenhum editor CLI seja encontrado, o sistema utiliza o editor padrão do seu sistema operacional (Notepad).
+
+🗂️ **Arquitetura de Dados**
+
+Os dados são armazenados localmente de forma persistente:
+* **Windows:** `%APPDATA%\CLInote\`
+* **Linux/macOS:** `~/.config/CLInote/`
+
+🛠 **Tecnologias**
+
+* **Python 3:** Linguagem principal do projeto.
+* **JSON:** Armazenamento leve e estruturado dos metadados.
+* **Subprocess:** Integração segura com editores de sistema.
+* **Shutil:** Detecção inteligente de dependências no PATH.
+
+📄 **Licença**
+
+MIT © Geovani Rodrigues 2026

clinote-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+notes.py,sha256=DZCuVK1uO2R4lsFK_bBIt0TUBKnVw7wsaqYKXiS0dbA,5597
+clinote-0.1.0.dist-info/licenses/LICENSE,sha256=Q3fS13BNynRE10Ep_JnWE3SRDPBpGa-W0mX9b0uLGHk,1093
+clinote-0.1.0.dist-info/METADATA,sha256=YYAyaFVpAiAuAV06dMEyfjc5E3T5seV0hY7atZKIaEc,2706
+clinote-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+clinote-0.1.0.dist-info/entry_points.txt,sha256=Oaa7EN4fywul0cxnH6-VyCBs9e09vlmNEyI51-2MdVA,34
+clinote-0.1.0.dist-info/top_level.txt,sha256=RE4P_72CXpYQ_1sZlIVwegyJUzmugMFcyKiu5BsQb9o,6
+clinote-0.1.0.dist-info/RECORD,,

clinote-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

clinote-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+nc = notes:main

clinote-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Geovani Rodrigues
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

clinote-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+notes

notes.py

@@ -0,0 +1,116 @@
+import sys  # importa o modulo sys
+import json  # importa o modulo json
+import os  # importa o modulo os
+import subprocess  # importa o modulo subprocess
+import shutil
+
+base_dir = os.environ.get('APPDATA') if os.name == 'nt' else os.path.expanduser('~/.config') # detecta a pasta base de usuario de forma genérica
+PASTA_DADOS = os.path.join(base_dir, 'notesCLI') # define a pasta de dados
+ARQUIVO_JSON = os.path.join(PASTA_DADOS, 'notas.json') #define o caminho absoluto
+
+def exibir_rodape(): # rodapé com informações
+    print("\n © 2026 Desenvolvido por Geovani Rodrigues | notesCLI v0.1.0 \n ")
+
+def abrir_editor(caminho):
+    editores = ['vim', 'nano', 'notepad'] #lista de editores por prioridade
+    editor_escolhido = None #inicializa a variavel como vazia
+
+    for editor in editores: # inicia um loop para verificar os editores
+        if shutil.which(editor): # verifica se o executavel do editor existe no PATH do sistema
+            editor_escolhido = editor # se achar algum editor defini como escolhido
+            break # interrompe o loop
+
+    exibir_rodape() # exibe o rodapé
+
+    if not editor_escolhido: # se não achar nenhum editor
+        print("Erro: Nenhum editor encontrado.") #mensagem de erro
+        sys.exit(1) # fecha o programa
+
+    subprocess.run([editor_escolhido, caminho], check=True) #executa o editor
+
+def main(): # funcao principal para o pacote pip
+    if not os.path.exists(PASTA_DADOS): # se a pasta de dados nao existir
+        os.makedirs(PASTA_DADOS) # cria a pasta de dados
+
+    if len(sys.argv) < 2: # verifica se o numero de argumentos é menor que 2
+        print("Uso correto: n [add <nome> | list | delete <id> | <nome_nota>]") # exibe msg caso seja
+        sys.exit(1) # fecha o programa
+
+    comando = sys.argv[1] # pega o segundo item digitado, o comando
+    print(f" Comando recebido: {comando}")
+
+    try:
+        with open(ARQUIVO_JSON, 'r', encoding='utf-8') as arquivo: # abre o arquivo notas.json em modo leitura
+            notas = json.load(arquivo) # carrega o arquivo json em notas
+    except (FileNotFoundError, json.JSONDecodeError): # caso o arquivo nao exista ou o arquivo nao for json
+        notas = [] # cria um array vazio
+
+    # ============ COMANDO LIST
+    if comando == 'list': # se o comando for list
+        if not notas: # se o array notas estiver vazio
+            print("Nenhuma nota encontrada.")
+        else:
+            print("\n ---MINHAS NOTAS---") # exibe o titulo na tela
+            for nota in notas: # percorre o array notas
+                print(f"ID: {nota['id']} | Nome: {nota['nome']}")
+                print("-" * 20)
+        exibir_rodape() #exibe o rodapé
+        sys.exit() # fecha o programa
+
+    # ======== COMANDO DELETE
+    if comando == 'delete': # se o comando for delete
+        if len(sys.argv) < 3:
+            print("Uso correto: n delete <id>") # mensagem de instrução caso o numero de argumentos for menor que 3
+            sys.exit(1)
+
+        id_apagar = int(sys.argv[2]) # pega o terceiro item digitado
+        notas_filtradas = [nota for nota in notas if nota['id'] != id_apagar] # filtra o array notas
+
+        if len(notas_filtradas) == len(notas): # se o tamanho do array não mudou (nada foi apagado)
+            print("Nenhuma nota encontrada com o ID fornecido.") # exibe msg
+        else:
+            with open(ARQUIVO_JSON, 'w', encoding='utf-8') as arquivo: # abre o arquivo notas.json em modo escrita
+                json.dump(notas_filtradas, arquivo, ensure_ascii=False, indent=4) # salva o array notas_filtradas no arquivo notas.json
+            print(f"Nota com o ID {id_apagar} removida com sucesso!") # mensagem de sucesso
+        exibir_rodape()
+        sys.exit()
+
+    # =========== COMANDO ADD
+    if comando == 'add': # se o comando for add
+        if len(sys.argv) < 3: # se o numero de argumentos for menor que 3
+            print("Uso correto: n add <nome_da_nota> [texto_opcional]")
+            sys.exit(1)
+
+        nome_nota = sys.argv[2] # pega o terceiro item digitado
+        caminho_txt = os.path.join(PASTA_DADOS, f"{nome_nota}.txt") # define caminho dentro da pasta de dados
+
+        nova_nota = { # cria um novo dicionario
+            "id": len(notas) + 1, # verifica o tamanho do array notas e adiciona 1 para o proximo id
+            "nome": nome_nota
+        }
+
+        notas.append(nova_nota) #adiciona o dicionario nova_nota ao array notas
+
+        with open(ARQUIVO_JSON, 'w', encoding='utf-8') as arquivo: # abre o notas.json em modo escrita
+            json.dump(notas, arquivo, ensure_ascii=False, indent=4) # salva o array notas no arquivo notas.json
+
+        print(f"A nota '{nome_nota}' foi registrada no notasCLI!") # exibe msg de sucesso
+
+        if not os.path.exists(caminho_txt): # se o arquivo não existir, cria um novo com um título dentro
+            with open(caminho_txt, 'w', encoding='utf-8') as f:
+                f.write(f"--- {nome_nota.upper()} ---\n\n")
+
+        abrir_editor(caminho_txt) # abre o arquivo no vim
+        sys.exit() # fecha o programa
+
+    # =========== COMANDO PARA ABRIR PELO NOME
+    caminho_txt = os.path.join(PASTA_DADOS, f"{comando}.txt") # define caminho dentro da pasta de dados
+
+    if os.path.exists(caminho_txt):
+        abrir_editor(caminho_txt)
+    else:
+        print(f"Nota '{comando}' não encontrada.")
+        sys.exit(1) # fecha o programa
+
+if __name__ == '__main__': #verifica se o script esta sendo executado diretamente
+    main() # chama a funcao principal