summaryrefslogtreecommitdiffhomepage
path: root/.github/ISSUE_TEMPLATE/20_bug_report.yml
blob: 82f90663e55b67c34de48551f1a1760e493689a4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
name: Bug Report
description: |
  Use this template when paramiko appears to be doing something wrong.
title: "[BUG] - <title>"
labels: ["Bug"]

body:
  - type: markdown
    attributes:
      value: |
        Thanks for taking the time to file a bug report!

  - type: dropdown
    id: usage_posture
    attributes:
      label: Are you using paramiko as a client or server?
      multiple: false
      options:
        - Client
        - Server
        - Both
        - Exception handling
        - Not sure
    validations:
      required: true

  - type: dropdown
    id: features
    attributes:
      label: What feature(s) aren't working right?
      description: Select as many as are relevant
      multiple: true
      options:
        - SSH
        - SFTP
        - Keys/auth
        - known_hosts
        - sshconfig
        - Something else
    validations:
      required: true
  
  - type: input
    id: paramiko_version
    attributes:
      label: What version(s) of paramiko are you using?
      description: |
        Find out with `$ python -c "import paramiko; print(paramiko.__version__)"`
      placeholder: |
        Example: 3.1.0
    validations:
      required: true

  - type: input
    id: python_version
    attributes:
      label: What version(s) of Python are you using?
      description: |
        Find out with `$ python -V`
      placeholder: |
        Example: 3.11.3
    validations:
      required: true

  - type: input
    id: os_info
    attributes:
      label: What operating system and version are you using?
      placeholder: |
        Example: WSL on Windows 11; or MacOS Mojave; or Ubuntu 22.10
    validations:
      required: true

  - type: input
    id: server_info
    attributes:
      label: If you're connecting as a client, which SSH server are you connecting to?
      description: |
        Leave this blank if you're not sure.
      placeholder: |
        Example: OpenSSH x.y; or Teleport vNN

  - type: input
    id: integrated_tool
    attributes:
      label: If you're using paramiko as part of another tool, which tool/version?
      placeholder: |
        Examples: Fabric, Ansible, sftputil
  
  - type: textarea
    id: desired_behavior
    attributes:
      label: Expected/desired behavior
      description: |
        Please describe what you are trying to do with paramiko. Include code snippets and be as detailed as possible.
    validations:
      required: true
  
  - type: textarea
    id: actual_behavior
    attributes:
      label: Actual behavior
      description: |
        What is paramiko doing instead?
    validations:
      required: true
  
  - type: textarea
    id: repro
    attributes:
      label: How to reproduce
      description: |
        If possible, please provide a minimal code example that reproduces the bug.
  
  - type: textarea
    id: more_info
    attributes:
      label: Anything else?
      description: |
        Please provide any additional information that might help us find and fix the bug.