genetinav 0.1.0__tar.gz

genetinav-0.1.0/.gitignore

@@ -0,0 +1,39 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+*.pyc
+
+# pytest cache
+.pytest_cache/
+
+# Distribution / packaging
+*.egg-info/
+build/
+dist/
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# Databases
+*.db
+*.sqlite3
+
+# OS artefacts
+.DS_Store
+Thumbs.db
+
+# Editor / IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Coverage reports
+.coverage
+htmlcov/

genetinav-0.1.0/LICENSE

@@ -0,0 +1,65 @@
+Custom Source-Available License 1.0
+
+Copyright (c) 2026 BIOWESS
+
+All rights reserved except as expressly permitted below.
+
+1. Permission Granted
+
+You are permitted to:
+
+- View and study the source code.
+- Clone and download the repository.
+- Run the software locally for personal or educational use.
+- Modify the source code for personal learning purposes.
+- Share snippets or modified versions for non-commercial educational purposes,
+  provided proper credit is clearly given to the original author.
+
+2. Restrictions
+
+You may NOT, without prior written permission from the copyright holder:
+
+- Sell this software or any modified version of it.
+- Use this software in a commercial product or service.
+- Offer this software as a paid SaaS, hosted platform, or subscription service.
+- Rebrand, sublicense, or redistribute this software while claiming it as your own work.
+- Remove copyright notices, attribution, or license text.
+- Use substantial portions of this software in commercial projects.
+- Create commercial derivatives based primarily on this project.
+
+3. Attribution Requirement
+
+Any public use, fork, modification, or redistribution of this project or its
+derivatives must include visible credit to the original author.
+
+Example attribution:
+
+"Based on genetinav by BIOWESS"
+
+4. Ownership
+
+The software and all associated intellectual property remain the exclusive
+property of the copyright holder.
+
+This license does not transfer ownership of the software or grant any trademark rights.
+
+5. Contributions
+
+Unless explicitly stated otherwise, any contributions submitted to this project
+may be incorporated into the project under this same license.
+
+6. Warranty Disclaimer
+
+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 NON-INFRINGEMENT.
+
+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.
+
+7. Acceptance
+
+By cloning, downloading, using, or modifying this software, you agree to the
+terms of this license.

genetinav-0.1.0/PKG-INFO

