Positron Documentation

repository·main·Indexed 26 days ago

https://github.com/posit-dev/positron

Positron is a next-generation, extensible, polyglot data science IDE built by Posit PBC for writing code, exploring data, and reproducible authoring. This documentation provides guides for setting up local testing and development environments, including ARM64 local testing, Connect-Local for e2e testing, and JupyterHub integration using Docker and The Littlest JupyterHub (TLJH).

Tokens
164.8K
Snippets
217
Records
910
Agent score
88%

What's inside Positron

  1. Overview of Dev Containers Reference Implementation

    main
    The Dev Containers Reference Implementation provides a way to use the MIT-licensed Dev Containers specification within Positron. It is adapted from the official devcontainers/cli to ensure compatibility with the Positron environment. A key architectural difference is that Docker or Podman commands are executed within Positron terminals rather than being run directly as child processes.
  2. Overview of Microsoft Authentication extension

    main

    This extension provides authentication support for Microsoft services. It registers the microsoft Authentication Provider, which can be utilized by other extensions, and powers the Microsoft authentication used by Settings Sync. It also includes support for sovereign clouds (e.g., Azure China, Azure US Government) via the microsoft-sovereign-cloud Authentication Provider.

    Note: This extension is bundled with the editor; it can be disabled but cannot be uninstalled.

  3. Overview of Positron CI Docker Images

    main

    Positron provides Docker images designed for continuous integration (CI) in GitHub Actions and for local development to mimic CI environments. These images provide consistent testing environments across AMD64 and ARM64 architectures and include:

    • Build dependencies
    • R and Python installations (including packages for test/e2e/test-files)
    • Runtime dependencies like Quarto
    • The Positron license server
    • Fluxbox and x11vnc for viewing running tests locally

    Available environments:

    • ubuntu24_04/: Ubuntu 24.04 configurations.
    • rocky_8/: Rocky 8 configurations.
  4. Overview of the autocomplete-parser project

    main
    The autocomplete-parser project is a fork of the autocomplete-parser from the Amazon Q Developer CLI and autocomplete-tools from Fig. It is designed to provide smart command parsing for terminal autocomplete. This specific version is optimized for Positron by providing a version that is compatible with non-ESM environments and includes the critical parseArguments function for parsing Fig commands, while stripping out implementation-specific logic like IPC, settings, and fuzzy sorting.
  5. Overview of CopilotChatSessionsProvider

    main

    The CopilotChatSessionsProvider is the default sessions provider in Positron, registered with the ID 'default-copilot'. It wraps existing agent session infrastructure into an extensible provider model. It supports three distinct session types:

    1. Copilot CLI: Local sessions for file:// workspaces.
    2. Copilot Cloud: Remote sessions for github-remote-file:// workspaces.
    3. Claude: Local sessions for file:// workspaces, gated by the sessions.chat.claudeAgent.enabled setting (defaults to true).