dioxide 0.0.4a1__tar.gz

dioxide-0.0.4a1/.github/CODEOWNERS

@@ -0,0 +1,55 @@
+# CODEOWNERS - Defines individuals or teams responsible for code in the repository
+# https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
+
+# Default owners for everything in the repo (fallback)
+# These owners will be requested for review when someone opens a PR unless a later match takes precedence
+* @mikelane
+
+# Core container and graph implementation
+/src/core/ @mikelane
+/dioxide-core/ @mikelane
+
+# Rust implementation
+*.rs @mikelane
+/Cargo.toml @mikelane
+/Cargo.lock @mikelane
+/rust/ @mikelane
+
+# Python bindings and API
+*.py @mikelane
+/python/ @mikelane
+/pyproject.toml @mikelane
+/setup.py @mikelane
+
+# Documentation
+/docs/ @mikelane
+*.md @mikelane
+/README.md @mikelane
+/CONTRIBUTING.md @mikelane
+
+# CI/CD and infrastructure
+/.github/ @mikelane
+/.github/workflows/ @mikelane
+/Dockerfile @mikelane
+/docker-compose.yml @mikelane
+
+# Tests
+/tests/ @mikelane
+/**/tests/ @mikelane
+
+# Configuration files
+*.toml @mikelane
+*.yml @mikelane
+*.yaml @mikelane
+*.json @mikelane
+
+# Dependency files
+/requirements.txt @mikelane
+/poetry.lock @mikelane
+/package.json @mikelane
+/package-lock.json @mikelane
+/uv.lock @mikelane
+
+# Security-sensitive files
+/SECURITY.md @mikelane
+/.github/workflows/security-*.yml @mikelane

dioxide-0.0.4a1/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,116 @@
+name: Bug Report
+description: Report a bug or unexpected behavior in dioxide
+title: '[BUG] '
+labels: ['type: bug', 'status: triage']
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug! Please fill out the form below with as much detail as possible.
+
+        Before submitting, please search existing issues to avoid duplicates.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is.
+      placeholder: What went wrong?
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior
+      placeholder: |
+        1. Initialize container with '...'
+        2. Add node with '...'
+        3. Call method '...'
+        4. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: Expected Behavior
+      description: What did you expect to happen?
+      placeholder: Describe the expected outcome
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual-behavior
+    attributes:
+      label: Actual Behavior
+      description: What actually happened?
+      placeholder: Describe what actually occurred
+    validations:
+      required: true
+
+  - type: textarea
+    id: minimal-reproducible-example
+    attributes:
+      label: Minimal Reproducible Example
+      description: Provide a minimal code example that reproduces the issue
+      placeholder: |
+        ```python
+        from dioxide import Container
+
+        # Your reproducible example here
+        container = Container()
+        # ...
+        ```
+      render: python
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment Information
+      description: Please provide details about your environment
+      value: |
+        - **dioxide version**: (e.g., 0.1.0)
+        - **Python version**: (e.g., 3.11.5)
+        - **Operating System**: (e.g., macOS 14.1, Ubuntu 22.04, Windows 11)
+        - **Installation method**: (pip, uv, poetry, conda)
+      render: markdown
+    validations:
+      required: true
+
+  - type: dropdown
+    id: severity
+    attributes:
+      label: Severity
+      description: How severe is this bug?
+      options:
+        - Critical (System crash, data loss, security vulnerability)
+        - High (Major functionality broken, no workaround)
+        - Medium (Feature broken, workaround available)
+        - Low (Minor inconvenience, cosmetic issue)
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Add any other context about the problem here (logs, screenshots, stack traces, etc.)
+      placeholder: Stack traces, error messages, screenshots, related issues, etc.
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      description: Please confirm the following
+      options:
+        - label: I have searched existing issues to avoid duplicates
+          required: true
+        - label: I have provided a minimal reproducible example
+          required: true
+        - label: I have included all relevant environment information
+          required: true