@@ -0,0 +1,311 @@
+Metadata-Version: 2.4
+Name: genetinav
+Version: 0.1.0
+Summary: GenetiNav — navigational genomics toolkit
+Project-URL: Homepage, https://github.com/biowess/genetinav
+Project-URL: Documentation, https://github.com/biowess/genetinav#readme
+Project-URL: Repository, https://github.com/biowess/genetinav
+Project-URL: Bug Tracker, https://github.com/biowess/genetinav/issues
+License: Custom Source-Available License 1.0
+        
+        Copyright (c) 2026 BIOWESS
+        
+        All rights reserved except as expressly permitted below.
+        
+        1. Permission Granted
+        
+        You are permitted to:
+        
+        - View and study the source code.
+        - Clone and download the repository.
+        - Run the software locally for personal or educational use.
+        - Modify the source code for personal learning purposes.
+        - Share snippets or modified versions for non-commercial educational purposes,
+          provided proper credit is clearly given to the original author.
+        
+        2. Restrictions
+        
+        You may NOT, without prior written permission from the copyright holder:
+        
+        - Sell this software or any modified version of it.
+        - Use this software in a commercial product or service.
+        - Offer this software as a paid SaaS, hosted platform, or subscription service.
+        - Rebrand, sublicense, or redistribute this software while claiming it as your own work.
+        - Remove copyright notices, attribution, or license text.
+        - Use substantial portions of this software in commercial projects.
+        - Create commercial derivatives based primarily on this project.
+        
+        3. Attribution Requirement
+        
+        Any public use, fork, modification, or redistribution of this project or its
+        derivatives must include visible credit to the original author.
+        
+        Example attribution:
+        
+        "Based on genetinav by BIOWESS"
+        
+        4. Ownership
+        
+        The software and all associated intellectual property remain the exclusive
+        property of the copyright holder.
+        
+        This license does not transfer ownership of the software or grant any trademark rights.
+        
+        5. Contributions
+        
+        Unless explicitly stated otherwise, any contributions submitted to this project
+        may be incorporated into the project under this same license.
+        
+        6. Warranty Disclaimer
+        
+        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 NON-INFRINGEMENT.
+        
+        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.
+        
+        7. Acceptance
+        
+        By cloning, downloading, using, or modifying this software, you agree to the
+        terms of this license.
+License-File: LICENSE
+Keywords: bioinformatics,cli,ensembl,genomics,terminal
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: Other/Proprietary License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
+Classifier: Topic :: Terminals
+Requires-Python: >=3.10
+Requires-Dist: httpx
+Requires-Dist: textual
+Requires-Dist: typer
+Description-Content-Type: text/markdown
+
+A terminal-based genomics toolkit for gene lookup, DNA sequence exploration, and genomic coordinate navigation.
+Built with Textual and Typer, powered by the public Ensembl REST API.
+
+Type a gene symbol to retrieve its metadata, then drop into a colour-coded, scrollable sequence viewer with motif search, reverse-complement display, and live gene-boundary detection — all from your terminal.
+
+## Features
+
+- **Gene lookup** – resolve gene symbols via the Ensembl REST API (human, mouse, rat, zebrafish)
+- **Interactive sequence viewer** – scrollable, colour-coded nucleotide track with coordinate ruler, GC-content sparkline, minimap, and stats footer
+- **Rich navigation** – base-by-base and page-by-page scrolling, jump-to-coordinate or gene, motif search with next/prev match, zoom, and back/forward history
+- **Reverse-complement toggle** – flip the display in place without losing position
+- **Dynamic gene-boundary detection** – the viewer automatically relabels itself as you scroll across gene/intergenic boundaries
+- **Search history** – automatically recorded, capped at 200 entries, browsable and re-openable
+- **Favourites** – bookmark genes for quick future access
+- **Theming** – 10 built-in dark colour themes, each with its own DNA base-colour palette
+- **Local caching** – SQLite-backed response cache plus an in-memory chunked sequence cache with background prefetching
+- **Export** – Markdown, JSON, or FASTA (genomic / transcript / CDS) export of the current gene
+- **Open in Ensembl** – jump straight to the gene’s Ensembl page in your browser
+- **Command palette** – fuzzy-filterable command search, global and viewer-aware
+- **Performance mode** – disable animations for a snappier or headless-friendly session
+- **Configurable** – all preferences stored in `~/.genetinav/settings.json`
+
+## Installation
+
+GenetiNav requires Python 3.10+.
+
+Install from PyPI using pip:
+
+```bash
+pip install genetinav
+```
+
+If you prefer an isolated, globally available installation, use pipx:
+
+```bash
+pipx install genetinav
+```
+
+After installation, the `genetinav` command will be available in your terminal.
+
+## Usage
+
+Launch the interactive TUI:
+
+```bash
+genetinav
+```
+
+Opens the home screen with a search bar. Type a gene symbol and press Enter, or use a `/command` to navigate directly.
+
+Quick gene lookup:
+
+```bash
+genetinav BRCA1
+genetinav brca2
+```
+
+Performs an immediate lookup inside the TUI.
+
+### Subcommands
+
+| Command                  | Description                              |
+|--------------------------|------------------------------------------|
+| `genetinav search <GENE>`| Launch the TUI and look up `<GENE>`      |
+| `genetinav settings`     | Open the Settings screen directly        |
+
+### Flags
+
+| Flag                 | Description                                               |
+|----------------------|-----------------------------------------------------------|
+| `--version`          | Print the version string and exit                         |
+| `--no-animation`     | Disable animations / enable performance mode              |
+| `--theme <NAME>`     | Override the active colour theme for this session         |
+| `--species <NAME>`   | Override the default species for this session             |
+| `--clear-cache`      | Clear the local gene/sequence response cache and exit     |
+| `--clear-history`    | Clear the search history and exit                         |
+
+```bash
+# Quick lookup with a specific theme
+genetinav BRCA1 --theme midnight_genome
+
+# Disable animations and set default species to mouse
+genetinav --no-animation --species mouse
+
+# Clear cached data
+genetinav --clear-cache
+genetinav --clear-history
+```
+
+### In-app navigation
+
+From the home screen, type a gene symbol or a slash command:
+
+| Command       | Action                           |
+|---------------|----------------------------------|
+| `/settings`   | Open Settings                    |
+| `/help`       | Show keybinding reference        |
+| `/about`      | About GenetiNav (and license)    |
+| `/history`    | View search history              |
+| `/recent`     | View search history              |
+| `/favorites`  | View saved favourites            |
+| `/themes`     | List available colour themes     |
+| `/theme`      | Prompt to switch active theme    |
+
+### Result screen keys
+
+| Key   | Action                                     |
+|-------|--------------------------------------------|
+| `o`   | Open the sequence viewer                   |
+| `v`   | Toggle favourite                           |
+| `c`   | Show / copy genomic coordinates            |
+| `n`   | Start a new search                         |
+| `m`   | Open the menu (Export, Open in Ensembl)    |
+| `q` / `Esc` | Back to home                        |
+
+### Sequence viewer keys
+
+| Key                | Action                                              |
+|--------------------|-----------------------------------------------------|
+| `←` / `→`          | Scroll 1 base pair                                  |
+| `↑` / `↓`, `PgUp` / `PgDn` | Scroll one full window                   |
+| `Home` / `End`     | Jump to sequence start / end                        |
+| `g`                | Go to a coordinate (e.g. `chr9:5057799`) or gene    |
+| `/`                | Search for a DNA motif                              |
+| `n` / `N`          | Next / previous match                               |
+| `c`                | Toggle reverse-complement display                   |
+| `Ctrl+G`           | Toggle the GC-content track                         |
+| `<` / `>`          | Navigate back / forward in viewer history           |
+| `+` / `-`          | Zoom window size in / out                           |
+| `Ctrl+P`           | Open the command palette                            |
+| `q` / `Esc`        | Close the viewer                                    |
+
+## Export Formats
+
+From the result screen menu (`m` → Export):
+
+| Format            | Filename                                | Contents                              |
+|-------------------|-----------------------------------------|---------------------------------------|
+| Markdown          | `{SYMBOL}_export.md`                    | Symbol, species, location, summary    |
+| JSON              | `{SYMBOL}_export.json`                  | Full GeneRecord dump                  |
+| FASTA – Genomic   | `{SYMBOL}_genomic_{timestamp}.fasta`    | The gene’s chromosomal region         |
+| FASTA – Transcript| `{SYMBOL}_transcript_{timestamp}.fasta` | Canonical transcript cDNA             |
+| FASTA – CDS       | `{SYMBOL}_cds_{timestamp}.fasta`        | Canonical CDS (falls back to cDNA)    |
+
+## Configuration
+
+Settings are stored in `~/.genetinav/settings.json` and can be edited through the in-app Settings screen (`/settings`) or directly.
+The local database lives at `~/.genetinav/genetinav.db`.
+
+| Setting               | Default           | Description                                 |
+|-----------------------|-------------------|---------------------------------------------|
+| `theme`               | `obsidian_helix`  | Active colour theme                         |
+| `history_enabled`     | `true`            | Record search history                       |
+| `cache_enabled`       | `true`            | Cache Ensembl API responses locally         |
+| `default_window_size` | `60`              | Sequence viewer window size (bases)         |
+| `default_species`     | `human`           | Default species for lookups                 |
+| `ruler_interval`      | `10`              | Spacing between ruler tick labels           |
+
+## Available Themes
+
+Ten dark, biologically-themed palettes, each defining both the UI chrome and the DNA base colours used by the sequence viewer:
+
+- obsidian_helix
+- midnight_genome
+- carbon_strand
+- void_polymer
+- deep_cell
+- nucleic_night
+- graphene_dark
+- helix_abyss
+- synthetic_strand
+- black_helix_neon
+
+List them at any time with `/themes`, or switch instantly with `/theme`.
+
+## Data Source
+
+Gene metadata and sequence data are retrieved from the Ensembl REST API (`https://rest.ensembl.org/`) using public, unauthenticated endpoints.
+GenetiNav is not affiliated with Ensembl.
+
+## Screenshots
+
+*Add screenshots or terminal recordings of GenetiNav below.*
+
+| Home Screen              | Result Screen              | Sequence Viewer              |
+|--------------------------|----------------------------|------------------------------|
+| Home screen placeholder  | Result screen placeholder  | Sequence viewer placeholder  |
+
+## Technologies
+
+| Library   | Purpose                                                |
+|-----------|--------------------------------------------------------|
+| Textual   | Terminal UI framework (screens, widgets, event loop)   |
+| Typer     | CLI argument parsing and subcommands                   |
+| httpx     | HTTP client for the Ensembl REST API                   |
+| SQLite    | Local persistence for cache, history, and favourites   |
+
+## Roadmap
+
+Potential future directions, not yet implemented:
+
+- [ ] Wire up reserved settings (high contrast, monochrome, animation toggles) to live Settings controls
+- [ ] Persist CLI `--theme` / `--species` overrides back to `settings.json`
+- [ ] Automatic retry/backoff for Ensembl API rate limiting and transient network errors
+- [ ] Configurable export destination directory
+- [ ] Disk-persisted sequence and overlap caches for faster cold starts
+- [ ] Broader species support beyond human, mouse, rat, and zebrafish
+
+## License
+
+Custom Source-Available License 1.0 – Copyright © 2026 BIOWESS.
+You may view, clone, run, and modify this software for personal or educational use, and share non-commercial educational derivatives with attribution. Commercial use, resale, rebranding, or hosting as a paid service is not permitted without prior written permission. See [LICENSE](https://github.com/biowess/genetinav/blob/main/LICENSE) for the full terms.
+
+## Credits & Acknowledgements
+
+Gene and sequence data courtesy of the Ensembl project.
+Built with Textual and Typer by Textualize.
+Nucleotide colour convention inspired by IGV and the UCSC Genome Browser.

genetinav-0.1.0/README.md

@@ -0,0 +1,218 @@
+A terminal-based genomics toolkit for gene lookup, DNA sequence exploration, and genomic coordinate navigation.
+Built with Textual and Typer, powered by the public Ensembl REST API.
+
+Type a gene symbol to retrieve its metadata, then drop into a colour-coded, scrollable sequence viewer with motif search, reverse-complement display, and live gene-boundary detection — all from your terminal.
+
+## Features
+
+- **Gene lookup** – resolve gene symbols via the Ensembl REST API (human, mouse, rat, zebrafish)
+- **Interactive sequence viewer** – scrollable, colour-coded nucleotide track with coordinate ruler, GC-content sparkline, minimap, and stats footer
+- **Rich navigation** – base-by-base and page-by-page scrolling, jump-to-coordinate or gene, motif search with next/prev match, zoom, and back/forward history
+- **Reverse-complement toggle** – flip the display in place without losing position
+- **Dynamic gene-boundary detection** – the viewer automatically relabels itself as you scroll across gene/intergenic boundaries
+- **Search history** – automatically recorded, capped at 200 entries, browsable and re-openable
+- **Favourites** – bookmark genes for quick future access
+- **Theming** – 10 built-in dark colour themes, each with its own DNA base-colour palette
+- **Local caching** – SQLite-backed response cache plus an in-memory chunked sequence cache with background prefetching
+- **Export** – Markdown, JSON, or FASTA (genomic / transcript / CDS) export of the current gene
+- **Open in Ensembl** – jump straight to the gene’s Ensembl page in your browser
+- **Command palette** – fuzzy-filterable command search, global and viewer-aware
+- **Performance mode** – disable animations for a snappier or headless-friendly session
+- **Configurable** – all preferences stored in `~/.genetinav/settings.json`
+
+## Installation
+
+GenetiNav requires Python 3.10+.
+
+Install from PyPI using pip:
+
+```bash
+pip install genetinav
+```
+
+If you prefer an isolated, globally available installation, use pipx:
+
+```bash
+pipx install genetinav
+```
+
+After installation, the `genetinav` command will be available in your terminal.
+
+## Usage
+
+Launch the interactive TUI:
+
+```bash
+genetinav
+```
+
+Opens the home screen with a search bar. Type a gene symbol and press Enter, or use a `/command` to navigate directly.
+
+Quick gene lookup:
+
+```bash
+genetinav BRCA1
+genetinav brca2
+```
+
+Performs an immediate lookup inside the TUI.
+
+### Subcommands
+
+| Command                  | Description                              |
+|--------------------------|------------------------------------------|
+| `genetinav search <GENE>`| Launch the TUI and look up `<GENE>`      |
+| `genetinav settings`     | Open the Settings screen directly        |
+
+### Flags
+
+| Flag                 | Description                                               |
+|----------------------|-----------------------------------------------------------|
+| `--version`          | Print the version string and exit                         |
+| `--no-animation`     | Disable animations / enable performance mode              |
+| `--theme <NAME>`     | Override the active colour theme for this session         |
+| `--species <NAME>`   | Override the default species for this session             |
+| `--clear-cache`      | Clear the local gene/sequence response cache and exit     |
+| `--clear-history`    | Clear the search history and exit                         |
+
+```bash
+# Quick lookup with a specific theme
+genetinav BRCA1 --theme midnight_genome
+
+# Disable animations and set default species to mouse
+genetinav --no-animation --species mouse
+
+# Clear cached data
+genetinav --clear-cache
+genetinav --clear-history
+```
+
+### In-app navigation
+
+From the home screen, type a gene symbol or a slash command:
+
+| Command       | Action                           |
+|---------------|----------------------------------|
+| `/settings`   | Open Settings                    |
+| `/help`       | Show keybinding reference        |
+| `/about`      | About GenetiNav (and license)    |
+| `/history`    | View search history              |
+| `/recent`     | View search history              |
+| `/favorites`  | View saved favourites            |
+| `/themes`     | List available colour themes     |
+| `/theme`      | Prompt to switch active theme    |
+
+### Result screen keys
+
+| Key   | Action                                     |
+|-------|--------------------------------------------|
+| `o`   | Open the sequence viewer                   |
+| `v`   | Toggle favourite                           |
+| `c`   | Show / copy genomic coordinates            |
+| `n`   | Start a new search                         |
+| `m`   | Open the menu (Export, Open in Ensembl)    |
+| `q` / `Esc` | Back to home                        |
+
+### Sequence viewer keys
+
+| Key                | Action                                              |
+|--------------------|-----------------------------------------------------|
+| `←` / `→`          | Scroll 1 base pair                                  |
+| `↑` / `↓`, `PgUp` / `PgDn` | Scroll one full window                   |
+| `Home` / `End`     | Jump to sequence start / end                        |
+| `g`                | Go to a coordinate (e.g. `chr9:5057799`) or gene    |
+| `/`                | Search for a DNA motif                              |
+| `n` / `N`          | Next / previous match                               |
+| `c`                | Toggle reverse-complement display                   |
+| `Ctrl+G`           | Toggle the GC-content track                         |
+| `<` / `>`          | Navigate back / forward in viewer history           |
+| `+` / `-`          | Zoom window size in / out                           |
+| `Ctrl+P`           | Open the command palette                            |
+| `q` / `Esc`        | Close the viewer                                    |
+
+## Export Formats
+
+From the result screen menu (`m` → Export):
+
+| Format            | Filename                                | Contents                              |
+|-------------------|-----------------------------------------|---------------------------------------|
+| Markdown          | `{SYMBOL}_export.md`                    | Symbol, species, location, summary    |
+| JSON              | `{SYMBOL}_export.json`                  | Full GeneRecord dump                  |
+| FASTA – Genomic   | `{SYMBOL}_genomic_{timestamp}.fasta`    | The gene’s chromosomal region         |
+| FASTA – Transcript| `{SYMBOL}_transcript_{timestamp}.fasta` | Canonical transcript cDNA             |
+| FASTA – CDS       | `{SYMBOL}_cds_{timestamp}.fasta`        | Canonical CDS (falls back to cDNA)    |
+
+## Configuration
+
+Settings are stored in `~/.genetinav/settings.json` and can be edited through the in-app Settings screen (`/settings`) or directly.
+The local database lives at `~/.genetinav/genetinav.db`.
+
+| Setting               | Default           | Description                                 |
+|-----------------------|-------------------|---------------------------------------------|
+| `theme`               | `obsidian_helix`  | Active colour theme                         |
+| `history_enabled`     | `true`            | Record search history                       |
+| `cache_enabled`       | `true`            | Cache Ensembl API responses locally         |
+| `default_window_size` | `60`              | Sequence viewer window size (bases)         |
+| `default_species`     | `human`           | Default species for lookups                 |
+| `ruler_interval`      | `10`              | Spacing between ruler tick labels           |
+
+## Available Themes
+
+Ten dark, biologically-themed palettes, each defining both the UI chrome and the DNA base colours used by the sequence viewer:
+
+- obsidian_helix
+- midnight_genome
+- carbon_strand
+- void_polymer
+- deep_cell
+- nucleic_night
+- graphene_dark
+- helix_abyss
+- synthetic_strand
+- black_helix_neon
+
+List them at any time with `/themes`, or switch instantly with `/theme`.
+
+## Data Source
+
+Gene metadata and sequence data are retrieved from the Ensembl REST API (`https://rest.ensembl.org/`) using public, unauthenticated endpoints.
+GenetiNav is not affiliated with Ensembl.
+
+## Screenshots
+
+*Add screenshots or terminal recordings of GenetiNav below.*
+
+| Home Screen              | Result Screen              | Sequence Viewer              |
+|--------------------------|----------------------------|------------------------------|
+| Home screen placeholder  | Result screen placeholder  | Sequence viewer placeholder  |
+
+## Technologies
+
+| Library   | Purpose                                                |
+|-----------|--------------------------------------------------------|
+| Textual   | Terminal UI framework (screens, widgets, event loop)   |
+| Typer     | CLI argument parsing and subcommands                   |
+| httpx     | HTTP client for the Ensembl REST API                   |
+| SQLite    | Local persistence for cache, history, and favourites   |
+
+## Roadmap
+
+Potential future directions, not yet implemented:
+
+- [ ] Wire up reserved settings (high contrast, monochrome, animation toggles) to live Settings controls
+- [ ] Persist CLI `--theme` / `--species` overrides back to `settings.json`
+- [ ] Automatic retry/backoff for Ensembl API rate limiting and transient network errors
+- [ ] Configurable export destination directory
+- [ ] Disk-persisted sequence and overlap caches for faster cold starts
+- [ ] Broader species support beyond human, mouse, rat, and zebrafish
+
+## License
+
+Custom Source-Available License 1.0 – Copyright © 2026 BIOWESS.
+You may view, clone, run, and modify this software for personal or educational use, and share non-commercial educational derivatives with attribution. Commercial use, resale, rebranding, or hosting as a paid service is not permitted without prior written permission. See [LICENSE](https://github.com/biowess/genetinav/blob/main/LICENSE) for the full terms.
+
+## Credits & Acknowledgements
+
+Gene and sequence data courtesy of the Ensembl project.
+Built with Textual and Typer by Textualize.
+Nucleotide colour convention inspired by IGV and the UCSC Genome Browser.

genetinav-0.1.0/pyproject.toml

@@ -0,0 +1,51 @@
+[project]
+name = "genetinav"
+version = "0.1.0"
+description = "GenetiNav — navigational genomics toolkit"
+requires-python = ">=3.10"
+license = { file = "LICENSE" }
+readme = "README.md"
+keywords = ["genomics", "bioinformatics", "terminal", "cli", "ensembl"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Science/Research",
+    "License :: Other/Proprietary License",
+    "Natural Language :: English",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Bio-Informatics",
+    "Topic :: Terminals",
+]
+dependencies = [
+    "typer",
+    "httpx",
+    "textual",
+]
+
+[project.urls]
+Homepage = "https://github.com/biowess/genetinav"
+Documentation = "https://github.com/biowess/genetinav#readme"
+Repository = "https://github.com/biowess/genetinav"
+"Bug Tracker" = "https://github.com/biowess/genetinav/issues"
+
+[project.scripts]
+genetinav = "genetinav.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/genetinav"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/",
+    "README.md",
+    "LICENSE",
+    "pyproject.toml",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

genetinav-0.1.0/src/genetinav/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"