Added comments

include/ast/ast.hpp

@@ -29,7 +29,7 @@ namespace fsh {
 
     class AstFactory {
       public:
-        // Generates an abstract syntax tree
+        // Generise abstraktno sintaksno drvo po ebnf formuli gore
         static std::shared_ptr<ExecutableNode> generate_ast(std::list<Token>& list) {
             auto it = list.begin();
             return CommandLineNode::build(it);
@@ -41,4 +41,4 @@ namespace fsh {
         AstFactory(const AstFactory&) = default;
     };
 
-} // namespace fsh
+}

include/ast/ast_base.hpp

@@ -33,6 +33,7 @@ namespace fsh {
         using TokenType = Lexer::TokenType;
         AstNode(NodeType type, std::string name) : type(type), name(name) {}
 
+        // Pokusa da napravi od narednih tokena zadati Node ako ne uspe vrati null
         template <class T>
         static std::shared_ptr<T> Optional(std::list<Token>::iterator& it, std::shared_ptr<T>& node_ptr);
 
@@ -42,6 +43,7 @@ namespace fsh {
             return Optional<T>(it, node_ptr);
         }
 
+        // Pravi od narednih tokena zadati Node ako ne uspe izbaci AstBuildError
         template <class T>
         static std::shared_ptr<T> Mandatory(std::list<Token>::iterator& it) {
             return T::build(it);
@@ -70,4 +72,4 @@ namespace fsh {
         AstBuildError(std::string err) : std::runtime_error(err) {}
     };
 
-} // namespace fsh
+}

include/ast/ast_component.hpp

@@ -80,4 +80,4 @@ namespace fsh {
         bool                       append = false;
     };
 
-} // namespace fsh
+}

include/ast/ast_executable.hpp

@@ -66,4 +66,4 @@ namespace fsh {
         std::shared_ptr<ExecutableNode> pipe;
     };
 
-} // namespace fsh
+}

include/ast/ast_token.hpp

@@ -6,6 +6,7 @@
 
 namespace fsh {
 
+    // Genericni node namenjen kao wrapper za tokene
     template <Lexer::TokenType T>
     class TokenNode : public AstNode {
       public:

include/cmd/args/arg.hpp

@@ -34,21 +34,25 @@ namespace fsh {
             bool      extends; //Not implemented
         };
 
+        // Dodavanje argumenta koji sluzi za ulaz
         void add_input_rule() {
             has_input = true;
             pos_arg_rules.push_back({ &_Argument::create<ArgInput>, false, false });
         }
 
+        // Dodavanje pozicionog argumenta sa automatskim prebacivanjem
         template <typename T>
         void add_rule(bool mandatory, bool extends = false) {
             pos_arg_rules.push_back({ &_Argument::create<Argument<T> >, mandatory, extends });
         }
 
+        // Dodavanje pravila za flag (sa mogucnoscu da se pokupi argument priljepljen npr. -n<count>)
         template <typename T = bool>
         void add_rule(const std::string name, bool capturing = false) {
             flag_rules[name] = { _Argument::create<Argument<T> >, false, capturing, false };
         }
 
+        // Popunjava ArgManager (Mozda bolji naziv bi bio populate?)
         void parse(ArgManager& manager, ArgNodes& vec, FlagNode flag);
 
         bool ghas_input() { return has_input; }

include/cmd/cmd.hpp

@@ -12,6 +12,7 @@
 
 namespace fsh {
 
+    // Ovaj singleton odrzava podatke o komanadama
     class CommandRegistry {
       public:
         static CommandRegistry& instance() {
@@ -27,6 +28,7 @@ namespace fsh {
         Command& operator[](const std::string n) { return get(n); }
 
       private:
+        // Nove komande bi registrovali ovde:
         CommandRegistry() {
             cmds["wc"]    = Command::register_cmd<CmdWc>();
             cmds["date"]  = Command::register_cmd<CmdDate>();
@@ -40,4 +42,4 @@ namespace fsh {
         std::unordered_map<std::string, std::unique_ptr<Command> > cmds;
     };
 
-} // namespace fsh
+}

include/cmd/cmd_base.hpp

@@ -27,7 +27,10 @@ namespace fsh {
         }
 
       protected:
+        // Register_flags se zove jednom pri registraciji komande i sluzi da u ArgFactory postavis
+        // pravila za argumente i opcije
         virtual void register_flags() {};
+        // Korisnik u ovoj funkciju implementira glavnu funkcionalnost komande
         virtual void run(std::istream& in, std::ostream& out, ArgManager& args) {};
         ArgFactory&  get_factory() { return arg_factory; }
 

include/fsh.hpp

@@ -8,9 +8,11 @@
 
 namespace fsh {
 
+    //Glavna singleton klasa za shell
     class fsh {
       public:
-        std::unordered_map<std::string, std::string> environment;
+        std::unordered_map<std::string, std::string>
+          environment; //Omogucava komandama da cuvaju informacije kroz upotrebe
 
         static fsh& instance() {
             static fsh f;

include/lexer.hpp

@@ -6,13 +6,13 @@
 
 namespace fsh {
 
+    // Ova klasa vrsi leksicku analizu ulaznog string-a
     class Lexer {
       public:
         enum TokenType {
             WHITESPACE,
             WORD,
             STRING_LITERAL,
-            OPT,
             FLAG,
             LREDIRECTION,
             RREDIRECTION,
@@ -23,8 +23,11 @@ namespace fsh {
 
         using Token = std::pair<Lexer::TokenType, std::string>;
 
-        int   peek();
-        int   consume();
+        // Daje nam sledeci karakter bez povecavanjem brojaca
+        int peek();
+        // Daje nam sledeci karakter sa povecavanjem brojaca
+        int consume();
+        // Trazi za sledeci token
         Token next_token();
 
         static std::list<Token> process(std::string line);
@@ -87,4 +90,4 @@ namespace fsh {
         return state;
     }
 
-} // namespace fsh
+}

include/util/input.hpp

@@ -7,6 +7,7 @@
 #include <iostream>
 #endif
 
+// Neke "workarounds" za terminale na Unix i Windows
 namespace fsh::util {
 
     /** 

include/util/text.hpp

@@ -5,6 +5,7 @@
 #include <fstream>
 #include <stdexcept>
 
+// Razlicite pomocne funkcije za tekstove
 namespace fsh::util {
 
     extern const char* tokens[];