Filtrar y buscar propuestas y solicitudes de cambios

Para encontrar información detallada sobre un repositorio en GitHub, puedes filtrar, clasificar y buscar propuestas y solicitudes de cambios que sean relevantes para el repositorio.

Tool navigation

En este artículo

Tip

También puedes filtrar las propuestas o solicitudes de cambios si utilizas el GitHub CLI. Para más información, vea "gh issue list" o "gh pr list" en la documentación de GitHub CLI.

Filtrar propuestas y solicitudes de extracción

Las propuestas y las solicitudes de extracción vienen con un conjunto de filtros predeterminados que puedes aplicar para organizar tus listas.

Puedes filtrar propuestas y solicitudes de extracción para buscar:

  • Todas las propuestas y solicitudes de extracción abiertas
  • Las propuestas y solicitudes de extracción creadas por ti
  • Las propuestas y solicitudes de extracción que se te han asignado
  • Propuestas y solicitudes de incorporación de cambios en las que apareces como @mentioned

Tip

También puedes filtrar las propuestas o solicitudes de cambios si utilizas el GitHub CLI. Para más información, vea "gh issue list" o "gh pr list" en la documentación de GitHub CLI.

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. En el nombre del repositorio, haga clic en Incidencias o Solicitudes de incorporación de cambios.

    Captura de pantalla de la página principal de un repositorio. En la barra de navegación horizontal, dos pestañas, con la etiqueta "Incidencias" y "Solicitudes de incorporación de cambios", se destacan en naranja oscuro.

  3. Encima de la lista, seleccione el menú desplegable Filtros y, a continuación, haga clic en el tipo de filtro que le interese.

    Captura de pantalla de la lista de problemas de un repositorio. Encima de la lista aparece el menú desplegable, con la etiqueta "Filtros", resaltado en naranja oscuro.

Creación de filtros avanzados para incidencias

Note

Los tipos de incidencias, las subincidencias y la búsqueda avanzada de incidencias se encuentran actualmente en versión preliminar pública opcional para las organizaciones. Para más información y agregar a la organización a la lista de espera, vea el "Blog de GitHub".

Puede crear filtros avanzados mediante consultas booleanas y anidadas en la página de incidencias del repositorio. A medida que escribe el filtro, GitHub mostrará los calificadores disponibles, sugerirá valores y advertirá cuando haya una incidencia con el filtro.

Uso de operadores booleanos

Puede usar los operadores AND y OR para refinar los filtros.

Use AND cuando necesite resultados en los que ambas instrucciones sean verdaderas. En el filtro de ejemplo siguiente, los resultados se componen de incidencias con la etiqueta "Corrección de errores" que se asigna al usuario @octocat.

label:"Bug fix" AND assignee:octocat

Para devolver resultados donde cualquiera de las instrucciones es true, use OR. En el ejemplo siguiente, los resultados contendrán incidencias asignadas a @octocat o @hubot.

assignee:octocat OR assignee:hubot

Si decide no usar los operadores AND y OR, GitHub tratará un espacio entre instrucciones como un operador AND a menos que use un campo org, repo o user para filtrar por propiedad donde cualquier espacio se tratará como operador OR.

Uso de paréntesis para filtros más complicados

También puede usar paréntesis para anidar filtros y calificadores de grupo. En el ejemplo siguiente, los resultados contendrán incidencias asignadas a @octocat con el tipo de incidencia "bug" o asignadas a @hubot con el tipo de incidencia "Enhancement".

(type:"Bug" AND assignee:octocat) OR (type:"Enhancement" AND assignee:hubot)

Puede anidar filtros mediante paréntesis con hasta cinco niveles de profundidad. Actualmente no es posible incluir los calificadores repo, org o user entre paréntesis.

Filtrar propuestas y solicitudes de extracción por asignatarios

Una vez que hayas asignado una propuesta o una solicitud de incorporación de cambios a alguien, puedes encontrar elementos basados en quién está trabajando en ella.

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. En el nombre del repositorio, haga clic en Incidencias o Solicitudes de incorporación de cambios.

    Captura de pantalla de la página principal de un repositorio. En la barra de navegación horizontal, dos pestañas, con la etiqueta "Incidencias" y "Solicitudes de incorporación de cambios", se destacan en naranja oscuro.

  3. Encima de la lista de problemas o solicitudes de incorporación de cambios, seleccione el menú desplegable Asignados.

    Captura de pantalla de una lista de incidencias. En el encabezado encima de la lista, un menú desplegable, con la etiqueta "Usuarios asignados" se resalta en naranja oscuro.

  4. El menú desplegable Asignatario menciona a todos los usuarios que tienen acceso de escritura a tu repositorio. Haz clic en el nombre de la persona cuyos elementos asignados quieras ver, o haz clic en No asignado a nadie para ver qué propuestas no están asignadas.

Tip

