Title: packOptions.filesIncluded is silently ignored for any path under a dot-prefixed directory · Issue #1855 · UiPath/uipath-python · GitHub
Open Graph Title: packOptions.filesIncluded is silently ignored for any path under a dot-prefixed directory · Issue #1855 · UiPath/uipath-python
X Title: packOptions.filesIncluded is silently ignored for any path under a dot-prefixed directory · Issue #1855 · UiPath/uipath-python
Description: What happens packOptions.filesIncluded accepts a relative path so a file in a subdirectory can be added to the package. Any path under a dot-prefixed directory is dropped instead, and nothing reports it. The same applies to a dotfile nam...
Open Graph Description: What happens packOptions.filesIncluded accepts a relative path so a file in a subdirectory can be added to the package. Any path under a dot-prefixed directory is dropped instead, and nothing repor...
X Description: What happens packOptions.filesIncluded accepts a relative path so a file in a subdirectory can be added to the package. Any path under a dot-prefixed directory is dropped instead, and nothing repor...
Opengraph URL: https://github.com/UiPath/uipath-python/issues/1855
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"packOptions.filesIncluded is silently ignored for any path under a dot-prefixed directory","articleBody":"## What happens\n\n`packOptions.filesIncluded` accepts a relative path so a file in a subdirectory can be added to the package. Any path under a dot-prefixed directory is dropped instead, and nothing reports it. The same applies to a dotfile named explicitly.\n\nThe spec describes `filesIncluded` as \"Specific files to **always** include\" ([packOptions](https://github.com/UiPath/uipath-python/blob/main/packages/uipath/specs/uipath.spec.md#4-packoptions)), and `uipath pack` exits successfully, so there is no signal that part of the configuration was ignored.\n\n## Reproduction\n\n```python\nimport os, tempfile\nfrom uipath._cli._utils._project_files import files_to_include\nfrom uipath._cli.models.uipath_json_schema import PackOptions\n\nroot = tempfile.mkdtemp()\nos.makedirs(f\"{root}/.config/assets/demo\")\nos.makedirs(f\"{root}/plain\")\nopen(f\"{root}/.config/assets/demo/ASSET.md\", \"w\").write(\"x\")\nopen(f\"{root}/plain/ASSET.md\", \"w\").write(\"x\") # control, same shape without the dot\nopen(f\"{root}/.python-version\", \"w\").write(\"3.11\")\nopen(f\"{root}/pyproject.toml\", \"w\").write(\"[project]\")\n\nopts = PackOptions(**{\"filesIncluded\": [\n \".config/assets/demo/ASSET.md\",\n \".python-version\",\n \"plain/ASSET.md\",\n]})\n\nincluded, skipped = files_to_include(opts, root, include_uv_lock=False)\nprint(\"included:\", sorted(f.relative_path for f in included))\nprint(\"skipped :\", skipped)\n```\n\nOutput:\n\n```\nincluded: ['plain/ASSET.md', 'pyproject.toml']\nskipped : []\n```\n\n`plain/ASSET.md` is honoured. `.config/assets/demo/ASSET.md` and `.python-version` are not, and `skipped` is empty.\n\n## Cause\n\nTwo unconditional filters run before the inclusion rules are evaluated.\n\n[`_project_files.py:471`](https://github.com/UiPath/uipath-python/blob/main/packages/uipath/src/uipath/_cli/_utils/_project_files.py#L471) drops dot-prefixed directories from `dirs[:]`, so `os.walk` never descends into them. [Line 497](https://github.com/UiPath/uipath-python/blob/main/packages/uipath/src/uipath/_cli/_utils/_project_files.py#L497) skips dot-prefixed files with a bare `continue`.\n\nThe per-file inclusion check that would honour the configuration is [lines 514 to 520](https://github.com/UiPath/uipath-python/blob/main/packages/uipath/src/uipath/_cli/_utils/_project_files.py#L514-L520), and it already supports a path match for subdirectories. It is simply unreachable for these paths.\n\nBecause both filters `continue` rather than appending to `skipped_files`, the omission does not surface anywhere, including in the caller that reports skipped files.\n\n## Why it matters\n\nTooling configuration and assets conventionally live in a dot-prefixed directory. A project that needs such a directory inside its package has no way to express that: `directoriesExcluded` has no `directoriesIncluded` counterpart, and the documented per-file escape hatch does not work there.\n\nThe available workaround is to keep the content under a non-dot directory and copy it into place at runtime, which means the package layout no longer matches the source layout and the copy step has to be reimplemented per project.\n\n## Suggested fix\n\nAny of these would resolve it, in rough order of smallest change:\n\n1. Honour an explicit `filesIncluded` entry regardless of a dot prefix. Descend into a dot-prefixed directory only when some `filesIncluded` entry has it as a path prefix, which keeps the current pruning fast for `.git`, `.venv` and similar. Apply the same to the dotfile filter at line 497. This matches the word \"always\" already in the spec.\n2. Add `directoriesIncluded` to `packOptions` as the counterpart to `directoriesExcluded`.\n\nIndependent of which is chosen, appending to `skipped_files` at both filters would turn a silent omission into something a caller can report.\n\n## Environment\n\n- `uipath` 2.14.2, resolved from PyPI\n- Python 3.14, macOS\n- Line numbers above are against `main`\n","author":{"url":"https://github.com/radu-mocanu","@type":"Person","name":"radu-mocanu"},"datePublished":"2026-08-11T15:40:40Z","url":"https://github.com/UiPath/uipath-python/issues/1855"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:fe4cb02f-51da-c113-9668-64330471608a |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | E172:EA085:194E5D:22EEBF:6AFF62B3 |
| html-safe-nonce | 01453c0e2a938303ea4ee3f290bc669a60fb900cede21758267b735bd766e92e |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJFMTcyOkVBMDg1OjE5NEU1RDoyMkVFQkY6NkFGRjYyQjMiLCJ2aXNpdG9yX2lkIjoiNjg4ODM1NTgxMTk3MDQ3NDY3NSIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | 3f3a1f6868f244201c47c370681e60511de1521d5874d12db34679651251dacd |
| hovercard-subject-tag | issue:5121917936 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/UiPath/uipath-python/1855/issue_layout |
| twitter:image | https://opengraph.githubassets.com/85b7544fd9f0a1a0f62e896792d114fe4678b2bf4f98acc120b5f2aecc084da5/UiPath/uipath-python/issues/1855 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/85b7544fd9f0a1a0f62e896792d114fe4678b2bf4f98acc120b5f2aecc084da5/UiPath/uipath-python/issues/1855 |
| og:image:alt | What happens packOptions.filesIncluded accepts a relative path so a file in a subdirectory can be added to the package. Any path under a dot-prefixed directory is dropped instead, and nothing repor... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | radu-mocanu |
| hostname | github.com |
| expected-hostname | github.com |
| None | 41b58589a1c4eda1e3c8904144a412b88ca4455f63ca2ad3629f2e9f3c3a1d12 |
| turbo-cache-control | no-preview |
| go-import | github.com/UiPath/uipath-python git https://github.com/UiPath/uipath-python.git |
| octolytics-dimension-user_id | 375663 |
| octolytics-dimension-user_login | UiPath |
| octolytics-dimension-repository_id | 925171912 |
| octolytics-dimension-repository_nwo | UiPath/uipath-python |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 925171912 |
| octolytics-dimension-repository_network_root_nwo | UiPath/uipath-python |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 8968d6d6acc65d74e4df332d23932dd3fd0502a4 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width