dioxide-0.0.4a1/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: GitHub Discussions
+    url: https://github.com/mikelane/dioxide/discussions
+    about: For questions, ideas, and general discussions
+  - name: Security Vulnerability
+    url: https://github.com/mikelane/dioxide/security/advisories/new
+    about: Report security vulnerabilities privately

dioxide-0.0.4a1/.github/ISSUE_TEMPLATE/documentation.yml

@@ -0,0 +1,90 @@
+name: Documentation
+description: Report missing, incorrect, or unclear documentation
+title: '[DOCS] '
+labels: ['type: docs', 'status: triage']
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for helping improve dioxide's documentation!
+
+  - type: dropdown
+    id: doc-type
+    attributes:
+      label: Documentation Type
+      description: What kind of documentation issue is this?
+      options:
+        - Missing documentation
+        - Incorrect documentation
+        - Unclear/confusing documentation
+        - Outdated documentation
+        - Typo or formatting issue
+    validations:
+      required: true
+
+  - type: textarea
+    id: location
+    attributes:
+      label: Documentation Location
+      description: Where should this documentation be? (Provide URL or file path)
+      placeholder: |
+        e.g., https://dioxide.readthedocs.io/en/latest/api/container.html
+        or docs/user-guide/getting-started.md
+    validations:
+      required: true
+
+  - type: textarea
+    id: issue-description
+    attributes:
+      label: Issue Description
+      description: What's wrong with the current documentation, or what's missing?
+      placeholder: Describe the documentation issue in detail
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposed-content
+    attributes:
+      label: Proposed Content
+      description: What should the documentation say instead? (Optional for bug reports, required for missing docs)
+      placeholder: |
+        Provide the corrected text or outline what should be documented
+
+        For API docs, include:
+        - Function/class signature
+        - Parameters and types
+        - Return value
+        - Examples
+      render: markdown
+
+  - type: dropdown
+    id: audience
+    attributes:
+      label: Target Audience
+      description: Who is this documentation primarily for?
+      options:
+        - End users (using dioxide in their projects)
+        - API reference (developers using specific functions)
+        - Contributors (contributing to dioxide)
+        - Tutorial/guide (learning dioxide concepts)
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Context
+      description: Any other context, screenshots, or examples
+      placeholder: Screenshots of confusing documentation, links to good examples from other projects, etc.
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      description: Please confirm the following
+      options:
+        - label: I have searched existing documentation issues to avoid duplicates
+          required: true
+        - label: I have identified the specific location that needs updating
+          required: true

dioxide-0.0.4a1/.github/ISSUE_TEMPLATE/enhancement.yml

@@ -0,0 +1,111 @@
+name: Enhancement
+description: Suggest an improvement to an existing feature
+title: '[ENHANCEMENT] '
+labels: ['type: enhancement', 'status: triage']
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting an enhancement! Use this template for improvements to **existing** features.
+
+        For **new** features, please use the Feature Request template instead.
+
+  - type: textarea
+    id: feature-to-enhance
+    attributes:
+      label: Feature to Enhance
+      description: Which existing feature should be improved?
+      placeholder: Describe the current feature that needs enhancement
+    validations:
+      required: true
+
+  - type: textarea
+    id: current-behavior
+    attributes:
+      label: Current Behavior
+      description: How does the feature currently work?
+      placeholder: Describe the current implementation and behavior
+    validations:
+      required: true
+
+  - type: textarea
+    id: desired-behavior
+    attributes:
+      label: Desired Behavior
+      description: How should the feature work after this enhancement?
+      placeholder: Describe the improved behavior you'd like to see
+    validations:
+      required: true
+
+  - type: textarea
+    id: motivation
+    attributes:
+      label: Motivation
+      description: Why is this enhancement needed? What value does it provide?
+      placeholder: Explain the benefits and use cases for this improvement
+    validations:
+      required: true
+
+  - type: textarea
+    id: example-comparison
+    attributes:
+      label: Before/After Example
+      description: Show how code would change with this enhancement
+      placeholder: |
+        **Before (current):**
+        ```python
+        # Current usage
+        ```
+
+        **After (enhanced):**
+        ```python
+        # Improved usage
+        ```
+      render: markdown
+    validations:
+      required: true
+
+  - type: dropdown
+    id: impact
+    attributes:
+      label: Impact
+      description: What is the impact of this enhancement?
+      options:
+        - High (Significantly improves usability or performance)
+        - Medium (Noticeable improvement, affects common use cases)
+        - Low (Minor improvement, nice to have)
+    validations:
+      required: true
+
+  - type: dropdown
+    id: breaking-change
+    attributes:
+      label: Breaking Change?
+      description: Would this enhancement break existing code?
+      options:
+        - No (Backward compatible)
+        - Yes (Would require code changes)
+        - Maybe (Depends on implementation)
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Add any other context, benchmarks, or references here
+      placeholder: Performance benchmarks, similar implementations in other projects, etc.
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      description: Please confirm the following
+      options:
+        - label: I have searched existing issues to avoid duplicates
+          required: true
+        - label: This is an enhancement to an existing feature (not a new feature)
+          required: true
+        - label: I have provided clear before/after examples
+          required: true

