stman


Namestman JSON
Version 0.1.0 PyPI version JSON
download
home_pageNone
SummaryA lightweight CLI tool that tabulates device/folder storage.
upload_time2025-08-03 01:37:11
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseMIT
keywords storage disk directory size cli windows
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Storage Manager (stman)

A lightweight CLI tool that tabulates device/folder storage on Windows systems.

## Features

- **Drive Analysis**: View storage usage across all available drives
- **Directory Scanning**: Calculate folder sizes with real-time updates
- **Interactive UI**: Navigate through directories with keyboard commands
- **Performance Optimized**: Uses native Windows APIs for fast scanning
- **Cross-Drive Support**: Works across all accessible Windows drives

## Requirements

- Windows 10/11
- Python 3.8 or higher

## Installation

```powershell
pip install stman
```

## Usage

```powershell
stman
```

### Commands

- `help` - Show available commands
- `exit` - Exit the application
- `goto` - Navigate to a specific path
- `top` - Go to root directory
- `b` - Go back one directory
- `r` - Refresh current view
- `togglecnc` - Toggle showing uncalculatable folders
- `togglewelcome` - Toggle welcome message
- `clearcache` - Clear the size cache

## Contributing

### Reporting Issues

If you encounter any issues or have suggestions for improvements:

1. **Check the error message**: The application provides specific error messages for common issues
2. **Platform compatibility**: This tool only works on Windows systems
3. **DLL errors**: If you see "dir_size.dll not found" errors, try reinstalling the package
4. **Permission errors**: Some folders may be inaccessible due to Windows permissions

### Contributing Code

Contributions are welcome. To contribute:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly on Windows
5. Submit a pull request

### Development Setup

```powershell
git clone https://github.com/glcon/storage-manager.git
cd storage-manager
pip install -e .
```

## License

MIT License - see LICENSE file for details.

## Author

Garrett Connell 

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "stman",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "storage, disk, directory, size, cli, windows",
    "author": null,
    "author_email": "Garrett Connell <glconnell.tx@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/ef/1c/0760ed51fbde147586207f64571d5a1855a4e8a5090863b188d0b59b9821/stman-0.1.0.tar.gz",
    "platform": null,
    "description": "# Storage Manager (stman)\r\n\r\nA lightweight CLI tool that tabulates device/folder storage on Windows systems.\r\n\r\n## Features\r\n\r\n- **Drive Analysis**: View storage usage across all available drives\r\n- **Directory Scanning**: Calculate folder sizes with real-time updates\r\n- **Interactive UI**: Navigate through directories with keyboard commands\r\n- **Performance Optimized**: Uses native Windows APIs for fast scanning\r\n- **Cross-Drive Support**: Works across all accessible Windows drives\r\n\r\n## Requirements\r\n\r\n- Windows 10/11\r\n- Python 3.8 or higher\r\n\r\n## Installation\r\n\r\n```powershell\r\npip install stman\r\n```\r\n\r\n## Usage\r\n\r\n```powershell\r\nstman\r\n```\r\n\r\n### Commands\r\n\r\n- `help` - Show available commands\r\n- `exit` - Exit the application\r\n- `goto` - Navigate to a specific path\r\n- `top` - Go to root directory\r\n- `b` - Go back one directory\r\n- `r` - Refresh current view\r\n- `togglecnc` - Toggle showing uncalculatable folders\r\n- `togglewelcome` - Toggle welcome message\r\n- `clearcache` - Clear the size cache\r\n\r\n## Contributing\r\n\r\n### Reporting Issues\r\n\r\nIf you encounter any issues or have suggestions for improvements:\r\n\r\n1. **Check the error message**: The application provides specific error messages for common issues\r\n2. **Platform compatibility**: This tool only works on Windows systems\r\n3. **DLL errors**: If you see \"dir_size.dll not found\" errors, try reinstalling the package\r\n4. **Permission errors**: Some folders may be inaccessible due to Windows permissions\r\n\r\n### Contributing Code\r\n\r\nContributions are welcome. To contribute:\r\n\r\n1. Fork the repository\r\n2. Create a feature branch\r\n3. Make your changes\r\n4. Test thoroughly on Windows\r\n5. Submit a pull request\r\n\r\n### Development Setup\r\n\r\n```powershell\r\ngit clone https://github.com/glcon/storage-manager.git\r\ncd storage-manager\r\npip install -e .\r\n```\r\n\r\n## License\r\n\r\nMIT License - see LICENSE file for details.\r\n\r\n## Author\r\n\r\nGarrett Connell \r\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A lightweight CLI tool that tabulates device/folder storage.",
    "version": "0.1.0",
    "project_urls": {
        "Homepage": "https://github.com/glcon/storage-manager"
    },
    "split_keywords": [
        "storage",
        " disk",
        " directory",
        " size",
        " cli",
        " windows"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "db609bd60bcea3db66928d5f7ae427ae1b9a15756dafb3b85bb52d1649acc534",
                "md5": "0cc947306a389bfc7d042452da962e74",
                "sha256": "e17a03d4611eada445395c3606c9dcc163f11a0cf5eacff7f5f5df53817829ef"
            },
            "downloads": -1,
            "filename": "stman-0.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "0cc947306a389bfc7d042452da962e74",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 262609,
            "upload_time": "2025-08-03T01:37:09",
            "upload_time_iso_8601": "2025-08-03T01:37:09.960408Z",
            "url": "https://files.pythonhosted.org/packages/db/60/9bd60bcea3db66928d5f7ae427ae1b9a15756dafb3b85bb52d1649acc534/stman-0.1.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "ef1c0760ed51fbde147586207f64571d5a1855a4e8a5090863b188d0b59b9821",
                "md5": "9c9e2293cb4811fd86c55ac353d12fb0",
                "sha256": "0045bbcefb88f58dcbd7ac0160773c17ed3044fa835fd6b85645f6f9553945c7"
            },
            "downloads": -1,
            "filename": "stman-0.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "9c9e2293cb4811fd86c55ac353d12fb0",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 260736,
            "upload_time": "2025-08-03T01:37:11",
            "upload_time_iso_8601": "2025-08-03T01:37:11.587517Z",
            "url": "https://files.pythonhosted.org/packages/ef/1c/0760ed51fbde147586207f64571d5a1855a4e8a5090863b188d0b59b9821/stman-0.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-03 01:37:11",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "glcon",
    "github_project": "storage-manager",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "stman"
}
        
Elapsed time: 1.44673s