First, thank you for contributing! 💝
The current goal of this project is to create a minimalistic but visual and informative tool to see our portfolios in new ways. While Finary provides nice graphs already, this project aims to freely explore other ideas.
Currently, this project is a command-line tool but it may be extended to other output formats (Web dashboard, PDF report, Jupyter notebook, …) depending on the features we’ll want to add. It may also remain as a pure command-line tool using plotting libraries such as
uniplot. Please feel free to open a new discussion to share your ideas and help shape this project! If you have any skill you would like to leverage here (e.g. web development), then let’s use that 🍀
The project structure is pretty typical for Python projects, with
finalynx being the source directory. The main entry point is
assistant.py with the
Assistant class, which orchestrates the fetching, processing, and printing steps. Each feature domain is separated in its own submodule:
portfolio/is responsible for building and displaying the portfolio tree, with basic processing tools such as investment targets.
fetch/is reponsible of using
finary_apito fetch the amounts into the
finary_api/is a git submodule since finary_api is not available on PyPI (the repository for
pip). Hence, we include its source code inside our own
copilot/are empty for now and will be developed later. Please checkout the project management and GitHub issues to see what’s planned next.
Feel free to suggest additions or changes!
💬 Project management
The most important panel is the 👉 Project View 👈 to see the current development status. Here is how you can participate:
Checkout The Plan™ to see what’s planned for Finalynx in general.
Open an issue for each of your ideas, even those you don’t think you’d develop yourself. Once discussed and assigned to someone in the project view, the development can start.
Remember: one issue = one pull request = one feature/bugfix.
When you finish a contribution, create a pull request and mention which issue your PR would close. See more details in the next section.
🌊 Contribution workflow
If you want to propose something new (new feature, extension, bugfix, documentation help, …), please follow these steps:
Open an issue and chat with everyone to make sure your contribution would fit nicely with the project.
Fork this repo (click the fork button on GitHub)
Follow the initial setup described in the section below
Create a separate branch that will hold your contribution with any name (e.g.
Make your changes 🪄 and stage them with
git add .
Check your changes with
pre-commit run. If some of your changes do not follow the conventions, they will automatically be fixed. Take a look at the proposed changes and run
git add . && pre-commit runagain until all checks pass.
Commit your contributions using the conventional commits naming standard (e.g.
feat(readme): added something cool)
Push your changes to your remote fork
Open a pull-request to our primary repo and target the
mainbranch (using conventional commits again for your PR title)
Wait for review: let’s chat about it in the pull request comments and merge it 🎉
For your next contributions, you can simply update your fork and start from step 3. Let me know if you plan on actively contributing to this project, I can give you direct access to this repo.
⚙️ Initial setup
Clone your fork using the
--recursiveoption to include the
git clone --recursive https://github.com/YOUR_GITHUB_USERNAME/finalynx.git
# If you forgot --recursive, run: git submodule update --init --recursive
poetrywhich manages the project dependencies, and get all dependencies needed to work on this project:
pip3 install poetry && poetry check && poetry install
Install this project in editable mode so that you don’t need to reinstall it on each change:
pip install -e .
Try the assistant with:
If you see a template portfolio tree and your investments detected from Finary, then you’re now part of the (small) team! 🎉 Now create your own copy of the demo file and go customize it for your own needs (the name
assistant_config is recommended as it is ignored from git):
cp examples/demo.py assistant_config.py # <- Your own portfolio here
When you’re ready to make a contribution, this project uses
pre-committo make sure we all use the same code styling and formatting conventions. Make sure to activate it on this repo using:
pre-commit install --install-hooks
Now, each time you commit, a list of checks will run on the files you changed. You can try it out before committing with:
pre-commit run # optional: --all-files
When you commit, make sure to follow the conventional commits naming standard for your commit messages, which will be used to automatically change the release version.
You can now push your changes to your fork (preferably in a separate branch if you plan on contributing again) and create a pull request on the original repo.
♻️ Continuous Integration
The original repo has an automated CI/CD pipeline setup for a few tasks:
Run the pre-commit checks on any new pull request or push to report if something was forgotten. Also run tests in CI.
When something is pushed to the
mainbranch (e.g. a merge from your pull request), a job calculates the new version for
finalynxbased on the commit messages, updates the changelog, creates a release on GitHub, and publishes the new package to PyPI.
When a PR is opened or edited, make sure the title and commit messages following the naming convention.
❓ Missing stuff for now
Tests and published documentation are limited for now. Ping me if you want me/us to improve them.