dioxide-0.0.4a1/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,112 @@
+name: Feature Request
+description: Propose a new feature for dioxide
+title: '[FEATURE] '
+labels: ['type: feature', 'status: triage']
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for proposing a new feature! Please provide as much detail as possible.
+
+        Before submitting, please search existing issues and discussions to see if this has been proposed before.
+
+  - type: textarea
+    id: user-story
+    attributes:
+      label: User Story
+      description: Describe this feature as a user story
+      placeholder: |
+        As a [type of user],
+        I want [goal/desire],
+        So that [benefit/value].
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem-statement
+    attributes:
+      label: Problem Statement
+      description: What problem does this feature solve? Why is it needed?
+      placeholder: Describe the problem or pain point this feature addresses
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposed-solution
+    attributes:
+      label: Proposed Solution
+      description: How should this feature work? Describe the desired behavior.
+      placeholder: Describe your ideal solution in detail
+    validations:
+      required: true
+
+  - type: textarea
+    id: example-usage
+    attributes:
+      label: Example Usage
+      description: Provide a code example showing how you envision using this feature
+      placeholder: |
+        ```python
+        from dioxide import Container
+
+        # Example of how this feature would be used
+        container = Container()
+        # ...
+        ```
+      render: python
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives-considered
+    attributes:
+      label: Alternatives Considered
+      description: What alternative solutions or features have you considered?
+      placeholder: Describe alternative approaches and why they are less suitable
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority
+      description: How important is this feature to you?
+      options:
+        - Critical (Blocking current work, no workaround)
+        - High (Very important, would significantly improve workflow)
+        - Medium (Nice to have, would improve experience)
+        - Low (Minor improvement, not urgent)
+    validations:
+      required: true
+
+  - type: textarea
+    id: acceptance-criteria
+    attributes:
+      label: Acceptance Criteria
+      description: What must be true for this feature to be considered complete?
+      value: |
+        - [ ] Criterion 1
+        - [ ] Criterion 2
+        - [ ] Criterion 3
+      render: markdown
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Add any other context, mockups, references, or examples here
+      placeholder: Links to similar features in other projects, mockups, diagrams, etc.
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      description: Please confirm the following
+      options:
+        - label: I have searched existing issues and discussions to avoid duplicates
+          required: true
+        - label: I have clearly described the problem this feature solves
+          required: true
+        - label: I have provided a concrete example of how this feature would be used
+          required: true

dioxide-0.0.4a1/.github/ISSUE_TEMPLATE/question.yml

