Awesome GitHub RepositoriesPython Code Formatters

YAPF este un instrument de formatare a codului Python și de conformitate cu stilul. Acesta operează ca un reformator bazat pe AST care utilizează arbori de sintaxă concreți pentru a asigura consistența structurală și o prezentare vizuală uniformă în fișierele sursă. Motorul utilizează un optimizator de layout bazat pe penalități pentru a determina cele mai bune întreruperi de linie prin calcularea costurilor numerice pentru diferite alegeri de formatare. Utilizează un procesor de cod multi-proces pentru a distribui formatarea mai multor fișiere pe mai multe nuclee CPU. Instrumentul acoperă reformatarea codului sursă prin modificări in-place ale fișierelor, analiza diferențelor și procesarea fragmentelor de cod parțiale. Include un sistem de configurare bazat pe reguli pentru gestionarea presetărilor de stil, regulilor de layout și setărilor la nivel de proiect. Capabilitățile de integrare includ verificarea conformității stilului pentru pipeline-uri de integrare continuă, automatizarea git hook-urilor și funcționalitatea de format-on-save bazată pe editor.

Spotless este un orchestrator de formatare multi-limbaj și plugin Gradle care automatizează stilizarea codului în diverse limbaje de programare într-un singur pipeline de build. Funcționează ca un coordonator pentru mai multe formatatoare terțe, un instrument de linting pentru stilul codului și un sistem pentru inserarea și actualizarea antetelor de licență standardizate. Proiectul se distinge prin aplicarea stilului integrată cu git, utilizând pre-push hooks și referințe git pentru a aplica formatarea doar fișierelor sau liniilor modificate. Suportă configurații de build partajate, permițând distribuirea și încărcarea regulilor de formatare în mai multe proiecte prin artefacte remote pentru a menține o singură sursă de adevăr. Instrumentul acoperă o gamă largă de capabilități, inclusiv transformarea textului codului sursă prin expresii regulate și patch-uri JSON, gestionarea importurilor și standardizarea spațiilor albe. Se integrează cu o gamă largă de binare și instrumente externe pentru limbaje precum Java, Python, Kotlin, C++, Go și TypeScript. Funcționalitatea suplimentară include verificarea formatării pentru a asigura idempotența și optimizarea incrementală pentru a omite fișierele neschimbate.

Acest proiect este o colecție cuprinzătoare de materiale educaționale de programare Python, incluzând tutoriale, exerciții și mostre de cod curate. Acesta servește drept curriculum de învățare și set de instrumente de inginerie software, utilizând Jupyter Notebooks pentru a combina codul executabil cu text educațional descriptiv. Repository-ul oferă ghiduri practice de implementare pentru construirea de aplicații cu modele de limbaj mari, cum ar fi sisteme de generare augmentată prin regăsire (RAG), agenți AI cu stare și fluxuri de lucru de machine learning. Se distinge prin oferirea unei abordări structurate a fluxurilor de lucru de codare agentică, acoperind distilarea ferestrei de context, rutarea modelelor agnostice la furnizor și output-uri structurate impuse prin schemă. Materialele acoperă o gamă largă de capabilități de inginerie software, inclusiv programarea asincronă cu cozi de sarcini distribuite, dezvoltarea de aplicații web cu API-uri REST și fluxuri de lucru de analiză a datelor. Include, de asemenea, resurse pentru stăpânirea designului orientat pe obiecte, implementarea pipeline-urilor CI/CD și aplicarea standardelor profesionale de linting și formatare.

autopep8 is a Python static code styler and formatter designed to automatically rewrite source code to comply with the PEP 8 style guide. It functions as a recursive code cleaner that identifies and fixes indentation, whitespace, and syntax irregularities across entire projects. The tool performs structural refactoring using abstract syntax tree transformations to execute non-whitespace changes, such as shortening long lines and improving identity tests. It includes an aggressive refactoring mode for complex style violations and supports selective formatting via inline markers to disable chan

Proselint este un linter de proză și un analizor de text bazat pe reguli, conceput pentru a identifica erori stilistice, clișee și jargon în textele scrise. Acesta scanează documentele comparându-le cu un registru curat de reguli lingvistice și tipografice pentru a menține standarde editoriale profesionale și a îmbunătăți calitatea scrierii. Proiectul funcționează ca un procesor de text pentru linia de comandă, o bibliotecă de analiză programabilă și un hook de pre-commit pentru git. Arhitectura sa modulară permite motorului principal să fie integrat în alte aplicații, expus printr-un API REST sau integrat în editoare de text. Instrumentul suportă parcurgerea recursivă a directoarelor pentru analiză în lot și acceptă text prin input standard pentru utilizarea în pipeline-uri de linie de comandă. Oferă opțiuni de configurare pentru a activa sau dezactiva verificări lingvistice specifice și poate exporta rezultatele diagnosticului în format JSON structurat.

doctoc este un generator de cuprins (table of contents) markdown și un procesor de fișiere conceput pentru a crea și actualiza automat liste de link-uri către titluri în documentele markdown. Funcționează ca un instrument de documentare pentru repository-uri git care scanează directoarele locale pentru a se asigura că navigarea rămâne consistentă într-o colecție de fișiere. Instrumentul dispune de un generator de ancore compatibil cu GitHub care formatează link-urile titlurilor pentru a se potrivi cerințelor specifice ale GitHub și ale platformelor de găzduire similare. Gestionează actualizările prin localizarea comentariilor de marcare pentru a înlocui tabelele de cuprins existente fără a suprascrie alt conținut al documentului. Proiectul acoperă procesarea recursivă a directoarelor, ceea ce îi permite să scaneze foldere imbricate și să aplice actualizări tuturor fișierelor compatibile. Include, de asemenea, filtrarea conținutului și controlul intrărilor pentru a exclude titluri sau fișiere specifice pe baza nivelurilor de imbricare sau a tag-urilor de metadate. Un utilitar de validare a consistenței permite instrumentului să verifice dacă fișierele sunt învechite fără a le modifica, facilitând integrarea în fluxurile de lucru de documentare automatizate.

This project is a Python library and command-line tool designed to convert Markdown text and files into structured HTML fragments. It functions as a Markdown-to-HTML converter and parser that transforms piped text or source files into web-ready documents. The project is an extensible text processor featuring a pluggable API for defining custom inline and block syntax. This modular framework allows for the registration of specialized syntax extensions, such as tables and footnotes, and provides a system for managing runtime configuration settings. The conversion process covers multilingual te