Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/kadiryazadzhi/softuni---randomsentencesgenerator

🎓 Solution for the "Random Sentence Generator" practical project in the C# Fundamentals course at SoftUni 🎓
https://github.com/kadiryazadzhi/softuni---randomsentencesgenerator

charp course fundamentals project softuni

Last synced: 9 days ago
JSON representation

🎓 Solution for the "Random Sentence Generator" practical project in the C# Fundamentals course at SoftUni 🎓

Awesome Lists containing this project

README 

        
# 🎲 Random Sentence Generator Project



Welcome to the **Random Sentence Generator**, an interactive C# console application that generates fun and quirky random sentences. This project demonstrates practical programming skills and problem-solving abilities using arrays, lists, methods, and randomness in C#. 🎉



## 📜 **Project Description**

This project was initially developed as an additional task for improving portfolio and GitHub skills. The primary aim is to generate random sentences based on predefined sets of names, places, verbs, nouns, adverbs, and details. You can either generate new random sentences or interactively modify the elements that form the sentences. 



### 🔥 **Enhanced Features**

- **User Interaction**: The project now allows users to modify the elements (names, places, verbs, nouns, adverbs, and details) interactively. Users can add, insert, or delete elements in real-time.

- **Multiple Random Sentences**: You can generate as many sentences as you like, each time getting a unique combination of elements.

- **Extended Word Lists**: I've expanded the lists of elements (names, places, verbs, etc.) beyond the basic set provided in the original task, making the generated sentences even more fun and unpredictable! ✨



## 🛠 **Technologies Used**

- **C# .NET 6**: Core logic for generating random sentences and interacting with the user.

- **Visual Studio**: IDE used for developing and testing the application.



## 📚 **Project Structure**



1. **Random Sentence Generation**: 

   - A set of lists holds words for different sentence components.

   - The program picks a random word from each list to construct a complete sentence.

   - Each sentence follows the structure: `[Name from Place] [Adverb] [Verb] [Noun] [Details]`.

   - Example sentence: `"Peter from Sofia happily jumps over stones near the river."`



2. **Interactive Element Management**:

   - **Add**: Users can add new elements to the lists.

   - **Insert**: Users can insert elements at specific positions within the lists.

   - **Delete**: Users can remove elements they no longer want in the random sentence generation.



## 🚀 **How to Use**



1. Open the project in Visual Studio:

   - Open the solution file (`.sln`) in Visual Studio.



2. Run the application:

   - Once running, you will be presented with a menu:

     - **Option 0**: Generate random sentences.

     - **Option 1**: Modify the elements used for sentence generation.

     - **Option 'Q'**: Exit the program.



3. To generate a new random sentence:

   - Select option `0`. The program will display a random sentence. Press `[Enter]` to generate another or 'q' to return to the main menu.



4. To modify the elements:

   - Select option `1`. You can choose to add, insert, or delete an element from the lists. Simply follow the prompts.



## 📦 **Installation & Setup**



1. **Pre-requisites**: Make sure you have the following installed on your system:

   - [.NET SDK](https://dotnet.microsoft.com/download)

   - [Visual Studio](https://visualstudio.microsoft.com/)



2. **Running Locally**:

   - Clone the repository using the command mentioned above.

   - Open the project in Visual Studio.

   - Build the project and run it.



## 🛠 **Project Functionality**



### ✨ **Main Menu Options**:



- **Generate Random Sentences**:  

  The application generates random sentences based on pre-defined arrays of words. The words are randomly selected from each category to create a funny or interesting sentence.



- **Modify Sentence Elements**:  

  You can interactively manage the words that form the sentences:

   - Add new elements to lists (names, places, verbs, nouns, etc.).

   - Insert elements at specific positions.

   - Delete existing elements.



## 📊 **Word Lists**:



The sentence generator uses the following lists:



- **Names**: `["Peter", "Michell", "Jane", "Steve", etc.]`

- **Places**: `["Sofia", "Plovdiv", "Varna", "Burgas", etc.]`

- **Verbs**: `["eats", "holds", "sees", "plays with", etc.]`

- **Nouns**: `["stones", "cake", "apple", "laptop", etc.]`

- **Adverbs**: `["slowly", "diligently", "warmly", "sadly", etc.]`

- **Details**: `["near the river", "at home", "in the park", etc.]`



## 🛠 **User Actions**:



- **Add**: Insert a new word into the list. If it already exists, you’ll be notified.

- **Insert**: Insert a word at a specific index in the list.

- **Delete**: Remove a specific word from a list.



## 🎨 **Future Improvements**:



- Expand the word lists to make the sentences even more unpredictable and diverse.

- Add new sentence structures or randomization techniques.

- Provide a graphical user interface (GUI) for a more engaging experience.



## 💡 **Project Insights**



- The original task was focused on generating random sentences. My additions include user interaction to modify sentence elements in real time, which adds flexibility and personalizes the experience.

- This project is a fun and engaging way to showcase basic programming skills, array handling, and user input management.



## 💾 **Contribution**



Feel free to fork this repository and submit pull requests! Contributions are welcome if you have ideas for expanding the word lists, adding more features, or improving functionality.



## 📞 **Contact**



If you have any questions or suggestions, feel free to reach out at:



- 📧 Email: [email protected]

- 🌍 Portfolio: [Kadir Yazadzhi](https://kadiryazadzhi.github.io/portfolio/)



---



💻 Made with ❤️ in C#  

Happy Coding! 🚀