fillmyfile 0.1.0__tar.gz

fillmyfile-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Vishnu. Made with Python.
+
+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.
+

fillmyfile-0.1.0/PKG-INFO

@@ -0,0 +1,116 @@
+Metadata-Version: 2.4
+Name: fillmyfile
+Version: 0.1.0
+Summary: Offline developer snippet and project engine
+Author: Vishnu
+License: MIT
+Keywords: snippets,templates,cli,tui,developer-tools
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click
+Requires-Dist: rich
+Requires-Dist: jinja2
+Requires-Dist: rapidfuzz
+Requires-Dist: pyperclip
+Requires-Dist: textual
+Requires-Dist: platformdirs
+Dynamic: license-file
+
+# FillMyFile
+
+FillMyFile is an offline snippet and project-template manager for developers.
+It lets you save reusable code snippets, create projects from local templates,
+search them from the CLI or TUI, and share libraries as zip packs.
+
+## Install
+
+```bash
+pip install fillmyfile
+```
+
+For local development:
+
+```bash
+pip install -e .
+```
+
+## Quick Start
+
+```bash
+fillmyfile init
+fillmyfile list
+fillmyfile search logger
+fillmyfile use logger ./scratch.py
+```
+
+## Add Your Own Snippets
+
+```bash
+fillmyfile add snippet click-command ./command.py \
+  --description "Click command skeleton" \
+  --category python \
+  --tags cli,click
+```
+
+Project templates work the same way:
+
+```bash
+fillmyfile add project fastapi-service ./my-fastapi-folder \
+  --description "FastAPI service starter" \
+  --category web \
+  --tags fastapi,api
+```
+
+## Share Packs
+
+Install a pack folder:
+
+```bash
+fillmyfile pack install ./my-pack
+```
+
+Export your local library:
+
+```bash
+fillmyfile pack export my-team-pack
+```
+
+## Useful Commands
+
+```bash
+fillmyfile init
+fillmyfile list --type snippet
+fillmyfile list --type project
+fillmyfile search auth
+fillmyfile dbsearch api
+fillmyfile info logger
+fillmyfile use logger ./app.py
+fillmyfile create click-cli-app my-tool
+fillmyfile export logger
+fillmyfile import ./logger.zip
+fillmyfile tui ./app.py
+```
+
+## Where Data Lives
+
+FillMyFile keeps user snippets, projects, packs, and its SQLite index in the
+operating system's user data directory. The installed Python package stays
+read-only and safe to upgrade.
+
+## License & Credits
+
+© 2026 Vishnu. Made with Python.  
+Licensed under the [MIT License](LICENSE).
+

fillmyfile-0.1.0/README.md

@@ -0,0 +1,86 @@
+# FillMyFile
+
+FillMyFile is an offline snippet and project-template manager for developers.
+It lets you save reusable code snippets, create projects from local templates,
+search them from the CLI or TUI, and share libraries as zip packs.
+
+## Install
+
+```bash
+pip install fillmyfile
+```
+
+For local development:
+
+```bash
+pip install -e .
+```
+
+## Quick Start
+
+```bash
+fillmyfile init
+fillmyfile list
+fillmyfile search logger
+fillmyfile use logger ./scratch.py
+```
+
+## Add Your Own Snippets
+
+```bash
+fillmyfile add snippet click-command ./command.py \
+  --description "Click command skeleton" \
+  --category python \
+  --tags cli,click
+```
+
+Project templates work the same way:
+
+```bash
+fillmyfile add project fastapi-service ./my-fastapi-folder \
+  --description "FastAPI service starter" \
+  --category web \
+  --tags fastapi,api
+```
+
+## Share Packs
+
+Install a pack folder:
+
+```bash
+fillmyfile pack install ./my-pack
+```
+
+Export your local library:
+
+```bash
+fillmyfile pack export my-team-pack
+```
+
+## Useful Commands
+
+```bash
+fillmyfile init
+fillmyfile list --type snippet
+fillmyfile list --type project
+fillmyfile search auth
+fillmyfile dbsearch api
+fillmyfile info logger
+fillmyfile use logger ./app.py
+fillmyfile create click-cli-app my-tool
+fillmyfile export logger
+fillmyfile import ./logger.zip
+fillmyfile tui ./app.py
+```
+
+## Where Data Lives
+
+FillMyFile keeps user snippets, projects, packs, and its SQLite index in the
+operating system's user data directory. The installed Python package stays
+read-only and safe to upgrade.
+
+## License & Credits
+
+© 2026 Vishnu. Made with Python.  
+Licensed under the [MIT License](LICENSE).
+

