Skip to content

Commit

Permalink
updated README
Browse files Browse the repository at this point in the history
  • Loading branch information
l.danilo authored and l.danilo committed Jan 24, 2019
1 parent fa299a4 commit cdb31ba
Show file tree
Hide file tree
Showing 317 changed files with 65,875 additions and 1 deletion.
15 changes: 15 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
.hg*
*.pyc
*.lock
*.log
*.log.[0-9]
*.start
*.stop
*.shm
*.DS_Store
core/config.json
make/native/*
make/tmp/*
*/.settings/*
*/bld_*/*
/.metadata/
31 changes: 30 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1 +1,30 @@
# agent
# DWService - Agent
This is [DWService](https://www.dwservice.net) agent for operative systems Linux, Mac and Windows.
The code is written in python2 and several libraries are written c++.

## Start the agent
If you prefer you can start the agent from the sources but you keep in mind in this mode the agent does not update automatically, so you need to update sources manually every time. Before to start the agent you need to:
- Install python2.7
- Install g++/make (if windows download [Mingw-w64](https://mingw-w64.org) version [64bit](https://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win64/Personal%20Builds/mingw-builds/8.1.0/threads-win32/sjlj/) or [32bit](https://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win32/Personal%20Builds/mingw-builds/8.1.0/threads-win32/sjlj/))
- Download agent source code ([zip](https://github.com/dwservice/agent/archive/master.zip) or git clone)
- Execute these commands from agent/make:

```
python2.7 compile_all.py (compile all c++ libraries)
python2.7 create_config.py (create config.json in agent/core path)
```

now you are ready to start the agent by execute this command from agent/core:
```
python2.7 agent.py
```


## Setup the agent for development
Thanks [Eclipse](https://www.eclipse.org) + [Pydev](https://marketplace.eclipse.org/content/pydev-python-ide-eclipse) and [CDT](https://marketplace.eclipse.org/content/complete-eclipse-cc-ide) you can develop the agent with only one IDE from your prefer operative system. You also need of python2.7 and g++/make (if windows download [Mingw-w64](https://mingw-w64.org) version [64bit](https://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win64/Personal%20Builds/mingw-builds/8.1.0/threads-win32/sjlj/) or [32bit](https://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win32/Personal%20Builds/mingw-builds/8.1.0/threads-win32/sjlj/)) installed on your system. After configuring the IDE and importing the source code, you need to execute same scripts of **"Start the agent"** section.

You can read the [guide on the wiki](https://github.com/dwservice/agent/wiki/Setup-the-agent-for-development) to learn how to setup the agent for development.

## License Agreement
This software is free and open source.
It consists of one core component released under the MPLv2 license, and several libraries and components defined "app" that could be governed by different licenses. you can read the "LICENSE" file in each folder.
18 changes: 18 additions & 0 deletions app_desktop/.project
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
<?xml version="1.0" encoding="UTF-8"?>
<projectDescription>
<name>app_desktop</name>
<comment></comment>
<projects>
<project>core</project>
</projects>
<buildSpec>
<buildCommand>
<name>org.python.pydev.PyDevBuilder</name>
<arguments>
</arguments>
</buildCommand>
</buildSpec>
<natures>
<nature>org.python.pydev.pythonNature</nature>
</natures>
</projectDescription>
8 changes: 8 additions & 0 deletions app_desktop/.pydevproject
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<?eclipse-pydev version="1.0"?><pydev_project>
<pydev_pathproperty name="org.python.pydev.PROJECT_SOURCE_PATH">
<path>/app_desktop</path>
</pydev_pathproperty>
<pydev_property name="org.python.pydev.PYTHON_PROJECT_VERSION">python 2.7</pydev_property>
<pydev_property name="org.python.pydev.PYTHON_PROJECT_INTERPRETER">Default</pydev_property>
</pydev_project>
Loading

0 comments on commit cdb31ba

Please sign in to comment.