| Name | ye3sld JSON |
| Version |
1.0.4
JSON |
| download |
| home_page | None |
| Summary | Create an html file that shows the directory listing structure of an s3 bucket. |
| upload_time | 2025-01-12 10:06:52 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | MIT License |
| keywords |
bucket
directory
html
s3
tree
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# ye3sld
Créer un fichier HTML qui affiche la structure de la liste des dossiers d'un bucket S3.
Create an html file that show the directory listing structure of an s3 bucket.
# Features
- Works with all S3 compatible storage API implementations ([Amazon](https://aws.amazon.com/s3/), [Garage](https://garagehq.deuxfleurs.fr/), [MinIO](https://min.io/), etc.)
- GUI (Graphical User Interface) mode and CLI (Command Line Interface) mode
- Enter the Endpoint URL, Access key ID, Secret access key, Region, Bucket name
- Filter on a specific folder in S3 bucket (Prefix)
- Filter with regex to exclude certain patterns (eg: .tmp, .old, backup_.*)
- Can list all files, even if there are more than 1000 files in the bucket (S3 pagination)
- Select the output HTML file location: in local and S3 bucket (optional)
- Output HTML : Nice tree structure with a smooth effect when moving the mouse over the list items
- Output HTML : List items are clickable, with customizable href base url
The main goal is to display the entire folder structure on a single page. Really light and simple, without any action button or entry box on the output html page.
# Prerequisite
Python and boto3
tkinter if you want a Graphical User Interface
# Simple usage
### 1) Install
Open the command prompt and type :
```bash
pip install ye3sld
```
### 2) Run
From the command prompt,
For GUI mode, type :
```bash
ye3sld
```
Fill in the fields in the GUI
For CLI mode, type :
```bash
ye3sld --cli --endpoint_url="http://MYWEBSITE" --aws_access_key_id="MYID" --aws_secret_access_key="MYSECRET" --bucket_name="MYBUCKET" --upload --overwrite --exclude=".tmp, .old"
```
To show all CLI options : `ye3sld --help`
### 3) Verify
Open the HTML output file in your local folder or in your s3 bucket
To view the HTML code [Click here](https://raw.githubusercontent.com/palw3ey/ye3sld/master/doc/demo-output.html)
# Version
| name | version |
| :- |:- |
|ye3sld | 1.0.4 |
# Changelog
## [1.0.4] - 2025-01-12
### Added
- Show size and last modification when clicking on a line or on the page title
- Add generation date in the html meta
- ttk style
### Changed
- Refactoring code to conform to PEP 8, improve readability, maintainability, and consistency. Passed conformity checks with Flake8 and Pylint (rated at 10.00/10).
- Changed some exception handling
- All DEFAULT can now be use for GUI and CLI
## [1.0.3] - 2025-01-07
### Added
- Hide the traceback, to avoid overwhelming the user with technical details
### Fixed
- args.cli replaced with True in cli_mode() function when calling generate_html() function
## [1.0.2] - 2025-01-06
### Changed
- Success and error message
- Help message in cli mode
- Missing tkinter message displayed in main()
### Added
- New function "check_s3_file_exists" to detect if s3 output file already exists
- New function "get_full_path" to get fullpath of the local output file
- Hint in cli mode
## [1.0.1] - 2025-01-02
### Fixed
- messagebox was not showing because tkinter was not imported in the generate_html function. Now, tkinter is imported at the top of the script, inside a try except.
## [1.0.0] - 2024-12-30
### Added
- première : first release
# ToDo
Feel free to contribute or share your ideas for new features, you can contact me here on github or by email. I speak French, you can write to me in other languages I will find ways to translate.
# License
MIT
author: palw3ey
maintainer: palw3ey
email: palw3ey@gmail.com
website: https://github.com/palw3ey/ye3sld
Raw data
{
"_id": null,
"home_page": null,
"name": "ye3sld",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "palw3ey <palw3ey@gmail.com>",
"keywords": "bucket, directory, html, s3, tree",
"author": null,
"author_email": "palw3ey <palw3ey@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/bf/43/b8d29f80857fcd43449d9dd24e68b8017f0c7f7ced624ca062cf5f23c164/ye3sld-1.0.4.tar.gz",
"platform": null,
"description": "# ye3sld\n\nCr\u00e9er un fichier HTML qui affiche la structure de la liste des dossiers d'un bucket S3. \n\nCreate an html file that show the directory listing structure of an s3 bucket.\n\n# Features\n\n- Works with all S3 compatible storage API implementations ([Amazon](https://aws.amazon.com/s3/), [Garage](https://garagehq.deuxfleurs.fr/), [MinIO](https://min.io/), etc.)\n- GUI (Graphical User Interface) mode and CLI (Command Line Interface) mode\n- Enter the Endpoint URL, Access key ID, Secret access key, Region, Bucket name\n- Filter on a specific folder in S3 bucket (Prefix)\n- Filter with regex to exclude certain patterns (eg: .tmp, .old, backup_.*)\n- Can list all files, even if there are more than 1000 files in the bucket (S3 pagination)\n- Select the output HTML file location: in local and S3 bucket (optional)\n- Output HTML : Nice tree structure with a smooth effect when moving the mouse over the list items\n- Output HTML : List items are clickable, with customizable href base url\n\nThe main goal is to display the entire folder structure on a single page. Really light and simple, without any action button or entry box on the output html page.\n\n# Prerequisite\n\nPython and boto3 \ntkinter if you want a Graphical User Interface\n\n# Simple usage\n\n### 1) Install\n\nOpen the command prompt and type :\n\n```bash\npip install ye3sld\n```\n\n### 2) Run\n\nFrom the command prompt, \n\nFor GUI mode, type :\n```bash\nye3sld\n```\n\nFill in the fields in the GUI\n \n\n\nFor CLI mode, type : \n```bash\nye3sld --cli --endpoint_url=\"http://MYWEBSITE\" --aws_access_key_id=\"MYID\" --aws_secret_access_key=\"MYSECRET\" --bucket_name=\"MYBUCKET\" --upload --overwrite --exclude=\".tmp, .old\"\n```\nTo show all CLI options : `ye3sld --help`\n \n### 3) Verify\n\nOpen the HTML output file in your local folder or in your s3 bucket\n\n\n \nTo view the HTML code [Click here](https://raw.githubusercontent.com/palw3ey/ye3sld/master/doc/demo-output.html)\n\n# Version\n\n| name | version |\n| :- |:- |\n|ye3sld | 1.0.4 |\n\n# Changelog\n\n## [1.0.4] - 2025-01-12\n### Added\n- Show size and last modification when clicking on a line or on the page title\n- Add generation date in the html meta\n- ttk style\n\n### Changed\n- Refactoring code to conform to PEP 8, improve readability, maintainability, and consistency. Passed conformity checks with Flake8 and Pylint (rated at 10.00/10).\n- Changed some exception handling \n- All DEFAULT can now be use for GUI and CLI\n\n## [1.0.3] - 2025-01-07\n### Added\n- Hide the traceback, to avoid overwhelming the user with technical details\n\n### Fixed\n- args.cli replaced with True in cli_mode() function when calling generate_html() function\n\n## [1.0.2] - 2025-01-06\n### Changed\n- Success and error message\n- Help message in cli mode\n- Missing tkinter message displayed in main()\n\n### Added\n- New function \"check_s3_file_exists\" to detect if s3 output file already exists\n- New function \"get_full_path\" to get fullpath of the local output file\n- Hint in cli mode\n\n## [1.0.1] - 2025-01-02\n### Fixed\n- messagebox was not showing because tkinter was not imported in the generate_html function. Now, tkinter is imported at the top of the script, inside a try except.\n \n## [1.0.0] - 2024-12-30\n### Added\n- premi\u00e8re : first release\n\n# ToDo\n\nFeel free to contribute or share your ideas for new features, you can contact me here on github or by email. I speak French, you can write to me in other languages \u200b\u200bI will find ways to translate.\n\n# License\n\nMIT \nauthor: palw3ey \nmaintainer: palw3ey \nemail: palw3ey@gmail.com \nwebsite: https://github.com/palw3ey/ye3sld\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "Create an html file that shows the directory listing structure of an s3 bucket.",
"version": "1.0.4",
"project_urls": {
"Documentation": "https://github.com/palw3ey/ye3sld",
"Homepage": "https://github.com/palw3ey/ye3sld",
"Repository": "https://github.com/palw3ey/ye3sld.git"
},
"split_keywords": [
"bucket",
" directory",
" html",
" s3",
" tree"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4efb169317500a0fe33c38ca725fe22d6f61ec44332a2655087e6cf022ba9df5",
"md5": "bd9716d3098e084644e063d94745677a",
"sha256": "35e0a119c8428af891ef5d36dfc66ee68d6ad28dd9f41bcbadf8e3236e89328e"
},
"downloads": -1,
"filename": "ye3sld-1.0.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bd9716d3098e084644e063d94745677a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 10607,
"upload_time": "2025-01-12T10:06:50",
"upload_time_iso_8601": "2025-01-12T10:06:50.532097Z",
"url": "https://files.pythonhosted.org/packages/4e/fb/169317500a0fe33c38ca725fe22d6f61ec44332a2655087e6cf022ba9df5/ye3sld-1.0.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bf43b8d29f80857fcd43449d9dd24e68b8017f0c7f7ced624ca062cf5f23c164",
"md5": "223d4c09063cd09d8d17513679ac5e9f",
"sha256": "bbfbe420561c382fa2bfa7c5d1688aa59be93bef92b5f0438db81687cd7a8751"
},
"downloads": -1,
"filename": "ye3sld-1.0.4.tar.gz",
"has_sig": false,
"md5_digest": "223d4c09063cd09d8d17513679ac5e9f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 114756,
"upload_time": "2025-01-12T10:06:52",
"upload_time_iso_8601": "2025-01-12T10:06:52.911197Z",
"url": "https://files.pythonhosted.org/packages/bf/43/b8d29f80857fcd43449d9dd24e68b8017f0c7f7ced624ca062cf5f23c164/ye3sld-1.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-12 10:06:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "palw3ey",
"github_project": "ye3sld",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ye3sld"
}
