Rustfinity

Rustfinity is an interactive learning platform dedicated to helping Rust developers of all levels learn and practice Rust programming concepts.
Visit our website → rustfinity.com to explore challenges, tutorials, and everything you need to level up your Rust skills!

Why Rustfinity?

• Hands-on Learning: Practice your Rust skills with real challenges in a fun environment.
• Comprehensive Exercises: From basics to advanced topics—there’s something for everyone.
• Engaging Community: Contribute, discuss, and grow alongside other Rust enthusiasts!

---

Table of Contents

• 🚀 Getting Started
• 📂 Folder Structure
  • challenges/
  • crates/
• 🤖 Crates
  • cli
  • rustfinity-runner
  • syntest
• ❤️ Contribute
• 🏠 Local Development
• 🔗 Follow Us
• ⚖️ License

---

🚀 Getting Started

1. Head to rustfinity.com
   Explore available challenges and pick the ones you want to tackle.
2. Try out the cli crate (optional)
   You can download challenges and practice them locally right from your terminal.
3. Dive into the code
   Explore this repository to see how challenges and crates are structured.

---

📂 Folder Structure

.
├── challenges/
│   ├── challenge-1/
│   │   ├── description.md
│   │   ├── src/
│   │   │   ├── lib.rs
│   │   │   └── starter.rs
│   │   └── tests/
│   │       └── tests.rs
│   └── challenge-2/ (and so on...)
└── crates/
    ├── cli
    ├── rustfinity-runner
    └── syntest

challenges/

This directory holds all the coding challenges served on rustfinity.com. Feel free to submit new challenges, improve existing ones, or solve them locally using our CLI.

crates/

This folder contains multiple Rust crates that power the Rustfinity platform.

---

🤖 Crates

cli

• What is it?
  The Rustfinity Command-Line Interface to help you download, solve, and submit Rustfinity challenges locally.
• Key Features
  • Download any challenge directly to your local environment
  • Submit solutions with rustfinity submit which redirects you to the challenge page with your solution

rustfinity-runner

• What is it?
  A crate designed for running challenge tests inside a secure Docker container.
• Key Features
  • Spins up a temporary Docker container to safely execute user code
  • Logs outputs and results from test runs
  • Ensures a clean environment for each challenge submission

syntest

• What is it?
  A specialized testing library built on top of Rust’s syn library to analyze and validate Rust code syntax.
• Key Features
  • Parse Rust AST (Abstract Syntax Tree) for testable patterns
  • Provides an easy interface for writing syntax-based tests
  • Helps ensure your Rust code meets style and syntactic guidelines

---

❤️ Contribute

We’d love your help! Whether it’s fixing bugs, adding challenges, or improving docs, every bit of help matters.

1. Check out our issues: Found a bug or want to suggest an enhancement? Open an issue!
2. Fork & PR: Fork the repo, make changes, and submit a pull request.
3. Join our Discord: Join our Discord server to discuss ideas, ask questions, or just hang out with the community.
4. Spread the word: Share Rustfinity with your friends, colleagues, or on social media.

---

🏠 Local Development

Ready to hack on Rustfinity locally? Here’s how:

# 1. Clone the repository
git clone https://github.com/dcodesdev/rustfinity.com.git
cd rustfinity.com

# 2. (Optional) Switch to a new branch for your work
git checkout -b my-new-feature

# 3. Explore and build
cargo build

We recommend installing Docker if you want to test the rustfinity-runner crate in a containerized environment.

---

🔗 Follow Us

Stay updated with the latest challenges, features, and announcements!

---

⚖️ License

This project is licensed under the Rustfinity Proprietary License.