aiogram-cmds 0.1.0__tar.gz

aiogram_cmds-0.1.0/.cursorignore

@@ -0,0 +1,100 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+.uv/
+
+# Testing
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Documentation
+docs/_build/
+/site
+site/
+
+# IDE
+.vscode/
+.idea/
+*.iml
+*.ipr
+*.iws
+
+# OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Temporary files
+*.tmp
+*.temp
+*.bak
+*.backup
+*.orig
+*.swp
+*.swo
+*~
+
+# Logs
+*.log
+logs/
+
+# Reports (keep structure but ignore generated files)
+reports/coverage/
+reports/*.log
+reports/performance/
+
+# Benchmark results
+.benchmarks/
+
+# Translations
+*.mo
+*.pot
+
+# Project specific
+.notes/

aiogram_cmds-0.1.0/.github/CODEOWNERS

@@ -0,0 +1,40 @@
+# Global owners
+* @ArmanAvanesyan
+
+# Core package
+/src/aiogram_cmds/ @ArmanAvanesyan
+
+# Core functionality modules
+/src/aiogram_cmds/manager.py @ArmanAvanesyan
+/src/aiogram_cmds/builder.py @ArmanAvanesyan
+/src/aiogram_cmds/policy.py @ArmanAvanesyan
+/src/aiogram_cmds/settings.py @ArmanAvanesyan
+/src/aiogram_cmds/customize.py @ArmanAvanesyan
+/src/aiogram_cmds/translator.py @ArmanAvanesyan
+/src/aiogram_cmds/registry.py @ArmanAvanesyan
+/src/aiogram_cmds/apply.py @ArmanAvanesyan
+/src/aiogram_cmds/setters.py @ArmanAvanesyan
+/src/aiogram_cmds/auto_setup.py @ArmanAvanesyan
+/src/aiogram_cmds/dynamic.py @ArmanAvanesyan
+/src/aiogram_cmds/builders_configured.py @ArmanAvanesyan
+/src/aiogram_cmds/version.py @ArmanAvanesyan
+
+# Documentation
+/docs/ @ArmanAvanesyan
+/README.md @ArmanAvanesyan
+/CONTRIBUTING.md @ArmanAvanesyan
+
+# CI/CD and project configuration
+/.github/ @ArmanAvanesyan
+/pyproject.toml @ArmanAvanesyan
+/uv.lock @ArmanAvanesyan
+
+# Development tools
+/tools/ @ArmanAvanesyan
+/.cursor/ @ArmanAvanesyan
+
+# Examples
+/examples/ @ArmanAvanesyan
+
+# Tests
+/tests/ @ArmanAvanesyan

aiogram_cmds-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,149 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+title: "[BUG] "
+labels: ["bug"]
+assignees: []
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for taking the time to report a bug! Please fill out the form below to help us understand and reproduce the issue.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear and concise description of what the bug is.
+      placeholder: Describe the bug...
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior
+      placeholder: |
+        1. Go to '...'
+        2. Click on '....'
+        3. Scroll down to '....'
+        4. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: Expected Behavior
+      description: A clear and concise description of what you expected to happen.
+      placeholder: What should happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual-behavior
+    attributes:
+      label: Actual Behavior
+      description: A clear and concise description of what actually happened.
+      placeholder: What actually happened?
+    validations:
+      required: true
+
+  - type: textarea
+    id: code-example
+    attributes:
+      label: Code Example
+      description: If applicable, provide a minimal code example that demonstrates the issue.
+      placeholder: |
+        ```python
+        # Your code here
+        ```
+      render: python
+
+  - type: textarea
+    id: error-messages
+    attributes:
+      label: Error Messages
+      description: If applicable, paste any error messages or stack traces.
+      placeholder: |
+        ```
+        # Error messages here
+        ```
+      render: shell
+
+  - type: dropdown
+    id: python-version
+    attributes:
+      label: Python Version
+      description: What Python version are you using?
+      options:
+        - "3.10"
+        - "3.11"
+        - "3.12"
+        - "3.13"
+        - "Other (please specify)"
+    validations:
+      required: true
+
+  - type: input
+    id: aiogram-cmds-version
+    attributes:
+      label: aiogram-cmds Version
+      description: What version of aiogram-cmds are you using?
+      placeholder: e.g., 0.1.0
+    validations:
+      required: true
+
+  - type: dropdown
+    id: operating-system
+    attributes:
+      label: Operating System
+      description: What operating system are you using?
+      options:
+        - "Windows"
+        - "macOS"
+        - "Linux"
+        - "Other (please specify)"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: python-environment
+    attributes:
+      label: Python Environment
+      description: What Python environment are you using?
+      options:
+        - "virtualenv"
+        - "conda"
+        - "pipenv"
+        - "poetry"
+        - "uv"
+        - "system"
+        - "Other (please specify)"
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Add any other context about the problem here.
+      placeholder: Any additional information that might be helpful...
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      description: Please confirm the following
+      options:
+        - label: I have searched existing issues to ensure this is not a duplicate
+          required: true
+        - label: I have provided all the requested information
+          required: true
+        - label: I have included a minimal code example (if applicable)
+          required: false
+        - label: I have included error messages (if applicable)
+          required: false
+        - label: I have checked the documentation for similar issues
+          required: true

aiogram_cmds-0.1.0/.github/ISSUE_TEMPLATE/documentation_issue.yml

@@ -0,0 +1,123 @@
+name: Documentation Issue
+description: Report issues with documentation or suggest improvements
+title: "[DOCS] "
+labels: ["documentation"]
+assignees: []
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for helping improve our documentation! Please fill out the form below.
+
+  - type: textarea
+    id: issue-description
+    attributes:
+      label: Issue Description
+      description: A clear and concise description of the documentation issue.
+      placeholder: Describe the documentation issue...
+    validations:
+      required: true
+
+  - type: dropdown
+    id: issue-type
+    attributes:
+      label: Issue Type
+      description: What type of documentation issue is this?
+      options:
+        - "Missing documentation"
+        - "Incorrect information"
+        - "Unclear or confusing"
+        - "Outdated information"
+        - "Broken links"
+        - "Formatting issues"
+        - "Missing examples"
+        - "Other (please specify)"
+    validations:
+      required: true
+
+  - type: input
+    id: affected-docs
+    attributes:
+      label: Affected Documentation
+      description: Which documentation files or sections are affected?
+      placeholder: e.g., README.md, CONTRIBUTING.md, API docs, etc.
+    validations:
+      required: true
+
+  - type: textarea
+    id: current-content
+    attributes:
+      label: Current Content (if applicable)
+      description: Paste the current documentation content that has issues.
+      placeholder: |
+        ```markdown
+        # Current documentation content
+        ```
+      render: markdown
+
+  - type: textarea
+    id: expected-content
+    attributes:
+      label: Expected Content
+      description: Describe what the documentation should say or show.
+      placeholder: |
+        Describe what the documentation should contain or how it should be improved.
+        Include specific examples if applicable.
+
+  - type: textarea
+    id: suggested-fix
+    attributes:
+      label: Suggested Fix
+      description: If you have a specific suggestion for how to fix this, please provide it.
+      placeholder: |
+        ```markdown
+        # Suggested documentation content
+        ```
+      render: markdown
+
+  - type: textarea
+    id: examples
+    attributes:
+      label: Examples or Screenshots
+      description: If applicable, provide examples, screenshots, or code snippets that would help clarify the documentation.
+      placeholder: |
+        Provide examples, screenshots, or code snippets that would help improve the documentation.
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority
+      description: How important is this documentation issue?
+      options:
+        - "Low - Minor improvement"
+        - "Medium - Confusing but workable"
+        - "High - Blocks understanding"
+        - "Critical - Misleading or incorrect"
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Add any other context about the documentation issue here.
+      placeholder: |
+        Add any other context, references, or information about the documentation issue.
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      description: Please confirm the following
+      options:
+        - label: I have searched existing issues to ensure this is not a duplicate
+          required: true
+        - label: I have clearly described the documentation issue
+          required: true
+        - label: I have identified the affected documentation
+          required: true
+        - label: I have provided the current content (if applicable)
+          required: false
+        - label: I have suggested improvements or fixes
+          required: false

aiogram_cmds-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,130 @@
+name: Feature Request
+description: Suggest a new feature or enhancement
+title: "[FEATURE] "
+labels: ["enhancement"]
+assignees: []
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for suggesting a new feature! Please fill out the form below to help us understand your request.
+
+  - type: textarea
+    id: feature-description
+    attributes:
+      label: Feature Description
+      description: A clear and concise description of the feature you'd like to see.
+      placeholder: Describe the feature...
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem-statement
+    attributes:
+      label: Problem Statement
+      description: What problem does this feature solve? What pain point does it address?
+      placeholder: |
+        Is your feature request related to a problem? Please describe.
+        A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposed-solution
+    attributes:
+      label: Proposed Solution
+      description: Describe the solution you'd like to see implemented.
+      placeholder: |
+        A clear and concise description of what you want to happen.
+        Include any specific implementation details if you have them.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Describe any alternative solutions or workarounds you've considered.
+      placeholder: |
+        A clear and concise description of any alternative solutions or features you've considered.
+
+  - type: textarea
+    id: use-cases
+    attributes:
+      label: Use Cases
+      description: Provide specific use cases or examples where this feature would be helpful.
+      placeholder: |
+        Describe specific scenarios where this feature would be useful.
+        Include code examples if applicable.
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority
+      description: How important is this feature to you?
+      options:
+        - "Low - Nice to have"
+        - "Medium - Would be helpful"
+        - "High - Important for my use case"
+        - "Critical - Blocking my project"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: complexity
+    attributes:
+      label: Estimated Complexity
+      description: How complex do you think this feature would be to implement?
+      options:
+        - "Simple - Small change"
+        - "Medium - Moderate effort"
+        - "Complex - Significant development"
+        - "Unknown - Not sure"
+
+  - type: textarea
+    id: api-design
+    attributes:
+      label: API Design (if applicable)
+      description: If this feature involves new APIs, describe how you'd like them to work.
+      placeholder: |
+        ```python
+        # Example of how the new API might look
+        from aiogram_cmds import SomeNewFeature
+        
+        # Usage example
+        ```
+      render: python
+
+  - type: textarea
+    id: breaking-changes
+    attributes:
+      label: Breaking Changes
+      description: Would this feature require breaking changes to existing APIs?
+      placeholder: |
+        Describe any potential breaking changes and how they might be mitigated.
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Add any other context, mockups, or references about the feature request here.
+      placeholder: |
+        Add any other context, screenshots, or references about the feature request here.
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      description: Please confirm the following
+      options:
+        - label: I have searched existing issues to ensure this is not a duplicate
+          required: true
+        - label: I have provided a clear problem statement
+          required: true
+        - label: I have described the proposed solution
+          required: true
+        - label: I have considered the impact on existing functionality
+          required: true
+        - label: I have provided use cases or examples
+          required: false

aiogram_cmds-0.1.0/.github/ISSUE_TEMPLATE/performance_issue.yml

@@ -0,0 +1,173 @@
+name: Performance Issue
+description: Report performance problems or suggest optimizations
+title: "[PERF] "
+labels: ["performance"]
+assignees: []
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for reporting a performance issue! Please fill out the form below to help us understand and investigate the problem.
+
+  - type: textarea
+    id: issue-description
+    attributes:
+      label: Performance Issue Description
+      description: A clear and concise description of the performance problem.
+      placeholder: Describe the performance issue...
+    validations:
+      required: true
+
+  - type: dropdown
+    id: issue-type
+    attributes:
+      label: Issue Type
+      description: What type of performance issue is this?
+      options:
+        - "Slow execution"
+        - "High memory usage"
+        - "Memory leak"
+        - "CPU intensive"
+        - "Network latency"
+        - "Database performance"
+        - "Concurrency issues"
+        - "Other (please specify)"
+    validations:
+      required: true
+
+  - type: textarea
+    id: affected-component
+    attributes:
+      label: Affected Component
+      description: Which component or feature is experiencing performance issues?
+      placeholder: e.g., CommandScopeManager, CommandBuilder, ProfileResolver, Translator, etc.
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction-steps
+    attributes:
+      label: Steps to Reproduce
+      description: Detailed steps to reproduce the performance issue.
+      placeholder: |
+        1. Set up the following configuration...
+        2. Run the following code...
+        3. Observe the performance issue...
+    validations:
+      required: true
+
+  - type: textarea
+    id: code-example
+    attributes:
+      label: Code Example
+      description: Provide a minimal code example that demonstrates the performance issue.
+      placeholder: |
+        ```python
+        # Code that demonstrates the performance issue
+        import time
+        from aiogram_cmds import CommandScopeManager
+        
+        # Your code here
+        ```
+      render: python
+    validations:
+      required: true
+
+  - type: textarea
+    id: performance-metrics
+    attributes:
+      label: Performance Metrics
+      description: Provide specific performance measurements (execution time, memory usage, etc.).
+      placeholder: |
+        - Execution time: X seconds
+        - Memory usage: X MB
+        - CPU usage: X%
+        - Number of operations: X
+        - Throughput: X ops/sec
+
+  - type: textarea
+    id: expected-performance
+    attributes:
+      label: Expected Performance
+      description: What performance do you expect or consider acceptable?
+      placeholder: |
+        - Expected execution time: X seconds
+        - Expected memory usage: X MB
+        - Expected throughput: X ops/sec
+
+  - type: textarea
+    id: environment-details
+    attributes:
+      label: Environment Details
+      description: Provide details about your environment that might affect performance.
+      placeholder: |
+        - Python version: X.X.X
+        - aiogram-cmds version: X.X.X
+        - Operating system: X
+        - Hardware specs: CPU, RAM, etc.
+        - Bot configuration: Number of commands, profiles, languages, etc.
+        - Load conditions: Number of concurrent users, command update frequency, etc.
+
+  - type: textarea
+    id: profiling-results
+    attributes:
+      label: Profiling Results (if available)
+      description: If you've done any profiling, share the results here.
+      placeholder: |
+        ```python
+        # Profiling code and results
+        import cProfile
+        import pstats
+        
+        # Your profiling code here
+        ```
+      render: python
+
+  - type: textarea
+    id: workarounds
+    attributes:
+      label: Workarounds
+      description: Have you found any workarounds or temporary solutions?
+      placeholder: |
+        Describe any workarounds or temporary solutions you've implemented.
+
+  - type: dropdown
+    id: severity
+    attributes:
+      label: Severity
+      description: How severe is this performance issue?
+      options:
+        - "Low - Minor impact"
+        - "Medium - Noticeable impact"
+        - "High - Significant impact"
+        - "Critical - Blocks production use"
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Add any other context about the performance issue here.
+      placeholder: |
+        Add any other context, logs, or information about the performance issue.
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      description: Please confirm the following
+      options:
+        - label: I have searched existing issues to ensure this is not a duplicate
+          required: true
+        - label: I have provided a clear description of the performance issue
+          required: true
+        - label: I have included reproduction steps
+          required: true
+        - label: I have provided a minimal code example
+          required: true
+        - label: I have included performance metrics (if available)
+          required: false
+        - label: I have described the expected performance
+          required: true