Skip to content

Little NuGet Package to brush up your Collection of photos, videos, documents and so on. Keep your Desktop tidy! 🧹✨

License

Notifications You must be signed in to change notification settings

NicoFilips/ByteBrusher

Repository files navigation


Logo

Source: DALL-E 3

NuGet

publish ByteBrusher to nuget Build

Code-Coverage License: MIT GitHub contributors

C# Logo Nuget

Byte Brusher

An awesome little Project to keep your Desktop tidy!
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents 📋
  1. About The Project
  2. Getting Started 🏄
  3. Usage✨
  4. Roadmap 🗺️
  5. Contributing 👨‍👩‍👦‍👦
  6. License 🏳️
  7. Contact 🪪
  8. Acknowledgments 🦉

About The Project

So, if you're anything like me, you'll realize that it's not always straightforward to manage your data. Whether it's vacation photos, memes, documents, bills, videos, or anything else you need to store, the challenge is real. The task becomes even more daunting when you add the necessity of managing additional backups. And let's face it, your desktop isn't a version control system like git, making it tough to handle all this without considering future changes you might make. This time, I set out to develop an application that corrects past mistakes. It identifies and, if needed, eliminates duplicates.

Here's why:

  • Your time should be spent on creating something remarkable, not hunting down duplicates and unnecessary documents.
  • Repeating the same tasks over and over isn't efficient.
  • Keeping your desktop organized and your storage as minimal as possible is essential. 😄

Admittedly, this project might not be flawless or meet all your needs. So, I plan to make more improvements soon. You're also welcome to suggest changes by forking this repository, creating a pull request, or opening an issue. A big thank you to everyone who takes the time to explore this Repository!

(back to top)

Architecture🔨

classDiagram
    class Your-Program-To-Implement {
        DependencyResolver
    }

    class DependencyResolver{
        -CreateHostBuilder(string[] args) IHostBuilder
        -ScanUtil
        -DeleteUtil
        -DuplicateUtil
        -FilterUtil
        -HashUtil
    }

    class ScanUtil {
        +ScanUtil(IOptions options, ILogger logger)
        +GetFiles()
    }

    class FilterUtil {
        +Filter()
    }

    class DuplicateUtil {
        +FindDuplicates()
    }

    class DeleteUtil {
        +DeleteDuplicates()
    }

    class HashUtil {
        +CompareFilehashes()
    }

    DependencyResolver o-- HashUtil : DI Service
    DependencyResolver o-- ScanUtil : DI Service
    DependencyResolver o-- FilterUtil : DI Service
    DependencyResolver o-- DuplicateUtil : DI Service
    DependencyResolver o-- DeleteUtil : DI Service

    Your-Program-To-Implement <|-- DependencyResolver : Hosting Extension

As you can see, ByteBrusher provides a bunch of Util Classes to implement in your Codebase. If you have a HostBuilder to build and run your App you can headlessly integrate the Codebase into your DI Container to let the Dependency Injection manage your instances. If you don't use an HostBuilder you're free to directly use the Implementation. Both works like a Charm.

(back to top)

Built With

This section should list any major frameworks/libraries used to bootstrap your project. Leave any add-ons/plugins for the acknowledgements section. Here are a few examples.

Technology Logo
.NET 6 .NET Logo
C# C# Logo
Serilog Serilog Logo
NUnit NUnit Logo
Moq Moq Logo

(back to top)

Getting Started

This is an example of how you may give instructions on setting up your project locally. To get a local copy up and running follow these simple example steps.

Prerequisites

This is an example of how to list things you need to use the software and how to install them.

  • dotnet
    dotnet build --release

Installation

Below is an example of how you can instruct your audience on installing and setting up your app. This template doesn't rely on any external dependencies or services.

  1. Request a Pull Request
  2. Clone the repo
    git clone https://github.com/NicoFilips/ByteBrusher.git](https://github.com/NicoFilips/ByteBrusher/
  3. Restore Nuget packages
    nuget restore
  4. Start the Application
    dotnet build --release

(back to top)

Usage

I've coded some extension methods to configure your IHost. It also registers Dependency Injection so you can integrate it into your Apps:

Register the DI Services into your App:

    private static void Main(string[] args)
    {
        IHost host = DependencyResolver.DependencyResolver.CreateHostBuilder(args).Build();

Get Services from your DI Container:

        CliOptions = host.Services.GetRequiredService<ICliOptions>();
        _byteBrusherClient = host.Services.GetRequiredService<IByteBrusherClient>();
        _logger = host.Services.GetRequiredService<ILogger<Program>>();

Start Brushing your Bytes!

        _byteBrusherClient.ExecuteAsync(CliOptions.DeleteFlag, CliOptions.Path);
        _logger.LogInformation("---- < ByteBrusher.CLI finished > ----");
 }

(back to top)

Roadmap

  • Build Architecture
  • Add Dependency Injection and HostBuilder Extensionmethod
  • Add and Handle CLI Arguments
  • Filehash Comparison
  • Add Serilog
  • Unittest for every Util
  • Add Codecoverage > 80%
  • Use ML.Net to find redundant Documents
    • Memetemplates
    • Duplicates
  • Find more Contributors!
  • Earn the Startruck Badge!

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contact

Nico Filips - git@nicofilips.de

Connect with me:

LinkedIn Badge ProtonMail Badge

(back to top)

Acknowledgments

(back to top)

About

Little NuGet Package to brush up your Collection of photos, videos, documents and so on. Keep your Desktop tidy! 🧹✨

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Sponsor this project

Languages