@@ -0,0 +1,90 @@
+name: Question / Support
+description: Ask a question or get help using dioxide
+title: '[QUESTION] '
+labels: ['type: question', 'status: triage']
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reaching out! We're here to help.
+
+        **Note:** For in-depth discussions, consider using [GitHub Discussions](https://github.com/mikelane/dioxide/discussions) instead of opening an issue.
+
+  - type: textarea
+    id: question
+    attributes:
+      label: Your Question
+      description: What would you like to know?
+      placeholder: Ask your question here in as much detail as possible
+    validations:
+      required: true
+
+  - type: textarea
+    id: goal
+    attributes:
+      label: What Are You Trying to Accomplish?
+      description: Provide context about what you're trying to achieve
+      placeholder: Describe your use case and end goal
+    validations:
+      required: true
+
+  - type: textarea
+    id: attempted-solutions
+    attributes:
+      label: What Have You Tried?
+      description: What approaches have you already attempted?
+      placeholder: |
+        List what you've tried so far:
+        1. Attempted approach 1
+        2. Attempted approach 2
+        3. Read documentation page X
+    validations:
+      required: true
+
+  - type: textarea
+    id: code-example
+    attributes:
+      label: Relevant Code
+      description: Share any relevant code that demonstrates what you're working on
+      placeholder: |
+        ```python
+        # Your code here
+        from dioxide import Container
+
+        # ...
+        ```
+      render: python
+
+  - type: textarea
+    id: error-output
+    attributes:
+      label: Error Messages or Output
+      description: If you're encountering errors, paste them here
+      placeholder: |
+        Any error messages, stack traces, or unexpected output
+      render: shell
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Provide relevant environment details
+      value: |
+        - **dioxide version**:
+        - **Python version**:
+        - **Operating System**:
+      render: markdown
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      description: Please confirm the following
+      options:
+        - label: I have searched existing issues and discussions for similar questions
+          required: true
+        - label: I have checked the documentation
+          required: true
+        - label: I have provided sufficient context about what I'm trying to accomplish
+          required: true

dioxide-0.0.4a1/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,114 @@
+# Pull Request
+
+## Description
+
+<!-- Provide a clear and concise description of what this PR does -->
+
+## Related Issues
+
+<!-- Link to related issues using keywords: Closes #123, Fixes #456, Resolves #789 -->
+
+Closes #
+
+## Type of Change
+
+<!-- Mark the relevant option with an 'x' -->
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Refactoring (no functional changes)
+- [ ] Performance improvement
+- [ ] Security fix
+- [ ] Other (please describe):
+
+## Changes Made
+
+<!-- Provide a bulleted list of specific changes -->
+
+-
+-
+-
+
+## Testing
+
+<!-- Describe the tests you ran to verify your changes -->
+
+### Test Coverage
+
+- [ ] All new code is covered by tests
+- [ ] All existing tests pass
+- [ ] Integration tests added/updated (if applicable)
+- [ ] Manual testing performed
+
+### Test Commands Run
+
+```bash
+# Example:
+# uv run pytest tests/
+# uv run tox -e lint
+# uv run mypy dioxide/
+```
+
+**Test Results:**
+
+<!-- Paste relevant test output or describe manual testing results -->
+
+```
+```
+
+## Breaking Changes
+
+<!-- If this is a breaking change, describe the impact and migration path -->
+
+**Impact:**
+
+**Migration Guide:**
+
+```python
+# Before:
+
+
+# After:
+
+```
+
+## Documentation
+
+- [ ] Documentation updated (if needed)
+- [ ] Docstrings added/updated for new/modified functions
+- [ ] `CHANGELOG.md` will be updated automatically (via semantic-release)
+- [ ] API changes documented in relevant docs
+
+## Checklist
+
+<!-- Ensure all items are checked before requesting review -->
+
+- [ ] My code follows the project's code style (ruff, isort, mypy)
+- [ ] I have performed a self-review of my own code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing unit tests pass locally with my changes
+- [ ] Any dependent changes have been merged and published
+
+## Additional Context
+
+<!-- Add any other context, screenshots, or information about the PR here -->
+
+---
+
+**For Reviewers:**
+
+<!-- Guidance for reviewers -->
+
+**Focus Areas:**
+
+-
+-
+
+**Known Issues/TODOs:**
+
+-