Para borrar la selección de filtro, haga clic en Clear current search query, filters, and sorts (Borrar consultas de búsqueda, filtros y ordenaciones actuales).

Filtrar propuestas y solicitudes de extracción por etiquetas

Una vez que hayas aplicado etiquetas a una propuesta o una solicitud de incorporación de cambios, puedes encontrar elementos basados en sus etiquetas.

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. En el nombre del repositorio, haga clic en Incidencias o Solicitudes de incorporación de cambios.

    Captura de pantalla de la página principal de un repositorio. En la barra de navegación horizontal, dos pestañas, con la etiqueta "Incidencias" y "Solicitudes de incorporación de cambios", se destacan en naranja oscuro.

  3. Encima de la lista de incidencias o solicitudes de incorporación de cambios, haga clic en Labels.

    Captura de pantalla de la lista de problemas de un repositorio. Encima de la lista, un botón, etiquetado con un icono de etiqueta y "Etiquetas", se resalta en naranja oscuro.

  4. En la lista de etiquetas, haga clic en una etiqueta.

Tip

Para borrar la selección de filtro, haga clic en Clear current search query, filters, and sorts (Borrar consultas de búsqueda, filtros y ordenaciones actuales).

Filtrado por tipo de incidencia

Note

Los tipos de incidencias, las subincidencias y la búsqueda avanzada de incidencias se encuentran actualmente en versión preliminar pública opcional para las organizaciones. Para más información y agregar a la organización a la lista de espera, vea el "Blog de GitHub".

Si en la organización usan tipos de incidencias, puede filtrar las incidencias de un tipo determinado. También puede escribir el calificador type: directamente en el filtro.

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. Debajo del nombre del repositorio, haga clic en Problemas.

    Captura de pantalla de la página principal de un repositorio. En la barra de navegación horizontal, una pestaña, con la etiqueta "Problemas", se destaca en naranja oscuro.

  3. Encima de la lista de incidencias, seleccione el menú desplegable Tipos.

    Captura de pantalla de una lista de incidencias. En el encabezado encima de la lista, un menú desplegable, con la etiqueta "Tipos" se resalta en naranja oscuro y el menú Tipos de incidencia está abierto.

  4. En la lista de tipos, haga clic en un tipo de incidencia.

Filtrar solicitudes de extracción por estado de revisión

Puedes usar filtros para ver en una lista las solicitudes de extracción por estado de revisión y buscar las solicitudes de extracción que has revisado o que otras personas te han pedido que revises.

Puedes filtrar la lista de solicitudes de extracción de un repositorio para buscar:

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. En el nombre del repositorio, haga clic en Solicitudes de incorporación de cambios.

    Captura de pantalla de la página principal de un repositorio. En la barra de navegación horizontal, una pestaña, con la etiqueta "Solicitudes de incorporación de cambios", se destaca en naranja oscuro.

  3. En la esquina superior derecha, selecciona el menú desplegable Revisiones.

    Captura de pantalla del menú de filtro situado encima de la lista de solicitudes de incorporación de cambios. La lista desplegable "Revisiones" está resaltada en naranja oscuro.

  4. Elige un filtro para buscar todas las solicitudes de extracción con ese estado de filtro.

Utilizar búsqueda para filtrar propuestas y solicitudes de extracción

Puede utilizar filtros para buscar incidencias y solicitudes de cambios que cumplan criterios específicos.

Buscar propuestas y solicitudes de cambio

La barra de búsqueda de propuestas y solicitudes de extracción te permite definir tus propios filtros personalizados y clasificar por una amplia variedad de criterios. Puedes encontrar la barra de búsqueda en las pestañas Propuestas y Solicitudes de incorporación de cambios de cada repositorio y en los paneles Propuestas y Solicitudes de incorporación de cambios.

Captura de pantalla de la lista de problemas de un repositorio. Encima de la lista, un campo de búsqueda, que contiene la consulta "is:issue is:open", resaltado en naranja oscuro.

Tip

Puedes enfocar tu cursor en la barra de búsqueda que está sobre el listado de informe de problemas o solicitud de extracción con un atajo de teclado. Para obtener más información, vea «Accesos directos del teclado».

Note

Para más información sobre GitHub CLI,consulte «Acerca del CLI de GitHub».

Puedes utilizar el GitHub CLI para buscar propuestas o solicitudes de cambio. Usa el subcomando gh issue list o gh pr list junto con el argumento --search y una consulta de búsqueda.

Por ejemplo, puedes enumerar, ordenados por fecha de creación, todas las propuestas que no tienen un usuario asignado y que tienen la etiqueta help wanted o bug.

gh issue list --search 'no:assignee label:"help wanted",bug sort:created-asc'

También puedes enumerar todas las solicitudes de incorporación de cambios que mencionan al equipo octo-org/octo-team.

gh pr list --search "team:octo-org/octo-team"

Acerca de los términos de búsqueda

