File: nodejs.h

package info (click to toggle)
kdevelop 4%3A5.6.2-4
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 57,892 kB
  • sloc: cpp: 278,773; javascript: 3,558; python: 3,385; sh: 1,317; ansic: 689; xml: 273; php: 95; makefile: 40; lisp: 13; sed: 12
file content (87 lines) | stat: -rw-r--r-- 2,944 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
/*
 * This file is part of qmljs, the QML/JS language support plugin for KDevelop
 * Copyright (c) 2014 Denis Steckelmacher <steckdenis@yahoo.fr>
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License as
 * published by the Free Software Foundation; either version 2 of
 * the License or (at your option) version 3 or any later version
 * accepted by the membership of KDE e.V. (or its successor approved
 * by the membership of KDE e.V.), which shall act as a proxy
 * defined in Section 14 of version 3 of the license.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 */
#ifndef __FRAMEWORK_NODEJS_H__
#define __FRAMEWORK_NODEJS_H__

#include "../declarationbuilder.h"
#include "duchainexport.h"
#include <language/duchain/duchainpointer.h>
#include <util/path.h>

#include <QMutex>

namespace QmlJS {

/**
 * Singleton implementing support for the Node.js Javascript framework
 */
class KDEVQMLJSDUCHAIN_EXPORT NodeJS {
private:
    NodeJS();

public:
    static NodeJS& instance();

    /**
     * Initialize a QML/JS context so that it contains built-in Node.js declarations
     * that will allow the module to export symbols.
     *
     * @note The DUChain must be write-locked
     */
    void initialize(DeclarationBuilder* builder);

    /**
     * Declaration of the "exports" (or "module.exports") member of a Node.js
     * module.
     *
     * @param moduleName Name of the module to import ("http", "../module.js", etc)
     * @param url Url of the document that imports the module
     */
    KDevelop::DeclarationPointer moduleExports(const QString& moduleName,
                                               const KDevelop::IndexedString& url);

    /**
     * Declaration of a member of a module
     */
    KDevelop::DeclarationPointer moduleMember(const QString& moduleName,
                                              const QString& memberName,
                                              const KDevelop::IndexedString& url);

    /**
     * List of directories where Node.js modules visible from @p url may exist
     */
    KDevelop::Path::List moduleDirectories(const QString& url);

private:
    void createObject(const QString& name, int index, DeclarationBuilder* builder);
    QString moduleFileName(const QString& moduleName, const QString& url);
    QString fileOrDirectoryPath(const QString& baseName);

private:
    using CachedModuleFileNamesHash = QHash<QPair<QString, QString>, QString>;
    CachedModuleFileNamesHash m_cachedModuleFileNames;
    QMutex m_mutex;
};

}

#endif