fillmyfile-0.1.0/fillmyfile/__init__.py

@@ -0,0 +1,8 @@
+"""FillMyFile - Offline developer snippet and project engine.
+
+© 2026 Vishnu. Made with Python.
+"""
+
+__version__ = "0.1.0"
+__author__ = "Vishnu"
+__copyright__ = "© 2026 Vishnu. Made with Python."

fillmyfile-0.1.0/fillmyfile/cli/main.py

@@ -0,0 +1,429 @@
+import click
+from rich import print
+
+from fillmyfile.engine.database_engine import DatabaseEngine
+from fillmyfile.engine.db_search_engine import DBSearchEngine
+from fillmyfile.engine.favorites_engine import FavoritesEngine
+from fillmyfile.engine.file_picker import FilePicker
+from fillmyfile.engine.indexer_engine import IndexerEngine
+from fillmyfile.engine.installer import Installer
+from fillmyfile.engine.metadata_engine import MetadataEngine
+from fillmyfile.engine.pack_manager import PackManager
+from fillmyfile.engine.paths import (
+    DATA_DIR,
+    PROJECTS_DIR,
+    SNIPPETS_DIR,
+    copy_starter_templates,
+    ensure_app_dirs,
+)
+from fillmyfile.engine.project_engine import ProjectEngine
+from fillmyfile.engine.recents_engine import RecentsEngine
+from fillmyfile.engine.search_engine import SearchEngine
+from fillmyfile.engine.snippet_engine import SnippetEngine
+from fillmyfile.engine.statistics_engine import StatisticsEngine
+from fillmyfile.engine.template_creator import TemplateCreator
+from fillmyfile.engine.template_deleter import TemplateDeleter
+from fillmyfile.engine.template_editor import TemplateEditor
+from fillmyfile.engine.template_exporter import TemplateExporter
+from fillmyfile.engine.template_importer import TemplateImporter
+
+
+def bootstrap(seed=False, force_seed=False):
+    ensure_app_dirs()
+    DatabaseEngine.initialize()
+
+    library_is_empty = not any(SNIPPETS_DIR.iterdir()) and not any(
+        PROJECTS_DIR.iterdir()
+    )
+
+    if seed or library_is_empty:
+        copy_starter_templates(force_seed)
+    else:
+        copy_starter_templates(False)
+
+    IndexerEngine.rebuild_index()
+
+
+def parse_tags(tags):
+    return [
+        tag.strip()
+        for tag in tags.split(",")
+        if tag.strip()
+    ]
+
+
+@click.group()
+def cli():
+    """Offline snippet and project template manager."""
+
+
+@cli.command()
+@click.option("--force", is_flag=True, help="Overwrite bundled starter templates.")
+def init(force):
+    """Create the FillMyFile library and seed starter templates."""
+
+    bootstrap(seed=True, force_seed=force)
+    print(f"[green]FillMyFile is ready at {DATA_DIR}[/green]")
+
+
+@cli.command("list")
+@click.option(
+    "--type",
+    "template_type",
+    type=click.Choice(["snippet", "project"]),
+    default="snippet",
+)
+def list_templates(template_type):
+    """List templates in the local library."""
+
+    bootstrap()
+
+    if template_type == "snippet":
+        items = SnippetEngine.list_snippets()
+    else:
+        items = [
+            item["name"]
+            for item in MetadataEngine.load_all_metadata("project")
+        ]
+
+    print(f"\n[bold white]Available {template_type.title()}s[/bold white]\n")
+
+    for item in items:
+        print(f"- {item}")
+
+
+@cli.command()
+@click.argument("name")
+@click.argument("target")
+def use(name, target):
+    """Render a snippet into a target file."""
+
+    bootstrap()
+
+    try:
+        SnippetEngine.insert_snippet(name, target)
+        print(f"[green]Inserted '{name}' into {target}[/green]")
+    except Exception as error:
+        print(f"[red]{error}[/red]")
+
+
+@cli.command()
+@click.argument("template")
+@click.argument("project_name")
+@click.option(
+    "--install/--no-install",
+    default=False,
+    help="Install requirements.txt after creating the project.",
+)
+def create(template, project_name, install):
+    """Create a project from a saved project template."""
+
+    bootstrap()
+
+    try:
+        project_path = ProjectEngine.create_project(template, project_name)
+
+        if install:
+            Installer.install_requirements(project_path)
+
+        print(f"[green]Project '{project_name}' created at {project_path}[/green]")
+    except Exception as error:
+        print(f"[red]{error}[/red]")
+
+
+@cli.command()
+@click.argument("query")
+@click.option(
+    "--type",
+    "template_type",
+    type=click.Choice(["snippet", "project"]),
+    default=None,
+)
+def search(query, template_type):
+    """Search templates from metadata files."""
+
+    bootstrap()
+    results = SearchEngine.search(query, template_type)
+
+    print(f"\n[bold white]Results for '{query}'[/bold white]\n")
+
+    if not results:
+        print("[red]No results found[/red]")
+        return
+
+    for result in results:
+        print(f"- {result['name']} [white]({result['category']})[/white]")
+
+
+@cli.command()
+@click.argument("query")
+@click.option(
+    "--type",
+    "template_type",
+    type=click.Choice(["snippet", "project"]),
+    default=None,
+)
+def dbsearch(query, template_type):
+    """Search templates from the local SQLite index."""
+
+    bootstrap()
+    results = DBSearchEngine.search(query, template_type)
+
+    print(f"\n[bold white]Database Results for '{query}'[/bold white]\n")
+
+    if not results:
+        print("[red]No results found[/red]")
+        return
+
+    for result in results:
+        print(f"- {result['name']} [white]({result['category']})[/white]")
+
+
+@cli.command()
+@click.argument("name")
+def info(name):
+    """Show metadata for one template."""
+
+    bootstrap()
+    templates = MetadataEngine.load_all_metadata()
+
+    for template in templates:
+        if template["name"] == name:
+            print()
+            print(f"[bold white]{template['name']}[/bold white]")
+            print(f"[white]Type:[/white] {template.get('type', '')}")
+            print(f"[white]Category:[/white] {template.get('category', '')}")
+            print(f"[white]Description:[/white] {template.get('description', '')}")
+            print(f"[white]Tags:[/white] {', '.join(template.get('tags', []))}")
+            print()
+            return
+
+    print(f"[red]Template '{name}' not found[/red]")
+
+
+@cli.command()
+def index():
+    """Rebuild the SQLite template index."""
+
+    try:
+        bootstrap()
+        print("[green]Template index rebuilt successfully[/green]")
+    except Exception as error:
+        print(f"[red]{error}[/red]")
+
+
+@cli.group()
+def add():
+    """Add snippets or project templates to your library."""
+
+
+@add.command("snippet")
+@click.argument("name")
+@click.argument("source_file", required=False)
+@click.option("--description", prompt=True)
+@click.option("--category", prompt=True)
+@click.option("--tags", prompt="Tags (comma separated)", default="")
+def add_snippet(name, source_file, description, category, tags):
+    """Add a snippet from a source file."""
+
+    bootstrap()
+
+    if not source_file:
+        print("Choose snippet file...")
+        source_file = FilePicker.pick_file()
+
+    try:
+        TemplateCreator.create_snippet(
+            name,
+            source_file,
+            description,
+            category,
+            parse_tags(tags),
+        )
+        print(f"[green]Snippet '{name}' added[/green]")
+    except Exception as error:
+        print(f"[red]{error}[/red]")
+
+
+@add.command("project")
+@click.argument("name")
+@click.argument("source_folder", required=False)
+@click.option("--description", prompt=True)
+@click.option("--category", prompt=True)
+@click.option("--tags", prompt="Tags (comma separated)", default="")
+def add_project(name, source_folder, description, category, tags):
+    """Add a project template from a folder."""
+
+    bootstrap()
+
+    if not source_folder:
+        print("Choose project folder...")
+        source_folder = FilePicker.pick_folder()
+
+    try:
+        TemplateCreator.create_project(
+            name,
+            source_folder,
+            description,
+            category,
+            parse_tags(tags),
+        )
+        print(f"[green]Project template '{name}' added[/green]")
+    except Exception as error:
+        print(f"[red]{error}[/red]")
+
+
+@cli.group()
+def new():
+    """Backward-compatible alias for add."""
+
+
+new.add_command(add_snippet, "snippet")
+new.add_command(add_project, "project")
+
+
+@cli.command()
+@click.argument("name")
+def remove(name):
+    """Remove a template from the local library."""
+
+    bootstrap()
+
+    try:
+        if TemplateDeleter.delete(name):
+            print(f"[green]Removed '{name}'[/green]")
+        else:
+            print(f"[red]Template '{name}' not found[/red]")
+    except Exception as error:
+        print(f"[red]{error}[/red]")
+
+
+@cli.command()
+@click.argument("name")
+def edit(name):
+    """Open a template folder in the OS file browser."""
+
+    bootstrap()
+
+    if not TemplateEditor.edit(name):
+        print(f"[red]Template '{name}' not found[/red]")
+
+
+@cli.command("export")
+@click.argument("name")
+@click.option("--destination", default=None, help="Folder for the exported zip.")
+def export_template(name, destination):
+    """Export one template as a zip file."""
+
+    bootstrap()
+
+    try:
+        archive = TemplateExporter.export(name, destination)
+        if archive:
+            print(f"[green]Exported to {archive}[/green]")
+        else:
+            print(f"[red]Template '{name}' not found[/red]")
+    except Exception as error:
+        print(f"[red]{error}[/red]")
+
+
+@cli.command("import")
+@click.argument("zip_path")
+def import_template(zip_path):
+    """Import a template or pack zip."""
+
+    bootstrap()
+
+    try:
+        TemplateImporter.import_zip(zip_path)
+        print("[green]Import complete[/green]")
+    except Exception as error:
+        print(f"[red]{error}[/red]")
+
+
+@cli.group()
+def pack():
+    """Install or export snippet packs."""
+
+
+@pack.command("install")
+@click.argument("folder_path")
+def pack_install(folder_path):
+    """Install a pack folder containing snippets/ and/or projects/."""
+
+    bootstrap()
+
+    try:
+        PackManager.install_pack(folder_path)
+        print("[green]Pack installed[/green]")
+    except Exception as error:
+        print(f"[red]{error}[/red]")
+
+
+@pack.command("export")
+@click.argument("name", default="fillmyfile-pack")
+@click.option("--destination", default=None, help="Folder for the exported pack zip.")
+def pack_export(name, destination):
+    """Export the whole local library as a pack zip."""
+
+    bootstrap()
+
+    try:
+        archive = PackManager.export_pack(name, destination)
+        print(f"[green]Exported pack to {archive}[/green]")
+    except Exception as error:
+        print(f"[red]{error}[/red]")
+
+
+@cli.command()
+@click.argument("name")
+def favorite(name):
+    """Mark a template as a favorite."""
+
+    bootstrap()
+    FavoritesEngine.add(name)
+    FavoritesEngine.mark(name, True)
+    print(f"[green]'{name}' added to favorites[/green]")
+
+
+@cli.command()
+def recent():
+    """Show recently used snippets."""
+
+    bootstrap()
+    items = RecentsEngine.get_recent()
+
+    print("\n[bold white]Recent Templates[/bold white]\n")
+
+    for item in items:
+        print(f"- {item}")
+
+
+@cli.command()
+def top():
+    """Show most-used snippets."""
+
+    bootstrap()
+    rows = StatisticsEngine.get_top_used()
+
+    print("\n[bold white]Top Used Templates[/bold white]\n")
+
+    for row in rows:
+        print(f"- {row[0]} ({row[1]} uses)")
+
+
+@cli.command()
+@click.argument("target_file", required=False)
+def tui(target_file):
+    """Launch the terminal UI."""
+
+    bootstrap()
+
+    from fillmyfile.tui.app import FillMyFileApp
+
+    app = FillMyFileApp(target_file)
+    app.run()
+
+
+if __name__ == "__main__":
+    cli()

fillmyfile-0.1.0/fillmyfile/engine/auto_indexer.py

@@ -0,0 +1,9 @@
+from fillmyfile.engine.indexer_engine import IndexerEngine
+
+
+class AutoIndexer:
+
+    @staticmethod
+    def rebuild():
+
+        IndexerEngine.rebuild_index()

fillmyfile-0.1.0/fillmyfile/engine/category_engine.py

@@ -0,0 +1,28 @@
+from fillmyfile.engine.database_engine import DatabaseEngine
+
+
+class CategoryEngine:
+
+    @staticmethod
+    def get_categories(template_type=None):
+
+        conn = DatabaseEngine.connect()
+        cursor = conn.cursor()
+
+        cursor.execute(
+            """
+            SELECT DISTINCT category
+            FROM templates
+            WHERE (? IS NULL OR type = ?)
+            """
+            ,
+            (template_type, template_type)
+        )
+
+        rows = cursor.fetchall()
+
+        conn.close()
+
+        return sorted(
+            [row[0] for row in rows if row[0]]
+        )