Con los términos de búsqueda de propuestas y solicitudes de extracción, puedes hacer lo siguiente:

  • Filtra las propuestas y las solicitudes de incorporación de cambios por autor: state:open type:issue author:octocat
  • Filtra las propuestas y las solicitudes de incorporación de cambios que impliquen, pero no necesariamente @mention , a determinados usuarios: state:open type:issue involves:octocat
  • Filtra las propuestas y solicitudes de incorporación de cambios por usuario asignado: state:open type:issue assignee:octocat
  • Filtra las propuestas y solicitudes de incorporación de cambios por etiqueta: state:open type:issue label:"bug"
  • Filtra los términos de búsqueda utilizando - antes del término: state:open type:issue -author:octocat

Tip

Puedes filtrar las propuestas y solicitudes de cambios por etiqueta mediante los operadores lógicos OR o AND.

  • Para filtrar las propuestas mediante el operador lógico OR, usa la sintaxis de coma: label:"bug","wip".
  • Para filtrar las propuestas mediante el operador lógico AND, usa filtros de etiqueta independientes: label:"bug" label:"wip".

Para el caso de informes de problemas, también puedes utilizar la búsqueda para:

  • Filtrar los problemas vinculadas a una solicitud de incorporación de cambios mediante una referencia de cierre: linked:pr
  • Filtre las incidencias por el motivo por el que se hayan cerrado: is:closed reason:completed o is:closed reason:"not planned"
  • Filtrado de incidencias con un tipo concreto: is:open type:"Bug"

Para las solicitudes de cambios, también puedes utilizar la búsqueda para:

  • Filtrar los borradores de solicitudes de incorporación de cambios: is:draft
  • Filtrar las solicitudes de incorporación de cambios que aún no se han revisado: state:open type:pr review:none
  • Filtrar las solicitudes de incorporación de cambios que requieren una revisión antes de poder combinarse: state:open type:pr review:required
  • Filtrar las solicitudes de incorporación de cambios que ha aprobado un revisor: state:open type:pr review:approved
  • Filtrar las solicitudes de incorporación de cambios en las que un revisor ha pedido cambios: state:open type:pr review:changes_requested
  • Filtrar las solicitudes de incorporación de cambios por revisor: state:open type:pr reviewed-by:octocat
  • Filtrar las solicitudes de incorporación de cambios por el usuario específico solicitado para la revisión: state:open type:pr review-requested:octocat
  • Filtrar las solicitudes de incorporación de cambios que alguien te pidió directamente que revisaras: state:open type:pr user-review-requested:@me
  • Filtrar las solicitudes de incorporación de cambios por el equipo solicitado para la revisión: state:open type:pr team-review-requested:github/docs
  • Filtrar las solicitudes de incorporación de cambios vinculadas a una incidencia que la solicitud de incorporación de cambios puede cerrar: linked:issue
  • Filtrar las solicitudes de incorporación de cambios por estado de combinación: is:merged o is:unmerged

Clasificar propuestas y solicitudes de extracción

Los filtros pueden ser clasificados para ofrecer mejor información durante un período de tiempo específico.

Puedes clasificar cualquier vista filtrada por:

  • Las propuestas y solicitudes de extracción creadas más recientemente
  • Las propuestas y solicitudes de extracción creadas con mayor antigüedad
  • Las propuestas y solicitudes de extracción más comentadas
  • Las propuestas y solicitudes de extracción menos comentadas
  • Las propuestas y solicitudes de extracción actualizadas más recientemente
  • Las propuestas y solicitudes de extracción actualizadas con mayor antigüedad
  • La reacción más agregada a las propuestas o solicitudes de cambio

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. En el nombre del repositorio, haga clic en Incidencias o Solicitudes de incorporación de cambios.

    Captura de pantalla de la página principal de un repositorio. En la barra de navegación horizontal, dos pestañas, con la etiqueta "Incidencias" y "Solicitudes de incorporación de cambios", se destacan en naranja oscuro.

  3. Encima de la lista de problemas o solicitudes de incorporación de cambios, seleccione el menú desplegable Ordenar y, a continuación, haga clic en un método de ordenación.

    Captura de pantalla de la lista de problemas de un repositorio. Encima de la lista aparece el menú desplegable, con la etiqueta "Filtros", resaltado en naranja oscuro.

Para borrar la selección de ordenación, haz clic en Ordenar > Más reciente.

Compartir filtros

Cuando filtras o clasificas propuestas y solicitudes de extracción, la URL de tu navegador se actualiza automáticamente para coincidir con la nueva vista.

Puedes enviar la URL que genera esa propuesta a cualquier usuario, que podrá ver el mismo filtro que tú ves.

Por ejemplo, si filtras propuestas asignadas a Hubot, y clasificas las propuestas abiertas más antiguas, tu URL se actualizaría a algo similar a esto:

/issues?q=state:open+type:issue+assignee:hubot+sort:created-asc

Información adicional